ROI360ストア収益について

プレミアム機能

概要: ROI360ストア収益を使用することで、アプリ内課金およびサブスクリプションの検証、重複計測の防止、ネット収益の算出を行えます。 

ROI360ストア収益は、AppsFlyerが提供するプレミアムソリューションであり、アプリ内課金およびサブスクリプション収益を完全かつ正確に計測できます。これにより、顧客ライフサイクル全体を包括的に把握し、広告費用対効果(ROAS)を正確に計測できます。

機能 詳細
収益計測範囲
  • App Store Connect(iOS)およびGoogle Play Console(Android)で管理される、すべてのアプリ内課金商品およびサブスクリプション収益
  • 払い戻し
  • 保留中および遅延トランザクションによる収益(Android)
  • アプリ内外で発生するサブスクリプション関連イベント
  • ストア手数料および税金を考慮したネット収益
収益検証と精度 本ソリューションでは、重複トランザクションの記録を防止します。iOSでは、ファミリー共有による重複計測も防止されます。また、ROI360ストア収益はApple App Storeのトランザクションデータを広告主へ直接転送できます。
データソース
  • AndroidおよびiOS向けAppsFlyer Purchase SDK Connector
  • App Store Server Notifications
  • Google Play Real-Time Developer Notifications(RTDN)
レポートおよびデータ利用 収益データはAppsFlyerのダッシュボードおよびレポートで利用でき、ポストバックを通じてパートナーと共有することも可能です。

注意

ROI360ストア収益を使用する場合、アプリ内課金イベントを別途送信しないでください。重複した収益計測が発生します。

ROI360ストア収益の仕組み

  1. ユーザーがアプリ内課金、または自動更新型サブスクリプションを購入します。
  2. アプリがアプリストア上でトランザクションを実行します。
  3. AppsFlyer Purchase SDK Connectorが購入を自動検知し、検証および記録のためにペイロードをAppsFlyerへ送信します。
  4. AppsFlyerが対象ストアに対して購入内容を検証し、不正な取引ではないことを確認します。
    • 検証に成功すると、AppsFlyerが購入またはサブスクリプションイベントをアプリ内イベントとして記録します。
    • レシート検証に失敗した場合、そのイベントは「ブロック済みアプリ内イベントのローデータレポート」(Protect360契約者向け)および「Live Events Viewer」ページに、af_validated = false パラメータ付きで表示されます。
  5. AppsFlyerは検証結果をSDK Connectorへ返却し、SDK Connectorがその結果(成功または失敗)をアプリへ返します。
  6. アプリストアから送信されるサーバー通知も、AppsFlyerの購入・サブスクリプション収益ロジックによって処理されます。
    • SDK Connector経由ですでに報告済みのトランザクションに関する通知は、検証・処理されたうえで、購入イベントまたはライフサイクルイベントとして内部的に生成されます。
    • 未知のトランザクションに関する通知は破棄されます。
    • iOSでは、すべてのサーバー通知を自社サーバーへリルーティングすることも可能です。

ROI360ストア収益の有効化

ROI360ストア収益の計測を有効化するには、以下の手順を実施してください。

  1. AppsFlyer のサイドメニューから settings-roi.png 設定  を開き、ROI360 配下の 収益設定 を選択します。
  2. 購入とサブスクリプションのタブを開きます。
  3. 1.プロダクトタイプの選択で、 ROI360を選択します。
  4. 「次へ」をクリックして続行してください。

ROI360ストア収益の設定

詳細は、「ROI360ストア収益の設定」の記事を参照してください。

リファレンス

以下のセクションでは、ROI360のアプリ内課金(IAP)およびサブスクリプション収益計測に関する主要な仕様について説明します。これには、IAPおよびサブスクリプションイベント用のイベント・パラメータ、グロス収益からネット収益への換算をサポートする「Net Revenue」、およびROI360 IAP/サブスクリプション収益計測ソリューションの全体的な仕様や制限事項が含まれます。

 注意

アプリ内イベントとあわせて追加のカスタムパラメータを送信したい場合は、Purchase SDK ConnectorCustom Data Sourceを設定してください。これにより、独自のビジネスロジックやメタデータを使用して、購入イベントやサブスクリプションイベントを拡張できます。
これらのパラメータは、ローデータレポートの custom_data フィールドで利用できます。

アプリ内購入関連のイベントとパラメータ

