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

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

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

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 вашого застосунку.

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

Android

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

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

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

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

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

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

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

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

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

• iOS;
• Android.

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