Customer.io
Renta выгружает в ваше хранилище данных три объекта Customer.io: людей воркспейса, кампании и рассылки.
Строка человека содержит атрибуты его профиля, включая кастомные. Кампании и рассылки приходят строками метаданных: название, тип, теги, связанные сегменты и время создания, обновления, запуска или отправки.
Аутентификация
Renta подключается к Customer.io по App API key. Пара Site ID и API key, которой отправляют события через Track API, для этого не подходит.
Чтобы создать ключ, откройте в Customer.io Settings > Account Settings > API Credentials, перейдите на вкладку App API Keys и нажмите Create App API Key. Выберите воркспейс, из которого ключ будет читать данные. Customer.io показывает ключ только один раз, сразу после создания. Скопируйте его, пока окно открыто.
App API key принадлежит одному воркспейсу. Чтобы загрузить несколько воркспейсов, создайте ключ в каждом из них и добавьте по отдельному источнику.
Подключение источника Customer.io
- Откройте раздел Connections > Catalog в левой панели.
- Откройте категорию Email marketing и нажмите на карточку Customer.io.
- Source name Название источника данных. Оно используется только в интерфейсе Renta.
- API key App API key вашего воркспейса Customer.io.
- Workspace region Регион, в котором аккаунт Customer.io хранит данные, US или EU. Администраторы аккаунта видят его в Customer.io в разделе Settings > Account Settings > Data and Privacy.
- Нажмите Save.
Перед сохранением Renta проверяет ключ в Customer.io, поэтому ключ с опечаткой или неверный регио н не пройдут этот шаг.
Новый источник появляется в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.
Создание пайплайна Customer.io
Когда источник Customer.io подключён, свяжите его с назначением и настройте пайплайн.
В левой панели нажмите New pipeline. На шаге Source выберите Customer.io в разделе Already connected и нажмите Next step.
Выберите созданное ранее подключение Customer.io и нажмите Next step. На карточке виден регион воркспейса этого подключения.
На шаге Destination выберите ваше назначение (например, Google BigQuery) и нажмите Next step.
Выберите подключение назначения, куда нужно загрузить данные, и нажмите Next step. На карточке видно датасет и проект, в которые попадут данные.
Настройка пайплайна
На последнем шаге выберите отчёт, его поля и расписание.
Тип отчёта
Выберите, какой объект Customer.io выгружает пайплайн. Один пайплайн загружает один тип отчёта.
| Тип отчёта | Описание |
|---|---|
| Campaigns metadata report (кампании) | Список кампаний воркспейса: название, тип, состояние и признак активности, теги, сегменты, запускающие кампанию, действия, которые она выполняет, а также время создания, обновления и первого запуска. |
| Newsletters metadata report (рассылки) | Список рассылок: название, тип, теги, сегменты получателей, тема подписки, идентификаторы контента, а также время создания, обновления и отправки. |
| Customers report (люди) | Каждый человек воркспейса с атрибутами его профиля: идентификаторы, почта и кастомные атрибуты, которые вы отправляете в Customer.io. |
Customers report работает через механизм экспорта Customer.io. Renta заказывает экспорт людей, когда вы открываете список параметров, и затем на каждом запуске. Поэтому в вашем воркспейсе появляются записи об экспортах, а список параметров большого воркспейса открывается с задержкой.
Параметры
Отметьте поля Customer.io, которые станут колонками таблицы назначения.
| Название | Имя в API | Описание |
|---|---|---|
Deduplicate ID text | deduplicate_id | Deduplication identifier of the segment. |
Campaign ID int | campaign_id | Deduplication Campaign ID. |
Name text | name | Name of the segment. |
Type text | type | Type of the segment. |
Created Timestamp int | created | Creation timestamp of the segment. |
Updated Timestamp int | updated | Last updated timestamp of the segment. |
Created Datetime datetime | created_datetime | Creation timestamp of the segment. |
Updated Datetime datetime | updated_datetime | Last updated timestamp of the segment. |
Created Date date | created_date | Creation timestamp of the segment. |
Updated Date date | updated_date | Last updated timestamp of the segment. |
Active bool | active | Indicates whether the segment is active. |
State text | state | Current state of the segment. |
Actions [Object] structure | actions | Array of actions with additional information. |
First Started Timestamp int | first_started | Timestamp when the segment was first started. |
First Started Datetime datetime | first_started_datetime | Timestamp when the segment was first started. |
First Started Date date | first_started_date | Timestamp when the segment was first started. |
Tags array_string | tags | Tags associated with the segment. |
Trigger Segment IDs array_int | trigger_segment_ids | IDs of segments that trigger this segment. |
| Название | Имя в API | Описание |
|---|---|---|
Deduplicate ID text | deduplicate_id | Deduplication identifier of the newsletter. |
Newsletter ID int | id | Unique identifier of the newsletter campaign. |
Name text | name | Name of the newsletter campaign. |
Type text | type | Type of the newsletter campaign. |
Created Timestamp int | created | Creation timestamp of the newsletter campaign. |
Updated Timestamp int | updated | Last updated timestamp of the newsletter campaign. |
Sent Timestamp int | sent_at | Timestamp when the newsletter was sent. Null if not sent yet. |
Content IDs array_int | content_ids | List of content IDs associated with the newsletter. |
Tags array_string | tags | Tags associated with the segment. |
Recipient Segment IDs array_int | recipient_segment_ids | List of recipient segment IDs for the newsletter. |
Subscription Topic ID int | subscription_topic_id | ID of the subscription topic linked to the newsletter. |
Created Datetime datetime | created_datetime | Creation timestamp of the segment. |
Updated Datetime datetime | updated_datetime | Last updated timestamp of the segment. |
Created Date date | created_date | Creation timestamp of the segment. |
Updated Date date | updated_date | Last updated timestamp of the segment. |
Под каждым полем подписана его будущая колонка. На вкладке Selected собрано всё отмеченное, кнопка Unselect All сбрасывает выбор.
В Campaigns metadata report и Newsletters metadata report отметки времени доступны в трёх вариантах: unix-секунды (Created Timestamp), дата со временем (Created Datetime) и дата (Created Date). Выбирайте вариант, который нужен вашим запросам. Параметр кампаний Actions [Object] загружается вложенным списком с идентификатором и типом каждого действия.
В Customers report список собран из атрибутов людей вашего воркспейса, включая кастомные. Все колонки этого отчёта приходят текстом.
Название таблицы и расписание
Задайте название пайплайна и выберите, как часто он запускается.
- Integration name Название пайплайна. Оно используется только в интерфейсе Renta.
- Table name Название таблицы назначения. Можно оставить сгенерированное название или ввести своё.
- Schedule Тип расписания пайплайна.
| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную через интерфейс или по API. |
| Daily | Пайплайн запускается раз в день в указанное время обновления. |
| Interval | Пайплайн запускается через указанные интервалы времени. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily укажите Update time (точное время запуска), затем нажмите Create pipeline.
Новый пайплайн появляется в разделе Pipelines на вкладке ETL, где видно его запуски, прогресс и название таблицы назначения.
Стратегия синхронизации
Все типы отчётов Customer.io Renta синхронизирует одинаково.
| Стратегия | Поддерживаемые типы отчётов | Описание |
|---|---|---|
| Полная перезагрузка | Campaigns metadata report, Newsletters metadata report, Customers report | Renta на каждом запуске читает объект целиком и заменяет содержимое таблицы назначения. Таблица повторяет состояние воркспейса на момент запуска, а запись, которую Customer.io перестал отдавать, уходит из таблицы на следующем запуске. |
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.