リッチアプリ内イベント—概要

なぜアプリ内イベントを計測すべきですか？

アプリ内イベントはアプリ内で何が起こっているかを知るインサイトを提供し、アプリユーザーの価値とさまざまなメディアソースからもたらされるトラフィックの質を決める重要なツールです。例えば、アプリ内イベントを計測することで、ROI（投資収益率）やLTV（顧客生涯価値）などのKPIを計測できるようになります。

ユーザーが会員登録を実行、チュートリアルを完了、ショッピングカートに商品を追加、購入を行った場合に、アプリ内イベントはそれらのデータを詳細とともに計測します。アプリ内イベントの実装は、インストール後のデータ分析をするために必須です。

アプリ内イベントについて

アプリ内イベントは、イベント名とイベントパラメーターで構成されています。アプリ内イベントにイベントパラメーターを追加した場合、リッチアプリ内イベントと呼ばれます。イベントパラメーターは、発生したイベントに関するより多くのコンテキストと情報を提供します。例えば、ユーザーが予約イベントを実行したという情報はある程度役立ちますが、イベントパラメーターを追加することで、予約の種類、目的地、収益値などの詳細を知ることができます。

既定イベントとカスタムイベント

アプリ内イベントを送信するためには、ディベロッパーがアプリ内で必要なコードを実装する必要があります。イベント名とイベントパラメーターは、以下のように分類されます：

• 既定：これらはさまざまなアプリで使用される一般的なイベント名とイベントパラメーターです。以下のような理由により、できる限り既定のイベント名とイベントパラメーターを使用することを推奨しています：
  • 既定の名前を使用すると、パートナーに自動的にイベントがマッピングされます。
  • もしAppsFlyerがイベント名やイベントパラメーターを変更した場合、実装は下位互換性があります。
• カスタム：これらはアプリ内で発生する特定のユーザーシナリオに対して定義するイベント名とパラメーターです。任意のカスタムイベント名やパラメーターの文字列を使用することができますが、カスタムイベントはディベロッパーにより管理が必要です。ヒントと制限事項を参照してください。

イベントの送信

AppsFlyerにアプリ内イベントを送信するには、いくつかの方法があります。

• AppsFlyer SDK：これはイベントを送信する最も一般的な方法です。AppsFlyerのアプリ内イベントAPIをSDKレベルで使用して、アプリ内のユーザーアクションを記録するリッチアプリ内イベントを送信できます。
• S2S API：サーバー間 (S2S) APIを使用して、モバイルアプリの外部で発生したイベントを直接AppsFlyerに送信します。例えば、Webとアプリの両方のインターフェースを利用しているユーザーがいる場合、Webとアプリからのイベントをそれぞれ記録して、AppsFlyer上で同じユーザーの行動として紐付けることができます。アプリ内イベントだけでなく、Webサイトのイベント、コールセンターのイベント、実店舗での購入など、他のイベントも対象にできます。
• レシート検証：AppleやGoogleなどの決済プラットフォーム側で計測通りにアプリ内購入が行われたことを検証する安全上のメカニズムです。不正な収益イベントの対策のための基本的なツールです。真の収益額を把握し、不完全なアプリ内課金と区別するのにも役立ちます。
• ハイブリッドアプリ：これらのアプリは、ネイティブビューとHTMLコンテンツを組み合わせ、アプリ内イベントの計測もできます。ただし、SDKはネイティブ側からのみ送信できるため、ディベロッパーは全てのイベントをネイティブコードに転送する必要があります。

アプリ内イベントの設定

アプリ内イベントを設定するには、マーケターと開発者が以下のように連携する必要があります。

アプリ内イベントの定義

計測したいアプリ内イベントが決定したら、アプリ内イベント生成ツールを使用して、以下のようにイベントとパラメーターを定義してください。

1. 記録したいシナリオに最適なイベント名を選択してください。
2. イベントに紐づけたいイベントパラメーターを選択してください。イベントに関する追加のコンテキストを提供し、データをより充実させるパラメーターを選択してください。
3. アプリ内イベント生成ツールから完全なファイルをダウンロードして、ディベロッパーと共有してください。

業種別の推奨イベント

以下の表では、業種別に推奨する一般的なアプリ内イベントの例とフローを含む記事へのリンクを提供しています。

