Підключення PostgreSQL

Підключення до PostgreSQL допоможе вирішити такі завдання:

• імпорт даних у додаткові поля для сегментації;
• налаштування безшовної синхронізації контенту;
• експорт даних щодо результатів розсилки, поведінки у віджетах або контактної інформації з eSputnik.

📘

Важливо

Інтеграція з PostgreSQL входить у платні тарифи

Крок 1. Налаштування конектора

1. Перейдіть на вкладку “Конектори” в налаштуваннях вашого акаунту і виберіть “Підключити PostgreSQL”.

2. Заповніть такі поля:

• Назва.
• Хост (може містити доменне ім'я віддаленого сервера або його IP-адресу).
• Порт (за замовчуванням вводиться автоматично).
• База даних (її назва на віддаленому сервері).
• Ім'я користувача (логін користувача бази даних; достатньо ролі лише для читання).
• Пароль.

Натисніть кнопку “Перевірити підключення”, щоб перевірити коректність авторизаційних даних та виконати тестове підключення до віддаленої бази даних.

📘

Примітка

При підключенні до PostgreSQL рекомендується використовувати захищене SSL з'єднання для безпечної передачі даних.

Якщо ви не використовуєте SSL з'єднання, система попередить про це:

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

3. Для визначення унікальності контакту вкажіть колонку таблиці, що містить унікальний ключ контакту, та унікальне поле контакту в eSputnik. Вони повинні співпадати.

Так, якщо ви вибрали email, після підключення стовпець таблиці PostgreSQL з електронними адресами буде зіставлено з відповідним полем у eSputnik.

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

📘

Важливо

Ви можете використовувати створений конектор для підключення до кількох джерел даних, які мають мати однаковий унікальний контактний ключ. Для роботи з іншими ключами створіть додаткові конектори з відповідним ID контакта.

4. Натисніть кнопку “Зберегти”.

Крок 2. Налаштування джерела даних

Ваша зовнішня база даних може містити кілька таблиць, і вам потрібно вибрати, до якої з них ви хочете підключитися.

1. Перейдіть у налаштування вашого профілю > вкладка “Джерела даних”, натисніть кнопку “Нове джерело” і оберіть “Зовнішні джерела даних”.

2. Виберіть створений конектор.

3. Виберіть dataset, таблицю і введіть назву джерела. Натисніть кнопку “Зберегти”.

Імпортуйте контакти в eSputnik i наповніть даними зовнішню базу. Після цього у вашому обліковому записі буде доступна можливість будувати сегменти на основі значення полів у зовнішній базі даних за допомогою побудови умовних груп.

📘

Важливо

Для сегментації доступні лише ті контакти, які є у вашому обліковому записі eSputnik та у зовнішній базі даних. Імпорт контактів із зовнішньої бази до вашого облікового запису не відбувається. Тому важливо оперативно синхронізувати та актуалізувати контакти перед здійсненням розсилок.

Крок 3. Підстановка повідомлення даних із зовнішнього джерела

Щоб використовувати зовнішні дані у повідомленні, до них необхідно звернутися за допомогою velocity-конструкції $!data.get('назва_джерела')... – так, у цьому прикладі ми підготували джерело під назвою promo_codes.

Масова розсилка на групу

Наприклад, ви плануєте кампанію на адресу [email protected].

Набір даних буде витягнуто з таблиці та вставлено в об’єкт:

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

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

• За допомогою елементів (цей спосіб підходить, якщо ви точно знаєте кількість елементів у масиві).

  JSON

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

• За допомогою циклу (найпоширеніший спосіб).

  JSON

  #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\":\"[email protected]\",\"name\":\"Dina Kozak\",\"birthday\":\"2020-09-02T00:00:00Z\",\"promo_code\":\"AAAA-BBBB-DDDD\"}]}"
    },
    {
      "name": "EmailAddress",
      "value": "[email protected]"
    }
  ]
}

Щоб десеріалізувати рядок у набір об’єктів, перейдіть до налаштувань  блоку Email → поле JSON та вкажіть джерело даних із події — ${jsonParam}.

Налаштувавши сценарій, налаштуйте запуск:

Для отримання даних із події використовується той самий підхід, що й для масової кампанії, з невеликою різницею в назві масиву. В листі буде такий об’єкт:

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

На поля масиву 1043 можна посилатися двома способами:

• За параметрами (якщо відома кількість параметрів у масиві).

  JSON

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

• За допомогою циклу (найпоширеніший спосіб).

  JSON

  - # foreach($pc in $!data.get('1043'))
  
    $!pc.get('name')
  
    $!pc.get('promo_code')
  
    # end
  

  
  

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

Крок 4. Налаштування експорту даних

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

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

• workflowInstanceId – ідентифікатор окремого запуску сценарію; використовуйте його для угрупування розсилок у рамках запуску одного сценарію;
• broadcasts;
• contactActivities;
• contacts;
• devices;
• events;
• messages;
• orderItems;
• orders;
• revenue.

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

Broadcasts

ContactActivities

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

Contacts

Devices

Events

Messages

OrderItems

Orders

Revenue

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

📘

Примітка

Існуючі записи в таблиці Revenue (для замовлень, зроблених після 08.03.2024) можна оновлювати разом з вивантаженням нових замовлень. Оновлення може знадобитися, наприклад, якщо змінилася загальна вартість замовлення.

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

📘

Важливо

Вам не потрібно попередньо створювати таблиці PostgreSQL. Вони будуть створені автоматично під час першого експорту, і з цього часу всі вхідні дані оновлюватимуться. Всі назви таблиць відповідатимуть наборам даних (contact activities, contacts, order items, orders, revenue)

Налаштування конектора PostgreSQL для експорту даних

1. Перейдіть у налаштування → “Експорт даних” та натисніть “Новий експорт даних”. Виберіть один із створених конекторів PostgreSQL.

2. Виберіть інтервал завантаження та встановіть прапорці для наборів даних, які потрібно завантажити. Тип набору даних за замовчуванням public, ви можете вибрати інший тип, якщо вказали його в налаштуваннях PostgreSQL.

3. Натисніть “Зберегти”.

Підключення буде відображено в розділі “Експорт даних”, тут ви можете змінити його налаштування.