以下のセクションでは、AppsFlyerが計測するIAP(アプリ内課金)関連イベントと、各イベントで記録されるパラメータについて説明します。各パラメータの詳細は、「イベントパラメータ一覧」を参照してください。

生成されるすべてのイベントには、以下の特性があります。

  • サーバー間通信(S2S)イベントとして送信されます。。

  • ローデータレポートでは、オーガニックまたは非オーガニックのアプリ内イベントとして利用でき、Revenue ETL Storesレポートにも含まれます。

  • ポストバック経由でパートナーへ送信されます。

  • SKAN Conversion Studioに対応しています。

購入 (af_purchase)

説明

ユーザーが購入を行った際に記録されます。

パラメーター

  • app_id
  • customer_user_id
  • af_currency
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_revenue
  • af_net_revenue
  • af_net_revenue_tax_name
  • af_net_revenue_tax_rate
  • af_net_revenue_tax_exclusive
  • af_net_revenue_country
  • af_net_revenue_subdivision
  • af_net_revenue_postal_code
  • af_net_revenue_factors

無料購入(af_purchase_free)

説明

収益金額が発生しない購入が行われた際に記録されます。すべての収益関連パラメータは 0 として表示されます。

パラメーター 

  • app_id
  • customer_user_id
  • af_currency
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_revenue
  • af_net_revenue
  • af_net_revenue_tax_name
  • af_net_revenue_tax_rate
  • af_net_revenue_tax_exclusive
  • af_net_revenue_country
  • af_net_revenue_subdivision
  • af_net_revenue_postal_code
  • af_net_revenue_factors

購入キャンセル(af_purchase_canceled)

説明

ユーザーが購入をキャンセルした際に記録されます。

パラメーター 

  • app_id
  • customer_user_id
  • af_currency
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment

購入保留(af_purchase_pending)

説明

ユーザーが購入を行ったものの、支払い処理がまだ完了していない場合に記録されます。

パラメーター 

  • app_id
  • customer_user_id
  • af_currency
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment

払い戻し(af_purchase_refund)

説明

購入が払い戻し(返金)された際に記録されます。

パラメーター 

  • app_id
  • customer_user_id
  • af_currency
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_discount_type
  • event_revenue_usd
  • event_revenue(収益が0を超える場合にのみイベントへ含まれます)
  • store_commission
  • af_revenue
  • af_net_revenue
  • af_net_revenue_factors
  • af_net_revenue_tax_name
  • af_net_revenue_tax_rate
  • af_net_revenue_tax_exclusive
  • af_net_revenue_country
  • af_net_revenue_subdivision
  • af_net_revenue_postal_code

テスト購入(af_purchase_sandbox_sdk)

説明

Sandbox環境において、SDK経由で記録された購入テスト時に記録されます。

パラメーター 

  • app_id
  • customer_user_id
  • af_currency
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_purchase_state
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_net
  • af_sandbox_revenue

テスト購入(af_purchase_sandbox_s2s)

説明

Sandbox環境において、S2S経由で報告された購入テスト時に記録されます。

パラメーター 

  • app_id
  • customer_user_id
  • af_currency
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_purchase_state
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_net
  • af_sandbox_revenue

サブスクリプション関連イベントとパラメータ

以下のセクションでは、AppsFlyerが計測するサブスクリプション関連イベントと、各イベントで記録されるパラメータについて説明します。含まれているパラメーターの説明については、イベントパラメーター一覧を参照してください。

生成されるすべてのイベントは、以下の特性を持ちます:

  • S2S(サーバー間通信)イベントとして扱われます。
  • ローデータレポート上で利用できます(オーガニック/非オーガニックのアプリ内イベントとして表示されます)。
  • ポストバック経由でパートナーへ送信できます。
  • SKAN Conversion Studioで利用できます。

注意:ユーザーデバイスのプラットフォームによっては、一部のパラメータがアプリ内イベントに含まれない場合があります。

トライアル開始(af_ars_trial_started)

説明

サブスクライバーがトライアル期間を開始した際に記録されます。

パラメーター 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type

トライアルキャンセル (af_ars_trial_cancelled)

説明

サブスクライバーがトライアル期間中にサブスクリプションの自動更新をキャンセルした際に記録されます。ユーザーがトライアル期間内に自動更新を再開しなかった場合、その後離脱イベントが発生します。

パラメーター 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type

トライアル離脱 (af_ars_trial_churned)

説明

