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

検索

ROI360ストア収益の設定 プレミアム機能

  • 更新

概要：AppsFlyerのROI360ストア収益を設定する方法を説明します。

重要

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

概要

注意

ROI360の仕組みやAppsFlyerで有効にする方法など、詳しくは「ROI360ストア収益について」を参照してください。

ROI360ストア収益を設定するには、次の手順を順番に実行します。

  1. ストアの認証情報の設定（iOS・Android）：
    • iOS：App Store Connectのキー（アプリ内課金キー、キーID、発行者ID）をAppsFlyerに設定します。
    • Android：Google Cloudのサービスアカウントを設定し、Google Play Consoleで必要な権限を付与します。その後、サービスアカウントのJSONキーをAppsFlyerにアップロードします。
  2. サーバー通知の設定（iOS・Android）：
    • iOS：App Storeのサーバー通知を設定し、連携を検証します。通知はAppsFlyerに直接送信するか（推奨）、自社のエンドポイントから転送します。
    • Android：Google Playのリアルタイムデベロッパー通知（RTDN）を設定します。Google PlayからAppsFlyerに直接送信するか（推奨）、Pub/Sub経由で転送します。
  3. SDK Connectorの実装：開発者がAppsFlyer Purchase SDK Connectorを実装できるよう準備します。
  4. SDKの実装の確認：両プラットフォームのサンドボックスで購入とサブスクリプションをテストし、SDKイベントとサーバー通知がAppsFlyerに正しく届き、処理されることを確認します。
  5. 設定の確認・更新：購入の検証、返金への対応、サブスクリプションの計測、ストア連携の状態を確認します。これにより、各プラットフォームの収益を継続して正確に紐づけられます。
  6. アプリのリリース：SDK Connectorを実装した更新版のアプリをリリースします。サンドボックスのフラグが無効で、必要な収益イベントが検証ルールによって許可されていることを確認してください。

手順1（iOS）｜App Store Connectのキーの設定

手順1では、App Store Connectで次の認証情報を取得し、AppsFlyerの［収益設定］ページに入力します。

  • アプリ内課金キー
  • キーID
  • 発行者ID

事前準備：

認証情報の設定には、App Store ConnectとAppsFlyerの両方で操作が必要です。設定中は、App Store ConnectとAppsFlyerをそれぞれ別のタブで開いておいてください。

1.1 App Store Connectのキーの作成

iOSの認証情報を設定するには、次の手順を実行します。

  1. App Store Connectで、［ユーザとアクセス］を開きます。

  2. ［ユーザとアクセス］＞［統合］に移動し、［キー］の一覧から［アプリ内課金］を選択します。

  3. ［＋］をクリックし、新しいアプリ内課金キーを生成します。

  4. APIキーの名前を入力します。
  5. ［生成］をクリックします。
  6. 作成したキーの横にある［アプリ内課金キーをダウンロード］をクリックし、キーをダウンロードします。 注意：キーは1回しかダウンロードできません。

  7. 生成したキーのキーIDをコピーし、AppsFlyerの購入・サブスクリプション設定の［キーID］に貼り付けます。

  8. 発行者IDをコピーします。 注意：ページ上部に発行者IDが表示されない場合は、App Store Connect APIキーを作成します。アクセスレベルは任意です。作成すると、アプリ内課金キーのページ上部に発行者IDが表示されます。

1.2 AppsFlyerでのApp Store Connectのキーの設定

  1. ROI360ストア収益を有効にします。 
  2. ［App Store Connectのキー］の手順で、［アプリ内課金キー］フィールドの［アップロード］をクリックし、p8ファイルをアップロードします。

  3. ［App Store Connectのキー］セクションに、App Store Connectでコピーした値を貼り付けます。

    • キーID
    • 発行者ID
  4. ［キーを検証］をクリックし、入力したキーが正しいことを確認します。 注意：［キーを検証］は、アプリがまだApp Storeで公開されていない場合、機能しないことがあります。
  5. ［保存して次へ］をクリックします。

手順1（Android）｜サービスアカウントのキーと権限の設定

手順1では、App Store Connectで次の認証情報を取得し、AppsFlyerの［収益設定］ページに入力します。

