どのようにお手伝いできますか?

ROI360ストア収益について プレミアム機能

  • 更新

概要:ROI360ストア収益でアプリ内購入とサブスクリプションを検証し、重複計上を防ぎながら、純収益(税金・ストア手数料を差し引いた収益)を計算します。 

重要

ROI360ストア収益は、ROI360の有料プランをご契約のお客様のみ利用できます。契約プランの確認やアップグレードについては、担当のカスタマーサクセスマネージャー(CSM)にお問い合わせください。

ROI360ストア収益は、アプリ内購入とサブスクリプションの収益を漏れなく正確に計測するための、AppsFlyerの有料機能です。顧客のライフサイクル全体を把握でき、広告費用対効果(ROAS)を正確に計測できます。

機能 詳細
収益の計測範囲
  • App Store Connect(iOS)とGoogle Play Console(Android)で管理する、すべてのアプリ内購入商品とサブスクリプションの収益
  • 返金
  • 支払いが保留中または延期されている取引の収益(Android)
  • アプリ内外で発生するサブスクリプション関連イベント
  • ストア手数料と税金を差し引いた純収益
収益の検証と正確性の確保 同じ取引の重複記録を防ぎます。 iOSでは、ファミリー共有による重複も防ぎます。また、Apple App Storeの取引データを広告主に直接転送することもできます。
データの取得元
  • Android・iOS向けのAppsFlyer Purchase SDK Connector
  • App Storeのサーバー通知
  • Google Playのリアルタイムデベロッパー通知(RTDN)
レポートとデータの利用 収益データはAppsFlyerのダッシュボードとレポートで利用でき、ポストバックでパートナーに共有することもできます。

警告

ROI360ストア収益を使用する場合は、アプリ内購入イベントを別途送信しないでください。収益が重複して計上されます。

ROI360ストア収益の仕組み

  1. ユーザーがアプリ内購入を行うか、自動更新サブスクリプションを購入します。
  2. アプリがアプリストアで購入処理を行います。
  3. AppsFlyer Purchase SDK Connectorが購入を自動的に検出し、検証・記録に必要なデータをAppsFlyerに送信します。
  4. AppsFlyerが該当するストアに購入内容を照会し、不正な取引でないことを確認します。
    • 検証に成功すると、AppsFlyerが購入またはサブスクリプションのアプリ内イベントを記録します。
    • レシート検証に失敗した場合、イベントはブロックされたアプリ内イベントのローデータレポート(Protect360の契約者が利用可能)とライブイベントの表示ページに表示され、パラメータ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・サブスクリプションのイベントとパラメータ、総収益から純収益を計算する仕組み、収益計測の仕様と制限事項を取り上げます。

注意

アプリ内イベントに追加のカスタムパラメータを含めるには、Purchase SDK Connectorでカスタムデータソースを設定します。これにより、自社の業務ルールに応じたデータやメタデータを、購入・サブスクリプションのイベントに追加できます。
これらのパラメータは、ローデータレポートのcustom_dataフィールドで確認できます。

IAPのイベントとパラメータ

AppsFlyerで計測するIAPイベントと、各イベントに含まれるパラメータを以下に示します。各パラメータの説明は、イベントパラメータの一覧を参照してください。

生成されるイベントには、次の共通点があります。

  • サーバー間(S2S)イベントとして扱われます。

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

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

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

説明

サンドボックス環境で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)

説明

サンドボックス環境で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_canceled)

説明

トライアル期間中に、ユーザーがサブスクリプションの自動更新を停止したときに記録されます。トライアル期間中に自動更新を再開しなかった場合は、期間終了後に終了(離脱)イベントが発生します。

パラメータ 

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

説明

トライアル期間が終わり、ユーザーが離脱したときに記録されます。自動更新を停止し、トライアル期間が終了した場合に発生します。支払いや技術上の問題で更新できず、離脱に至った場合にも発生します。

パラメータ 

  • 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_canceled)

説明

請求期間の途中で、サブスクリプションの自動更新が停止されたときに記録されます。同じ請求期間内に自動更新を再開しなかった場合は、期間終了後に終了(離脱)イベントが発生します。

パラメータ 

  • 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(イベント収益が0を超える場合にイベントに含まれます)
  • store_commission
  • af_revenue
  • af_net_revenue
  • af_net_revenue_factors

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

説明

サブスクリプションのユーザーが離脱したときに記録されます。通常は、自動更新の停止や請求期間の終了後に発生します。支払いや技術上の問題で更新できず、離脱に至った場合にも発生します。

パラメータ 

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

説明

