Unisender — сервис для автоматизации маркетинга, который повышать продажи и поддерживать связь с аудиторией с помощью email-рассылок, чат-ботов и т.п

При помощи сервиса Garpun Feeds можно удобно загрузить список контактов из GBQ/ClickHouse/Google Spreadsheets в Unisender.

Первоначально необходимо зайти в систему Garpun Feeds https://feeds.garpun.com/ под своим логином и паролем и нажать кнопку "+Поток данных".

Алгоритм создания потока из системы Я.Директ в BQ:

1) Источник данных > Приемник данных

В открывшемся меню выбираем:

  • Источник данных - GBQ/ClickHouse/Google Spreadsheets,
  • Приемник данных - Unisender

2) Настройка источника данных

Настройки источника будут зависеть от того, какой именно источник был выбран в п.1. 

Если был выбран Google Spreadsheets, то необходимо указать ID таблицы(берется из ссылки на таблицу, например если ссылка – https://docs.google.com/spreadsheets/d/1bkce1c284KAXYeGMAXEgZX_dgOhZxBM5SLQP2w/edit#gid=0, то id = 1bkce1c284KAXYeGMAXEgZX_dgOhZxBM5SLQP2w)

Предоставьте доступ к документу на почту garpun@devision-storage.iam.gserviceaccount.com или установите значение 'Доступен для всех'

Если передача производится из GBQ/ClickHouse, то первоначально необходимо добавить и выбрать подключение определенной системы, далее необходимо прописать SQL-запрос.

Garpun Feeds использует метод ImportContacts https://www.unisender.com/ru/support/api/contacts/importcontacts/ для передачи контактов, это необходимо учитывать при написании запроса.

Здесь важно учитывать требуемые названия полей(field_names)

deleteЕсли поле с этим названием содержит 1, то указанные контакты списка удаляются.
tagsЧерез запятую можно указать метки, присваемые контакту. Максимально допустимое количество - 10 меток.
emailАдрес электронной почты контакта
email_statusСтатус email, один из: 'new' (новый), 'active' (активный), 'inactive'(временно отключённый), 'unsubscribed' (отписался от всех настоящих и будущих рассылок). Если статус не указан, то для новых адресов подразумевается 'new'. Для уже существующих адресов с текущим статусом, не совпадающим с 'active' или 'inactive', значение статуса поменять нельзя.
email_availabilityДоступность адреса.
email_list_idsПеречисленные через запятую коды списков, на которые будет подписан email-адрес.
email_subscribe_timesПеречисленные через запятую дата и время подписки, количество и порядок дат должен соответствовать количеству и порядку кодов списков в email_list_ids. Даты указаны в UTC, в формате "ГГГГ-ММ-ДД чч:мм:сс" или "ГГГГ-ММ-ДД".
email_unsubscribed_list_idsПеречисленные через запятую коды списков, в которые email входит, но от которых контакт отписался. Может показаться, что это поле избыточно, ведь можно просто в поле email_status указать unsubscribed. Но если у вас несколько списков, контакт может быть отписанным, например, только от одного, и тогда только этот список указывается в email_unsubscribed_list_ids, а остальные - в email_list_ids. Поле же email_status относится к адресу в целом и может быть при этом равно 'active'.
email_excluded_list_idsПеречисленные через запятую коды списков, в которые email входит, но из которых контакт будет исключен.
phone, phone_status, phone_availability, phone_list_ids, phone_subscribe_times, phone_unsubscribed_list_ids, phone_excluded_list_idsСмысл полей совпадает с аналогичными полями для email. Ещё одно отличие — по умолчанию для новых телефонов phone_status устанавливается в 'active'. Также обратите внимание, что значение поля «phone» должно передаваться в международном формате (пример: +79261232323)

Иными словами, если в вашей таблице поле с email-адресами имеет название, отличное от email, в запросе необходимо указать требуемое название, например 

SELECT 
	email_adress AS email, 
	phone_number AS phone 
FROM
	table_name



3) Настройка приемника данных

1) Выбираем подключение Unisender или, если оно не было добавлено ранее, добавляем новое. Для добавления подключения нажимаем кнопку "+ добавить", указываем удобное для Вас название подключения и вводи API-ключ. О том, как получить ключ API: https://www.unisender.com/ru/support/api/common/api-key/

2) Выбираем список контактов, в который будет произведена загрузка.

 Ds

4) Общие настройки

  • В графе “Название потока” ввести название либо оставить сгенерированное автоматически
  • В графе “Период сбора при автоматическом запуске” можно выбрать за какой период поток будет пересобирать статистику. По умолчанию - 30 дней.
  • В графе “Расписание” - выбрать например 7:00 утра, в это время поток будет запускаться ежедневно
  • Нажать "Готово"
  • No labels