事前準備：

  • アプリ内購入とサブスクリプションの収益計測を設定するには、Google Cloud Platform、Google Play Console、AppsFlyerの管理画面で操作を行います。設定中は、3つのサービスをそれぞれ別のタブで開いておくことを推奨します。
  • AppsFlyerの管理画面で設定するには、管理者権限が必要です。

1.1｜ Google PlayデベロッパーアカウントとGoogle Cloudプロジェクトのリンク

前提条件：Google Play ConsoleとGoogle Cloudプロジェクトへのアクセス権。

Google PlayデベロッパーアカウントをGoogle Cloudプロジェクトにリンクするには、次の手順を実行します。

  1. Google Play Consoleで、Google Playデベロッパーアカウントを開きます。
  2. アカウントをGoogle Cloudプロジェクトにリンクします。手順は、Googleのこちらのヘルプを参照してください。

  3. Google Play Developer APIを有効にします。手順は、Googleのこちらのヘルプを参照してください。

1.2｜ Google Cloudでのサービスアカウントの設定

前提条件：Google Cloudへのアクセス権。

サービスアカウントを設定するには、次の手順を実行します。

  1. サービスアカウントを作成するか、既存のサービスアカウントを使用します。

    1. Google Cloudの［サービスアカウント］で、［サービスアカウントを作成］をクリックします。

    2. サービスアカウントの詳細を入力します。

    3. メールアドレスをコピーします。

    4. ［作成して続行］をクリックします。

    5. ［このサービスアカウントにプロジェクトへのアクセスを許可する］の手順で、Pub/Subのサブスクライバーロールを選択します。

    6. ［続行］＞［完了］の順にクリックします。

  2. サービスアカウントの秘密鍵をダウンロードします。
    1. Google Cloudの［サービスアカウント］で、先ほど作成したアカウントを一覧から選び、［その他の操作］アイコンをクリックします。

    2. ［鍵を管理］をクリックします。

    3. ［鍵を追加］＞［新しい鍵を作成］をクリックします。

    4. ［秘密鍵の作成］ポップアップで、［キーのタイプ］から［JSON］を選択し、［作成］をクリックします。

    5. ［作成］をクリックします。秘密鍵のJSONファイルがダウンロードされます。

    6. 後でAppsFlyerにアップロードするため、JSONキーファイルを保存しておきます。 注意！キーは必ず保存してください。後から取得することはできません。保存しなかった場合は、キーを新たに作成し直す必要があります。

1.3｜ Google Play ConsoleでのAPIアクセス権限の設定

前提条件：Google Play Consoleへのアクセス権。

注意：サービスアカウントの認証情報と権限の設定が反映されるまで、24時間ほどかかる場合があります。そのため、後の手順でエラーが発生する場合があります。

Google Play ConsoleでAPIのアクセス権限を設定するには：

  1. Google Play Consoleの［ユーザーと権限］で、作成したサービスアカウントを探し、［新しいユーザーを招待］をクリックします。

  2. 手順1.2.1.3でサービスアカウントを設定した際にコピーしたメールアドレスを入力します。

  3. ［権限］セクションの［アカウントの権限］タブで、次の両方を選択します。

    • 財務データ、注文、解約に関するアンケートの回答の閲覧。
    • 注文と定期購入の管理。

  4. ［アプリの権限］タブで、［アプリを追加］をクリックし、対象のアプリを選択します。必要に応じて複数のアプリを追加します。

  5. ［ユーザーを招待］をクリックします。

  6. 確認ポップアップで、［招待状を送信］をクリックします。

1.4｜サービスアカウントの秘密鍵のAppsFlyerへのアップロード

手順1.2でダウンロードしたGoogleのJSONキーをアップロードし、検証します。

前提条件：AppsFlyerの管理者権限。

サービスアカウントの秘密鍵をAppsFlyerにアップロードするには、次の手順を実行します。

  1. ROI360ストア収益を有効にします。 
  2. ［サービスアカウントのキーと権限］の手順で、［GoogleのJSONキーをアップロード］フィールドのアップロードアイコンをクリックします。
  3. 手順1.2でダウンロードしたJSONファイルをアップロードします。
  4. ［キーを検証］をクリックします。注意：
    • サービスアカウントの認証情報と権限の設定が反映されるまで、最大24時間かかる場合があります。そのため、キーの検証や検証テストの実行時にエラーが発生する場合があります。
    • 設定を早く反映させたい場合は、Google Play Consoleで任意のアプリを開き、［収益化］＞［商品］＞［定期購入／アプリ内アイテム］に移動して、変更を加えます。例えば、商品の説明を編集して保存します。通常、この操作によってアカウントの認証情報と権限がすぐに更新されます。その後、加えた変更は元に戻せます。
  5. ［保存して次へ］をクリックします。

