Skip to content

Переход с другого сервиса 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 получит новые токены.

Порядок перехода ​

  1. Загрузите ключи APNs и Firebase в разделе Коммуникации → Настройки → Mobile push.
  2. Выпустите обновление приложения с SDK вместо SDK старого сервиса. С параметром autoSendPushToken SDK сам передаст токен устройства в платформу при запуске приложения.
  3. Настройте обработку уведомлений в приложении: старый SDK обрабатывал нажатия по своим правилам.
  4. Проверьте отправку на своем устройстве.
  5. Если нужно отправлять пуши клиентам, которые еще не обновили приложение, импортируйте базу токенов из старого сервиса (смотрите ниже).

Не отправляйте пуши из двух сервисов одновременно

Технически токены работают в обоих сервисах, но клиенты будут получать дубли. Остановите рассылки в старом сервисе, как только начнете отправку из платформы.

Перенос базы токенов ​

Что выгрузить из старого сервиса ​

Нужны именно токены 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.