Skip to content

Migración de tokens de notificaciones push

Un token de notificaciones push es un identificador anónimo único que especifica dónde enviar las notificaciones de una aplicación. Braze se conecta con proveedores de servicios push como Firebase Cloud Messaging Service (FCM) para Android y Apple Push Notification Service (APN) para iOS, y esos proveedores envían tokens de dispositivos únicos que identifican tu aplicación. Si enviabas notificaciones push antes de integrar Braze, por tu cuenta o a través de otro proveedor, la migración de token de notificaciones push te permite seguir enviando notificaciones push a tus usuarios con tokens de notificaciones push registrados.

Migración automática mediante SDK

Después de integrar el SDK de Braze, los tokens de notificaciones push de tus usuarios con adhesión voluntaria se migrarán automáticamente la próxima vez que abran tu aplicación. Hasta entonces, no podrás enviar a esos usuarios notificaciones push a través de Braze.

También puedes migrar tus tokens de notificaciones push manualmente, lo que te permitirá reactivar a tus usuarios más rápidamente.

Consideraciones sobre los tokens Web

Debido a la naturaleza de los tokens de notificaciones push web, asegúrate de tener en cuenta lo siguiente cuando implementes las notificaciones push web:

Migración manual mediante API

La migración manual de token de notificaciones push es el proceso de importar estas claves creadas previamente a tu plataforma Braze a través de la API.

Programa la migración de tokens de iOS (APN) y Android (FCM) a tu plataforma utilizando el punto final users/track . Puedes migrar tanto usuarios identificados (usuarios con un ID externo asociado) como usuarios anónimos (usuarios sin ID externo).

Especifica el app_id de tu aplicación durante la migración del token de notificaciones push para asociar el token de notificaciones push adecuado con la aplicación apropiada. Cada aplicación (iOS, Android, etc.) tiene su propio app_id, que puedes encontrar en la sección Identificación de la página Claves de API. Asegúrate de utilizar el app_id de la plataforma correcta.

Para usuarios identificados, establece el indicador push_token_import en false (u omite el parámetro) y especifica los valores external_id, app_id y token en el objeto de usuario attributes.

Por ejemplo:

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"}
      ]
    }
  ]
}'

Al importar tokens de notificaciones push de otros sistemas, no siempre se dispone de una dirección external_id. En este caso, configura tu flag push_token_import como true y especifica los valores app_id y token. Braze creará un perfil de usuario anónimo temporal para cada token para habilitarte a seguir enviando mensajes a estas personas. Si el token ya existe en Braze, se ignora la solicitud.

Por ejemplo:

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"}  
      ]
    }
  ]
}'

Tras la importación, cuando el usuario anónimo inicie la versión habilitada para Braze de tu aplicación, Braze moverá automáticamente su token de notificaciones push importado a su perfil de usuario Braze y limpiará el perfil temporal.

Braze comprobará una vez al mes si hay algún perfil anónimo con la bandera push_token_import que no tenga un token de notificaciones push. Si el perfil anónimo ya no tiene un token de notificaciones push, eliminaremos el perfil. Sin embargo, si el perfil anónimo aún tiene un token de notificaciones push, lo que sugiere que el usuario real aún no ha iniciado sesión en el dispositivo con dicho token de notificaciones push, no haremos nada.

Importar tokens de notificaciones push de Android

Si debes enviar notificaciones push de Android a tus usuarios antes de que se complete la integración de SDK de Braze, utiliza pares clave-valor para validar las notificaciones push.

Debes tener un receptor para gestionar y mostrar cargas útiles push. Para notificar al receptor la carga útil push, añade los pares clave-valor necesarios a la campaña push. Los valores de estos pares dependen del socio de push específico que hayas utilizado antes de Braze.

Última actualización: 5 de diciembre de 2022

Github   Editar esta página en GitHub
¿QUÉ TAN ÚTIL FUE ESTA PÁGINA?
New Stuff!