手順2（iOS）｜App Storeのサーバー通知の設定

AppsFlyerがApp Storeの通知を受信する方法を設定します。

  • App Store Connectに、すでにApp Storeのサーバー通知用エンドポイント（自社のバックエンドや別のサービスなど）を設定している場合は、方法1（推奨）または方法2を選択します。
  • App Store Connectにまだエンドポイントを設定していない場合は、方法1を選択します。

方法1（推奨）｜通知の最初の送信先をAppsFlyerにする

App Store Connectの既存の通知URLをAppsFlyerのエンドポイントに置き換え、従来のエンドポイントをAppsFlyer側で転送先として追加します。既存のサブスクリプションの処理やワークフローは、そのまま利用できます。

この方法では、通知は次のように送信されます。

  1. App Store ConnectがAppsFlyerに通知を送信します。
  2. AppsFlyerがROI360の収益計測に必要な処理を行います。
  3. AppsFlyerがすべての通知を既存のエンドポイントにリアルタイムで転送します。

この方法を使用するには、手順2.1、2.2、2.4を実行します。

方法2｜通知の最初の送信先を自社のエンドポイントにする

既存のエンドポイントを最初の送信先として使い続ける場合は、自社サーバーからApp Storeのサーバー通知をAppsFlyerに転送するよう設定します。

この方法を使用するには、手順2.1と2.2を省略し、2.3と2.4を実行します。

注意

Appleで設定できるApp Storeのサーバー通知用エンドポイントは、アプリごとに1つです。購入やサブスクリプションに関する通知だけでなく、すべての種類の通知がそこに送信されます。 AppsFlyerは、購入とサブスクリプションの通知を使って収益を計測します。その他の通知には、Appleから再送されないよう受信確認を返しますが、通知の内容に応じた処理や操作は行いません。

購入やサブスクリプション以外の通知（同意に関する通知など）をアプリで使用する場合は、自社サーバーにも必ず届くようにしてください。

  • 方法1：AppsFlyerを最初の送信先として使い、転送を有効にします（手順2.1）。 AppsFlyerは、自身が処理しない種類も含め、すべての通知をAppleから受信した内容のまま、自社のエンドポイントにリアルタイムで転送します。
  • 方法2：自社のエンドポイントを最初の送信先として使います。自社サーバーがすべての種類の通知を直接受信・処理し、購入とサブスクリプションの通知をAppsFlyerに転送します。

2.1 AppsFlyerのサーバー通知用エンドポイントのコピー

AppsFlyerのサーバー通知用エンドポイントをコピーするには、次の手順を実行します。

  1. AppsFlyerで、［App Storeのサーバー通知］の手順を開き、AppsFlyerのサーバー通知用エンドポイントをコピーします。
  2. 従来のApp Storeのサーバー通知用エンドポイントにAppsFlyerから通知を転送する場合は、［通知のコピーを自社サーバーに転送］を選択します（方法1のみ）。
  3. 表示されたテキストボックスに、通知の転送先エンドポイントを入力します。

2.2 通知をAppsFlyerに直接送信

通知をAppsFlyerに直接送信するには、App Storeのサーバー通知の最初の送信先をAppsFlyerに設定します。

  1. App Store Connectの［アプリ情報］セクションで、［App Storeサーバ通知］までスクロールし、［本番環境サーバURL］の横にある［編集］をクリックします。

  2. AppsFlyerからコピーしたサーバー通知用エンドポイントを貼り付け、［バージョン2の通知］を選択して、［保存］をクリックします。 注意：バージョン1の通知には対応していません。 App Store Connectに通知のバージョンの選択肢が表示されない場合は、すでにバージョン2を使用しています。

  3. ［アプリ情報］セクションで、［App Storeサーバ通知］までスクロールし、［サンドボックスサーバURL］の横にある［編集］をクリックします。

  4. AppsFlyerからコピーしたサーバー通知用エンドポイントを貼り付け、［バージョン2の通知］を選択して、［保存］をクリックします。注意：バージョン1の通知には対応していません。 App Store Connectに通知のバージョンの選択肢が表示されない場合は、すでにバージョン2を使用しています。

