アプリ内イベント - 概要

購入やフライト予約などのアプリ内イベントを送信するときは、 収益と一緒に送信します。 関連する収益と共に送信されます。収益を伴う唯一のパラメーターは アプリ内イベントで収益を記録するのはaf_revenue

• SDKでの収益記録
• Unityでの収益記録

ユーザーが購入をキャンセルした場合や、 払い戻しを行う際には、 マイナスの収益を記録することもできます。マイナスの収益を記録するには、 必要なのは 収益の値にマイナス記号（-）を追加することです。 これを af_revenueに渡します。

af_revenueは、ユーザーの収益を蓄積する唯一のパラメーターです。 常にアプリ内イベントと組み合わせて使用してください。ビジネスロジックで実際の収益を生み出すために利用します。 実際の収益生成を表すアプリ内イベントには常に使います。

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

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

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

注:

• AppsFlyerは、SDKから送られた正確な収益を表示します。 この収益には VATやアプリストアの手数料は含まれていません。 これらの計算が開発者によってSDKで行われていない限りは、 SDK 側でAppsFlyerに送信されます。

af_currency は 表示 指定された通貨を表します。もしaf_currencyが イベントの パラメーターに含まれていない場合、AppsFlyerはデフォルトの「USD」として送信します。

金銭パラメーターとしてaf_price を使用することができ、 これは収益としてカウントされない （「カートに追加」イベントなど）。 このパラメーターは 個々の項目の価格を示します。すべての購入の 総額は af_revenueパラメーターに表示されます。

広告主は予測収益を使用してキャンペーンを最適化し、 ユーザーのライフサイクルの早い段階で潜在的なユーザー価値を予測します。 予測収益は ユーザーの過去の行動とインタラクションに基づいて計算されます。注: アドネットワークがサポートしているかどうかを確認するには、AppsFlyerサポートにお問い合わせください。 予測収益。

予測収益はどのように報告するべきか AppsFlyer?

AppsFlyerに予測収益を報告する場合、それは ドル、またはそれに相当する元の通貨額となります。 実際の収益を含むイベントとは別に されるべきです。広告主は次の点を確認してください：

• 実際の収益のあるイベントと 予測収益のイベントは 別個に 報告されます。
• 予測収益データはイベントの値に含まれています。 例えば、 例：

      "event_value": {
          "af_projected_revenue": 0.79
      }

AppsFlyer管理画面とレポートに表示される予測収益

• 予測収益は含まれていません 総収益の計算または 指標 AppsFlyer管理画面に表示されます。これにより、管理画面は 実際に稼いだ収益のみを反映します。 実際に稼いだ収益のみを反映します。
• ローデータでは予測収益は報告されず、 専用の フィールド としてではなく利用可能です イベント内の 値に含まれます。 広告主から送信された収益額を含むイベントの値に含まれます。

予測収益ポストバックを送信する

予測収益ポストバックをアドネットワークに送信する方法の詳細については、 参照 プロジェクトの収益を共有する。

AppsFlyerが通貨設定をどのように処理するか、及び通貨コンバージョンを理解することが重要です。 と通貨コンバージョン。

AppsFlyerはアプリ設定の通貨とアプリ内イベントの通貨の違いを通貨コンバージョンを使用して処理します。 別個に 通貨変換機能を使用するアプリ内イベント通貨

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

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

AppsFlyerは オープン為替レート 通貨コンバージョン用に使用します。為替レートは毎時更新されます。 基づいています。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にとって唯一の収益データのソースです。各イベントに特定の収益値を関連付けて、アプリの管理画面で表示できます。収益化パラメーターについて、詳細はこちらをご覧ください。altrevenue_data.pngalt

イベント名やパラメーターをアプリで定義する際には次の点に注意してください。

• アプリ内イベント名には、小文字の英数字（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は、次の場合に、アトリビュートされたインストールのイベントをオーガニックとしてアトリビュートします。

• インストール日から24ヶ月以上経過した場合
• メディアソースの規約によりユーザーレベルのデータを削除する必要がある場合
• ユーザーが端末上のアプリの保存データを削除すると、新しいAppsFlyer IDの作成が強制的に行われます。

インターネット接続が利用できないときにユーザーがイベントを開始しても、AppsFlyerはそれを記録します。仕組みは以下のとおりです。

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

複雑なアプリ内イベントにより、1回のAPI呼び出しで複数のイベントを送信できます。

これらは、密接に関連する複数のユーザーアクションをグループ化して表示する場合に便利です（例えば、1回のセッションで複数の製品をバスケットに追加するなど）。
1234.56

{
  "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つのイベントは同一と見なされます。

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

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

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

• Android SDKとiOS SDKは、OS(オペレーティングシステム)パラメータを自動的に追加します。
• S2S APIでは、2021年7月1日以降、iOSアプリのOS(オペレーティングシステム)パラメータを送信する必要があります。このパラメータを送信しない場合、データはiOS 14.5ユーザーからのものと見なされ、ローデータが利用可能になる方法に影響します。