🌐EN🛠️ Developer Guide
User Guide

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

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

  1. Зареєструвати акаунт у Google Cloud Platform.
  2. Отримати ключ проєкту.
  3. Створити таблиці в Google BigQuery для імпорту даних в eSputnik; таблиці з даними з eSputnik будуть створені автоматично після першого експорту.
❗️

Важливо

При створенні таблиць у Google BigQuery для назв полів використовуйте стилі snake_case або camelCase. Це допоможе уникати пробілів у назвах і спростить інтеграцію з eSputnik.

Приклади правильних назв:

  • first_name
  • loyalty_card_number
  • orderDate
  1. Створити конектор eSputnik.

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

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

  1. Авторизуйтеся в акаунті Google Cloud Platform.
  2. Виберіть потрібний проект → перейдіть до розділу APIs & Services → Credentials.
Перехід до розділу APIs & Services → Credentials у Google Cloud Platform
  1. Натисніть +Create credentials → Service account.
Вибір Service account у меню Create credentials
  1. Введіть назву акаунта. Потім натисніть Create and continue.
Поле назви сервісного акаунта Google Cloud
  1. Призначте роль BigQuery Job User на рівні проєкту, натисніть Continue і потім Done.
Призначення ролі сервісному акаунту BigQuery
📘

Зверніть увагу

Роль BigQuery Admin на весь проєкт не потрібна — конектор працює за принципом найменших привілеїв:

  1. На рівні проєкту сервісному акаунту достатньо ролі BigQuery Job User — вона дозволяє виконувати завдання BigQuery.
  2. Створіть окремий датасет, який використовуватиметься для інтеграції.
  3. Призначте сервісному акаунту роль BigQuery Data Owner лише на цей датасет — конектор створюватиме й оновлюватиме таблиці всередині нього.
  1. На головній сторінці розділу Credentials натисніть посилання Manage service accounts.
Посилання Manage service accounts у розділі Credentials
  1. Навпроти щойно створеного акаунта натисніть три крапки і виберіть опцію Manage keys.
Вибір опції Manage keys для сервісного акаунта
  1. Ви потрапили до розділу Keys. Натисніть кнопку Add key і виберіть Create new key.
Створення нового ключа в розділі Keys
  1. У діалоговому вікні, що відкриється, виберіть тип ключа JSON і натисніть CREATE.
Вибір типу ключа JSON у діалоговому вікні створення

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

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

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

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

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

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

Тепер ви можете використовувати конектор для експорту даних eSputnik і для імпорту даних з BigQuery.

📘

Зверніть увагу

  • Цільовий датасет BigQuery має існувати ще до підключення — eSputnik автоматично створює окремі таблиці всередині цього датасету, але не створює сам датасет.
  • Перший експорт містить історію, яку акаунт уже зберігає, тому окремо замовляти вивантаження давніших даних не потрібно. Обмежує його те, що акаунт зібрав: активність контактів доступна на глибину до 90 днів і не раніше дня, коли ввімкнено збір активності, а решта наборів даних охоплює весь час існування акаунта. Активність за період до ввімкнення збору відновити неможливо, зокрема й через API-ресурс Get contacts activity.

Updated 3 days ago

Did this page help you?