SDK de React Native - Soporte de notificaciones push

Seguir
Avatar
Ghani Yusuf
Updated
Documento

Seguimiento del reenganche mediante notificaciones push

Singular admite el seguimiento de notificaciones push para mejorar la medición del reenganche. Mediante la integración de Firebase Cloud Messaging (FCM) con el SDK de Singular, puede realizar un seguimiento de los usuarios que interactúan con las notificaciones push y atribuirlos en consecuencia.

Para garantizar un seguimiento preciso, siga las directrices de implementación que se indican a continuación y asegúrese de que los datos de las notificaciones se transmiten correctamente a Singular SDK.

¿Por qué es importante el seguimiento de las notificaciones push?

Las notificaciones push son una herramienta clave de captación, pero su seguimiento requiere una integración correcta. Singular asegura que los usuarios que interactúan con las notificaciones son atribuidos correctamente, ayudando a optimizar las campañas de marketing y las estrategias de compromiso.

Guía de implementación

Integrar el SDK de Singular

Integra el SDK de Singular en tu proyecto React Native siguiendo las instrucciones oficiales proporcionadas en la documentación de Singular.

Configurar notificaciones push

  • Configura las notificaciones push usando Firebase Cloud Messaging

  • Asegúrate de que los siguientes plugins de React Native están añadidos:

    bash
    npm install @react-native-firebase/app
npm install @react-native-firebase/messaging

iOS

  • Registra tu aplicación iOS en Firebase.
  • Añade GoogleService-Info.plist a tu proyecto Xcode.
  • Habilita las notificaciones push y los modos de fondo (notificaciones remotas).

Android

  • Registre su aplicación Android en Firebase.
  • Añade google-services.json a tu proyecto en android/app/.
  • Asegúrate de que las dependencias de mensajería de Firebase están añadidas y los permisos concedidos.

Manejo de Notificaciones Push con Singular SDK

iOS

App en Background o Foreground

Llame al siguiente método donde se maneja la notificación:

javascript
Singular.handlePushNotification(notificationPayloadData);

App en Estado Terminado

En AppDelegate.m, añada la siguiente línea dentro de didFinishLaunchingWithOptions:

AppDelegate.m
[SingularBridge startSessionWithLaunchOptions:launchOptions];

Android

Aplicación en segundo o primer plano

En su actividad principal (por ejemplo, MainActivity.java), anule onNewIntent:

MainActivity.java
@Override
protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    SingularBridgeModule.onNewIntent(intent);
}

Aplicación en estado finalizado

No se requiere ninguna acción. La capa puente de React Native maneja este escenario automáticamente.

Configurar rutas de enlaces push

Configure Singular SDK para reconocer rutas específicas en sus cargas útiles de notificación para la atribución de Re-engagement. Actualice el objeto SingularConfig con las opciones withPushNotificationsLinkPaths.

App.tsx
config.withPushNotificationsLinkPaths([
  ["path", "to", "url"]]);

Guía de validación

Paso 4: Validación/Verificación de la recepción de notificaciones push en la llamada de inicio de sesión

La llamada a la API de Singular SDK garantiza que el enlace de la carga útil de la notificación push se pasa correctamente bajo el parámetro reservado singular_link en la llamada de inicio de sesión.

Ejemplo:

bash
https://sdk-api-v1.singular.net/api/v1/start?a=<SDK-Key>&ab=arm64-v8a&aifa=180f63a1-0955-47b4-896a-d75ae3d35955&apc=Marchv7&apg=1&aps=Intex&asid_scope=1&asid_timeinterval=0.112&av=20.0&br=samsung&c=wifi&current_device_time=1740905574088&de=m15x&device_type=phone&device_user_agent=Dalvik/2.1.0 (Linux; U; Android 14; SM-E156B Build/UP1A.231005.007)&dnt=0&event_index=3&fi=e5bRZuVddO8:APA91bHXI3OmFZv3-r8f03zyji2kvKWbIngwf8KBDHk4Rj5q5MEeEm6EtzC-if1vpJRmuYLyGdAcSz9-nc49eIjD86xwj-n9J4jKucqMVt9mP8ICifP0arA&i=net.singular.singularsampleapp&install_time=1740905507036&is=false&k=SDID&lag=0.067&lc=en_IN&ma=samsung&mo=SM-E156B&n=Singular-TestApp-Debug&p=Android&pr=m15xnndins&pu=1&rt=json&s=1740905574084&sdk=Singular/v12.6.2&singular_install_id=2dc5dfc2-a2a8-484a-aad1-fed6cb7a3023&singular_link=https://singularassist2.sng.link/C4nw9/r1m0?_dl=singular://test&_smtype=3&src=com.android.shell&u=75f7b911-5a77-597d-8892-56f5e0e210ff&update_time=1740905507036&v=14&h=1e723fd90344d5d037059f110611ed1d84fbba88


Alternativamente, puede utilizar la consola de Singular SDK para verificar el enlace de seguimiento de la notificación push bajo la URL Deeplink, como se demuestra a continuación.

Al verificar esto, puede confirmar que los compromisos de notificación push se rastrean correctamente en Singular SDK.

Notas:

  • Tenga en cuenta que, a diferencia del código singularLinksHandler, Singular SDK no proporciona callbacks de carga útil push para esta función. Es responsabilidad del desarrollador de la aplicación leer los datos de la notificación push e implementar la lógica de enlace profundo para redirigir a los usuarios a páginas de productos específicos dentro de la aplicación. En esta solución, Singular recupera la carga útil de la notificación push cuando el usuario toca la notificación e incluye esta carga útil en el evento de inicio de sesión del SDK activado por Singular.start(config). A continuación, estos datos se procesan en el backend de Singular para atribuir el punto de contacto/clic de la notificación push y registrarlo para el seguimiento del reenganche.

  • Disponemos de un mecanismo de seguridad que sólo permite a Singular enlazar dominios a partir del par clave-valor personalizado pasado en la carga útil de la notificación push. En concreto, sólo se permiten los dominios sng.link predefinidos en la página Singular Manage Links.

    Por ejemplo
    https://prod_test.sng.link/B0s2a/51oi?_dl=singular%3A%2F%2Fmain

    Si pretende envolver enlaces Singular dentro de un dominio diferente (por ejemplo, un dominio ESP para proveedores de servicios de correo electrónico), debe configurar explícitamente el dominio añadiendo la siguiente opción en su configuración: Esto garantiza que el dominio externo se reconozca y se permita dentro del marco de Singular. consulte el siguiente ejemplo de configuración. config.withESPDomains(Arrays.asList("sl.esp.link"));

  • Si necesita activar diferentes enlaces profundos en función de las acciones del usuario desde una única notificación push, puede utilizar un único enlace de seguimiento de Singular y modificar dinámicamente las redirecciones.

    Ejemplo:

    Una notificación push de noticias de última hora puede ofrecer múltiples opciones de enlaces profundos. En lugar de crear varios enlaces de seguimiento, configure un único enlace de seguimiento Singular y ajuste los redireccionamientos dinámicamente en función de la selección del usuario.

    Leer últimas noticias →
    newsapp://article?id=12345
    Temas de actualidad → Trending Topics 
    newsapp://trending
    Deportes →
    newsapp://sports


    Más información sobre la anulación de redirecciones en Enlaces de seguimiento singulares.

¡¡¡Éxito!!!

Siguiendo estos pasos, su aplicación ya está configurada para realizar un seguimiento de las interacciones de las notificaciones push mediante Singular. Esto ayuda a mejorar la información sobre el rendimiento de la campaña y garantiza una atribución precisa del reenganche.