푸시 알림을 이용한 리인게이지먼트 추적 지원

Singular는 리인게이지먼트 측정을 향상시키기 위해 푸시 알림 추적을 지원합니다. Firebase 클라우드 메시징(FCM)을 Singular SDK와 연동하면 푸시 알림과 상호 작용하는 사용자를 추적하고 그에 따라 어트리뷰션할 수 있습니다.

정확한 추적을 위해 아래의 구현 가이드라인을 따르고 알림 데이터가 Singular SDK에 올바르게 전달되었는지 확인하세요.

1단계: Flutter에서 Firebase 푸시 알림 설정하기

먼저, 푸시 알림을 처리하기 위해 Firebase를 Flutter 앱에 연동합니다. 다음 단계를 따르세요:

1. 종속성추가 pubspec.yaml에 필요한 패키지를 추가합니다.
   yaml

   dependencies:
     firebase_core: ^2.24.2
     firebase_messaging: ^14.7.10

2. Firebase 구성
   • Android: android/app/ 에 google-services.json 를 배치하고 Gradle 파일을 업데이트합니다( ).
   • iOS: GoogleService-Info.plist 을 Xcode Runner 폴더에 배치하고 Podfile 을 Firebase 포드로 업데이트합니다.
3. Flutter에서 Firebase 초기화 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());
   }

2단계: Flutter에서 푸시 알림 처리하기

앱이 Firebase에서 푸시 알림을 수신하면 알림 데이터를 캡처하여 Singular에 맞게 준비해야 합니다. 다음은 다양한 앱 상태에서 알림을 처리하는 방법입니다:

Android

• 포그라운드: Dart에서 직접 알림을 처리합니다.
• 백그라운드/종료: 기본 Android 레이어와 인터페이스합니다.

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

• 전경: Android와 유사하며, Dart에서 처리됩니다.
• 배경/종료: 기본 iOS 연동이 필요합니다.

3단계: 푸시 알림과 Singular SDK 연동하기

Singular가 어트리뷰션을 위해 푸시 알림 참여를 추적하도록 하려면, 알림 페이로드를 Singular SDK에 전달해야 합니다. 여기에는 Dart 코드와 일부 기본 구성이 포함됩니다.

푸시 페이로드 제공

1. Android
   • 배경: Android MainActivity 에서 onNewIntent 을 재정의하여 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)
         }
     }

   • 종료되었습니다: Singular 브리지 레이어에서 자동으로 처리되며 추가 코드가 필요하지 않습니다.
2. iOS
   • 백그라운드: 백그라운드 알림을 처리할 때 Dart 코드에서 handlePushNotification을 호출하세요:
     dart

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

   • 종료되었습니다: AppDelegate.swift 을 업데이트하여 실행 옵션을 처리합니다:
     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)
       }
     }

Singular 컨피규레이션에서 푸시 링크 경로 설정하기

리인게이지먼트 어트리뷰션을 위해 알림 페이로드에서 특정 경로를 인식하도록 Singular SDK를 구성합니다:

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());
}

유효성 검사 가이드

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