Експорт даних у таблиці BigQuery

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

  • broadcasts
  • contactActivities
  • contacts
  • devices
  • events
  • messages
  • orderItems
  • orders
  • revenue
📘

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

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

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

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

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

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

Broadcasts

Параметр

Тип даних

Опис

createdDate

timestamp

Дата та час створення повідомлення (формат: '2021-10-08 11:11:02')

groupId

int

ID груп, що брали участь у розсилці

id

int

ID розсилки

mediaType

varchar (50)

Медіатип (SMS, Email, Web Push, Viber, Mobile Push, AppInbox, Widget)

messageId

int

ID повідомлення

name

varchar (1000)

Назва розсилки

startedDate

timestamp

Дата та час відправки розсилки (формат: '2021-10-08 11:11:02')

status

varchar (50)

Статуси розсилки:

  • IDLE – завершена;
  • RUNNING - почалася;
  • PAUSED - призупинена (якщо розсилка не була зупинена вами вручну, зверніться до служби підтримки для уточнення деталей);
  • SCHEDULED – запланована;
  • UNCONFIRMED – у черзі на модерацію;
  • CONSIDERATION – на модерації;
  • BLOCKED – заблокована модератором.

updatedDate

timestamp

Дата та час оновлення розсилки (формат: '2021-10-08 11:11:02')

ContactActivities

Параметр

Тип даних

Опис

activity
(activityStatus) *

string

Статус активності:

  • DELIVERED – повідомлення доставлено.
  • UNDELIVERED – повідомлення не доставлено (містить причину statusDescription).
  • RECEIVED –повідомлення відкрито.
  • UNSUBSCRIBED – контакт відмовився від розсилки.
  • CLICKED – контакт клікнув посилання у повідомленні.
  • SPAM – контакт повідомив про спам.
  • SUBSCRIPTION_CHANGED – контакт змінив категорію підписки.
  • PUSH_SUBSCRIBED —контакт підписався на push-сповіщення.

workflowInstanceId

string

Ідентифікатор окремого запуску сценарію. Використовуйте його для угрупування розсилок у рамках запуску одного сценарію.

broadcastId

int

ID розсилки

campaignType

string

Тип розсилки: 

  • IM — тригерне повідомлення, 
  • Group — масова розсилка.

clickEventLink

string

Містить посилання, яке клікнув контакт (статус CLICKED)

contactId

int

ID контакту в eSputnik (Внутрішній)

errorCode (statusDescription)*

string

Помилка доставки SMTP та опис

eventKey

string

Ключ події

eventTypeKey

string

Ключ типу події

eventId

string

Ідентифікатор події, яка запустила сценарій

externalCustomerId

string

ID контакту у вашій системі (Зовнішній)

iid

string

Ім'я відправника для Email та SMS

mediaType

string

Медіатип (SMS, Email, Web Push, Viber, Mobile Push, AppInbox, Widget, In-App, Telegram)

messageInstanceId

int

Службове поле

messageLanguageCode

string

Код мови повідомлення

messageName

string

Назва повідомлення в обліковому записі eSputnik

messageId

int

ID повідомлення

messageTags

string

Мітки повідомлення

messageURL

string

Містить посилання на веб-версію email

osName

string

Операційна система пристрою

osType

string

Тип пристрою

senderName

string

Ім'я відправника у Viber

started
(activityDateTime)*

timestamp

Дата та час відправки повідомлення (формат: '2021-10-08 11:11:02')

utmCampaign

string

UTM-мітка розсилки

workflowId

string

ID сценарію

workflowBlockId

string

ID блока сценарію

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

Contacts

Параметр

Тип даних

Опис

contactId

bigint

ID контакту в eSputnik (Внутрішній)

contactSource

varchar (50)

Джерело контакту:

  • SITE_AUTOMATED - прив'язка email до push-підписника (скрипт збору web push),
  • I_MESSAGE -відправка одного повідомлення,
  • CAMPAIGN - сценарій (блок Створити контакт або блок Додати до групи),
  • IMPORT - імпорт файла або метод Add contacts,
  • MANUAL - створен вручну,
  • SUBSCRIPTION - форма підписки (API метод Subscribe a contact),
  • API метод Add contact,
  • ORDER - замовлення на сайті (API метод Add orders).

createdDate

timestamp

Дата та час створення контакту (формат: '2021-10-08 11:11:02')

email

varchar (50)

Email контакту

emailDomain

varchar (100)

Домен email

emailStatus

varchar (50)

Статус email

externalCustomerId

varchar (100)

ID контакту у вашій системі (Зовнішній)

firstName

varchar (50)

Ім'я контакту

languageCode

varchar (20)

Код мови повідомлень

lastClickedDate

timestamp

Дата та час останнього кліку (формат: '2021-10-08 11:11:02')

lastName

varchar (50)

Прізвище контакту

lastReceivedDate

timestamp

Дата та час останньої доставки (формат: '2021-10-08 11:11:02')

lastSentDate