2.3 ［任意］自社のエンドポイントからAppsFlyerに通知を転送

App Storeのサーバー通知をAppsFlyerに直接送信せず、自社のエンドポイントを最初の送信先として使い続ける場合にのみ、この手順を実行します。

この方法は推奨される設定ではなく、バックエンド側での実装が必要です。上記の手順2.2でAppsFlyerを最初の送信先に設定済みの場合は、この手順を省略してください。

自社のエンドポイントからAppsFlyerにサーバー通知を転送するには、次の手順を実行します。

  1. App Store Connectの［アプリ情報］セクションで、［App Storeサーバ通知］までスクロールし、［本番環境サーバURL］の横にある［編集］をクリックします。

  2. 自社サーバーのエンドポイントURLを貼り付けます。

  3. ［バージョン2の通知］を選択します。注意：バージョン1の通知には対応していません。 App Store Connectに通知のバージョンの選択肢が表示されない場合は、すでにバージョン2を使用しています。
  4. ［保存］をクリックします。

  5. App Store Connectの［アプリ情報］セクションで、［App Storeサーバ通知］までスクロールし、［サンドボックスサーバURL］の横にある［編集］をクリックします。

  6. 自社サーバーのエンドポイントURLを貼り付けます。

  7. ［バージョン2の通知］を選択します。注意：バージョン1の通知には対応していません。
  8. ［保存］をクリックします。
  9. Appleのサーバー通知をAppsFlyerの通知用エンドポイントURLに転送するよう、バックエンドを設定します。リクエストは、Appleから受信したApp Storeのデータと完全に一致する必要があります。Appleの形式要件を参照してください。

2.4 サーバー通知の連携テスト

App Storeのサーバー通知をAppsFlyerが正しく受信しているか確認する場合や、エンドポイントを設定したばかりで通知がまだ届いていない場合は、次の手順を実行します。

  1. AppsFlyerで、［App Storeのサーバー通知］の手順を開きます。

  2. ［連携をテスト］をクリックします。 AppsFlyerがAppleにテスト通知をリクエストし、過去7日間にAppleから有効な通知を受信したか確認して、次のいずれかを表示します。

    • 有効な通知を受信したことを示す確認メッセージ。
    • 通知が見つからなかったことを示すステータスメッセージ。

    注意

    Appleがテストメッセージを送信するまでに、数秒かかる場合があります。

    • ステータスが無効のままの場合は、少し待ってから再試行してください。
    • テストに成功したら、または次に進む準備ができたら、［保存して次へ］をクリックします。

手順2（Android）｜Google Playのサーバー通知の設定

Google Playからアプリ内購入とサブスクリプションの収益データを受信する方法として、次のいずれかを選択します。

  • （推奨）Google PlayからAppsFlyerに通知を直接送信する。この方法では、自社のエンドポイントに通知のコピーを転送することはできません。この方法を選択する場合は、「Google Playの通知をAppsFlyerに直接送信」を参照してください。
  • Google Playからまず自社に通知を送信し、その後AppsFlyerに転送する。この方法を選択する場合は、「Google Playの通知をAppsFlyerに転送」を参照してください。

前提条件：Google Play ConsoleとAppsFlyerの管理画面へのアクセス権。

2.1 Google Playの通知をAppsFlyerに直接送信

  1. AppsFlyerで手順2［Google Playのサーバー通知の設定］を開き、［AppsFlyerのトピックでGoogleからRTDNメッセージを直接受信］を選択します。
  2. AppsFlyerのトピックをクリップボードにコピーします。

  3. Google Play Console＞［ホーム］で、対象のアプリを選択して開きます。ダッシュボードが開きます。

  4. ［Google Playで収益化］＞［収益化の設定］に移動し、［Google Play Billing］セクションで、［リアルタイム通知を有効にする］にチェックが入っていることを確認します。

  5. ［トピック名］フィールドに、コピーしたAppsFlyerのトピックアドレスを貼り付けます。

  6. ［通知の内容］で、［定期購入、無効になった購入、すべての1回限りの購入商品］を選択します。

  7. ［変更を保存］をクリックします。設定が反映されるまで、24時間ほどかかる場合があります。そのため、反映を待ってからテストしてください。