サブスクライバーがトライアル期間終了後に離脱(Churn)した際に記録されます。これは、自動更新キャンセル後にトライアル期間が終了した場合に発生します。また、更新時の請求エラーや技術的問題によって離脱に至った場合にも発生します。

パラメーター 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type
  • af_reason

トライアル後の有料転換 (af_ars_trial_converted)

説明

トライアル期間終了後に、通常価格での更新が開始(有料ユーザーへ転換)された際に記録されます。 

パラメーター 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type
  • af_discount_id
  • af_discount_type
  • event_revenue_usd
  • store_commission
  • af_revenue(収益が0を超える場合のみイベントに含まれます)
  • af_net_revenue
  • af_net_revenue_factors
  • af_net_revenue_tax_name
  • af_net_revenue_tax_rate
  • af_net_revenue_tax_exclusive
  • af_net_revenue_country
  • af_net_revenue_subdivision
  • af_net_revenue_postal_code

サブスクリプション開始(af_ars_subscription_started)

説明

割引価格または通常価格のサブスクリプションが開始された際に記録されます。

注意:

  • 新規サブスクリプションはSDK Connector経由でのみ記録できます。
  • iOSでは、サブスクライバーがすでに所有しているサブスクリプションを再購入した場合、SDK Connectorはアプリへ正常なレシート検証結果を返しますが、AppsFlyer上では新しいトランザクションとして記録されません。

パラメーター 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type
  • af_discount_id
  • af_discount_type
  • event_revenue_usd
  • event_revenue(収益が0を超える場合にのみイベントへ含まれます)
  • store_commission
  • af_revenue
  • af_net_revenue
  • af_net_revenue_factors
  • af_net_revenue_tax_name
  • af_net_revenue_tax_rate
  • af_net_revenue_tax_exclusive
  • af_net_revenue_country
  • af_net_revenue_subdivision
  • af_net_revenue_postal_code

サブスクリプションキャンセル(af_ars_subscription_cancelled)

説明

自動更新型サブスクリプションが、請求期間の途中でキャンセルされた際に記録されます。ユーザーが同一請求期間内に自動更新を再開しなかった場合、その後離脱イベントが発生します。

パラメーター 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type

サブスクリプション一時停止 (af_ars_subscription_paused) - Androidのみ

説明

ユーザーが有効なサブスクリプションを一時停止した際に記録されます。

パラメーター 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type

サブスクリプション再開 (af_ars_subscription_resumed)

説明

解約または払い戻し後に、通常価格のサブスクリプションが再開された際に記録されます。

パラメーター 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type
  • af_discount_id
  • af_discount_type
  • af_reason
  • event_revenue(event revenueが0を超える場合のみイベントに含まれます)
  • store_commission
  • af_revenue
  • af_net_revenue
  • af_net_revenue_factors

サブスクリプション離脱(af_ars_subscription_churned)

説明

サブスクライバーが離脱(Churn)した際に記録されます。通常は、自動更新キャンセル後または請求期間終了後に発生します。また、更新時の請求エラーや技術的問題によって離脱に至った場合にも発生します。

パラメーター 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type
  • af_reason

サブスクリプションの払い戻し (af_ars_subscription_refunded)

説明

サブスクライバーへ払い戻しが行われた際に記録されます。

注意:

  • このイベントは通常、マイナス値の収益として生成されます。どのトランザクションが払い戻し対象か判別できない場合、または通知に払い戻し詳細が含まれていない場合、払い戻しイベントには収益値が含まれません。

パラメーター 

  • app_id
  • customer_user_id
  • af_reason
  • af_subscription_ownership_type
  • af_discount_id
  • af_discount_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_refunded_transaction_ids
  • event_revenue_usd
  • event_revenue(収益が0を超える場合にのみイベントへ含まれます)
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_store
  • af_environment
  • af_period_type
  • store_commission
  • af_revenue
  • af_net_revenue
  • af_net_revenue_factors
  • af_net_revenue_tax_name
  • af_net_revenue_tax_rate
  • af_net_revenue_tax_exclusive
  • af_net_revenue_country
  • af_net_revenue_subdivision
  • af_net_revenue_postal_code

サブスクリプション請求の猶予 (af_ars_subscription_billing_grace)

説明

請求エラーによってサブスクリプション更新に失敗し、サブスクライバーが請求の猶予期間へ移行した際に記録されます。

パラメーター 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type

サブスクリプション更新 (af_ars_subscription_renewed)

説明

自動更新型サブスクリプションが更新された際に記録されます。