業種	記事のタイトル
	ゲームアプリ向けの推奨イベント
	eコマースアプリの推奨イベント
	エンターテイメントアプリ向けの推奨イベント
	金融・銀行アプリ向けの推奨イベント
	P2Pレンディングアプリ向けの推奨イベント
	オンライン教育アプリ向けの推奨イベント
	配車アプリ向けの推奨されるイベント
	フライト予約アプリ向けの推奨イベント
	ホテル予約アプリ向けの推奨イベント
	ヘルスケアアプリの推奨イベント
	情報通信アプリの推奨イベント
	電子ウォレットアプリの推奨イベント
	スポーツベッティングの推奨イベント

アプリ内イベントデータの確認

アプリ内イベントは、インストールをもたらしたメディアソースの成果として紐付けられて計測されます。イベントデータは、顧客生涯価値（LTV）またはアクティビティデータとして表示されます。

アプリ内イベントのデータは、以下の場所で確認できます。

• 管理画面のオーバービューページ：ユーザー獲得（UA）のパフォーマンスのLTVをリアルタイムで表示します。
• イベントページ：メディアソースのアプリ内イベントのLTVパフォーマンスを表示します。
• ローデータアプリ内イベントレポート：アクティビティデータを表示します。つまり、全てのユーザーが実行したアクションを時系列で表示します。このレポートには、イベントパラメーターの値が含まれています。例：

  {
    "af_level":"10",
    "af_score":"3387",
    "arena":"7",
    "char_type":"paladin"
  }

  ローデータレポートはプレミアム機能です。

ヒント

イベント名とパラメーターを追加する際には、以下の点に注意してください。

• ローデータレポートにおいてデータの一貫性を保つために、すべてのプラットフォームで同じアプリ内イベント名と構造を定義し、使用することをお勧めします。
• 最小限のイベント数を使用して、さまざまな媒体からのユーザーの質を簡単に比較できるようにします。
• ユーザーのプライバシーを保護することは重要です。アプリ内イベントの値に直接個人を識別できる情報を入力しないでください。例えば、メールアドレス、名前、ID番号、一部の場所に関する郵便番号などです。制限されているデータについての詳細は、サービスプライバシーポリシーを参照してください。
• AppsFlyerは、エンゲージメント中にデバイスのIPアドレスを収集します。管轄区域または使用シナリオによっては、IPアドレスがPIIと見なされる場合があります。IPアドレスを使用して、デバイスの広い地理的位置（都市、地区レベル）を取得しますが、特定のアドレスは取得しません。必要に応じて、ローデータレポートに表示されないように、IPアドレスをマスクするように選択できます。
• アプリ内イベントはAppsFlyerの収益データの唯一の情報源です。特定の収益値を各イベントに関連付けして、アプリの管理画面に表示できます。収益化パラメーターについてを参照してください。

  

制限事項

イベント名とパラメーターを追加する際には、以下の点に注意してください。

• アプリ内イベントの名前には、小文字の英数字 (a-zと0-9) のみを使用してください。イベント名では、大文字と小文字が区別されます。つまり、af_purchase と af_PURCHASE は2つの異なるイベントとしてローデータに表示されます。ただし、集計レポート（オーバービューやイベント画面など）では、1つのイベントとして表示されることがあります。
• カーディナリティの制限として、1日あたり300個のユニークイベントが設けられています。詳細はこちら
• ユニークユーザーは、アプリのインストール後の最初の100個のイベントに対してのみカウントされます。
• イベント名は以下の文字で始まることはできません："、=、+、-。
• イベント値は1000文字を超えないようにしてください。
• 参照URLをイベント値として含める場合は、URLエンコードする必要があります。
• Facebookでは、イベント名やパラメーターに関する制限を設けています。制限についてこちらを参照してください。

よくある質問

以下のセクションでは、アプリ内イベントに関するさまざまなFAQを掲載しています。

{
  "af_revenue":"50.87",
  "af_currency":"USD",
  "af_receipt_id":"57601333",
  "product":[ 
   { 
	 "af_content_id":"1164_8186",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"1164_8186",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"1164_8186",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"1177_8185",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"0153_9077",
	 "af_price":"14.99",
	 "af_quantity":"1"
   }
  ]
}

"{\"af_content_id\": [\"123\",\"988\",\"399\"], \"af_quantity\": [\"2\",\"1\",\"1\"], \"af_price\": [\"25\",\"50\",\"10\"], \"af_revenue\": \"110\", \"af_currency\": \"USD\"}"