レシート検証でアプリ内購入やサブスクリプションの収益を計測し、アプリストアへの照会で取引の正当性を確認する仕組みを説明します。
レシート検証を使うと、Play StoreとApp Storeでのアプリ内購入やサブスクリプションの取引を検証し、収益を計測できます。
レシート検証は、どのプランでも無料で利用できます。
純収益の計算、サブスクリプションのライフサイクル全体の計測、返金への対応、購入の自動検出と重複排除が必要な場合は、有料機能のROI360ストア収益をご検討ください。両機能の詳細と比較は、「購入・サブスクリプションの検証に使える2つの機能」を参照してください。
レシート検証の仕組み
レシート検証は、次の流れで行われます。
- ユーザーがアプリ内購入を行います。
- アプリストアが、購入の完了をアプリに通知します。
- アプリ開発者が、SDKのレシート検証メソッド
validateAndLogInAppPurchaseを呼び出します。 - SDKがAppsFlyerの検証サービスを呼び出します。
- AppsFlyerが購入内容を検証し、不正な取引でないことを確認します。
- 検証に成功すると、AppsFlyerが購入またはサブスクリプションのイベントを記録します。
- レシート検証に失敗した場合、イベントはブロックされたアプリ内イベントのローデータレポート(Protect360の契約者が利用可能)とライブイベントの表示ページに表示され、パラメータ
af_validatedはfalseに設定されます。 - AppsFlyerの検証サービスが、結果をSDKに返します。
- SDKが、レシート検証の結果(成功または失敗)をアプリに返します。
レシート検証の有効化
レシート検証を有効にするには、次の手順を実行します。
- AppsFlyerのサイドメニューから[設定]を開き、[ROI360]の[収益設定]を選択します。
- [購入・サブスクリプション]タブを開きます。
- [1 製品タイプを選択]で、[レシート検証]を選択します。
- [保存して次へ]をクリックし、レシート検証の設定に進みます。
レシート検証の設定
詳しくは、「レシート検証の設定」を参照してください。
レシート検証のアプリ内購入イベントとパラメータ
定義済みイベントには、次の共通点があります。
- S2Sイベントとして処理されます。
- ダッシュボードとローデータレポートで、オーガニックまたはノンオーガニックのアプリ内イベントとして利用できます。
- ポストバックでパートナーに送信できます。
- SKAN Conversion Studioで使用できます。
アプリ内購入では、次のイベントが記録されます。
-
af_purchase:本番環境 -
af_purchase_sandbox_sdk:サンドボックス環境
サブスクリプションのイベント:
-
af_ars_trial_started:トライアル期間付きのサブスクリプションの開始。 -
af_ars_subscriptions_started:有料サブスクリプション(トライアル期間なし)の開始。本番環境用。 -
af_ars_sandbox_sdk:トライアルまたは有料サブスクリプションの開始。サンドボックス環境用。
イベントには、次の定義済みパラメータが含まれます。
af_product_id-
af_transaction_id(iOSのみ) -
af_purchase_token(Androidのみ) -
af_revenue(サンドボックスイベントではaf_sandbox_revenue) af_currency-
af_store(app_store/play_store) -
af_environment(sandbox/production) -
af_validation_type(receipt_validation)
追加のカスタムパラメータ:
- SDKの呼び出し時に送信した追加のカスタムパラメータは、ローデータレポートの
custom_dataフィールドに表示されます。
ROI360ストア収益からレシート検証への切り替え
現在ROI360ストア収益を使用していて、レシート検証に切り替える場合は、次の手順を実行します。
- AppsFlyerのサイドメニューから
[設定]を開き、[ROI360]の[収益設定]を選択します。
- [購入・サブスクリプション]タブで、[製品タイプ]が現在[ROI360]に設定されていることを確認します。
-
をクリックします。
- レシート検証に切り替えると利用できなくなる機能や、データへの影響を説明するメッセージが表示されます。
- 返金のアトリビューション、サブスクリプション更新の計測、純収益の計算など、ROI360の機能が無効になります。
- 収益データの正確性が低下する可能性があります。
- レシート検証では、Purchase Connectorは使用できません。
- 使用できるSDKメソッドは、
validateAndLogInAppPurchaseのみです。
- 必要に応じて、[製品の比較を表示]をクリックし、比較表を確認します。
- 切り替えを進める場合は、[切り替える]をクリックして確定します。
- 切り替え後は、[製品タイプ]が[レシート検証]となり、設定画面も簡略化されます。
- 次の項目を再確認してください。
- validateAndLogメソッドのSDK実装
仕様と制限事項
| 項目 | 補足 |
|---|---|
| 対応するストア | • Play Store • App Store • その他のストア(サードパーティストア)では、アプリ内購入イベントを手動で送信する必要があります。 |
| iOSのサンドボックスアプリ | iOSのサンドボックスアプリ(App Storeで公開されていないアプリ)では、[キーを検証]の結果は常に「無効」と表示されます。 |