パラメーター 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type
  • af_discount_id
  • af_discount_type
  • event_revenue_usd
  • event_revenue(収益が0を超える場合にのみイベントへ含まれます)
  • store_commission
  • af_revenue
  • af_net_revenue
  • af_net_revenue_factors

サブスクリプション変更 (af_ars_subscription_xgraded)

説明

サブスクライバーが別プランへアップグレード、ダウングレード、またはクロスグレードした際に記録されます。

パラメーター 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type
  • af_discount_id
  • af_discount_type
  • event_revenue_usd
  • event_revenue(収益が0を超える場合にのみイベントへ含まれます)
  • store_commission
  • af_revenue
  • af_net_revenue
  • af_net_revenue_factors

既存のサブスクライバー (af_ars_existing_subscriber)

説明

SDK Connectorが、請求サイクル途中の既存サブスクライバー情報を受信した際に記録されます。その後、別のライフサイクルステージへ移行するサーバー通知が続いて送信されます。このイベントは通常、オンボーディング期間やSDK Connector導入初期に生成されます。

パラメーター 

  • app_id
  • customer_user_id
  • country
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type
  • af_cuids
  • af_validated

テスト購入(af_ars_sandbox_sdk)

説明

Sandbox環境において、SDK経由で記録された購入テスト時に記録されます。

パラメーター 

  • app_id
  • customer_user_id
  • country
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_discount_id
  • af_discount_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type
  • af_cuids
  • af_validated
  • af_net
  • af_sandbox_revenue

テスト購入(af_ars_sandbox_s2s)

説明

Sandbox環境において、S2S経由で報告された購入テスト時に記録されます。

パラメーター 

  • app_id
  • customer_user_id
  • country
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_discount_id
  • af_discount_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type
  • af_cuids
  • af_validated
  • af_net
  • af_sandbox_revenue

パラメーター一覧

アプリ内購入およびサブスクリプションイベント用のパラメータは、ローデータレポート上で独立したカラムとして表示されるか、またはEvent Value内に格納されて表示されます。

独立したカラムとして表示されるパラメータは以下の通りです。

  • app_id
  • customer_user_id
  • country_code
  • af_currency
  • event_revenue_usd
  • af_revenue
  • android_id
  • ip
  • idfa
  • appsflyer_id

これらのパラメータの詳細については、「データフィールド一覧」を参照してください。

以下の表では、ARSおよびVIAPイベントで利用可能なローデータパラメータについて説明します。

パラメータ 備考 対象
af_cancelation_date_ms キャンセル日時 アプリ内購入
af_cuids
  • ARSにおいて、このパラメータにはすべてのCUIDを含む配列が格納されます。
  • このCUID配列はデバイスIDに依存せず表示されるため、同じCUIDが複数のデバイスIDに対して表示される場合があります。
サブスクリプション
af_discount_id 初回購入時にユーザーへ提示されたオファーID。割引コードが存在する場合のみ値が設定されます。
  • アプリ内購入
  • サブスクリプション
af_discount_type

ユーザーが利用した割引タイプ。想定される値:

  • iOS
    • introductory(初回購入・初回契約向けの割引)
    • promotional(プロモーション用の割引)
    • offer_codes(オファーコードによる割引)
    • win_back(解約ユーザーの復帰を目的とした割引)
  • Android
    • intro price(初回価格・導入価格の割引)
    • one_time_code(ワンタイムコード)
    • vanity_code(カスタム/任意文字列の割引コード)
サブスクリプション
af_environment データ送信元の環境。production または sandbox。
  • アプリ内購入
  • サブスクリプション
af_expires_date_ms 現在のサブスクリプション請求サイクルの有効期限 サブスクリプション
af_net_revenue すべての要因を考慮して算出されたネット収益。詳細は af_net_revenue_factors を参照してください。
  • アプリ内購入
  • サブスクリプション
af_net_revenue_country
  • 税率適用対象のISO 2文字国コード
  • 例:CA
  • 注意:英国については、GBではなくUKが使用されます。
  • アプリ内購入
  • サブスクリプション
af_net_revenue_factors
  • af_net_revenue 算出時に考慮された要因を示す配列。
  • 例:store_commission
  • アプリ内購入
  • サブスクリプション
af_net_revenue_postal_code
  • 英数字で構成される郵便番号。
  • 例:L4J8E3
  • アプリ内購入
  • サブスクリプション
