アプリ内イベントを追跡する方法

特異な出来事 学習パス

 

アプリで適切なアプリ内イベントをトラッキングすることで、組織にとって重要なKPIを通じて組織のマーケティング活動の成功を測定することができます。

このガイドは、グロースプランを新規にご利用のお客様に適用されます。その他のお客様の場合、イベントは自動的にイベントページに追加されないため、プロセスは若干異なります(下記のステップ5をご参照ください)。この機能はすべてのお客様に展開されます。

ガイド マーケティングおよびユーザー獲得チーム
前提条件

アトリビューションパートナー(MMP)としてSingularを使用してください。

イベントをトラッキングするには

  1. トラッキングしたいイベントを選択します。
  2. 開発者にSingular SDKまたはS2S統合のコードをアプリに組み込んでもらい、選択したイベントを発生時に送信してもらいます。
  3. Singularプラットフォームの設定 > イベント ページにイベントが表示されるようにします。

events1.jpg

詳しい手順は以下のガイドに従ってください。

1

イベントのリストを定義する

測定したいKPIを考え、その測定に役立つアプリ内イベントをリストアップします。

Singularに自動的にインポートされるため、可能な限りこれらの標準イベントを使用することをお勧めします。

例えば、Eコマースアプリの場合、Product View、Add To Cart、Checkoutなどのイベントを実装することをお勧めします。

(オプション)必要に応じてカスタムイベントを追加する

アプリのコンテンツやマーケティングのニーズによっては、Singularの標準イベントにマッピングしにくいアプリ内イベントをトラッキングしたい場合があります。 その場合は、独自のカスタムイベントを定義できます。

カスタムイベントをSingularレポートで測定するには、Singularで手動で設定する必要があります。広告ネットワークによって、最適化に使用できる場合とできない場合があります。

注意:カスタムイベントを定義する場合でも、可能な限り標準属性を使用してイベントと一緒にデータを渡すことをお勧めします。そうすることで、広告ネットワークがあなたの属性をレポートしやすくなります。近い将来、標準属性もSingularによってレポートされるようになります。

2

SDKインテグレーションにイベントを実装する

Singular SDKインテグレーションに組み込むイベントと属性のリストを開発チームに渡しましょう。

目標は、あなたのアプリが選択したすべてのイベントをSingularサーバーに報告することです:

  1. Singularが情報を集計・分析します。
  2. Singularはあなたのアプリで発生したイベントについて広告ネットワークに自動ポストバックを送信します。ポストバックFAQをご覧ください。
どのイベントがビルトインで常に実装されていますか?

Singular SDKやS2Sをアプリに統合するとSingularはいくつかのタイプのアプリ内イベントを自動的にトラッキングします。

これらのビルトインイベントは以下のように表示されます:

サポートされる組み込みイベント

イベント名 説明 追跡されるタイミング
START__ インストール 最初のセッションがSDK/S2Sインテグレーションを通じて送信されたときに自動的にトラッキングされます。
セッション セッション SDK/S2Sとの連携でセッションが送信されると自動的に追跡されます。
iap__ SDK収益 SDK/S2Sインテグレーションが収益メソッドを通して収益イベントを報告している場合にトラッキングされます。
__REVENUE__ 任意の収益

何らかの収益が報告された場合などにトラッキングされます:

  • iap__イベントが発生した場合
  • SDKが広告収益イベントを報告している場合
  • S2S経由で"purchase "のようなイベント名で収益を報告している場合。
  • 払い戻し」や「オフライン購入」など、他の収益イベントを報告している場合

注: すでに__iap__や他の収益イベントのポストバックを送信している場合、重複した収益を報告してしまう可能性があるため、このイベントのポストバックを送信することはお勧めしません。

アンインストール アンインストール iOSまたはAndroidアプリでアンインストールが有効になっており、少なくとも1つのアンインストールが追跡されている場合、自動的に追跡されます。デバイスのアンインストールが検出されると、1 日に 1 回トリガーされます。
再インストール 再インストール SDK/S2Sでアンインストールが有効になっている場合、自動的に追跡されます。デバイスの__UNINSTALL__が追跡され、その後__SESSION__がトリガーされると、__REINSTALL__イベントもトリガーされます。