timestamp

Дата та час останньої відправки (формат: '2021-10-08 11:11:02')

lastViewedDate

timestamp

Дата та час останнього відкриття (формат: '2021-10-08 11:11:02')

sms

varchar (50)

Номер телефону

totalClicked

int

Загальна кількість кліків

totalReceived

int

Загальна кількість отриманих повідомлень

totalSent

int

Загальна кількість надісланих повідомлень

totalViewed

int

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

Devices

Параметр
Тип даних
Опис

appVersion

varchar (50)

Версія додатку

applicationId

int

ID додатку

category

varchar (50)

Категорія

contactId

bigint

ID контакту

deviceId

varchar (250)

ID пристрою

deviceModel

varchar (100)

Модель пристрою

externalCustomerId

varchar (100)

Зовнішній ID контакту

languageCode

varchar (20)

Код мови

osType

varchar (50)

Тип ОС

osVersion

varchar (50)

Версія ОС

pushToken

varchar (max)

Пуш-токен

timeZone

varchar (100)

Часовий пояс

Events

Параметр
Тип даних
Опис

contactId

int

ID контакту

eventId

int

ID події

eventTypeKey

string

Тип події

keyValue

string

Ключ події

occured

timestamp

Дата і час виникнення (формат: '2021-10-08 11:11:02')

paramsJson

json

50 перших параметрів та значень події (name/value); передається до 300 символів значень.

Messages

Параметр
Тип даних
Опис

annoyanceLevel

int

Рівень занепокоєння повідомлення

language

varchar (50)

Мова основної версії повідомлення

mediaType

varchar (50)

Медіатип (SMS, Email, Web Push, Viber, Mobile Push, AppInbox, Widget, In-App)

messageId

int

ID повідомлення

name

varchar (200)

Назва повідомлення

replyTo

varchar (200)

Адреса для відповідей

sender

varchar (200)

Відправник

subject

varchar (1000)

Тема

tags

varchar (200)

Мітки

translations

varchar (200)

Мовні версії повідомлення

updateDate

timestamp

Дата та час оновлення повідомлення (формат: '2021-10-08 11:11:02')

OrderItems


Параметр
Тип даних
Опис

cost

numeric

Вартість товару

description

varchar (300)

Опис товару

externalProductId

varchar (100)

Зовнішній ID товару

imageUrl

varchar (200)

Посилання на зображення товару

name

varchar (100)

Назва товару

orderDate

timestamp

Дата створення замовлення (формат: '2021-10-08 11:11:02')

orderId

int

ID замовлення в eSputnik (Внутрішній)

quantity

int

Кількість товарів

url

varchar (200)

URL-адреса товару

Orders

Параметр

Тип даних

Опис

contactId

bigint

ID контакту в eSputnik (Внутрішній)

deliveryAddress

varchar (100)

Адреса доставки

deliveryMethod

varchar (50)

Спосіб доставки

discount

numeric

Знижка

email

varchar (50)

Email

externalOrderId

varchar (100)

Зовнішній ID замовлення

firstName

varchar (50)

Ім'я контакту

lastName

varchar (50)

Прізвище контакту

orderCreatedDate

timestamp

Дата створення замовлення на eSputnik (формат: '2021-10-08 11:11:02')

orderDate

timestamp

Дата створення замовлення (формат: '2021-10-08 11:11:02')

orderId

int

ID замовлення в eSputnik (Внутрішній)

paymentMethod

varchar (50)

Спосіб оплати

Phone

varchar (50)

Номер телефону

Status

varchar (50)

Статус замовлення:

  • INITIALIZED,
  • IN PROGRESS,
  • DELIVERED,
  • CANCELED.

totalCost

numeric

Загальна вартість замовлення

Revenue

Параметр

Тип даних

Опис

activity (activityStatus)*

varchar (100)

Статус активності:

  • DELIVERED – повідомлення доставлено.
  • UNDELIVERED – повідомлення не доставлено (містить причину statusDescription).
  • RECEIVED –повідомлення відкрито.
  • UNSUBSCRIBED – контакт відмовився від розсилки.
  • CLICKED – контакт клікнув посилання у повідомленні.
  • SPAM – контакт повідомив про спам.
  • SUBSCRIPTION_CHANGED – контакт змінив категорію підписки.
  • PUSH_SUBSCRIBED —контакт підписався на push-сповіщення.

campaignType

varchar (50)

Тип розсилки:

  • IM — тригерне повідомлення,
  • Group — масова розсилка.

clickEventLink

varchar (1000)

Містить посилання, яке клікнув контакт (статус CLICKED)

contactId

bigint

ID контакту в eSputnik (Внутрішній)

currency

varchar (3)

Валюта

externalCustomerId

varchar (100)

ID контакту у вашій системі (Зовнішній)

externalOrderId

varchar (200)

ID замовлення зовнішній

mediaType

varchar (50)

Медіатип (SMS, Email, Web Push, Viber, Mobile Push, AppInbox, Widget)

