SendGrid
Renta выгружает в ваше хранилище данных три объекта SendGrid: контакты, списки контактов и сегменты.
Строка контакта содержит зарезервированные поля профиля и все кастомные поля, заведённые в вашем аккаунте SendGrid. Списки и сегменты приходят строками метаданных: идентификатор, название и число контактов внутри.
Аутентификация
Renta подключается к SendGrid по API-ключу с доступом на чтение к разделу Marketing. С таким ключом Renta читает списки и сегменты аккаунта и запускает экспорт контактов.
Создайте ключ в SendGrid в разделе Settings > API Keys > Create API Key. Выберите Restricted Access и выдайте разделу Marketing доступ на чтение либо используйте ключ с Full Access. SendGrid показывает ключ один раз, сразу после создания. Скопируйте его, пока страница открыта.
Подключение источника SendGrid
- Откройте раздел Connections > Catalog в левой панели.
- Откройте категорию Email marketing и нажмите на карточку SendGrid с подписью Source. Карточка SendGrid с подписью Destination относится к Reverse ETL: она записывает данные обратно в SendGrid, а не загружает их в хранилище.
- Source name.
Название источника данных. Оно используется только в интерфейсе Renta. - API key.
API-ключ SendGrid с доступом на чтение к разделу Marketing.
Заполните оба поля и нажмите Save. Перед созданием подключения Renta проверит ключ на стороне SendGrid.
Новый источник появится в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.
Создание пайплайна SendGrid
Создайте этот пайплайн, когда источник SendGrid уже подключён.
В левой панели нажмите New pipeline. На шаге Source выберите SendGrid в блоке Already connected и нажмите Next step.
Выберите созданное ранее подключение SendGrid и нажмите Next step. Если в аккаунте несколько API-ключей, выбрать нужное подключение помогает дата создания на карточке.
На шаге Destination выберите назначение (например, Google BigQuery) и нажмите Next step.
Выберите подключение, в которое будут загружаться данные, и нажмите Next step. На карточке показаны датасет и проект, куда попадут данные.
Настройка пайплайна
На последнем шаге выберите отчёт, его поля и расписание.
Тип отчёта
В выпадающем списке Report type выберите, какой объект SendGrid выгружает пайплайн. Один пайплайн загружает один тип отчёта, поэтому под каждый нужный объект создайте отдельный пайплайн.
| Тип отчёта | Описание |
|---|---|
| Contacts | Контакты выбранного списка с зарезервированными полями профиля и кастомными полями вашего аккаунта. |
| Lists metadata | Списки контактов аккаунта: идентификатор, название и число контактов в списке. |
| Segments metadata | Сегменты аккаунта: идентификатор, название, родительский список, число контактов, версия запроса, даты создания и обновления сегмента, а также время последнего и следующего обновления выборки. |
Список контактов
Отчёт Contacts загружает по одному списку за раз. В выпадающем списке Contact list выберите All lists или конкретный список аккаунта.
Renta заказывает у SendGrid отдельный экспорт контактов на каждый список. Поэтому контакт из нескольких списков приходит несколькими строками, по од ной на список, и различить их помогает параметр List ID. А контакт, который не состоит ни в одном списке, в таблицу не попадёт вообще.
С вариантом All lists запуск проходит по всем спискам аккаунта по очереди, поэтому чем больше списков, тем дольше идёт запуск.
Отфильтровать контакты по сегменту здесь нельзя. Отчёт Segments metadata загружает описания сегментов, а не контакты внутри них.
Параметры
Отметьте поля SendGrid, которые попадут в таблицу назначения.
| Название | Имя в API | Описание |
|---|---|---|
List ID text | id | List ID. |
List name text | name | Name of list. |
Contact count int | contact_count | The number of contacts in the list. |
| Название | Имя в API | Описание |
|---|---|---|
Segment ID text | id | Unique identifier of the segment. |
Segment name text | name | Name of the segment. |
Query version text | query_version | Version of the segment query syntax. |
Contact count int | contacts_count | The number of contacts in the segment. |
Sample updated at datetime | sample_updated_at | Timestamp of the last segment sample update. |
Next sample update datetime | next_sample_update | Timestamp when the next sample update is scheduled. |
Created at datetime | created_at | Timestamp when the segment was created. |
Updated at datetime | updated_at | Timestamp when the segment was last updated. |
Parent list ID text | parent_list_id | ID of the parent contact list associated with this segment. |
Под каждым полем подписано название будущей колонки. Кнопка Select All отмечает все поля сразу, а в блоке Selected Parameters под панелью можно убрать лишнее.
Для отчёта Contacts Renta читает описания полей из вашего аккаунта в момент открытия панели. Поэтому в наборе оказываются зарезервированные и кастомные поля SendGrid, а также List ID того списка, из которого пришла строка. Колонки сохраняют тип, который SendGrid присвоил полю, а alternate_emails загружается списком значений внутри одной колонки.
У отчётов Lists metadata и Segments metadata фиксированный набор полей, который не зависит от аккаунта.
Название таблицы
Задайте названия пайплайна и таблицы назначения.
- Integration name.
Название пайплайна. Оно используется только в интерфейсе Renta. - Table name.
Название таблицы назначения. Можно оставить сгенерированное или ввести своё.
Расписание
Выберите, как часто запускается пайплайн.
| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную через интерфейс или по API. |
| Daily | Пайплайн запускается раз в сутки в указанное время обновления. |
| Interval | Пайплайн запускается через заданные интервалы времени. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily укажите Update time (точное время старта каждого запуска) и нажмите Create pipeline.
Новый пайплайн появится в разделе Pipelines на вкладке ETL, где видно его запуски, прогресс и название таблицы назначения.
Стратегия синхронизации
Все типы отчётов SendGrid Renta синхронизирует одинаково.
| Стратегия | Поддерживаемые типы отчётов | Описание |
|---|---|---|
| Полная перезагрузка | Contacts, Lists metadata, Segments metadata | На каждом запуске Renta читает объект целиком и заменяет содержимое таблицы назначения. Таблица повторяет состояние SendGrid на момент запуска: то, что вы удалили в SendGrid или убрали из списка, пропадает из таблицы на следующем запуске. |
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.