Вхiд

Email

Омніканальність

In-App
Рекомендації в мобільних додатках

Автоматизація

Мультимовність

Документи

Відповідність GDPR

Інтеграція

Інтеграція з сайтом

Інтеграція з Google BigQuery

BigQuery – це хмарна база даних, яка входить до складу Google Cloud Platform. Користувачі BigQuery можуть завантажувати великі обсяги даних із високою швидкістю, зберігати їх у вигляді двовимірних таблиць, звертатися до них, використовуючи SQL-запити, і вивантажувати результати обробки даних.

Інтеграція eSputnik із BigQuery буде корисною в таких ситуаціях:

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

eSputnik підтримує два варіанти інтеграції з Google BigQuery:

Для налаштування інтеграції необхідно:

  • зареєструвати акаунт у Google Cloud Platform;
  • створити ключ проекту із правами адміністратора;
  • створити таблиці з даними у Google BigQuery;
  • налаштувати передачу даних до/із eSputnik із/до Google BigQuery.

Налаштування інтеграції eSputnik із BigQuery

Якщо ви вже маєте ключ проекту і налаштовані таблиці у BigQuery, ви можете взяти цей ключ і перейти одразу до пунктів:

Створення ключа проекту

Щоб отримати ключ проекту, необхідно:

1. Авторизуватися в акаунті Google Cloud Platform.

2. Вибрати потрібний проект① → перейти до розділу APIs & Services② → Credentials③.

Шлях для додавання ключа проекту

3. Натисніть +Create credentials① → Service account②.

Створення облікових даних сервісного акаунта4. Введіть назву акаунта. Потім натисніть Create and continue.

Назва сервісного акаунта

5. Призначте роль BigQuery Admin, натисніть Continue і потім Done.

Налаштування ролі нового сервісного акаунта

6. На головній сторінці розділу Credentials натисніть посилання Manage service accounts.

Управління сервісними акаунтами

7. Навпроти щойно створеного акаунта натисніть три крапки і виберіть опцію Manage keys.

Управління ключами8. Ви потрапили до розділу Keys. Натисніть кнопку Add key і виберіть Create new key.

Створення ключа

9. У діалоговому вікні, що відкриється, виберіть тип ключа JSON і натисніть CREATE.

Вибрати тип ключа JSON

10. Після цього браузер автоматично скачає ключ у папку для завантаження.

Збереження ключа на комп'ютері

Потім у налаштуваннях eSputnik ви завантажите цей ключ.

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

Щоб підключити BigQuery до eSputnik, перейдіть до “Налаштувань”① → “Конектори”② і натисніть “Підключити BigQuery”③.

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

 У вікні налаштувань, що відкриється, впишіть назву①, завантажте ключ проекту ② і задайте відповідність полів, що містять ключ унікальності③. Завдяки цьому ключу унікальності система eSputnik асоціюватиме поля з контактами у BigQuery. Без ключа унікальності не можна буде ані побудувати сегмент за параметрами з BigQuery, ані підставити дані до повідомлення.

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

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

Конектори

Експорт даних із системи eSputnik до таблиці BigQuery

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

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

  • contactActivities;

  • contacts;

  • orderItems;

  • orders.

Експорт даних

Після налаштування один раз на добу ця інформація передаватиметься до BigQuery, також вона оновлюватиме дані в таблицях.

Важливий момент!

Заздалегідь створювати таблиці у BigQuery не потрібно. Вони створюються автоматично під час першого експорту, і надалі інформація в них оновлюватиметься. Назви таблиць відповідатимуть наборам даних (contactActivities, contacts, orderItems, orders).

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

1. Перейдіть у “Налаштування”① → “Конектори”② і натисніть “Нове джерело”③.

Додавання нового джерела в eSputnik

2. Завантажте файл ключа і позначте галочками ті набори даних, які бажаєте вивантажувати. Потім натисніть "Зберегти".

Налаштування передавання даних

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

