アプリ内イベントの概要

課金・購入や航空券の予約など、アプリ内イベントを計測する際に、関連する売り上げ・収益を計測したい場合があります。 アプリ内イベントで収益を計測できる唯一のパラメータは af_revenue です。

• SDKでの収益計測
• Unityでの収益計測

ユーザーが購入をキャンセルした場合や、 払い戻しを行う際には、 マイナスの収益を計測することもできます。マイナスの収益を記録するには、収益値 af_revenue パラメータにマイナス記号（-）を追加するだけで、ユーザーの収益を累積できます。

原則、実際の収益を生み出すアプリ内イベントで利用してください。

取引がキャンセルされるなどの場合に備えて、キャンセルされた取引などのイベントを記録する必要がある場合、af_revenueは、必要に応じて負の収益値を持つこともできます。

収益の値には、数字（と必要に応じて小数点）だけを含める必要があります ：

• 他の文字や記号を含めたり、収益値を他の方法でフォーマットしたり しないでください。 これにはコンマ、 通貨 記号（例：$）、特殊文字、またはテキストを含めないことが意味されます。
• AppsFlyerは、収益を最大5桁の小数点で提供します。 小数点以下5桁までの精度で提供されます。
• この値の範囲は-1,000,000から1,000,000の間で ドル、またはそれに相当する元の通貨額となります。 ドルまたは相当の通貨額に換算されます。この範囲外の値はローデータレポートで取得できますが、集計レポートでは確認できません。
• 例：1234.56
• 収益を文字列として送信する場合、引用符内の値は有効である必要があります。 例："1234.56"

注：

• 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,"EUR");
AppsFlyerLib.getInstance().trackEvent(getApplicationContext() , AFInAppEventType.PURCHASE , eventValue);

通貨表示について

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

測定するアプリ内イベントを決定した後、アプリ内イベントジェネレーターを利用して、以下のようにイベントとパラメーターを定義します。

1. 記録するシナリオに最も適したイベント名を選びます。
2. イベントに紐付けるイベントパラメーターを選びます。イベントに追加のコンテキストを提供し、データをより充実させるパラメーターを選びます。
3. アプリ内イベントジェネレーターから完成したファイルをダウンロードし、開発者と共有します。

以下の表は、業種ごとに記録することをおすすめするアプリ内イベントの例とフローを含む記事へのリンクです。

業界	参照先ガイド
	ゲームアプリ向け：実装推奨イベント
	Eコマースアプリ向け：実装推奨イベント
	エンターテイメントアプリ向け：実装推奨イベント
	金融・銀行アプリ向け：実装推奨イベント
	P2Pレンディングアプリ向け：実装推奨イベント
	教育アプリ向け：実装推奨イベント
	配車アプリ向け：実装推奨イベント
	航空券予約アプリ向け：実装推奨イベント
	ホテル予約アプリ向け：実装推奨イベント
	ヘルスケアアプリ向け：実装推奨イベント
	通信アプリ向け：実装推奨イベント
	eWalletアプリ向け：実装推奨イベント
	スポーツベッティングアプリ向け：実装推奨イベント

アプリ内イベントはユーザーのライフタイム全体を通して、アプリのインストールのきっかけとなったメディアソースに紐づいて計上されます。イベントデータは、顧客生涯価値（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 はローデータでは別々のイベントとして扱われます。ただし、集計レポートや管理画面（オーバービューやイベントなど）では、小文字しか使用できないため、1つのイベントとして表示できます。
• 1日の固有イベント数には300の上限があります。詳細はこちら
• ユニークユーザーは、アプリインストール後の最初の100件のイベントのみカウントされます。
• イベント名は次の文字で始められません： " = + -
• エンコードされた URL 内または ASCII に従ってエンコードされていない限り、イベント値に + を含めることはできません。
• イベント名に空白を含めることはできません。イベント名の前後には下線（アンダースコア）を使用できます。
• ローデータレポートで短縮されないよう、イベント値は2,000文字を超えないようにしてください。しかし、イベントがSDKから送信されたものである場合、HTTPリクエストでペイロードが切り捨てられないよう1,000文字未満にすることを推奨します。
• イベント値として参照URLを含む場合は、必ずURLエンコードされている必要があります。
• メタ広告には、イベント名とパラメーターに関するいくつかの制限があります。制限についての詳細はこちらをご覧ください。

任意のパラメーター名とイベントで収益値を送信できます。ただし、AppsFlyerのローデータおよび集計データで収益（マイナス収益を含む）を登録するためには、af_revenue パラメーターを使用する必要があります。必ず、実際の収益を生み出すアプリ内イベントで利用してください。

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

af_revenue パラメーターの詳細については、収益アトリビューションガイドをご覧ください。

アプリ内イベントは、アプリインストールの元のメディアソースに紐づけられます。

アプリをインストール（アプリを初回起動）すると、AppsFlyerは様々なアトリビューション方法を用いてインストールのアトリビューションを判断します。同時に、AppsFlyer SDKは、アトリビューションの詳細に紐付けられた新しい一意のAppsFlyer IDを作成します。

アプリ内で同じデバイスによって行われるすべてのその後のアプリ内イベントには、このIDが付与されます。これにより、AppsFlyerはイベントを元のメディアソースにアトリビューションさせることが可能になります。広告主はこれを利用して、アプリ内でのユーザージャーニー全体を追跡できます。

最近リターゲティングされたユーザーのイベントには、二重のアトリビューションが生じる可能性があります。

AppsFlyerは、次の場合にアプリ内ベントをオーガニックとして紐付けます：

• メディアソースの規約によりユーザーレベルのデータを削除する必要がある場合
• ユーザーが端末上のアプリの保存データを削除すると、新しい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"
   }
  ]
}

一つの取引（トランザクション）に複数のアイテムを追加できます。イベントパラメーターごとに単一の値を使用する代わりに、トランザクションを説明するアイテムの配列をコンマで区切って指定できます。形式はJSON文字列である必要があります。

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

アプリ内イベント重複排除メカニズムが適用されます。発火されたすべてのアプリ内イベントを確認し、10秒以内に同じAppsFlyer IDから発生した同一のアプリ内イベントが存在するかどうかをチェックします。そのようなイベントが見つかった場合、仕組みによって重複が削除されます。

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

• Event name
• Event value
• App ID
• AppsFlyer ID

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

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

• Android SDK / iOS SDK：OSパラメータを自動的に追加します。
• S2SモバイルイベントAPI：2021年7月1日以降、iOSアプリのOSパラメータを手動で送信する必要があります。このパラメータを送信しない場合、データはiOS 14.5以降のユーザーと見なされ、ローデータの可用性や媒体へのポストバックに影響します。