af_net_revenue_subdivision
  • 一部の国では州や地域区分が存在し、ISO 3166-2コードに基づいて処理されます。
  • 国コードおよび地域コードを含みます。
  • 例:US-CA
  • アプリ内購入
  • サブスクリプション
af_net_revenue_tax_exclusive
  • Boolean値(true / false)。
  • false:税額が総収益に含まれます。
  • true:税額が総収益とは別に加算されます。
  • アプリ内購入
  • サブスクリプション
af_net_revenue_tax_name
  • 顧客請求書に表示される税種別名。
  • 例:Sales, VAT, GST
  • アプリ内購入
  • サブスクリプション
af_net_revenue_tax_rate
  • 徴収された税率。小数点以下4桁まで。
  • 例:7.25
  • アプリ内購入
  • サブスクリプション
af_offer_id
  • トランザクションに適用されたオファーID(割引・プロモーション等)。
  • Androidのみ
  • アプリ内購入
  • サブスクリプション
af_order_id
  • トランザクションの注文ID。
  • Androidのみ
  • アプリ内購入
  • サブスクリプション
af_original_transaction_id
  • 元のトランザクションID。
  • iOSのみ
  • アプリ内購入
  • サブスクリプション
af_original_transaction_id
  • 元のトランザクションID。
  • iOSのみ
  • アプリ内購入
  • サブスクリプション
af_period_type
  • サブスクリプションまたはトライアル期間の種類。
  • 想定される値:
    • trial
    • intro
    • normal
サブスクリプション
af_product_id サブスクリプション商品ID
  • アプリ内購入
  • サブスクリプション
af_purchase_date_ms 対象商品IDに紐づくアプリ内イベントの購入日時
  • アプリ内購入
  • サブスクリプション
af_purchase_option_id
  • トランザクションに関連付けられた購入オプションID。
  • Androidのみ
アプリ内購入
af_purchase_option_type

トランザクションの購入オプションタイプ。可能な値(Android):

  • buy
  • rent
アプリ内購入
af_purchase_state

可能な値:

  • Purchased(購入済み)
  • Canceled(キャンセル)
  • Pending(保留中)
アプリ内購入
af_purchase_token
  • トランザクションの購入トークン。
  • Androidのみ
  • アプリ内購入
  • サブスクリプション
af_reason [内容変更なし]
  • アプリ内購入
  • サブスクリプション
af_refunded_transaction_ids
  • 払い戻し対象となったトランザクションID配列。
  • iOSのみ
  • アプリ内購入
  • サブスクリプション
af_store サブスクリプション商品を購入したアプリストア
  • アプリ内購入
  • サブスクリプション
af_subscription_ownership_type FAMILY_SHARED:ファミリー共有経由で利用している状態。PURCHASED:購入者本人が課金した状態。 サブスクリプション
af_transaction_id
  • トランザクションID。
  • iOSのみ
  • アプリ内購入
  • サブスクリプション
store_commission
  • 購入商品に対してストアが取得する手数料率。
  • 小数値で表示されます。
  • 例:30
  • アプリ内購入
  • サブスクリプション

ネット収益

ネット収益は、AppsFlyerのアプリ内課金およびサブスクリプション収益ソリューション向けに構築されたビジネスロジックレイヤーです。受信した各トランザクションに対して、リアルタイムでネット収益を自動計算し、レポートへ反映します。

注意

ネット収益はローデータレポート上で利用でき、リアルタイムのアプリ内イベントポストバックでも送信可能です。一方、ダッシュボード上では購入およびサブスクリプションのグロス収益のみ表示されます。

ポストバックでネット収益を送信するには、アプリ内イベント設定で「値、収益、ネット収益」の送信オプションを設定してください。詳細については、アプリ内イベントのポストバック設定を参照してください。

ヒント

アプリ内イベントポストバック設定では、標準のマネタリーパラメータ$$sdk(monetary))にグロス収益の代わりとしてネット収益を送信することも可能です。この設定を利用するには、Customer Success Manager(CSM)へお問い合わせください。

