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

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

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

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

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

• Експорт даних із системи eSputnik до таблиці BigQuery;
• Підключення таблиць BigQuery як зовнішнього джерела даних для підстановки до повідомлень і сегментації.

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

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

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

Якщо ви вже маєте ключ проекту і налаштовані таблиці у 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.

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

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

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

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

Створіть конектор:

1. Введіть назву.
2. Завантажте файл ключа.
3. Клікніть “Перевірити підключення”, щоб впевнитися у коректності даних авторизації. Якщо підключення не відбудеться, перевірте введені дані та за потреби зверніться до вашого системного адміністратора.
4. Задайте відповідність полів, що містять ключ унікальності. Завдяки цьому ключу унікальності система eSputnik асоціюватиме поля з контактами у BigQuery. Без ключа унікальності не можна буде ані побудувати сегмент за параметрами з BigQuery, ані підставити дані до повідомлення.
5. Натисніть “Зберегти”.

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

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

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

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

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

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

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

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

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

Broadcasts

ContactActivities

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

Contacts

Devices

Messages

OrderItems

Orders

Revenue

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. Виберіть зі списку dataset, який містить потрібну таблицю.
2. Визначте таблицю з потрібним набором даних.
3. Назвіть джерело будь-якою зрозумілою назвою.
4. Натисніть “Зберегти”.

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

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

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

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

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

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

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

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

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