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
Выполните эти шаги, чтобы добавить Customer.io как источник в Renta по App API key.
- Откройте раздел 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
Свяжите источник 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, которые станут колонками таблицы назначения.
Под каждым полем подписана его будущая колонка. На вкладке 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.