Подключение PostgreSQL

Частой является ситуация, когда контент для вставки в сообщения отделен от контактов, когда используется стороннее решение для анализа поведения клиента на сайте или в мобильном приложении. Примером могут служить персональные товарные рекомендации на основе offline-продаж или заказов по телефону.

Когда нужно редко или единоразово подготовить специфический контент, можно воспользоваться такими функциями, как подстановка данных при помощи препроцессора или использование в качестве источника данных Google-таблицы.

Если

• сегментации по полям контакта недостаточно
• необходимо наладить быстрый и бесшовный способ синхронизации контентной составляющей
• необходимо добавить дополнительные сведения о контакте, позволяющие построить точный сегмент по специфическим условиям

то подключение внешней базы данных PostgreSQL будет отличными инструментом для решения ваших задач. 

Обратите внимание, что эта интеграция доступна после оплаты тарифа Advanced.

1. Конфигурация коннектора к внешней базе данных

Чтобы предоставить доступ к внешней базе данных, необходимо настроить коннектор, для этого перейдите в настройки своего аккаунта в раздел “Коннекторы” и выберите пункт Подключить PostgreSQL.

Задайте название для коннектора и укажите данные авторизации, для того чтобы наладить доступ из вашего аккаунта в eSputnik к внешней базе данных.

1. Хост может содержать доменное имя удаленного сервера или же его IP-адрес.

2. Порт.

3. Название базы данных на удаленном сервере.

4. Логин пользователя базы данных (достаточно роли только для чтения).

5. Пароль.

На этом этапе можно проверить корректность авторизационных данных и выполнить тестовое подключение к удаленной базе данных, нажав кнопку “Проверить подключение” (6).

Если вы не используете SSL-соединение, система предупредит об этом:

При успешном подключении в правом верхнем углу раздела отобразится сервисное уведомление о том, что соединение установлено. В противном случае, если подключение не удалось, необходимо уточнить у вашего системного администратора корректность настроек или авторизационных данных.

Далее в пункте определения уникальности контакта нужно выбрать колонку таблицы, которая содержит уникальный ключ контакта (7), и сопоставить её с уникальным полем в аккаунте eSputnik (8).

На примере данного изображение показано наличие в таблице колонки с email-адресами контактов и сопоставление с аналогичным полем в системе eSputnik.

Вы можете создать любой ключ уникальности контакта, который содержится в таблице и в eSputnik —  внешнему ID, номеру телефона,  дополнительному полю и т.д.

После заполнения настроек и теста подключения сохраните  подготовленный коннектор. Созданный коннектор будет отображен в соответствующем разделе. При необходимости настройки в дальнейшем можно будет скорректировать.

2. Конфигурация источника данных на базе коннектора

Коннектор – это первичный этап настройки интеграции внешней базы данных. Так как в базе может быть несколько таблиц, нужно конкретизировать, к какой именно обращаться.

Для этого, перейдя в раздел “Источники данных” в настройках аккаунта eSputnik, подготовьте новый источник данных:

В открывшемся окне выберите необходимый коннектор, созданный на предыдущем этапе:

1. Выбирается схема базы данных.

2. Выбирается необходимая таблица с данными.

3. Задается название источника данных.

После сохранения источника данных он отобразится в соответствующем разделе:

Следующий этап – это импорт контактов в аккаунт eSputnik и наполнение данными внешнюю базу.

После этого в вашем аккаунте будет доступна возможность строить сегменты на основе значения полей во внешней базе данных при помощи построения условных групп:

Полученный сегмент можно использовать в промо- и триггерных рассылках.

3. Подстановка в сообщение данных из внешнего источника

Чтобы в письме задать использование внешних данных, к ним необходимо обратиться при помощи Velocity конструкции вида $!data.get(‘название_источника’)... – так, в этом примере мы подготовили источник под названием promo_codes.

а. Для массовой рассылки (отправка группе)

Допустим, запланирована рассылка контакту kozak@example.com, тогда из таблицы

для контакта будет получен набор данных и помещен в объект data:

{
  "data": {
    "promo_codes": [
      {
        "id": "2",
        "email": "kozak@example.com",
        "name": "Dina Kozak",
        "birthday": "2020-09-02T00:00:00Z",
        "promo_code": "AAAA-BBBB-DDDD"
      }
    ]
  }
}

К полям массива promo_codes можно обратится двумя способами:

• поэлементно

$!data.get('promo_codes').get(0).get('name')

$!data.get('promo_codes').get(0).get('promo_code')

