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.

Paso 1: Configuración de las notificaciones push de Firebase en Flutter

En primer lugar, integra Firebase en tu app Flutter para gestionar las notificaciones push. Sigue estos pasos:

1. Añade dependencias Añade los paquetes necesarios a tu pubspec.yaml
   yaml

   dependencies:
     firebase_core: ^2.24.2
     firebase_messaging: ^14.7.10

2. Configurar Firebase
   • Android: Coloca google-services.json en android/app/ y actualiza los archivos Gradle (ver ).
   • iOS: Coloca GoogleService-Info.plist en la carpeta Xcode Runner y actualiza Podfile con los pods de Firebase.
3. Inicializa Firebase en Flutter Actualiza tu main.dart:
   dart

   import 'package:firebase_core/firebase_core.dart';
   import 'package:firebase_messaging/firebase_messaging.dart';
   
   Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
     await Firebase.initializeApp();
     print("Background message: ${message.messageId}");
   }
   
   void main() async {
     WidgetsFlutterBinding.ensureInitialized();
     await Firebase.initializeApp();
     FirebaseMessaging.onBackgroundMessage(_firebaseMessagingBackgroundHandler);
     runApp(MyApp());
   }

Paso 2: Manejo de notificaciones push en Flutter

Cuando tu aplicación recibe una notificación push de Firebase, necesitas capturar los datos de la notificación y prepararlos para Singular. A continuación se explica cómo gestionar las notificaciones en diferentes estados de la aplicación:

Android

• Primer plano: Gestiona las notificaciones directamente en Dart.
• Fondo/Terminado: Interfaz con la capa nativa de Android.

Actualiza tu código Dart:

class _MyAppState extends State<MyApp> {
  final FirebaseMessaging _firebaseMessaging = FirebaseMessaging.instance;

  @override
  void initState() {
    super.initState();

    // Request permission

    _firebaseMessaging.requestPermission();

    // Foreground notifications

    FirebaseMessaging.onMessage.listen((RemoteMessage message) {
      print('Foreground message: ${message.messageId}');
      String title = message.notification?.title ?? '';
      String body = message.notification?.body ?? '';
      Map<String, dynamic> data = message.data;

      // Process notification for Singular (foreground)

      _processNotificationForSingular(title, body, data);
    });

    // Background/Opened from notification

    FirebaseMessaging.onMessageOpenedApp.listen((RemoteMessage message) {
      print('Message opened: ${message.messageId}');
      _processNotificationForSingular(
        message.notification?.title ?? '',
        message.notification?.body ?? '',
        message.data,
      );
    });
  }

  void _processNotificationForSingular(
      String title, String body, Map<String, dynamic> data) {
    print('Notification - Title: $title, Body: $body, Data: $data');
    // Add Singular handling here (Step 3)

  }
}

iOS

• Primer plano: Similar a Android, manejado en Dart.
• Fondo/Terminado: Requiere integración nativa de iOS.

Paso 3: Interfaz de notificaciones push con el SDK de Singular

Para asegurarse de que Singular realiza un seguimiento de las notificaciones push para su atribución, debe pasar la carga útil de la notificación al SDK de Singular. Esto implica código Dart y alguna configuración nativa.

Proporcionar la carga útil push

1. Android
   • Antecedentes: En su Android MainActivity, anule onNewIntent para pasar la intención a Singular:
     kotlin

     // MainActivity.kt
     
     package com.example.yourapp
     
     import io.flutter.embedding.android.FlutterActivity
     import android.content.Intent
     import com.singular.sdk.SingularBridge
     
     class MainActivity: FlutterActivity() {
         override fun onNewIntent(intent: Intent) {
             super.onNewIntent(intent)
             SingularBridge.onNewIntent(intent)
         }
     }

   • Terminado: Manejado automáticamente por la capa puente de Singular, sin necesidad de código adicional.
2. iOS
   • En segundo plano: Llame a handlePushNotification en su código Dart cuando procese notificaciones en segundo plano:
     dart

     void _processNotificationForSingular(
         String title, String body, Map<String, dynamic> data) {
       Singular.handlePushNotification(data);
     }

   • Terminado: Actualice AppDelegate.swift para manejar las opciones de lanzamiento:
     swift

     import UIKit
     import Singular
     
     @UIApplicationMain
     @objc class AppDelegate: FlutterAppDelegate {
       override func application(
         _ application: UIApplication,
         didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
       ) -> Bool {
         SingularAppDelegate.shared().launchOptions = launchOptions
         return super.application(application, didFinishLaunchingWithOptions: launchOptions)
       }
     }

Configuración de rutas de enlaces push en Singular Config

Configure Singular SDK para que reconozca rutas específicas en sus cargas útiles de notificación para la atribución de Re-engagement:

import 'package:singular_flutter_sdk/singular.dart'; // Adjust import


void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();

  // Singular configuration

  SingularConfig config = SingularConfig(
    apiKey: 'your_api_key',
    secret: 'your_secret',
  );

  // Set push notification link paths (same for iOS and Android)

  config.pushNotificationsLinkPaths = [
    ['sng_link'],
    ['rootObj', 'nestedObj', 'anotherNested', 'singularLink'],
  ];

  // Initialize Singular

  Singular.init(config);

  runApp(MyApp());
}

Guía de validación

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