React Native SDK - プッシュ通知のサポート

フォローする
Avatar
Ghani Yusuf
Updated
ドキュメント

プッシュ通知を使ったリエンゲージメント・トラッキングのサポート

Singularはプッシュ通知のトラッキングをサポートし、リエンゲージメント測定を強化します。Firebase Cloud Messaging (FCM)をSingular SDKと統合することで、プッシュ通知とやり取りしたユーザーを追跡し、それに応じて属性を設定することができます。

正確なトラッキングを行うには、以下の実装ガイドラインに従い、通知データがSingular SDKに正しく渡されるようにしてください。

なぜプッシュ通知のトラッキングが重要なのですか？

プッシュ通知は重要なリエンゲージメントツールですが、トラッキングには正しい統合が必要です。Singularは通知とやり取りしたユーザーを適切に帰属させ、マーケティングキャンペーンやエンゲージメント戦略を最適化します。

実装ガイド

Singular SDKを統合する

Singular SDKをReact Nativeプロジェクトに統合するには、Singularのドキュメントに記載されている公式の手順に従ってください。

プッシュ通知の設定

  • Firebase Cloud Messagingを使用してプッシュ通知を設定します。

  • 以下のReact Nativeプラグインが追加されていることを確認してください：

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

iOS

  • iOSアプリをFirebaseに登録します。
  • GoogleService-Info.plist をXcodeプロジェクトに追加します。
  • プッシュ通知とバックグラウンドモード（リモート通知）を有効にする。

Android

  • AndroidアプリをFirebaseに登録します。
  • android/app/ でgoogle-services.json をプロジェクトに追加します。
  • Firebase メッセージングの依存関係が追加され、パーミッションが付与されていることを確認します。

Singular SDKでプッシュ通知を処理する

iOS

バックグラウンドまたはフォアグラウンドのアプリ

通知が処理される以下のメソッドを呼び出します：

javascript
Singular.handlePushNotification(notificationPayloadData);

終了状態のアプリ

AppDelegate.m で、didFinishLaunchingWithOptions の中に以下の行を追加する：

AppDelegate.m
[SingularBridge startSessionWithLaunchOptions:launchOptions];

アンドロイド

バックグラウンドまたはフォアグラウンドのアプリ

メインのアクティビティ（例：MainActivity.java ）で、onNewIntent をオーバーライドします：

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

終了状態のアプリ

何もする必要はありません。React Nativeブリッジレイヤーがこのシナリオを自動的に処理します。

プッシュリンクパスの設定

Re-engagementアトリビューションのために、通知ペイロード内の特定のパスを認識するようにSingular SDKを設定します。withPushNotificationsLinkPathsオプションで SingularConfig オブジェクトを更新します。

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

検証ガイド

ステップ 4: セッション開始コールでプッシュ通知の受信を検証/確認する

Singular SDK APIコールは、開始セッションコールのsingular_link予約パラメータの下にプッシュ通知ペイロードリンクが正しく渡されることを確認します。

例

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


代わりに、Singular SDK コンソールを使って、以下のようにDeeplink URL の下にあるプッシュ通知トラッキングリンクを確認することもできます。

これを確認することで、プッシュ通知のエンゲージメントがSingular SDK内で正しくトラッキングされていることを確認できます。

注意事項

  • singularLinksHandlerコードとは異なり、Singular SDK はこの機能のプッシュペイロードコールバックを提供していないことに注意してください。プッシュ通知データを読み取り、ユーザーをアプリ内の特定の商品ページにリダイレクトするディープリンクロジックを実装するのは、アプリ開発者の責任です。このソリューションでは、ユーザーが通知をタップするとSingularがプッシュ通知のペイロードを取得し、Singular.start(config)によってトリガーされるSDKスタートセッションイベントにこのペイロードを含めます。このデータはSingularのバックエンドで処理され、プッシュ通知のタッチポイント/クリックを属性化し、リエンゲージメント追跡のために登録されます。

  • 私たちは、プッシュ通知のペイロードに渡されたカスタムキーバリューペアから、Singularのリンクドメインだけを許可する安全機構を持っています。具体的には、Singular Manage Linksページで事前に定義されたsng.link ドメインのみが許可されます。

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

    Singularリンクを別のドメイン（例：EメールサービスプロバイダのESPドメイン）でラップする場合は、セットアップで以下のオプションを追加して明示的にドメインを設定する必要があります：これにより、Singularフレームワーク内で外部ドメインが認識され、許可されるようになります。以下の設定例を参照してください。config.withESPDomains(Arrays.asList("sl.esp.link"));

  • 1つのプッシュ通知からユーザーのアクションに基づいて異なるディープリンクをトリガーする必要がある場合、1つのSingularトラッキングリンクを使用し、動的にリダイレクトを変更することができます。

    例

    ニュース速報のプッシュ通知は複数のディープリンクオプションを提供することがあります！複数のトラッキングリンクを作成する代わりに、1つのSingularトラッキングリンクを設定し、ユーザーの選択に基づいて動的にリダイレクトを調整します。

    最新ニュースを読む
    newsapp://article?id=12345
    トレンドトピックを読む →トレンドトピックを読む
    newsapp://trending
    スポーツ
    newsapp://sports


    リダイレクトのオーバーライドについては、Singularトラッキングリンクをご覧ください。

成功です！

以下のステップに従うことで、あなたのアプリはSingularを使ってプッシュ通知のインタラクションをトラッキングするように設定されました。これにより、キャンペーンのパフォーマンスインサイトが改善され、正確なリエンゲージメントアトリビューションが保証されます。