| 項目 | 詳細 |
|---|---|
| 変更内容 |
AppsFlyerは、2026年9月7日に従来のレシート検証のバックエンドサービスのサポートを終了します。同日以降、SDKのバージョンにかかわらず、従来の 加えて、AppsFlyer SDK v7.0.0以降では、従来のメソッドをSDKから削除します。 v7.0.0以降にアップグレードしたアプリは、従来のメソッドを呼び出せなくなります。 検証済みの購入を引き続き計測するため、AppsFlyerは以下の2つの代替手段を提供しています。
|
| 適用日 |
以下の日付が適用されます。
|
| 留意事項 |
|
| 必要な対応 |
2026年9月7日より前に、以下のいずれかの方法で移行してください。
詳しくは、以下を参照してください。 |
よくある質問
従来のレシート検証を使用しているアプリを確認するには、どうすればよいですか?
収益設定ページのプロダクトタイプには従来の方式が表示されないため、管理画面だけでは使用状況を確認できません。以下の方法を併用してください。
-
まずローデータを確認します。
event_source: SDKとis_receipt_validated: trueを含むaf_purchaseイベントを探します。これらは該当する可能性がありますが、logEventの呼び出しでも同様のイベントが生成されるため、これだけでは断定できません。 -
SDKのコードで確認します。アプリが従来のシグネチャで
validateAndLogInAppPurchaseを呼び出している場合は、従来の方式を使用しています。従来のシグネチャには、以下が含まれます。- Android:ライセンスキー、JSONペイロード、価格、通貨
- iOS:プロダクトID、価格、通貨、トランザクションID
- CSMにお問い合わせください。 CSMが、従来の方式を引き続き使用しているアプリを確認できます。
2026年9月7日には、具体的に何が起きますか?
従来のレシート検証のバックエンドサービスが終了します。同日以降、以下の変更が適用されます。
- SDKのバージョンにかかわらず、従来の
validateAndLogInAppPurchaseメソッドを呼び出しても、検証結果が返されなくなります。 -
このメソッドで検証・記録される
af_purchaseイベントは、AppsFlyerに記録されなくなります。 - 従来の方式による購入データは、ダッシュボード、ローデータ、パートナーへのポストバックに反映されなくなります。
検証済みの購入データを継続して取得するには、2026年9月7日より前に、サポートされる代替手段へ移行してください。
新しいレシート検証を有効にすると、従来のメソッドを呼び出す公開済みのアプリバージョンに影響しますか?
いいえ。 2026年9月7日までは、両方の製品が並行して動作します。 AppsFlyerで新しいレシート検証を有効にしても、従来のメソッドを呼び出すアプリバージョンには影響しません。終了日までは、従来どおり動作します。
更新されずに古いバージョンを使用し続けるユーザーは、どうなりますか?
古いアプリバージョンを使用するユーザーについては、2026年9月7日まで、検証済みのaf_purchaseイベントが生成されます。検証済みの購入データを継続して取得できるよう、終了日前に大半のユーザーへ更新が行き渡るだけの余裕を持って、新しいアプリバージョンをリリースしてください。
レシート検証からROI360のストア収益へ、後から切り替えられますか?
はい。両方の製品が同じSDKメソッドvalidateAndLogInAppPurchase(v2)を使用するため、切り替えにSDKの変更やアプリのリリースは必要ありません。切り替えるには、収益設定ページのプロダクトタイプを変更し、ROI360の追加設定を完了します。iOSではApp Storeサーバー通知、AndroidではGoogle Play RTDNの設定が必要です。レシート検証からROI360のストア収益への切り替えを参照してください。
購入の自動検出、更新・アップグレード・既存の登録者を含むサブスクリプションのライフサイクル全体の取得、サブスクリプションの価格変更への対応も有効にする場合は、SDKコンポーネントのPurchase Connectorを実装してください。この場合はアプリの更新が必要ですが、任意です。このコンポーネントがなくても、validateAndLogInAppPurchase(v2)を手動で呼び出す方式をROI360のストア収益で使用できます。
AppsFlyerで購入を一切検証しない運用も可能ですか?
はい。標準のlogEvent APIでアプリ内購入イベントを報告できます。ただし、以下は利用できなくなります。
- 不正な購入を除外するための、アプリストアでのレシート検証
- イベントの
af_validatedフラグ。AppsFlyerがストアで購入を正常に検証できた場合はtrue、失敗した場合はfalseになります。検証を行わない場合、このフラグは含まれません。 - UAパートナーへの正確な収益ポストバック。検証を行わない場合、指定した
af_revenueは、実際に購入が発生したか確認されずに、そのまま記録され、アドネットワークに送信されます。
そのためAppsFlyerは、検証を一切行わない運用ではなく、レシート検証またはROI360のストア収益を使用することをお勧めします。
AppleやGoogleの検証サービスに障害が発生した場合は、どうなりますか?
使用する製品によって異なります。
- レシート検証:SDKのコールバックでエラーコードが返されます。アプリ側でエラーを処理し、独自の再試行ロジックを実装する必要があります。
- ROI360のストア収益:ストアのサービスが復旧すると、AppsFlyerが検証を自動的に再試行し、障害中に生成できなかったイベントを再生成します。
移行後にダッシュボードの収益が変わったのはなぜですか?
収益額の取得元が変わったためです。従来の方式では、SDKの呼び出しで指定した値を使用していました。新しいレシート検証では、ストアが返す総収益を使用します。これまでストア手数料を差し引いた純収益など、独自の値を指定していた場合、移行後はダッシュボードやパートナーへのポストバックの数値が変わります。
純収益が必要な場合は、ROI360のストア収益を使用してください。総収益と純収益(総収益からストア手数料と税金を差し引いた額)の両方を記録できます。
独自に指定したaf_revenueの値はどうなりますか?
引き続きaf_revenueの値を指定した場合、イベント内のcustom_dataオブジェクトに保持されます。ダッシュボードとパートナーへのポストバックには、独自に指定した値ではなく、ストアの応答に含まれる総収益の値が使用されます。
パートナーへのポストバックには、新しい総収益が含まれますか?
はい。移行後、af_purchaseのポストバックにはストアが返す総収益が含まれます。従来の方式で独自の値を指定していた場合、パートナーが受信する数値は変わります。移行を適用する前に、UAパートナーへ必ず伝えてください。特に、収益データをキャンペーンの最適化に使用しているパートナーには周知が必要です。
移行後、イベント名はどう変わりますか?
従来の方式では、すべての取引タイプで1種類のaf_purchaseイベントが生成されていました。新しいレシート検証では、以下のようにイベント名が分かれます。
- 1回限りの購入:
af_purchase - トライアル開始:
af_ars_trial_started - サブスクリプション開始:
af_ars_subscription_started - サンドボックスでの購入:
af_purchase_sandbox_sdk - サンドボックスでのサブスクリプションまたはトライアル:
af_ars_sandbox_sdk
更新、解約、返金、アップグレードなど、サブスクリプションのライフサイクル全体のイベントを取得できるのは、ROI360のストア収益のみです。イベントの一覧は、レシート検証についてを参照してください。
SDKの検証結果を使用して、購入済みコンテンツへのアクセスを制御できますか?
新しいレシート検証でも、SDKのコールバックで検証結果が返されます。この結果を使用して、購入済みコンテンツへのアクセスを制御できます。 Apple App StoreとGoogle Playが提供する最新の検証の仕組みを使用するため、結果の精度が向上し、コールバックで受け取る情報の信頼性が高まります。
新しいメソッドでは、サブスクリプションと1回限りの購入をどう区別しますか?
新しいvalidateAndLogInAppPurchaseでは、PurchaseTypeパラメータが必須です。取引タイプに応じて、one-timeまたはsubscriptionを設定します。
SDKから「Purchase validation is not enabled for this app in AppsFlyer」というエラーが返されるのはなぜですか?
アプリに新しいvalidateAndLogInAppPurchase(v2)メソッドが実装されていますが、AppsFlyerの管理画面で製品が設定されていないためです。設定 > ROI360 > 収益設定 > 購入とサブスクリプションを開き、レシート検証またはROI360を選択して、設定手順を完了してください。
新しいSDKビルドで、af_purchaseではなくサンドボックスイベントだけが記録されるのはなぜですか?
af_purchaseは、本番環境での取引でのみ記録されます。サンドボックスの取引は、af_purchase_sandbox_sdkとして記録されます。実際のaf_purchaseイベントを生成するには、本番環境の経路でテストしてください。iOSではTestFlight以外、Androidではライセンステスター以外を使用します。