ネット集計では、グロス収益からネット収益を算出する際、以下の要素を考慮します。

  • ストア手数料
    • ストア手数料は自動計算・レポートされるため、追加設定は不要です。
    • アプリ内購入(IAP)の場合、デフォルトのストア手数料率はストアフロントによって異なります。
      • App Store — 日本:26% / 中華圏:25% / その他の地域:30%
      • Google Playストア:30%
    • サブスクリプションの場合、手数料率はサブスクライバーの継続期間に応じて自動計算されます。 
      • App Store — 最初の12ヶ月間:日本:26% / 中華圏:25% / その他の地域:30%13ヶ月以降:日本:15% / 中国圏:12% / その他の地域:15%
      • Google Playストア:初日から15%
    • 関連するネット収益のパラメータは、ローデータレポート上で利用できます。
    • デフォルトとは異なるストア手数料率を使用したい場合は、「Net Revenue API」を利用してください。たとえば、Apple Small Business Programに参加している場合、手数料率は15%(中華圏では12%)となるため、この設定が有効です。
  • 税金
    • ROI360で計測されるすべてのトランザクションでは、デフォルトの税率設定に基づき税額がレポートされます。
    • これは、税額込み価格(tax-inclusive)の国に適用されます。たとえば英国では、AppsFlyerは税額およびストア手数料を差し引いてネット収益を算出します。一方、米国のような税額別(tax-exclusive)の国では、表示価格に税額が含まれないため、収益およびネット収益パラメータにはデフォルトで税額が含まれません。
    • これらの設定は「Net Revenue API」で変更可能です。サポート対象国およびデフォルト税率については、このJSONファイルを参照してください。開発者はそのまま利用することも、編集してAPIへ適用することもできます。

レポート上でNet Revenueを確認する場合、以下のパラメータにNet Revenue情報が含まれます。詳細は、パラメーター一覧を参照してください。

パラメータ ネット収益要因
store_commission ストア手数料
af_net_revenue_tax_name 税金
af_net_revenue_tax_rate 税金
af_net_revenue_tax_exclusive 税金
af_net_revenue_postal_code 税金
af_net_revenue_country 税金
af_net_revenue_subdivision 税金
af_net_revenue
  • ストア手数料
  • 税金
af_net_revenue_factors
  • ストア手数料
  • 税金

トラブルシューティングと乖離

症状 説明 / 対応方法
AppsFlyer上のアプリ内課金・サブスクリプションイベント数が、実際のアプリストアより少ない AppsFlyerでは、SDK Connectorを含むアプリバージョンへ更新済みのユーザーに対してのみイベントが生成されます。一方、アプリストア側では、アプリバージョンに関係なくすべてのイベントが記録されます。そのため、アップデート版アプリの利用が十分に浸透するまでは、アプリ側データとストア側データに差異が発生することがあります。

特性と制限

仕様 対象 備考
分割支払いサブスクリプション(Android) サブスクリプション収益 非対応
保留中のサブスクリプション
取引(Android)
サブスクリプション収益 非対応
新規サブスクリプション サブスクリプション収益 AppsFlyer Purchase SDK経由でのみ記録可能
価格変更 サブスクリプション収益 Subscription Revenueが、新しい商品価格を含むSDK由来通知を受信しない場合、従来の商品価格を継続して収益としてレポートします。Purchase SDKから新価格が送信されると、その時点で新価格が記録されます。
グロス収益
  • アプリ内購入
  • サブスクリプション収益
対応
ネット収益
  • アプリ内購入
  • サブスクリプション収益
ローデータでのみ利用可能
払い戻し アプリ内購入 元の購入日から180日以内であればレポート可能
重複排除
  • アプリ内購入
  • サブスクリプション収益
イベント発生日から180日以内に報告されたトランザクションに対応
SDK strictモード
  • アプリ内購入
  • サブスクリプション収益

ROI360 SubscriptionおよびIAPは、以下バージョン以降のSDK Strict Modeに対応しています。

  • AppsFlyer iOS purchase SDKコネクタ V6.13.0
  • Unity purchase SDKコネクタ V2.0.1
通貨
  • アプリ内購入
  • サブスクリプション収益
収益は、元通貨(event_revenue パラメータ)およびUSD換算(event_revenue_usd パラメータ)の両方でレポートされます。
データ更新頻度
  • アプリ内購入
  • サブスクリプション収益
  • トランザクション単位のStore Revenueレポート:毎時更新
  • デバイス単位のStore Revenueレポート:8時間ごと更新
StoreKit 2
  • アプリ内購入
  • サブスクリプション収益
  • Purchase SDK Connector version 6.16.2以降で対応しています。
  • こちらに記載されている最新のApp Store認証情報を使用してください。
Googleのワンタイムプロダクト アプリ内購入
  • 対応している購入オプション:Buy、Rent
  • Pre-order:非対応