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

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

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

購入や航空券の予約などのアプリ内イベントを送信する際には、関連する収益と一緒に送信する必要があります。アプリ内イベントで収益を意味する唯一のパラメーターは、af_revenue です。

• SDKでの収益計測
• マイナスの収益を記録する

購入のキャンセルや返金など、マイナスとなる収益を記録したい場合は、マイナスの収益を送ることができます。マイナスの収益を記録するには、af_revenue に渡す収益値にマイナスの記号（-）を追加してください。

af_revenue は、ユーザーの収益を累積する唯一のパラメーターです。ビジネスロジックに従って、実際に収益が発生するイベントの場合は、常にこのパラメーターを使用してください。

この値の範囲は、$-10,000～$+10,000、または元の通貨金額で同等の値である必要があります。この範囲外の値はローデータレポートに含まれますが、集計レポートには含まれません。 

af_revenue では、キャンセルされたトランザクションや返金などのイベントを記録する必要がある場合は、負の収益値にすることもできます。

注記：

• 収益の値は、書式化しないでください。カンマ区切り、通貨記号、特殊文字、テキストなどは含めないでください。例えば、収益イベントは「1234.56」のように指定してください。AppsFlyerでは、小数点以下5桁までの精度で収益値を設定できます。
• AppsFlyerでは、SDKから送信された正確な収益が表示されます。VAT（付加価値税）やアプリストア手数料などの計算は含まれません。ただし、開発者がAppsFlyerに送信する前にSDK側でそれらを含むようにロジック構築をしている場合を除きます。

af_currency は、af_revenue（または af_price）の通貨単位を示します。イベントパラメーターに af_currency がない場合は、AppsFlyerはデフォルト値である「USD」を送信します。

af_price は金額に関するパラメーターとして使用できますが、収益にはカウントされません（例：「カートに追加」イベントなど向け）。このパラメーターは、個々の商品の価格を示します。すべての購入イベントの合計金額は、af_revenue に従って表示されます。

収益の通貨単位

AppsFlyerが通貨設定と通貨換算をどのように処理するかを理解することは重要です。

AppsFlyerは、通貨換算を使用して、アプリ設定の通貨とアプリ内イベント通貨の差を処理します。

上の図では、次のプロセスを示しています：

1. イベントごとに異なる通貨が設定されているアプリ内イベントが送信されます。
2. AppsFlyerはすべての通貨をUSDに正規化します。
3. AppsFlyerは収益データを処理します。
4. 管理画面の収益データがアプリ設定の通貨で表示されます。
5. AppsFlyerは、ローデータレポートに収益データをイベントとアプリ設定の両方の通貨で記入します。

AppsFlyerは通貨換算にOpen Exchange Ratesを利用しています。この為替レートは一時間ごとに更新されます。AppsFlyerが通貨変換を実行するたびに、最新更新時の為替レートが適用されます。

通貨換算

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.REVENUE,200);
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"category_a");
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"1234567");
eventValue.put(AFInAppEventParameterName.CURRENCY,"USD");
AppsFlyerLib.getInstance().trackEvent(getApplicationContext(), AFInAppEventType.PURCHASE , eventValue);

表示する通貨

通貨はアプリ設定から設定できます。アプリ設定で設定した通貨が、管理画面上で表示される通貨です。アプリ内イベントで送信する通貨に関係なく、管理画面の収益は常にアプリ設定で指定した通貨で表示されます。

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

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

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

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

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

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

• 管理画面のオーバービューページ：リアルタイムのLTVユーザー獲得（UA）パフォーマンスを表示します。注記：これには、アプリ内イベントでレポートされるオーガニックと非オーガニックユーザー別の収益値と、重複計測されたリターゲティング収益が含まれています。
• イベントページ：メディアソースのアプリ内イベントの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では、イベント名やパラメーターに関する制限を設けています。制限についてこちらを参照してください。

