Налаштування аналітики доставлень та кліків | Support eSputnik

Дані користувача

Email

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

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

Відстеження подій та поведінки

Налаштування аналітики доставлень та кліків

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

Важливо

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

Ми пропонуємо 2 способи передачі статусів: Public API та інтеграція з Firebase Message Cloud та BigQuery.

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

Наведені нижче методи аналітики доставок та кліків призначені для проектів, які не встановили наш SDK

Public API

Використовуйте API-метод Update interaction status, щоб повернути статус DELIVERED (якщо повідомлення було доставлене на пристрій).

Разом зі значенням статусу в interfaceId в тілі запиту потрібно передати FCM-токен і час зміни статусу на пристрої.

Приклад:

{
    "token": "bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
    "status": "DELIVERED",
    "time": "2020-07-09T15:11:17"
}

Експорт даних про доставку повідомлень залежить від операційної системи пристрою одержувача.

iOS

Використовуйте Notification Service Extension та API-виклик у сервісному розширенні, щоб отримати звіт про статуси push-повідомлень.

  1. Встановіть Notification Service Extension у своєму мобільному застосунку.
  2. У didReceiveNotificationRequest додайте код для виклику веб-сервісу, щоб повідомити ваш сервер про отримане повідомлення.
  • Перевизначте метод didReceive (_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) → Void)
  • didReceiveNotificationRequest повинен складатися з HTTP запиту Update interaction status (PUT) зі статусом доставлення.

Активуйте фонове завантаження у розділі Capabilities → Background Modes вашого застосунку.

Важливо

Параметри "content-available" та "mutable-content" активовані (мають значення == 1) при передачі токенів в APN. Якщо передача даних налаштована через FCM, активовано лише параметр mutable-content (значення == 1).

Докладніше про зміну контенту в доставлених повідомленнях див. у інструкції Apple.

Android

Використовуйте сервіс, який дозволяє FirebaseMessagingService отримувати повідомлення. Сервіс повинен перевизначати виклики на MessageReceived і onDeletedMessages.

Відстеження кліків

Ви можете додати до тіла повідомлення посилання безпосередньо в редакторі повідомлень без можливості відстежувати кліки по ньому.

Додавання посилання у повідомлення

При додаванні посилання до тіла повідомлення додадуться 2 додаткові поля:

  • es_link_raw – http://example.com/somelink – містить вихідне посилання, яке може бути відкрите в браузері пристрою або може бути внутрішнім посиланням, що веде до інших розділів застосунку;
  • es_link – https://hh.esclick.me/37NdHw333DjRcukc0l – створюється на основі доданого посилання та містить обернене посилання, що використовується для відстеження кліків.

Важливо

Використовуйте для вашого мобільного застосунку дані з поля es_link_raw, щоб перенаправляти користувача в потрібний розділ застосунку або на веб-ресурс. Запит GET на посилання в es_link використовується для відстеження кліків.

Інтеграція з Firebase Message Cloud та BigQuery

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

1. Зв'яжіть свій проект із BigQuery.

2. Налаштуйте експорт даних із застосунку до BigQuery:

3. Інтегруйте вашу організацію в eSputnik з BigQuery.

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