Експорт до BigQuery

Підключення таблиць BigQuery як джерела даних для розсилки

Цей варіант є придатним, коли треба виділити сегмент користувачів і здійснити за ним розсилку — як одноразово, так і на регулярній основі. Працює таким чином:

  • у BigQuery є таблиця, де зберігаються дані про контакти, які ви передаєте туди, наприклад із CRM;

  • ви бажаєте виділити певний сегмент клієнтів і відправити їм розсилку з персоналізованим контентом;

  • у системі eSputnik ви вибираєте, за якими полями ви хочете зробити сегментацію. Наприклад, треба налаштувати регулярну розсилку для контактів, у яких сьогодні день народження. У такому випадку під час налаштування ви вибираєте з таблиці поле "День народження";

  • ви підключаєте таблицю з потрібним контентом до eSputnik у розділу Налаштування — Джерела даних і створюєте умовну групу;

  • під час редагування ви задаєте умови відбору, так само як у звичайній умовній групі (День народження → сьогодні), тільки при цьому використовуєте набори даних із таблиць BigQuery. Вони будуть знаходитись у списку умов дещо нижче стандартних полів у такому вигляді, в якому вони названі в джерелі даних;

  • тепер ви можете підключити отриману групу до регулярного сценарію, щоб автоматизувати відправлення листа до дня народження.

Пройдемося по порядку пунктами налаштування.

Налаштування джерела зовнішніх даних

Щоб сформувати групу за даними з BigQuery, треба спочатку налаштувати джерело.

Для цього перейдіть до розділу “Налаштування” → “Джерела даних”. Потім натисніть кнопку “Нове джерело” → “Зовнішні джерела даних”.

Налаштування джерела зовнішніх даних

У діалоговому вікні, що відкриється, виберіть джерело даних BigQuery, яке ви налаштовували в розділі “Конектори”. У нашому прикладі це esputnik.

Вибір джерела зовнішніх даних

Налаштування даних:

  1. Виберіть зі списку dataset, який містить потрібну таблицю.

  2. Визначте таблицю з потрібним набором даних.

  3. Назвіть джерело будь-якою зрозумілою назвою і натисніть “Зберегти”.

Налаштування джерела даних в eSputnik

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

Список джерел

Створення умовної групи за параметрами BigQuery

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

1. Перейдіть до розділу “Контакти” → “Групи”. На сторінці списку груп виберіть “Нова група” → “Умовна”.

Створення умовної групи

2. Додайте для групи назву (обов'язково), опис і мітку (за бажання).

Задати назву групи

3. Виберіть умови для включення до групи. У параметрах умов натисніть назву джерела, потім назву таблиці та задайте умову. Наприклад, DR → date → сьогодні.

DR – це dataset, date – таблиця з датами народження клієнтів, сьогодні – умова входження контакту до групи за цим параметром.

Умови для включення до групи

Наразі до групи входитимуть лише ті контакти, які вже наявні в базі eSputnik.

Наприклад, якщо у зовнішньому джерелі знаходяться 10 000 контактів, а до бази eSputnik із цих контактів додано тільки 1 000, то система задіює лише цю тисячу контактів. Щоб оперувати всіма 10 000 контактів, їх необхідно спочатку додати до бази eSputnik шляхом ручного імпорту або методом API v1/contacts-POST. Пізніше ми додамо можливість використовувати всі контакти із зовнішнього джерела, а також автоматично зберігати їх до бази eSputnik і оновлювати дані вже наявних контактів.

Залишилися питання?
Спеціалісти обов'язково нададуть відповідь та допоможуть вирішити вашу проблему!
Зворотний дзвінок
Залишіть заявку – і наш спеціаліст зв'яжеться з вами в робочий час.
Відправити заявку
Консультація в чаті
Готові до ваших запитань!
Написати в чат
Електронна пошта
Напишіть в службу підтримки eSputnik.
Надіслати email