任意のパラメーター名とイベントを使用して収益値を送信できます。ただし、収益（マイナスの収益を含む）をAppsFlyerのローデータと集計データに登録するためには、必ず af_revenue パラメーターを使用する必要があります。自身のビジネスロジックに基づいて、実際の収益生成を反映するアプリ内イベントに対して使用してください。

af_currency は、af_revenue（または af_price）の通貨単位を示しています。イベントパラメーターに af_currency がない場合は、AppsFlyerはデフォルト値である「USD」を送信します。

af_revenue パラメーターに関する詳細は、収益の計測ガイドを参照してください。

アプリ内イベントはアプリインストールに紐づく元のメディアソースの成果として計測されます。

アプリがインストール（初回起動）されると、AppsFlyerはさまざまなアトリビューション方法を使用してインストールアトリビューションを決定します。同時に、AppsFlyer SDKは新しい一意のAppsFlyer IDを作成し、これにアトリビューションの詳細を紐づけます。

その後アプリ内の同じデバイスで実行されるアプリ内イベントには、このIDが含まれています。これにより、AppsFlyerはイベントを元のメディアソースに紐づけることができます。広告主はこれを使用してアプリ内での完全なユーザージャーニーを追跡できます。

最近リターゲティングされたユーザーのイベントは重複計測されている可能性があります。

AppsFlyerは、以下の場合、計測されたインストールのイベントをオーガニックと計測します：

• インストール日から24ヵ月以上経っている
• メディアソースの規制によりユーザーレベルデータの削除が求められている
• ユーザーは、デバイスに保存されているアプリのデータを削除し、新しい AppsFlyer ID を強制的に作成した

インターネット接続が利用できないときにユーザーがイベントを開始した場合でも、Appsflyerはそれを記録できます。裏側の仕組み：

1. SDKはイベントをAppsFlyerのサーバーに送信し、正常な応答を待ちます。
2. SDKが正常な応答を受け取らなかった場合、イベントはキャッシュに保存されます。
3. 次に正常な応答を受信されると、保存されていたイベントは再度サーバーに送信されます。
4. キャッシュに複数のイベントがある場合は、それらはイベントを次々にサーバーに送信されます。

複雑なアプリ内イベントは、1回のAPI呼び出しで複数のイベントを送ることができます。

関連性の高い複数のユーザーアクションをまとめてグループ化したい場合に便利です。たとえば、1回のセッション中に複数の商品をバスケットに追加するなどです。
例例：

{
  "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"
   }
  ]
}

1つのトランザクションに複数の商品を追加することができます。イベントパラメーターごとに1つの値を指定する代わりに、カンマ区切りで複数の商品をトランザクションに記述できます。フォーマットはJSON文字列です。

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

Appsにはイベントの重複排除メカニズムがあります。すべてのアプリ内イベントをチェックして、同じ appsflyer_id から10秒以内に発生した同一のアプリ内イベントがあるかどうかを確認します。そのようなイベントが見つかった場合、メカニズムは重複を削除します。

両方のイベントの以下のフィールドが同じ場合、2つのイベントは同一であると見なされます。

• イベント名
• イベント値
• アプリID
• AppsFlyer ID

AppsFlyerでは、法律で別途指示、要求、または許可されている場合を除いて、ユーザーレベルデータ（ローデータ）を24か月間保持します。一部のSRN／パートナーは、AppsFlyerを含むアトリビューションプロバイダーに24か月の期間が終了する前にSRN／パートナーに関するユーザーレベルデータを削除することを要求しています。

削除後、削除されたユーザーに紐づくイベントはオーガニックとして表示されます。過去の集計データは変更されません。詳細は、データ保持と削除に関する義務を参照してください。

• Android SDKとiOS SDKは自動的にOS（オペレーティングシステム）パラメーターを追加します。
• S2S APIに関して、2021年7月以降、iOSアプリに対してOS（オペレーティングシステム）パラメーターを送信する必要があります。このパラメーターを送信しないと、データはiOS 14.5ユーザーのものとみなされ、ローデータの利用方法に影響します。