サンドボックス環境で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)

説明

サンドボックス環境で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

パラメータ一覧

IAPとサブスクリプションのイベントのパラメータは、ローデータレポートで個別の列に表示されるか、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 キャンセル日 IAP
af_cuids
  • ARSでは、このパラメータにすべてのCUIDを含む配列が格納されます。
  • CUIDの配列は、端末IDにかかわらず表示されます。このため、異なる端末IDに同じCUIDが表示されることがあります。
サブスクリプション
af_discount_id 初回購入時にユーザーに提示されたオファーのID。割引コードがある場合にのみ値が入ります。
  • IAP
  • サブスクリプション
af_discount_type

ユーザーが適用した割引の種類。設定される値:

  • iOS
    • introductory
    • promotional
    • offer_codes
    • win_back
  • Android
    • intro price(初回割引料金)
    • one_time_code
    • vanity_code
サブスクリプション
af_environment データを受信した環境。productionまたはsandbox。
  • IAP
  • サブスクリプション
af_expires_date_ms 現在のサブスクリプションの請求期間が終了する日時 サブスクリプション
af_net_revenue 適用されるすべての控除を反映した純収益。 af_net_revenue_factorsを参照してください。
  • IAP
  • サブスクリプション
af_net_revenue_country
  • IAP
  • サブスクリプション
af_net_revenue_factors
  • 報告されるaf_net_revenueの計算に使用した、すべての控除項目を表す配列。
  • 値の例:store_commission
  • IAP
  • サブスクリプション
af_net_revenue_postal_code
  • 文字、数字、またはその組み合わせからなる文字列
  • 例:L4J8E3
  • IAP
  • サブスクリプション
af_net_revenue_subdivision
  • 一部の国では、州などの行政区画を追加で指定できます。 ISO 3166-2の行政区画コードに従って処理されます。
  • 国コードと行政区画コードを含みます。
  • 例:US-CA
  • IAP
  • サブスクリプション
af_net_revenue_tax_exclusive
  • trueまたはfalseを指定するブール値のパラメータ。
  • falseは、収益の総額に税金が含まれることを表します。
  • trueは、表示された収益の総額とは別に税金が加算されることを表します。
  • IAP
  • サブスクリプション
af_net_revenue_tax_name
  • 顧客の請求書に表示される、税の種類を表す名前。
  • 例:Sales、VAT、GST
  • IAP
  • サブスクリプション
af_net_revenue_tax_rate
  • 徴収する税率を表す数値。小数点以下4桁まで指定できます。
  • 例:7.25
  • IAP
  • サブスクリプション
af_offer_id
  • 該当する場合に、その取引に適用されたオファーのID(割引やプロモーションのオファーなど)。
  • Androidのみ
  • IAP
  • サブスクリプション
af_order_id
  • 取引の注文ID
  • Androidのみ
  • IAP
  • サブスクリプション
af_original_transaction_id
  • 元の取引ID
  • iOSのみ
  • IAP
  • サブスクリプション
af_original_transaction_id
  • 元の取引ID
  • iOSのみ
  • IAP
  • サブスクリプション
af_period_type
  • サブスクリプションまたはトライアル期間の種類。
  • 設定される値:
    • trial
    • intro
    • normal
サブスクリプション
af_product_id サブスクリプションの商品ID
  • IAP
  • サブスクリプション
af_purchase_date_ms 報告対象の商品IDに対応するアプリ内購入イベントの発生日時
  • IAP
  • サブスクリプション
af_purchase_option_id
  • 取引に紐づく購入オプションのID。
  • Androidのみ
IAP
af_purchase_option_type

取引の購入オプションの種類。設定される値(Android):

  • buy
  • rent
IAP
af_purchase_state

設定される値:

  • Purchased(購入済み)
  • Canceled(キャンセル済み)
  • Pending(保留中)
IAP
af_purchase_token
  • 取引の購入トークン
  • Androidのみ
  • IAP
  • サブスクリプション
af_reason [内容に変更なし]
  • IAP
  • サブスクリプション
af_refunded_transaction_ids
  • 返金されたすべての取引IDを含む配列
  • iOSのみ
  • IAP
  • サブスクリプション
af_store サブスクリプション商品を購入したアプリストア
  • IAP
  • サブスクリプション
af_subscription_ownership_type FAMILY_SHAREDは、ファミリー共有を通じて利用権を持つユーザーであることを表します。 PURCHASEDは、支払いを行うユーザー本人が購入したことを表します。 サブスクリプション
af_transaction_id
  • 取引のID
  • iOSのみ
  • IAP
  • サブスクリプション