該当するSDK/S2Sのイベント実装ガイドを使用してください。 ガイドでは、標準イベントとカスタムイベント(使用する場合)の両方の実装方法を説明しています。

SDKごとのイベント実装ガイド

iOS SDKとの統合 Singular S2Sとの統合: イベントのトラッキング
Android SDK:イベントと収益のトラッキング Flutterインテグレーション
Unity SDK:イベントと収益のトラッキング mParticleの統合
React Native SDK:イベントと収益のトラッキング セグメントSDKの統合
アンリアル エンジン SDK:イベントと収益のトラッキング セグメントS2Sインテグレーション

注: 標準のイベント/属性名は、プラットフォームごとに多少異なる場合があります。例えば、エンティティ名に関するプラットフォームのガイドラインによって、sng_login の代わりに sngLogin となります。各SDKのガイドは、特定のプラットフォームで利用可能な標準イベントの最新リストと、コードに表示する必要があるそれらの名前にリンクしています。

3

Singular Platformでイベントを確認する

設定 > イベントページでイベントを定義し、集計レポートでイベントを確認します。

アプリが標準イベントをSingularに送信し始めると、それらは自動的にイベントページに追加されます。 SDKの各イベントに対して、SingularはユニークイベントとユニークでないイベントをUIに作成します。下記の「イベントUIを理解する」を参照してください。

注意: イベントを削除した場合、Singularは自動的に再追加しませんが、手動でいつでも再追加できます。

 

コホートイベントUIを理解する

コホートイベントタブには、自動的に追加されたイベントの折りたたまれたリストが表示されます。イベントを展開すると、そのプロパティが表示されます。

events3.png

  1. 名前と折りたたみアイコン: ここで指定した名前がレポートUIに表示されます。
  2. ユニーク・イベント・フィルタ:このトグルは、MMPからのユニーク・イベントと非ユニーク・イベントのどちらを集計対象とするかを変更します。イベント測定を理解する - ユニーク」を参照してください。
  3. データソース:Singularまたは広告ネットワークから、このイベントに集約するイベントを選択します。複数のイベントを1つに集約できます。イベントは保存後、ロックされます。
  4. 計算されたメトリクスを追加します: CPEと ECVRに関するFAQをご覧ください。
  5. イベントを削除します:イベント・ページには12個のイベント*が表示されます。
  6. 変更を保存]ボタンと[変更をキャンセル]ボタン
  7. イベント履歴

*注:12イベントまでという制限のため、Singularはお客様のSDKイベントに最大6つのユニークバージョンと6つの非ユニークバージョンを自動的に追加します。 エンタープライズのお客様は12イベントまでという制限はありません。

一旦コホートイベントが保存されると、追加されたSDKイベントは編集できません。イベントの横にあるロックアイコンに注目してください。SDKイベントを追加して同じコホートイベントに集約することは可能です。

コンバージョンイベントUIを理解する

コンバージョンイベントタブには、広告パートナーからのイベントが折りたたまれた状態で表示されます。イベントを展開すると、そのプロパティが表示されます。

events4.png

  1. 名前と折りたたみアイコン: ここで指定した名前がレポートUIに表示されます。
  2. データソース:このイベントに集約する広告ネットワークからのイベントを選択します。複数のイベントを1つに集約できます。これらのイベントは自由に編集できます。
  3. 計算メトリクスの追加: CPEおよびECVRに関するFAQを参照してください。
  4. イベントを削除します:コンバージョンイベントページには、無制限にイベントを追加できます。
  5. 変更の保存と キャンセルのボタン
  6. イベント履歴

*注:コホート・イベントとは異なり、設定されたコンバージョン・イベントには制限がなく、自由に編集することができます。各イベントの横にある "x "アイコンに注目してください。

カスタムイベントを手動で追加する

SDKがカスタムイベントをSingularに送信する場合、それらは自動的にイベントページに追加されません。新規イベントをクリックしてイベントの詳細を定義し、手動で追加する必要があります。