2.2 ［任意］Google Playの通知をAppsFlyerに転送

注意：この手順は、Google PlayからAppsFlyerへ直接通知を送信する推奨方法を選択しなかった場合にのみ実行します。推奨方法に従い、Google PlayのRTDNメッセージをAppsFlyerが直接受信するトピックを作成済みの場合は、この手順を省略してください。

既存のPub/SubトピックにAppsFlyerをサブスクライバーとして追加する場合は、以下の手順に進みます。

前提条件：Google CloudとAppsFlyerの管理画面へのアクセス権。

Google Playの通知をAppsFlyerに転送するには：

  1. AppsFlyerのサイドメニューから［設定］＞［収益設定］に移動します。
  2. 対象のアプリを選択します。
  3. ［購入・サブスクリプション］タブで、［自社のRTDNトピックのメッセージをAppsFlyerに転送］を選択します。
  4. エンドポイントURLをクリップボードにコピーします。

  5. Google Cloudで対象のプロジェクトを開き、Pub/Subを検索します。

  6. Pub/Subの［トピック］セクションを開き、定期購入用の専用Pub/Subトピックがあることを確認します。

  7. Pub/Subの［サブスクリプション］セクションで、［サブスクリプションを作成］をクリックします。

  8. サブスクリプションIDを入力します。

  9. ドロップダウンから、該当する定期購入用のPub/Subトピックを選択します。

  10. ［配信タイプ］で［プッシュ］を選択します。

  11. AppsFlyerでコピーしたエンドポイントURLを貼り付けます。

  12. ［有効期限］で［無期限］を選択します。

  13. ［作成］をクリックします。

  14. ［サブスクリプション］セクションに移動し、対象のトピック名をクリックします。

  15. トピック名をクリップボードにコピーします。

  16. Google Play Consoleで、［Google Playで収益化］＞［収益化の設定］に移動します。 ［Google Play Billing］セクションの［トピック名］に、前の手順でコピーしたトピック名を貼り付けます。

  17. ［通知の内容］で、［定期購入、無効になった購入、すべての1回限りの購入商品］を選択します。

  18. ［変更を保存］をクリックします。設定が反映されるまで、24時間ほどかかる場合があります。そのため、反映を待ってからテストしてください。

2.3 Google Play Consoleからテスト通知を送信

Google Playのリアルタイムデベロッパー通知（RTDN）をAppsFlyerが正しく受信するか確認するため、Google Play Consoleからテスト通知を送信します。

  1. ［テスト通知を送信］をクリックします。 AppsFlyer用に設定したPub/Subトピックに、テスト用のRTDNメッセージが送信されます。

    image (33).png
  2. ［Google Play Billing］で、［トピック名］セクションを探します。
  3. 左側のメニューから［Google Playで収益化］＞［収益化の設定］に移動します。
  4. Google Play Consoleを開きます。

2.4 AppsFlyerで通知の受信を確認

  1. テストに成功したら、または次に進む準備ができたら、［保存して次へ］をクリックします。
  2. 結果：AppsFlyerに、過去7日間に通知を受信したかどうかが表示されます。
    • 受信に成功している場合は、最後に受信した通知の日時が表示されます。
    • 通知を受信していない場合は、過去7日間に通知が見つからなかったことが表示されます。
    • ステータスが表示されない場合は、Pub/Subの設定を見直し、テスト通知を再送信してください。
  3. ［Google Playのサーバー通知］の手順で、［連携をテスト］をクリックします。

手順3｜SDK Connectorの実装

この手順では、開発者がAppsFlyer Purchase SDK Connectorを実装できるよう準備し、テスト用のサンドボックス環境を設定します。

SDK Connectorを実装するには、次の手順を実行します。

  1. ［SDK Connectorの実装］の手順で、ダッシュボードに表示されるメッセージのひな形をコピーします。
  2. コピーしたメッセージを開発者に送信します。メッセージには、次の情報が含まれます。
    • アプリ名とアプリID
    • SDK実装ガイドへのリンク。
    • サンドボックス環境の設定手順（sandbox = true）
    • テスト手順（TestFlightを使用）

