Підключення мобільного застосунку

Щоб надсилати push-сповіщення у своєму мобільному застосунку за допомогою нашої CDP, підключіть мобільний застосунок до eSputnik.

Щоб підключити мобільний застосунок до eSputnik:

1. Перейдіть в налаштування вашого облікового запису.
2. Натисніть Mob Push у лівому бічному меню.
3. На сторінці Мобільні застосунки натисніть Підключити мобільний застосунок.

Створіть окремі застосунки з різними API-ключами для stage- та prod-оточення: так ви мінімізуєте ризики й перевірите кінцевий продукт перед випуском.

Окремого перемикача «sandbox-режим» немає. Ізоляція досягається виключно через окремі записи застосунків: кожен має власний API-ключ і облікові дані Firebase/APNs, власну базу контактів і власне доставлення push-повідомлень. Пристрій реєструється під тим ключем, який використовує зараз, тож перемикання ключа реєструє його як новий контакт в іншому записі — історія push-сповіщень і підписок між stage і prod не переноситься.

Кілька застосунків з однаковим bundle ID або Topic підключити можна. А от один застосунок не можна підключити до двох акаунтів eSputnik одночасно: ключ доступу мобільного SDK прив'язаний до одного акаунта, і контакти одного акаунта недоступні з іншого.

Крок 1. Назва застосунку

Введіть назву застосунку у відповідне поле.

Крок 2. Платформа

Виберіть платформи, для яких потрібно налаштувати мобільні пуші.

• Android

• iOS

Крок 3. Служба сповіщень

Залежно від платформ, вибраних на попередньому кроці, є 3 варіанти налаштувань:

1. Firebase Cloud Messaging (FCM) для всіх платформ.
2. Apple Push Notification Service (APN) для iOS.
3. FCM для Android та APN для iOS.

FCM

1. Клікніть Завантажити файл.

2. Натисніть на поле і завантажте JSON-файл закритого ключа Google Firebase зі свого комп'ютера, або перетягніть файл JSON-файл у поле.

3. Натисніть Готово у верхньому правому куті вікна.

APN

Оберіть один з двох варіантів:

• За допомогою токенів

Інструкції з генерації APN-токена ви знайдете в документації Apple Developer.

• За допомогою сертифікатів

Інструкції з генерації APN-сертифіката ви знайдете в документації Apple Developer.

За допомогою токенів

1. Натисніть Завантажити файл.

2. Натисніть поле і завантажте зі свого комп'ютера APN-ключ у форматі P8, або перетягніть файл у форматі P8.

3. Введіть у відповідні поля наступне:

• Key ID — 10-значний ідентифікатор ключа, отриманий вами у вашому обліковому записі розробника.
• Team ID — 10-значний ідентифікатор групи розробників Apple, який ви використовуєте для розробки застосунків вашої компанії. Отримайте це значення у вашому обліковому записі розробника.
• Topic — унікальний ідентифікатор, завдяки якому повідомлення надходить у відповідний додаток на пристрої користувача. Найчастіше Topic – це ідентифікатор пакета додатку.

Детальніше про поле Topic за посиланням >

4. Натисніть Готово у верхньому правому куті вікна.

За допомогою сертифікатів

1. Натисніть Завантажити файл.

2. Натисніть на поле і завантажте зі свого комп'ютера APN-ключ у форматі P12, або перетягніть файл у форматі P12.

3. Введіть відповідні значення в поля Пароль, Topic та натисніть Далі.

Детальніше про поле Topic за посиланням >

4. Натисніть Готово у верхньому правому куті вікна.

Якщо все налаштовано вірно, ви побачите відповідне сповіщення.

Якщо в налаштуваннях є помилки, ви побачите їх перелік та посилання на рекомендації з виправлення.

Керування дублюванням мобільних push-токенів

Увімкніть цю опцію, якщо один контакт керує кількома акаунтами (наприклад, магазинами або філіями) у застосунку на одному пристрої. Це гарантує доставлення push-сповіщень до всіх пов’язаних акаунтів без необхідності повторного входу та виходу.

1. У налаштуваннях акаунту перейдіть на вкладку Mob Push → Розширені налаштування та активуйте перемикач Дозволити дублювання токена.

2. Збережіть зміни.

Видалення застосунку та залишкові токени

Токени, прив'язані до мобільного застосунку, видаляються разом із самим застосунком. Якщо в застосунку були одночасно токени, додані через SDK, і токени, додані через API, після видалення частина токенів може залишитися.

• Спочатку видаліть застосунок, а потім перевірте результат — не видаляйте токени завчасно через публічний API.
• Якщо після цього токени залишилися, зверніться до служби підтримки та вкажіть UUID застосунку, спосіб додавання токенів і їхню кількість.
• Опублікованого SLA для такого очищення немає.