messageInstanceId

int

Службове поле

messageName

varchar (100)

Назва повідомлення в обліковому записі eSputnik

messageTags

varchar (200)

Мітки повідомлення

messageUrl

varchar (1000)

Містить посилання на веб-версію email

orderDate

timestamp

Дата створення замовлення (формат: '2021-10-08 11:11:02')

senderName

varchar (200)

Ім'я відправника у Viber

started (activityDateTime)*

timestamp

Дата та час відправки повідомлення (формат: '2021-10-08 11:11:02')

totalCost

numeric

Загальна вартість замовлення

utmCampaign

varchar (400)

UTM-мітка розсилки

eventKey

string

Ключ події

eventTypeKey

string

Ключ типу події

messageLanguageCode

string

Код мови повідомлення

orderId

int

ID замовлення в eSputnik (Внутрішній)

workflowId

int

ID сценарію

broadcastId

int

ID розсилки

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

📘

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

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

Приклади використання

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

1. Розширений аналіз ефективності кампанії

  • Використаний набір даних: broadcasts, contactActivities, messages
  • Опис: BigQuery дає змогу детально аналізувати ефективність кампаній, відстежуючи ключові показники, такі як рейтинги відкриття та кліків. Експорт даних про розсилки, включаючи критерії сегментації, статус доставлення та тип повідомлення, дозволяє маркетологам оцінити, які кампанії досягають найкращого залучення.
  • Переваги використання: визначивши найефективніші кампанії, маркетологи можуть оптимізувати контент повідомлень, час і таргетинг, підвищуючи вплив і рентабельність інвестицій майбутніх кампаній.

2. Сегментація клієнтів і аналіз поведінки

  • Використаний набір даних: contacts, contactActivities, events
  • Опис: BigQuery може обробляти великі обсяги даних про активність клієнтів, дозволяючи виявляти моделі поведінки, такі як частота покупок або бажані канали взаємодії. Це розуміння дозволяє глибше сегментувати аудиторію, щоб точніше таргетувати зацікавлених клієнтів.
  • Переваги використання: Кампанії, орієнтовані на поведінку, сприяють збільшенню утримання клієнтів і вищій пожиттєвої цінності клієнтів (LTV), надаючи досвід, який резонує з кожним сегментом аудиторії.

3. Прогнозне моделювання

  • Використаний набір даних: contacts, orders, revenue, contactActivities
  • Опис: Історичні дані про доходи, покупки та інші активності контактів дозволяють розробляти прогнозні моделі відтоку клієнтів. Це дає змогу виявляти клієнтів із групи ризику та націлювати на них стратегії утримання.
  • Переваги використання: Цільові кампанії зменшують відтік і збільшують LTV, допомагаючи утримувати цінних клієнтів і підвищувати довгостроковий дохід.

4. Стратегічний аналіз замовлень і доходів

  • Використаний набір даних: orders, orderItems, revenue
  • Опис: Аналізуючи дані про замовлення та доходи в BigQuery, маркетологи можуть відстежувати такі показники, як середня вартість замовлення та тенденції доходу. Цей аналіз допомагає виявити можливості збільшення продажів.
  • Переваги використання: Аналіз моделей доходів дозволяє приймати керовані даними рішення щодо ціноутворення, рекламних акцій і пропозицій продуктів, максимізуючи потенційний дохід.

5. Моніторинг і попередження за ключовими показниками

  • Використаний набір даних: broadcasts, contactActivities, revenue
  • Опис: Інформаційні панелі BigQuery можуть відстежувати ключові показники ефективності (KPI), такі як рівень залученості та доходи, із можливістю налаштування сповіщень про значні зміни (наприклад, раптове зниження показників доставлень).
  • Переваги використання: Моніторинг допомагає підтримувати ефективність кампаній, дозволяючи швидко розв'язувати проблеми та забезпечуючи послідовну взаємодію з підписниками.

6. Аналіз рентабельності інвестицій та розподілу бюджету

  • Використаний набір даних: broadcasts, orders, revenue, contactActivities
  • Опис: Експорт даних про кампанії та доходи в BigQuery дозволяє обчислювати рентабельність інвестицій і оцінювати економічну ефективність кампанії, надаючи відомості для оптимального розподілу бюджету.
  • Переваги використання: Зосереджуючись на високоефективних кампаніях, маркетологи можуть оптимізувати витрати, щоб максимізувати ефективність і віддачу від інвестицій.

7. Відображення омніканального шляху клієнта

  • Використаний набір даних: contacts, contactActivities, events, orders
  • Опис: Можливості обробки даних BigQuery дозволяють брендам аналізувати шляхи користувачів за різними каналами, надаючи розуміння життєвого циклу клієнта від обізнаності до конверсії.
  • Переваги використання: Розуміння шляху клієнта дозволяє виявити моменти деактивації та можливості для вдосконалення, забезпечуючи більш позитивний користувацький досвід і вищі коефіцієнти конверсії.