このメッセージに、実装からテスト開始までに開発者が必要とする情報がすべて含まれています。

注意

SDK Connectorは、取引を自動的に検出します。代わりに、validateAndLog SDKメソッドを実装して、取引ごとに手動で記録することもできます。ただし、このメソッドではSDK Connectorの一部の機能を利用できません。 SDK連携の2つの方法について詳しくは、DevHubのドキュメントを参照してください。

手順4｜SDKの実装の確認

サンドボックス環境で購入とサブスクリプションの収益計測をテストし、SDK Connectorの実装とサーバー通知の設定が正しく、通知がAppsFlyerに届くことを確認します。

SDKの実装テスト

過去7日間に、アプリから有効な購入・サブスクリプションのイベントデータをAppsFlyerが受信したか確認するには、次の手順を実行します。

  1. ［SDKの実装を確認］の手順で、［SDKの実装をテスト］をクリックします。

  2. AppsFlyerが最後にデータを受信した日時など、結果を確認します。

    注意

    このテストで分かるのは、リクエストがAppsFlyerに届いているかどうかだけです。データの完全性や正確性までは検証されません。

  3. 実装を十分に検証するには、引き続き以下のテストを行ってください。

サンドボックスのイベントとパラメータ

  • SDK Connectorがイベントを生成するのは、サンドボックスでの初回取引時のみです。
    • アプリ内購入：af_purchase_sandbox_sdk
    • サブスクリプション：af_ars_sandbox_sdk
  • AppsFlyerがサーバー通知を処理するのは、元の取引のSDKイベントが記録されている場合のみです。
    • アプリ内購入のS2Sイベント：af_purchase_sandbox_s2s
    • サブスクリプションのS2Sイベント：af_ars_sandbox_s2s
  • 元の取引がSDKで記録されていない場合は、 S2Sイベントは生成されません。

iOSでの注意点

  • af_purchase_sandbox_sdkにaf_sandbox_revenueが含まれる場合は、本番環境のaf_purchaseに対応します。
  • 収益が含まれない場合は、本番環境のaf_purchase_freeに対応します。

Androidでの注意点

  • ライセンステスターによる購入では、常にサンドボックスイベントが生成されます。 SDKでサンドボックスモードが設定されていない場合も同様です。

テストイベントに必要なパラメータ

サンドボックスの購入イベントに、必ず次の情報が含まれるようにします。

  • 収益＝0（実際のレポートに影響を与えないため）。
  • af_sandbox_revenue＝実際の商品価格（正しい収益を紐づけるため）。
  • af_validated＝true。 falseの場合は、前の手順に戻ってストアのキーを検証してください。
  • af_validation_type = receipt_validation.

アプリ内購入とサブスクリプションの収益テスト

前提条件：

  • iOSでは、App Store Connectの［App Storeサーバ通知］で、AppsFlyerのエンドポイントが［サンドボックスサーバURL］に設定されていることを確認します。

アプリ内購入とサブスクリプションの収益をテストするには：

  1. 開発者に、Android、iOS、Unityの実装手順に従い、SDK Connectorのサンドボックス環境を設定するよう依頼します。
  2. Google Playのライセンステスターで、購入またはサブスクリプションの開始をテストします。 iOSでは、TestFlightを使用します。注意：サブスクリプション商品をテストできるのは、端末ごとに1回のみです。同じ端末では、同じサブスクリプション商品のテスト購入を複数回記録できません。 2回目以降の試行は記録されません。
  3. Google PlayのライセンステスターとiOSのTestFlightで、返金、サブスクリプションの更新、または自動更新の停止のイベントをテストします。注意：サブスクリプション商品をテストする場合は、ストアからのサーバー通知がAppsFlyerに届くまでお待ちください。通常は、初回購入の数分後に届きます。
  4. ［SDK Connectorの実装を確認］の手順で、［SDKの実装をテスト］をクリックします。過去7日間にPurchase ConnectorからSDKのデータを正常に受信したかどうかが表示されます。

  5. 次のいずれかの方法で、テストイベントが表示されることを確認します。

  6. AppsFlyerのアクティビティダッシュボードにイベントが表示されることを確認します。 AppsFlyerで［分析］＞［アクティビティ］を開き、［アクティビティの推移］グラフの［アプリ内イベント］タブで、テストするイベントを選択します。自動更新サブスクリプションの購入イベントの名前はaf_ars_s2s_sandboxです。イベントには、次の情報が含まれます。
    • 収益の値が0であること（AppsFlyerの実際のレポートに影響を与えないため）。
    • 購入した商品の収益額がaf_sandbox_revenueパラメータに含まれ、正しい収益が報告されていること。
       

