Mailchimp
Renta выгружает в ваше хранилище данных восемь объектов Mailchimp: аудитории, участников аудиторий, кампании, отчёты по кампаниям, активность получателей, отписки, сегменты и теги.
Строка участника содержит статус подписки контакта, его merge-поля и теги. Строка отчёта по кампании содержит итоги одной отправленной кампании: открытия, клики, возвраты и отписки. Активность получателе й раскладывает эти итоги на отдельные действия: одна строка на каждое открытие, клик или возврат письма.
Аутентификация
Renta подключается к Mailchimp по OAuth. Вы входите в свой аккаунт Mailchimp и разрешаете доступ, после чего Renta читает все аудитории и кампании этого аккаунта.
Mailchimp выдаёт доступ к аккаунту целиком, поэтому на экране согласия упомянуты и чтение, и изменение данных. Источник Mailchimp только читает данные.
Доступ Mailchimp не истекает. Подключение работает, пока вы не отзовёте доступ в своём аккаунте Mailchimp.
Подключение источника Mailchimp
- Откройте раздел Connections > Catalog в левой панели.
- Откройте категорию Email marketing и нажмите на карточку Mailchimp с подписью Source. Карточка Mailchimp с подписью Destination относится к Reverse ETL: она записывает данные в Mailchimp, а не загружает их в хранилище.
Нажмите Log in to your Mailchimp account. Mailchimp откроется в той же вкладке.
Войдите в аккаунт, данные которого хотите выгружать. Если Mailchimp запросит код подтверждения, введите его.
На экране Authorize Renta нажмите Allow. Mailchimp вернёт вас в Renta.
Renta подтверждает выданный доступ. Завершите настройку:
- Source name.
Renta подставляет название вашего аккаунта Mailchimp. Замените его на любое удобное. Название используется только в интерфейсе Renta.
Нажмите Save, чтобы завершить.
Новый источник появится в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.
Создание пайплайна Mailchimp
Создавайте пайплайн после того, как источник Mailchimp подключён.
В левой панели нажмите New pipeline. На шаге Source выберите Mailchimp в блоке Already connected и нажмите Next step.
Выберите созданное ранее подключение Mailchimp и нажмите Next step.
На шаге Destination выберите назначение, например Google BigQuery, и нажмите Next step.
Выберите подключение назначения, в которое нужно загружать данные, и нажмите Next step.
Настройка пайплайна
На последнем шаге выберите отчёт, отметьте его поля и задайте расписание.
Тип отчёта
В выпадающем списке Report Types выберите объект Mailchimp, который выгружает пайплайн. Один пайплайн загружает один тип отчёта, поэтому для каждого нужного объекта создайте отдельный пайплайн.
| Тип отчёта | Описание |
|---|---|
| Audiences (аудитории) | Аудитории вашего аккаунта Mailchimp с настройками и числом подписчиков. |
| Audience members (участники аудиторий) | Контакты всех аудиторий со статусом, merge-полями и тегами. Архивные контакты тоже выгружаются. |
| Campaigns (кампании) | Email-кампании в любом статусе с настройками и получателями. |
| Campaign reports (отчёты по кампаниям) | Результаты отправленных кампаний: открытия, клики, возвраты и отписки. |
| Email activity (активность получателей) | Открытия, клики и возвраты по каждому получателю отправленных кампаний. Одна строка описывает одно действие. |
| Unsubscribes (отписки) | Контакты, отписавшиеся после кампании, с указанной ими причиной. |
| Segments (сегменты) | Сегм енты всех аудиторий с условиями и числом контактов. |
| Tags (теги) | Теги всех аудиторий. |
Пайплайн всегда охватывает весь аккаунт. Отчёты Audience members, Segments и Tags загружают все аудитории, а параметр List ID показывает, к какой аудитории относится строка. Отчёты Email activity и Unsubscribes загружают все отправленные кампании, а Campaign ID связывает строку с её кампанией.
Mailchimp хранит теги как статические сегменты, поэтому ваши теги есть и в отчёте Segments.
Параметры
Отметьте поля Mailchimp, которые попадут в таблицу назначения. Под каждым полем подписано имя его будущей колонки.
В отчёте Audience members поля List Member ID и Last Changed отмечены и заблокированы. В отчёте Email activity то же относится к Activity ID и Timestamp. По этим полям Renta обновляет таблицу назначения.
Некоторые поля содержат больше одного значения:
- Merge-поля.
Merge Fieldsзагружается как JSON, потому что у каждой аудитории свой набор merge-полей. То же относится кInterests. - Теги.
Tagsв отчётеAudience membersзагружается списком записей с идентификатором и названием тега. - Условия сегмента.
Options Conditionsв отчётеSegmentsзагружается как JSON.
Дата, которая не задана в Mailchimp, например время отправки черновика кампании, загружается пустым значением.
Название таблицы
Задайте название пайплайна и таблицы назначения.
- Integration name.
Название пайплайна. Используется только в интерфейсе Renta. - Table name.
Название таблицы назначения. Оставьте сгенерированное название или введите своё.
Расписание
Выберите, как часто запускается пайплайн.
| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную через интерфейс или по API. |
| Daily | Пайплайн запускается раз в сутки в указанное время обновления. |
| Interval | Пайплайн запускается через заданные интервалы времени. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily укажите Update time (точное время старта каждого запуска) и нажмите Create pipeline.
Новый пайплайн появится в разделе Pipelines на вкладке ETL, где видно его запуски, прогресс и название таблицы назначения.
Стратегия синхронизации
В таблице ниже описано, как Renta синхронизирует каждый тип отчёта Mailchimp.
| Стратегия | Поддерживаемые типы отчётов | Описание |
|---|---|---|
| Инкрементальная (merge) | Audience members, Email activity | Первый запуск загружает всё. Каждый следующий запуск получает только контакты, изменённые после предыдущего запуска, или действия, записанные после него. Участники обновляются по List Member ID, а Last Changed определяет, какая версия строки новее. Действия обновляются по Activity ID, таблица партицируется по дню действия. |
| Полная перезагрузка | Audiences, Campaigns, Campaign reports, Unsubscribes, Segments, Tags | Renta читает объект целиком на каждом запуске и заменяет содержимое таблицы назначения. Таблицы партицируются по дню создания записи: день создания аудитории, кампании или сегмента, день отправки кампании или день отписки. Таблица Tags не партицируется. |
Если изменить выбранные параметры инкрементального пайплайна, следующий запуск снова загрузит всё.
Ограничения
- Весь аккаунт, без диапазона дат.
У пайплайна нет фильтра по аудитории, кампании или дате. Каждый запуск охватывает все аудитории или все отправленные кампании аккаунта. - Время запуска растёт вместе с аккаунтом.
ОтчётыEmail activityиUnsubscribesчитаются по кампаниям, аAudience membersпо аудиториям. Первый запуск для аккаунта с большим числом отправленных кампаний идёт заметно дольше следующих. - Безвозвратно удалённые контакты остаются в инкрементальной таблице.
Инкрементальный запуск добавляет и обновляет строки, но не удаляет их. У контакта, который вы архивируете в Mailchimp,Statusменяется наarchived. Контакт, удалённый безвозвратно, сохраняет последнюю загруженную строку, пока вы не запустите пайплайн с Full refresh.
Ready to get started?
Build your data pipeline today or get a personalized demo. Start free!
Need help?
Get expert support to ensure your project succeeds. We're here to help!
Feature requests?
Help shape our product! Share your ideas for new features and integrations.