af_revenue is the default parameter for reporting revenue. Revenue sent in af_revenue feeds all revenue metrics across AppsFlyer products (dashboards, LTV, cohort, ROAS, ROI) and is included in postbacks to partners. Always use it with in-app events that represent actual revenue generation in your business logic.

If you also want to report revenue with your own logic applied, for example, after app store fees and tax deductions, you can additionally send af_net_revenue. It is an addition to af_revenue, not a replacement. See Net revenue below.

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

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

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

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

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

af_price は金額に関するパラメーターとして使用できますが、収益にはカウントされません（例：「カートに追加」イベントなど、収益が発生する手前のイベント向け）。 このパラメータは個々のアイテムの価格を示します。 すべての購入の合計金額は、af_revenue パラメータの値にしたがって計上されます。 This parameter refers to the individual item price. The total amount of all purchases appears under the af_revenue parameter.

The af_net_revenue parameter provides an optional, additional way to report revenue when you want to apply your own logic to the revenue amount, for example, revenue after app store fees, tax deductions, gross margin, or service fees.

af_net_revenue does not replace af_revenue. Keep sending af_revenue as usual and add af_net_revenue alongside it when you want net reporting.

• Currency follows af_currency (default USD), similar to af_revenue.
• Since there is no predefined SDK constant for af_net_revenue, you must send it as a custom parameter with the key af_net_revenue.
• Net revenue powers the Net metrics (Net revenue, Net ROI, Net ROAS, Net ARPU, and Net profit) in My Dashboards.

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

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

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

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

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

通貨コンバージョン

ヒント

In your app settings, you set currency to GBP. A user from France purchases a product using your app. The price is quoted in EUR (€). The in-app event that you send to AppsFlyer looks like this:

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);

In this case, AppsFlyer converts revenue from EUR to USD and then to GBP. Let's assume the exchange rate is €1 = $1.13. So €200 becomes $226.85. 次に、AppsFlyerはUSDを GBPに変換します。 為替レートが1ドル＝0.78ポンドと仮定します。 Let's assume the exchange rate is $1 = £0.78. $226.85 は £176.92 になります。

通貨表示について

Currency is set in the app settings. The currency that you set in the app settings, is the currency that appears in the dashboard. No matter what currency you send in-app events, the revenue in the dashboard always appears in the currency that you set in the app settings.

例

Let's say that you send in-app events with different currencies than the one set in the app settings, or with no currency at all. 例えば、アプリ設定で設定した通貨とは異なる通貨で、または通貨を全く設定せずに、アプリ内イベントを送信したとします。 この例では、アプリ設定の通貨はGBPに設定されています。

3つのアプリ内イベントをAppsFlyerに送信します。

1. イベントAは、234の収益が発生、通貨はGBPが設定されています。
2. イベントBの収益額は171で、 通貨はEURです。
3. イベントCの収益額は171ですが、 通貨が指定されていません。

管理画面の収益データ

管理画面に表示される収益データは、アプリ内イベントの通貨からUSDに、その後アプリ設定の通貨に変換された値です。

イベント内で通貨が指定されていない場合は、AppsFlyerはデフォルトでUSDを使用します。 管理画面ではイベントと収益を次のように表示します： The dashboard displays the event and revenue as follows:

ローデータレポートの収益データ

アプリ設定で通貨をGBPに設定し、アプリ内イベントでは異なる通貨を送信した場合、ローデータレポートはアプリ設定とアプリイベントの両方の通貨で収益を表示します。

アプリ設定で通貨をGBPに設定し、アプリ内イベントでは通貨を指定せずに送信した場合、ローデータレポートはアプリ設定と USD の両方の通貨で収益を表示します。

アプリ内イベントのローデータレポートはイベントと収益を、次のように表示します：

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

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

例

Eコマースアプリのマーケティング担当者は、ユーザーが閲覧する商タイプを記録して、どのカテゴリーが最も人気があるかを理解し、商品ページの閲覧と売上を結びつけたいと考えています。

次の表は、マーケティング担当者が開発者に渡すイベント構造の例です：

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

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

アプリ内イベントはユーザーのライフタイム全体を通して、アプリのインストールのきっかけとなったメディアソースに紐づいて計上されます。イベントデータは、顧客生涯価値（LTV）またはアクティビティデータとして提示されます。 

アプリ内イベントデータは以下の場所で確認可能です：

• 管理画面オーバービュー：リアルタイムのLTVユーザー獲得（ユーザー獲得またはUA）パフォーマンスを分析できます。注：これには、アプリ内イベントによってレポートされたオーガニックユーザーと非オーガニックユーザーの間で分けられた収益と、二重アトリビューションロジックに基づいたリターゲティング収益が含まれます。
• アプリ内ベントダッシュボード：メディアソース全体でのLTVアプリ内イベントパフォーマンスを確認できます。
• アクティビティレポート：選択した期間内のアプリ内アクティビティを確認できます。

• アプリ内イベントローデータレポート： アクティビティデータ、つまり、全ユーザー基盤によって行われたアクションの時系列リストを表示します。このレポートには、イベントパラメーターの値が含まれます。 例としては、次の通りです：

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

  Note that raw-data reporting is a premium feature.

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

• 生データレポーティングのデータ一貫性を保つため、すべてのプラットフォームで同じアプリ内イベント名と構造を定義し、使用することをお勧めします。
• 異なるソースから来るユーザーの質を比較しやすくするために、イベントの数を最小限に使用してください。
• ユーザーのプライバシーを確保することが重要です。ユーザーを直接識別できる制限されたデータをアプリ内イベントの値に入力しないでください。例：メールアドレス、名前、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 represents the currency that is stated in af_revenue (or af_price). af_currency は af_revenue（または af_price ）で示される通貨を表します。 イベントのパラメーターに af_currency が存在しない場合、AppsFlyerはデフォルトで「USD」として計測します。 af_revenue パラメーターの詳細については、収益アトリビューションガイドをご覧ください。

If you also want to report revenue with your own logic applied, for example, after fees and taxes, send af_net_revenue as a custom parameter alongside af_revenue. af_net_revenue does not replace af_revenue. For more information, see Net revenue.

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

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

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

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

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

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

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

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

複雑なアプリ内イベントにより、1回のAPI呼び出しで複数のイベントを送信できます。これらは、密接に関連する複数のユーザーアクションをグループ化して表示する場合に便利です（例：1回のセッションで複数の製品をカートに追加する、など）。
例：

To structure a complex in-app event, use af_content as a JSON array. Each object in the array must include id and quantity. af_content_list is optional and can be omitted.

例

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

For full details about sending complex in-app events to Meta, see Send complex in-app events to Meta ads.

Note: In AppsFlyer Audiences, arrays are not supported within event attributes, only numbers or strings.

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

ヒント

同じ取引で、スミス氏は米国のオンラインストアから同一のシャツ2枚、靴1足、帽子を購入します。各アイテムがリストされる順序は、各パラメーターごとに同一である必要があります。

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

複数のアイテムは、ポストバックの配列として送信されます。現状、Meta広告とX広告は配列パラメーターを正しく解析できません。この問題の解決するために、AppsFlyerはアイテム数（af_quantity）を配列としてではなく合計数として これらのSRNに送信します。この例では、Meta広告は af_quantity=4 と受信します。

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

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

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

AppsFlyer retains raw user-level data based on integration type and partner requirements. Aggregated data might be retained for up to five years.

Retention periods can vary across media sources and delivery methods (for example, Data Locker or Pull API), and might change due to legal, contractual, or partner obligations.

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

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