Migration des jetons Push

Un jeton de notification est un identifiant anonyme unique qui spécifie où envoyer les notifications d’une application. Braze se connecte à des fournisseurs de services push comme Firebase Cloud Messaging Service (FCMs) pour Android et Apple Push Notification Service (APN) pour iOS, et ces fournisseurs envoient des jetons d’appareil uniques qui identifient votre application. Si vous envoyiez des notifications push avant d’intégrer Braze, soit par vous-même, soit par un autre fournisseur, la migration des jetons push vous permet de continuer à envoyer des notifications push à vos utilisateurs avec des jetons push enregistrés.

Migration automatique via SDK

Le SDK Braze migrera automatiquement le jeton de notification push d’un utilisateur qui a déjà choisi de recevoir vos notifications push la première fois qu’il se connecte à votre application ou site intégré à Braze. Si vous intégrez les SDK Braze, vous n’aurez pas besoin de migrer les jetons push en utilisant l’API.

Cependant, comme les jetons de push migrent lorsqu’un utilisateur se connecte pour la première fois à votre application, notez que Braze ne pourra pas envoyer de notifications push aux utilisateurs qui ne se sont pas connectés après l’intégration de votre SDK. Vous pouvez toujours souhaiter migrer manuellement les jetons push Android et iOS comme moyen de réengager ces utilisateurs.

Migration manuelle via API

La migration manuelle des jetons push est le processus d’importation de ces clés précédemment créées dans votre plateforme Braze via l’API.

Migrez par programme les jetons iOS (APNs) et Android (FCM) vers votre plateforme en utilisant le users/track point de terminaison. Vous pouvez migrer à la fois les utilisateurs identifiés (utilisateurs avec un ID externe associé) et les utilisateurs anonymes (utilisateurs sans ID externe).

Spécifiez votre app_id lors de la migration du jeton de notification pour associer le jeton de notification approprié à l’application appropriée. Chaque application (iOS, Android, etc.) a son propre app_id, qui peut être trouvé dans la section Identification de la page Clés API. Assurez-vous d’utiliser les bonnes app_id pour chaque plateforme.

Migration si l’ID externe est présent

Pour les utilisateurs identifiés, définissez l’indicateur push_token_import sur false (ou omettez le paramètre) et spécifiez les valeurs external_id, app_id et token dans l’objet attributes utilisateur.

Par exemple :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
curl --location --request POST 'https://rest.iad-01.braze.com/users/track' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-API-KEY-HERE' \
--data-raw '{
  "attributes" : [
    {
      "push_token_import" : false,
      "external_id": "example_external_id",
      "country": "US",
      "language": "en",
      "YOUR_CUSTOM_ATTRIBUTE": "YOUR_VALUE",
      "push_tokens": [
        {"app_id": "APP_ID_OF_OS", "token": "PUSH_TOKEN_STRING"}
      ]
    }
  ]
}'

Migration si l’ID externe n’est pas présent

Lors de l’importation de jetons de notification push provenant d’autres systèmes, un external_id n’est pas toujours disponible. Dans ce cas, définissez votre indicateur push_token_import sur true et spécifiez les valeurs app_id et token. Braze créera un profil utilisateur temporaire et anonyme pour chaque jeton pour vous permettre de continuer à envoyer des messages à ces personnes. Si le jeton existe déjà dans Braze, la demande sera ignorée.

Par exemple :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
curl --location --request POST 'https://rest.iad-01.braze.com/users/track' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-API-KEY-HERE' \
--data-raw '{
  "attributes": [ 
    {
      "push_token_import" : true,
      "email": "[email protected]",
      "country": "US",
      "language": "en",
      "YOUR_CUSTOM_ATTRIBUTE": "YOUR_VALUE",
      "push_tokens": [
        {"app_id": "APP_ID_OF_OS", "token": "PUSH_TOKEN_STRING", "device_id": "DEVICE_ID"}
      ]
    },
      
    {
      "push_token_import" : true,
      "email": "[email protected]",
      "country": "US",
      "language": "en",
      "YOUR_CUSTOM_ATTRIBUTE_1": "YOUR_VALUE",
      "YOUR_CUSTOM_ATTRIBUTE_2": "YOUR_VALUE",
      "push_tokens": [
        {"app_id": "APP_ID_OF_OS", "token": "PUSH_TOKEN_STRING", "device_id": "DEVICE_ID"}  
      ]
    }
  ]
}'

Après l’importation, lorsque l’utilisateur anonyme lance la version de votre application activée par Braze, Braze déplacera automatiquement leur jeton de notification importé vers leur profil utilisateur Braze et nettoiera le profil temporaire.

Braze vérifiera une fois par mois s’il existe des profils anonymes avec l’indicateur push_token_import qui n’ont pas de jeton de notification push. Si le profil anonyme n’a plus de jeton de notification push, nous le supprimerons. Cependant, si le profil anonyme a toujours un jeton de notification push, indiquant que l’utilisateur ne s’est pas encore connecté à l’appareil avec le jeton de notification push, nous ne ferons rien.

Importation de jetons push Android

Si vous devez envoyer une notification push Android à vos utilisateurs avant d’avoir terminé l’intégration du SDK Braze, utilisez des paires clé-valeur pour valider les notifications push.

Vous devez disposer d’un récepteur pour manipuler et afficher les charges utiles de push. Pour notifier le récepteur de la charge utile de push, ajoutez les paires valeur-clé nécessaires à la campagne push. Les valeurs de ces paires dépendent du partenaire push spécifique que vous utilisiez avant Braze.

Dernière mise à jour le 5 décembre 2022