SendGrid

Renta отправляет строки из вашего хранилища данных в SendGrid как контакты Marketing.

Строка контакта содержит адрес электронной почты, по которому SendGrid опознаёт человека. Рядом ложатся встроенные поля контакта, такие как имя, город и телефон, и любые кастомные поля, заведённые в вашем аккаунте SendGrid.

Аутентификация

Renta авторизуется по API-ключу SendGrid. Ключу нужны права Full Access или полный доступ к разделу Marketing, если ключ ограниченный: синхронизация читает описания полей контакта, а затем записывает и удаляет контакты.

Чтобы выпустить ключ, откройте SendGrid и перейдите в Settings > API Keys > Create API Key. SendGrid показывает ключ один раз, поэтому скопируйте его до закрытия окна.

Создание пайплайна

Когда назначение подключено, создайте пайплайн, который будет отправлять модель данных в SendGrid.

Настройка пайплайна

На последнем шаге выберите, что Renta запишет в SendGrid и какие колонки это заполнят.

Что отправляет Renta

Выберите объект SendGrid и модель данных за ним.

1. What would you like Renta to send to SendGrid.
   Сейчас доступен единственный объект Contacts. Каждая строка становится контактом в пуле контактов SendGrid Marketing.
2. Data model.
   Выберите модель данных для синхронизации. Из неё берутся колонки для сопоставления и маппинга ниже.

Сопоставление записей

Укажите, по какому значению строка хранилища и контакт SendGrid считаются одним и тем же человеком.

Левый список предлагает уникальный ключ модели данных, правый: поле SendGrid с тем же значением. Обычно с обеих сторон стоит адрес электронной почты, потому что именно по нему SendGrid опознаёт контакт.

Renta отправляет сопоставленное значение с каждой строкой, поэтому повторять его в блоке маппинга ниже не нужно.

Маппинг полей

Свяжите колонки модели данных с полями контакта SendGrid.

1. Строки маппинга.
   Выберите колонку хранилища слева и поле SendGrid, которое она заполняет, справа.
2. Add mapping.
   Добавьте строку для каждого следующего поля, которое хотите заполнить.

В правом выпадающем списке два вида полей SendGrid.

Поля, которые SendGrid ведёт сам, такие как created_at, updated_at и даты активности, в списке не предлагаются: в SendGrid они доступны только для чтения.

Следите за соответствием типов. Поле Number принимает числовую колонку, поле Date: колонку с датой или временной меткой. Значение, которое не подходит под объявленный тип, SendGrid отклонит вместе со всем пакетом.

Пустые значения

Решите, что пустая ячейка хранилища сделает со значением, которое уже лежит в SendGrid. Настройка живёт под иконкой шестерёнки в строке маппинга и действует только на эту строку.

Поведение синхронизации

Задайте, что произойдёт с контактом, чья строка пропала из модели данных.

Дальше задайте имя пайплайна.

Поле Integration name задаёт имя пайплайна в интерфейсе Renta. Измените его так, как вам удобно.

Расписание

Выберите, как часто запускается пайплайн.

Для расписания Daily укажите Update time (точное время старта каждого запуска) и нажмите Create pipeline.

Новый пайплайн появится в разделе Pipelines на вкладке Reverse ETL, где видно его запуски и прогресс.

Стратегия синхронизации

Renta синхронизирует данные инкрементально. Каждый запуск сравнивает модель данных с состоянием, записанным на прошлом запуске, и отправляет только изменившиеся строки. Поэтому первый запуск отдаёт модель целиком, а следующие получаются заметно меньше.

Повторная отправка безопасна. SendGrid опознаёт контакт по email, поэтому повторно отправленная строка обновит тот же контакт, а не создаст второй.

Журнал запуска

Чтобы посмотреть, что отправил запуск, откройте пайплайн и нажмите на запуск в таблице Runs. Блок Delivery breakdown показывает, сколько контактов запуск добавил, обновил и удалил, а Run actions перечисляет пройденные шаги.

Ссылка Inspect every record and its API calls открывает построчный журнал: в нём видно, какой запрос Renta отправила по конкретному контакту и что ответил SendGrid.

Ограничения

1. Запись контактов асинхронная.
   SendGrid принимает пакет контактов и обрабатывает его фоновой задачей импорта. Renta дожидается завершения этой задачи и только потом помечает запуск завершённым, поэтому даже маленькая модель занимает минуты, а не секунды. Задача, которая не завершилась за 10 минут, приводит к ошибке запуска.
2. Пакет отклоняется целиком.
   SendGrid проверяет пакет контактов целиком, поэтому одно неподходящее значение, например ломаный email или число в поле даты, отклоняет и все остальные контакты этого пакета. Отклонённые строки видны в построчном журнале вместе с причиной от SendGrid.
3. Запуск останавливается при массовых отказах.
   Renta прекращает запуск, если отклонено больше 30% пакета или больше 10% строк, отправленных с начала запуска. Уже записанные контакты остаются в SendGrid, а следующий запуск продолжит с места остановки.
4. Кастомные поля нужно создать заранее.
   Renta пишет только в те поля, которые уже заведены в вашем аккаунте SendGrid, и никогда не создаёт новые. Поле, добавленное в SendGrid, появится в списке маппинга при следующем открытии настроек пайплайна.