store_commission
  • 購入した商品からストアに支払う手数料の割合(計算値)。
  • 小数で表示されます。
  • 例:30
  • IAP
  • サブスクリプション

純収益

純収益機能は、ROI360ストア収益で取引ごとの純収益を算出する仕組みです。取引を受信するたびに純収益をリアルタイムで自動計算し、レポートに反映します。

注意

純収益はローデータレポートに表示され、アプリ内イベントのポストバックでリアルタイムに送信することもできます。また、マイダッシュボードの純収益ベースの指標(純収益、純ROI、純ROAS、純ARPU、純利益)でも確認できます。

ポストバックで純収益を送信するには、アプリ内イベントで[値、収益、純収益]を選択します。詳しくは、アプリ内イベントのポストバック設定を参照してください。

ヒント

アプリ内イベントのポストバックで、通常は総収益を送信する収益(金額)パラメータに、純収益を設定することもできます。この設定を利用するには、担当のカスタマーサクセスマネージャー(CSM)にお問い合わせください。

総収益から純収益を計算する際は、次の項目を考慮します。

  • ストア手数料:
    • 自動的に計算・報告されます。お客様側での操作は不要です。
    • アプリ内購入(IAP)のデフォルトのストア手数料は、ストアの国・地域によって異なります。
      • App Store:日本とEU諸国は26%。中国本土(CN):25%。その他の国・地域:30%。
      • Play Store:30%。
    • サブスクリプションの手数料は、各ユーザーの契約継続期間に応じて自動的に計算されます。 
      • App Storeの最初の12か月:日本とEU諸国は26%、中国本土(CN)は25%、その他の国・地域は30%。 13か月目以降:日本は15%、中国本土(CN)は12%、その他の国・地域は15%。
      • Play Store:初日から15%。
    • 純収益の計算に関するパラメータは、ローデータレポートで確認できます。
    • デフォルトとは異なるストア手数料率を設定するには、純収益APIを使用します。例えば、手数料率が15%(中国本土(CN)では12%)となるAppleのSmall Business Programに参加しているアプリで役立ちます。
  • 税金:
    • ROI360で計測する取引の税金は、デフォルトの税率設定に基づいて報告されます。
    • これは、表示価格に税金が含まれる国に適用されます。例えば英国では、AppsFlyerは税金とストア手数料の合計額を差し引きます。米国など、表示価格に税金が含まれない国では、デフォルトで収益と純収益のパラメータに税金は含まれません。
    • この設定は、純収益APIで変更できます。対応する国とデフォルトの税率は、このJSONファイルで確認できます。開発者は、このファイルを必要に応じて編集するか、そのままAPIで使用できます。

レポートでは、次のパラメータに純収益のデータが格納されます。詳しくは、パラメータ一覧を参照してください。

パラメータ 純収益の計算で差し引く項目
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の購入SDK経由でのみ記録されます。
価格変更 サブスクリプション収益 サブスクリプション収益の計測で、変更後の商品価格を含むSDK通知をまだ受信していない場合は、変更前の価格を収益として報告し続けます。購入SDKから変更後の商品価格を受信すると、新しい価格が反映されます。
総収益
  • IAP
  • サブスクリプション収益
対応
純収益
  • IAP
  • サブスクリプション収益
ローデータとマイダッシュボード(純収益ベースの指標)で利用できます。
返金 IAP 元の購入から180日後まで報告できます。
重複排除
  • IAP
  • サブスクリプション収益
イベントの発生日から180日後までに報告された取引に対応しています。
SDKの厳格モード
  • IAP
  • サブスクリプション収益

ROI360のサブスクリプションとIAPは、次のバージョン以降でSDKの厳格モードに対応しています。

  • AppsFlyer iOS Purchase SDK Connector V6.13.0
  • Unity Purchase SDK Connector V2.0.1
通貨
  • IAP
  • サブスクリプション収益
収益は元の通貨(event_revenueパラメータ)と米ドル(event_revenue_usdパラメータ)で報告されます。
データの更新・反映
  • IAP
  • サブスクリプション収益
  • 取引単位のストア収益レポート:1時間ごと
  • 端末単位のストア収益レポート:8時間ごと
StoreKit 2
  • IAP
  • サブスクリプション収益
  • StoreKit 2には、Purchase SDK Connectorのバージョン6.16.2以降で対応しています。
  • こちらで説明している、更新されたApp Storeの認証情報を使用していることを確認してください。
Googleの1回限りの購入商品 IAP
  • 対応する購入オプション:購入、レンタル
  • 予約購入:非対応