手順5｜設定の確認・更新

最後の手順で設定を保存すると、現在の設定を確認する画面が開きます。この画面で、次の設定を確認・更新できます。

  1. ［App Storeで購入を検証］のトグルがオンになっていることを確認します。
  2. ［購入］で、次のオプションを確認します。
    • ［購入の重複を防いでデータを正確に保つ］：報告済みの取引の重複記録を防ぎます。
    • ［返金、キャンセル、マイナスの収益を自動計測］：返金に関するイベントを計測し、マイナスの収益として記録します。
    • ［ファミリー共有による収益の二重計上を防ぐ］：ファミリー共有による収益の重複を防ぎます。これらのイベントにはpurchase_ownership_type=FAMILY_SHAREDが設定され、収益は0として報告されます。
  3. ［自動更新サブスクリプションの収益を計測・アトリビューション］のトグルがオンになっていることを確認します。
  4. 次の設定の状態を確認します。
    • App Storeのキーの設定
    • サーバー通知用エンドポイントの設定
    • SDK Connectorの実装とテスト

手順6｜SDK Connectorを実装したアプリのリリース

設定とAppsFlyer Purchase SDK Connectorの実装が完了したら、実装済みのアプリをリリースするよう開発者に依頼します。

新しいバージョンをリリースする前に、次の点を確認してください。

  • アプリ内購入またはサブスクリプションとして記録したいアプリ内イベントが、AppsFlyerで設定した検証ルールによってブロックされていないこと。
  • 開発者が、すべてのサンドボックスフラグをfalseに設定していること。

SDK Connectorを実装したアプリが公開されると、アプリ内購入とサブスクリプションのイベントが生成され、AppsFlyerのすべてのダッシュボード、集計レポート、ローデータレポート（収益ETLを含む）で利用できるようになります。

注意：イベントが生成されるのは、SDK Connectorを実装したバージョンにアプリを更新したユーザーのみです。そのため、更新版のアプリがすべてのユーザーに行き渡るまでは、アプリの収益データとストアのデータに差異が生じます。

レシート検証からROI360ストア収益への切り替え

レシート検証の導入が完了していて、ROI360ストア収益を有効にする場合は、次の手順を実行します。

  1. AppsFlyerのサイドメニューから［設定］を開き、［ROI360］の［収益設定］を選択します。
  2. ［購入・サブスクリプション］タブを開きます。 ROI360が利用可能ですが、有効になっていないことを示すバナーが表示されます。
  3. ［製品の比較を表示］をクリックし、返金のアトリビューション、純収益のレポート、サブスクリプションのライフサイクル全体の計測などの利点を確認します。
  4. ［ROI360を有効にする］をクリックします。
  5. ［App Storeのサーバー通知を有効にする］の手順を実行します。詳しくは、「App Storeのサーバー通知の設定」または「Google Playのサーバー通知の設定」を参照してください。
  6. ［購入・サブスクリプション］セクションで、［製品タイプ］が［ROI360］に変わったことを確認します。
  7. 現在のSDKの設定で、必要なROI360ストア収益の機能を使用できるか確認します。

注意

ROI360ストア収益は、Purchase SDK ConnectorとValidate and Logの2つの連携方法に対応しています。次の機能を利用できるため、Purchase SDK Connectorを推奨します。

  • 取引の自動検出
  • 既存の契約者（連携前に契約したユーザー）の収益の計測
  • サブスクリプションの価格変更への対応。価格変更後も正確に収益を報告できます。

これらの機能が不要な場合は、Validate and Logの連携を引き続き使用できます。

SDKの連携方法の確認

アプリがPurchase SDK ConnectorとValidate and Logのどちらを使用しているか確認するには：

  1. ［SDK Connectorの連携］の手順を開きます。
  2. ［SDK連携をテスト］をクリックします。過去7日間にAppsFlyerがSDKのデータを最後に受信した日時と、送信元がPurchase SDK ConnectorかValidate and Logかが表示されます。

Tags