Appearance
Переход с другого сервиса mobile push
Если приложение уже отправляет пуши через другой сервис, подписчиков можно перенести без повторного запроса разрешения на уведомления. В отличие от web push, токен mobile push выдает не сервис рассылок, а Apple (APNs) или Google (Firebase). Он привязан к вашему приложению, поэтому продолжает работать после смены сервиса.
Когда перенос сработает
Токены будут работать, если платформа отправляет пуши от имени того же приложения, что и старый сервис:
- iOS: сертификат APNs выпущен для того же Bundle ID приложения. Смотрите Сертификат APNs для iOS.
- Android: ключ сервисного аккаунта взят из того же проекта Firebase, к которому подключено приложение (тот же
google-services.json). Смотрите Ключ Firebase для Android.
Если старый сервис использовал свой проект Firebase
Некоторые сервисы подключают приложение к своему проекту Firebase. Токены такого проекта нельзя использовать с ключом другого проекта. В этом случае перенос базы не поможет: подписчики появятся в платформе после обновления приложения, когда SDK получит новые токены.
Порядок перехода
- Загрузите ключи APNs и Firebase в разделе Коммуникации → Настройки → Mobile push.
- Выпустите обновление приложения с SDK вместо SDK старого сервиса. С параметром
autoSendPushTokenSDK сам передаст токен устройства в платформу при запуске приложения. - Настройте обработку уведомлений в приложении: старый SDK обрабатывал нажатия по своим правилам.
- Проверьте отправку на своем устройстве.
- Если нужно отправлять пуши клиентам, которые еще не обновили приложение, импортируйте базу токенов из старого сервиса (смотрите ниже).
Не отправляйте пуши из двух сервисов одновременно
Технически токены работают в обоих сервисах, но клиенты будут получать дубли. Остановите рассылки в старом сервисе, как только начнете отправку из платформы.
Перенос базы токенов
Что выгрузить из старого сервиса
Нужны именно токены APNs и FCM. Внутренние идентификаторы старого сервиса (ID подписчика, ID устройства) для отправки не подходят. Для каждого токена выгрузите:
- сам токен;
- платформу:
iosилиandroid; - хотя бы один идентификатор клиента: email, телефон, номер карты лояльности или ID клиента в вашей системе.
Записи без идентификатора клиента не импортируются.
Как загрузить
Используйте метод импорта аудитории с полями mobile_token и mobile_token_platform. В одной записи передается один токен. Если у клиента несколько устройств, передайте несколько записей с одним и тем же идентификатором: токены добавятся к одному профилю.
json
{
"shop_id": "YOUR_SHOP_ID",
"shop_secret": "YOUR_SHOP_SECRET",
"audience": [
{ "external_id": "998877", "mobile_token": "IOS_DEVICE_TOKEN", "mobile_token_platform": "ios" },
{ "external_id": "998877", "mobile_token": "FCM_REGISTRATION_TOKEN", "mobile_token_platform": "android" }
]
}Клиент с импортированным токеном получает подписку на mobile push. Он попадет в массовые рассылки, триггерные цепочки и сервисные сообщения, если не отписан от них.
Цепочки по подписке
Добавление токена считается подпиской на канал. Если у вас есть триггерные цепочки, которые запускаются при подписке на mobile push, они сработают для импортированных клиентов. Отключите такие цепочки на время импорта.
Ограничения
- Huawei Push Kit. Токены Huawei импортом перенести нельзя: они появятся в платформе после обновления приложения с SDK.
- Устаревшие токены. Многие сервисы не удаляют токены удаленных приложений. Платформа удалит такой токен после первой неудачной отправки, поэтому охват первой рассылки после импорта может оказаться ниже, чем в старом сервисе.
- Тестовые токены iOS. Токены из тестовых сборок (окружение sandbox) с боевым сертификатом APNs не работают. Импортируйте только токены из App Store.