アプリ内イベントのトラッキング
アプリ内イベントは、ログイン、登録、チュートリアルの完了、ゲームアプリのレベルアップなどのユーザーアクションを追跡することで、キャンペーンのパフォーマンスや主要業績評価指標（KPI）を測定するのに役立ちます。Singularはこれらのイベントを収集することで、ユーザーの行動に関する洞察を提供し、マーケティング活動を最適化します。
標準イベントとカスタムイベント
Singularは2種類のイベントをサポートしています：
- 標準イベント：標準イベント：Singularが認識する定義済みのイベント（例：sngLogin 、sngContentView ）で、レポートや最適化のために広告ネットワークがサポートすることがよくあります。標準イベントを使用すると、手動で定義しなくてもSingularが自動的にイベントリストに追加するため、設定が簡単になります。推奨互換性と使いやすさのために、可能な限り標準イベントを使用してください。標準イベント名と推奨属性については標準イベントと属性のリストをご覧ください。
-
カスタムイベント：Singularの標準イベントと一致しない、アプリ独自のイベント（例：Signup 、AchievementUnlocked ）。
カスタムイベントの制限：
- サードパーティのパートナーや分析ソリューションとの互換性を保証するために、イベント名と属性を英語で渡すことを強くお勧めします。
- イベント名は32 ASCII文字までに制限されています。非ASCII文字の文字列は、UTF-8に変換された後、32バイト以下にする必要があります。
- 属性と値は500 ASCII文字に制限されます。
UA、マーケティング、またはビジネスチームと協力して、アプリのマーケティングKPIに基づいてイベントと属性のリストを作成してください。アプリ内イベントのトラッキング方法」を参照してください：イベントの選択に関するガイダンスについては、Singular Attribution Customersのガイドを参照してください。
イベントの送信
- を使用します。 eventメソッドを使用して、SingularのSDKでシンプルなカスタムイベントをトラッキングします。
- メソッドを使用してください。 eventWithArgsメソッドを使用してください。
ベストプラクティス
- 標準イベントを使用する：広告ネットワークとの互換性やSingularのイベントリストでの自動認識のために、標準イベントを優先しましょう。
- 属性を検証する：属性が期待されるフォーマットと一致していることを確認します。
- イベントをデバッグする：開発中にSDKロギングを有効にして、イベントが正しく送信され、アプリのライフサイクルの適切なタイミング（ユーザーがログインした後など）でトリガーされていることを確認します。
注：トラッキングされたイベントがアプリのKPIと一致するように、UA/マーケティングチームと調整してください。本番環境にデプロイする前に、開発環境でイベントをテストし、Singular Dashboardのデータの正確性を確認してください。
収益の追跡
SingularのReact Native SDKでは、アプリ内の収益イベントをトラッキングして、キャンペーンのパフォーマンスとROIを分析できます。収益データはSingularのレポート、ログエクスポート、ポストバックで利用でき、アプリの収益化に関する実用的な洞察を提供します。
収益イベントを追跡する理由
- 豊富な分析：詳細なトランザクションデータを取得し、Singularのレポートを強化します。
- 不正防止：トランザクションのレシート（Google PlayやApple App Storeからのレシートなど）を含めることで、購入を検証し、アプリ内詐欺に対処できます。
- キャンペーンの最適化：収益をマーケティング活動に結びつけてROIを測定します。
ベストプラクティス完全な購入オブジェクトを渡す
Android（Google Play Billing）またはiOS（StoreKit）のアプリ内課金（IAP）プロセスから返される購入オブジェクトを渡すことを強くお勧めします。これにより、Singularは以下を含む包括的なトランザクションの詳細を受け取ることができます：
- 商品ID
- 価格
- 通貨
- トランザクションID
- レシートデータ（検証用）
完全な購入オブジェクトを渡すことで、リッチなレポーティングが可能になり、Singularの不正検出機能（特にGoogle Playのトランザクション）を活用できます。
IAP購入オブジェクトの取得
プラットフォーム固有の IAP ライブラリを使用して購入オブジェクトを取得します：
- iOS：iOSでは react-native-iapまたは同様のライブラリを使用して、StoreKitの購入詳細にアクセスします。
- Android：購入オブジェクトを取得するには react-native-iapまたはGoogle Play Billing Libraryを使用して購入オブジェクトを取得します。
IAP収益の送信
- inAppPurchaseメソッドを使用して、購入の詳細を含むアプリ内購入イベントをトラッキングします。
- inAppPurchaseWithArgsメソッドを使用して、購入の詳細と追加のカスタム属性を含むアプリ内購入イベントをトラッキングします。
Purchase オブジェクトを使用しない収益の送信
収益検証のためにinAppPurchaseメソッドを使用して収益イベントを報告することを強く推奨しますが、通貨とトランザクション金額を渡すだけで収益イベントをSingularに送信することもできます。
重要：有効な購入オブジェクトなしで収益イベントを送信する場合、Singularはトランザクションを検証しません。
要件
注意:通貨は3文字のISO 4217通貨コードで渡します（例："USD," "EUR", "INR" ）。
- revenueメソッドを使用して、指定した通貨と金額の単純な収益イベントをトラッキングします。
- revenueWithArgsメソッドを使用して、指定した通貨、金額、および追加のカスタム属性を持つ収益イベントを追跡します。
- customRevenueメソッドを使用して、指定したイベント名、通貨、および金額を持つカスタム収益イベントを追跡します。
- customRevenueWithArgsメソッドを使用して、指定されたイベント名、通貨、金額、および追加のカスタム属性を持つカスタム収益イベントを追跡します。
サブスクリプション収益の送信
Singularは、Singular SDKを使ってサブスクリプションイベントを実装する方法について包括的なガイドを提供しています。様々なプラットフォームでのアプリ内サブスクリプションイベントのトラッキングをカバーしています。
- サブスクリプション収益をトラッキングしたい場合は、サブスクリプションイベント技術実装ガイドをお読みください。
広告収益の送信
広告収益アトリビューションは、広告収益をアプリにユーザーを呼び込んだ特定のキャンペーンに結びつけるのに役立ちます。これにより、キャンペーンコスト、アプリ内収益、広告収益を一度に表示し、広告のパフォーマンスを明確に把握できます。また、広告収益データを広告ネットワークに送信して、広告パフォーマンスを改善することもできます。
- 詳細な広告データ情報で広告収益イベントを追跡するには、adRevenueメソッドを使用します。
- メディエーション・パートナーとの広告収益アトリビューションの実装に関する詳細ガイドをお読みください。
ハイブリッドイベント追跡
Singularは、アプリに統合されたSingular SDKを通してすべてのイベントと収益を送信することを推奨しています。しかし、Singularは他のソースからイベントと収益を収集することができます。
Singular SDKから送信されないイベントは、Singularのサーバー間イベントドキュメンテーション要件に準拠し、イベントを正しくアトリビュートするために一致するデバイス識別子を提供する必要があります。
重要です：
Server-to-Server イベントリクエストで使用されるデバイス識別子がSingularで一致しない場合、不一致が発生します。以下の可能性に注意してください：
- イベントリクエストがSingular SDKがアプリセッションからデバイス識別子を記録する「前」に受信された場合、そのイベントリクエストは未知のデバイスの「最初のセッション」とみなされ、Singularはそのデバイスをオーガニックアトリビューションとしてアトリビュートします。
- Singular SDKがデバイス識別子を記録していたとしても、Singular SDKの識別子がServer-to-Server Eventリクエストで指定されたデバイス識別子と異なる場合、イベントの帰属は正しくありません。
ハイブリッドイベント追跡ガイド
Singularはお客様のサーバーから収益に関するデータを収集し、キャンペーンのパフォーマンスやROIの分析に役立てることができます。
要件
- アプリ内登録またはログインイベントから、デバイス識別子を取得して渡し、このデータをユーザーIDと共にサーバーに保存します。デバイス識別子はユーザーによって変更される可能性があるため、ユーザーがアプリセッションを生成する際には必ず識別子を更新してください。これにより、サーバー側イベントが正しいデバイスに帰属することが保証されます。
- サーバー側イベントはプラットフォーム固有であるため、デバイスプラットフォームに一致するデバイス識別子（iOSデバイスのIDFAまたはIDFVなど）のみを使用して送信する必要があります。
- Singular 内部 BI ポストバック メカニズムを使用して、内部エンドポイントにリアルタイムでイベントをプッシュすると、サーバー側でデータセットを更新できます。内部 BI ポストバック FAQ を参照してください。
- 詳細については、『サーバー間統合』ガイドの「収益の追跡」セクションを参照してください。
これらのパートナーを有効にする方法の詳細については、以下のリンクを参照してください。
- 詳しくはRevenueCatのドキュメントをご覧ください。
- 詳細はadaptyのドキュメントをご覧ください。