Этот способ подходит, если вы точно знаете, количество элементов в массиве.

• при помощи цикла

#foreach($pc in $!data.get('promo_codes'))

$!pc.get('name')

$!pc.get('promo_code')

#end

Этот способ более универсальный и подойдет в большинстве ситуаций.

б.Для триггерной рассылки

Для того чтобы использовать внешний источник данных в триггерных рассылках, необходимо подготовить условную группу, например, задать условие, что сегодня у контакта день рождения:

Детальнее следует рассмотреть принцип использования условной группы в триггерных рассылках. В момент срабатывания сценария для каждого контакта, который соответствует условию группы, системой генерируется событие. Название этого события формируется из статической части regularEventType- и идентификатора группы, для которой запускается сценарий, например regularEventType-170531841.

Событие содержит данные о контакте, идентификатор контакта в eSputnik (ContactId), имейл-адрес (EmailAddress), а также данные из внешней таблицы.

Содержимое каждого поля из таблицы преобразуется в вид ключ-значение и помещается в массив с числовым названием, соответствующим порядковому номеру источника внешних  данных:

В свою очередь это массив сериализован и помещен в виде строки в поле  jsonParam. Содержимое события может иметь приблизительно такой вид:

{
  "params": [
    {
      "name": "ContactId",
      "value": "623927159"
    },
    {
      "name": "jsonParam",
      "value": "{\"1043\":[{\"id\":,\"email\":\"kozak@example.com\",\"name\":\"Dina Kozak\",\"birthday\":\"2020-09-02T00:00:00Z\",\"promo_code\":\"AAAA-BBBB-DDDD\"}]}"
    },
    {
      "name": "EmailAddress",
      "value": "kozak@example.com"
    }
  ]
}

Для обратного преобразования из сериализованной строки в набор объектов в сценарии у блока отправки в поле JSON укажите источник данных из события – ${jsonParam}:

Настроив и сохранив сценарий, остается задать условие запуска и желаемую частоту срабатывания:

Для вывода содержимого из события используется идентичный подход, как и для массовой рассылки, с небольшим отличием в наименовании массива. Так в письме будет доступен объект data, с содержимым вида

{
  "data": {
    "1043": [
      {
        "id": "2",
        "email": "kozak@example.com",
        "name": "Dina Kozak",
        "birthday": "2020-09-02T00:00:00Z",
        "promo_code": "AAAA-BBBB-DDDD"
      }
    ]
  }
}

К полям массива 1043 можно так же обратится двумя способами:

• поэлементно

$!data.get('1043').get(0).get('name')
$!data.get('1043').get(0).get('promo_code')

• или при помощи цикла

#foreach($pc in $!data.get('1043'))

$!pc.get('name')

$!pc.get('promo_code')

#end

Подключение внешней базы данных PostgreSQL позволяет решать широкий спектр маркетинговых задач: от простой подстановки промокода в триггерной рассылке для именинников или же средствами самой же системы управления баз данных строить сложные сегменты на основе большого количества данных, собранных из разрозненных источников в одном универсальном хранилище.

4. Настройка экспорта данных

Чтобы регулярно обновлять информацию об аудитории, заказах и результатах кампаний в PostgreSQL, настройте экспорт данных из eSputnik в таблицы. Например, вы можете экспортировать ответы на NPS-опрос, историю покупок, дату последнего клика в сообщении и т. д.

Доступные наборы данных для экспорта:

• broadcasts;
• contactActivities;
• contacts;
• events;
• messages;
• devices;
• orderItems;
• orders;
• revenue.

Список параметров данных для экспорта

Broadcasts

ContactActivities

* Поле будет удалено как устаревшее; используйте поле, указанное в скобках.

Contacts

Devices

Events

Messages

OrderItems

Orders

Revenue

* Поле будет удалено как устаревшее; используйте поле, указанное в скобках

Эта информация будет передана в PostgreSQL и обновит данные в таблицах.

Настройка PostgreSQL-коннектора для экспорта данных

1. Перейдите в «Настройки» → «Экспорт данных» и нажмите «Новый экспорт данных». Выберите один из созданных PostgreSQL-коннекторов.

2. Выберите интервал загрузки и установите флажки для наборов данных, которые вы хотите загрузить. Тип набора данных по умолчанию public, вы можете выбрать другой тип, если указали его в настройках PostgreSQL.
   Нажмите "Сохранить".

Соединение отобразится в разделе «Экспорт данных», здесь вы можете отредактировать его настройки.