ROI360 ストア収益の設定

1. ROI360 ストア収益を有効化します。 
2. 「App Store Connect keys」ステップ内の「In-App Purchase key」欄で「 Upload 」をクリックし、.p8 ファイルをアップロードします。

3. 「App Store Connect keys」というタイトルのセクションに、App Store Connectからコピーした以下の値を貼り付けます。

   • Key ID
   • Issue ID
4. 「キーの検証」をクリックして、入力したキーが正しいことを確認します。 注意：アプリがまだApp Storeへ公開されていない場合、「キーの検証」が正常に動作しない場合があります。
5. 「保存して次へ」をクリックします。

前提条件：Google Play ConsoleおよびGoogle Cloud Projectへのアクセス権限

Google Play Developer AccountをGoogle Cloud Projectへリンクするには、以下の手順を実施してください：

1. Google Play Consoleで、Google Play Developer Accountへ移動します。
2. Google Cloud Projectへアカウントをリンクします。手順については、Googleのヘルプトピックを参照してください。

3. Google Play Developer APIを有効化します。手順については、Googleのヘルプトピックを参照してください。

   

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

サービスアカウントを設定するには、以下の手順を実施してください：

1. サービスアカウントを作成または確認する：

   1. Google Cloud Platformの「サービスアカウント」セクションへ移動し、「サービスアカウントの作成」をクリックします。

      

   2. サービスアカウント情報を入力します。

      

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

      

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

      

   5. このサービスアカウントにプロジェクトへのアクセス権を付与するステップで、  Pub/sub subscriber のロールを選択します。

      

   6. 続行 > 完了をクリックします。

      

2. サービスアカウントのプライベートキーをダウンロードする：
   1. Google Cloud Platform上で一覧から対象のサービスアカウント（先ほど作成したアカウント）を探し、「More actions」アイコンをクリックします。

   2. キーの管理をクリックします。

      

   3. キーの追加 > 新しいキーを作成をクリックしてください。

      

   4. プライベートキーの作成のポップアップで、キーの種類を選択し、JSONを選択、作成をクリックします。

      

   5.  Createをクリックしてください。プライベートキーのJSONファイルがダウンロードされます。

      

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

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

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

AppsFlyerへサービスアカウントのプライベートキーをアップロードするには、以下の手順を実施してください：

1. ROI360 ストア収益を有効化します。 
2. 「Service Account Key and Permissions」ステップ内の「Upload Google JSON key」欄で、 （アップロードアイコン）をクリックします。
3. ステップ1.2でダウンロードしたJSONファイルをアップロードします。
4. 「キーの検証」をクリックします 注意：
   • サービスアカウントの認証情報と権限を設定した後、それらを使用できるようになるまでに最大24時間かかる場合があります。これにより、キーの検証または検証テストの実行時にエラーが発生する可能性があります。
   • この24時間待機を回避するには、Google Play Consoleで任意アプリへ移動し、「Monetize > Products > Subscriptions/In-app products」を開き、商品の説明文を編集して保存するなど、何らかの変更を加えてください。これにより、アカウント認証情報および権限設定が即時更新されます。更新後、変更内容は元に戻して問題ありません。
5. 「保存して次へ」をクリックします。

AppsFlyerのサーバー通知エンドポイントをコピーするには、以下の手順を実施してください：

1. AppsFlyer上で、 「App Storeサーバー通知」のステップへ移動し、サーバー通知エンドポイントをコピーします。
2. 以前から別のApp Storeサーバー通知エンドポイントを使用しており、AppsFlyer経由で通知転送したい場合は、「Forward a copy of notifications to your server」を選択します（Option 1のみ対象）。
3. 表示されたテキストボックスへ、通知転送先エンドポイントを入力します。

AppsFlyerへ通知を直接送信するには、AppsFlyerをPrimary App Store Server Notifications Endpointとして設定します。

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

   

2. AppsFlyerからコピーしたAppsFlyerサーバー通知エンドポイントを貼り付け、バージョン2 通知を選択して保存をクリックします。 注意：バージョン1の通知はサポートを終了しています。 Notification Version SelectorがApple Store Connect上に表示されない場合、すでにVersion 2を利用しています。

   

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

   

4. AppsFlyerからコピーしたAppsFlyerサーバー通知エンドポイントを貼り付け、バージョン2 通知を選択して保存をクリックします。注意：バージョン1の通知はサポートを終了しています。 Notification Version SelectorがApple Store Connect上に表示されない場合、すでにVersion 2を利用しています。

   

この手順は、通知をAppsFlyerへ直接送信せず、自社エンドポイントをPrimary Destinationとして維持したい場合のみ使用してください。

この構成は推奨設定ではなく、バックエンド実装が必要です。上記の手順2.2でAppsFlyerをプライマリエンドポイントとして設定済みの場合は、この手順をスキップしてください。

自社エンドポイントからAppsFlyerへサーバー通知を転送するには、以下の手順を実施してください：

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

   

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

   

3. [バージョン2の通知]を選択します。注意： バージョン1の通知はサポートを終了しています。Notification Version SelectorがApple Store Connect上に表示されない場合、すでにVersion 2を利用しています。
4. 保存をクリックします。

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

   

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

   

7. [バージョン2の通知]を選択します。注意： バージョン1の通知はサポートを終了しています。
8. 保存をクリックします。
9. 自社バックエンド側で、Appleのサーバー通知をAppsFlyerの通知エンドポイントURLへ転送するよう設定します。リクエスト内容は、Appleから受信したApp Store Payloadと完全に一致している必要があります。詳細は「 Apple format requirements」を参照してください。

1. AppsFlyerの管理画面上で、ステップ2「Google Playのサーバー通知を設定する」へ移動し、「Googleから直接RTDNメッセージを取得するためにAppsFlyerトピックの許可」を選択します。
2. AppsFlyer トピックをクリップボードへコピーします。

3. Google Play Console > Homeで、対象アプリを選択するとダッシュボードが開きます。

   

4. 「Monetize with Play」 > 「Monetization setup」へ移動し、「Google Play Billing」のセクションで「Enable real-time notification」が有効になっていることを確認します。

   

5. 「Topic name」のフィールドへ、AppsFlyerからコピーしたトピックアドレスを貼り付けます。

   

6. 通知内容で、サブスクリプション、無効になった購入、およびすべての一回限りのプロダクトを選択します。

   

7. 変更の保存をクリックします。設定反映まで時間がかかる場合があります（最大24時間程度）。そのため、テスト実行前にしばらく待機してください。

注意：この手順は、Google Playからのアプリ内課金およびサブスクリプション売上データを取得する推奨方法（Google PlayのRTDN通知をAppsFlyerが直接受信するトピックを作成する方法）を選択しなかった場合にのみ必要です。AppsFlyerがGoogle PlayのRTDN通知を直接受信するための推奨設定が完了している場合は、この手順をスキップしてください。

既存のPub/SubトピックにAppsFlyerをサブスクライバーとして追加したい場合は、以下の手順に従ってください。

前提条件：Google Cloud PlatformおよびAppsFlyer管理画面へのアクセス権限が必要です。

Google Play通知をAppsFlyerへ転送する方法：

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

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

   

6. Pub/Subの Topics セクションに移動し、サブスクリプション用の専用Pub/Subトピックが存在することを確認します。

   

7. Pub/Subの Subscriptions セクションに移動し、Create Subscriptions をクリックします。

   

8. Subscription IDを入力します。

   

9. ドロップダウンから関連するサブスクリプションのパブ/サブスクライブのトピックを選択してください。

   

10. 配信の種類 で、プッシュ を選択してください。

    

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

    

12. 有効期限 で、有効期限なし を選択します。

    

13.  Createをクリックしてください。

    

14. サブスクリプションセクションに移動し、クリックして希望するトピック名を選択してください。

    

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

    

16. Google Play Consoleで、Monetize with Play >

17. Monetization setup に移動し、Google Play Billingセクションの Topic nameフィールドに、前の手順でコピーしたトピック名を貼り付けます。通知内容で、サブスクリプション、無効になった購入、およびすべての一回限りのプロダクトを選択します。

    

18. 変更を保存をクリックしてください。設定反映まで時間がかかる場合があります（最大24時間程度）。そのため、テスト実行前にしばらく待機してください。

AppsFlyerが過去7日間にアプリから有効な購入イベントおよびサブスクリプションイベントのペイロードを受信しているか確認するには、以下の手順を実施します。

1. Verify SDK implementationのステップで Test SDK implementation をクリックします。

2. AppsFlyerが最後に受信したペイロードのタイムスタンプを含む結果を確認します。

    注意

   このテストでは、リクエストがAppsFlyerへ到達していることのみを確認します。データの完全性や正確性までは検証しません。

3. 実装を完全に検証するには、以下のテスト手順も実施してください。

前提条件：

• iOSの場合は、App Store Connectの App Store Server Notifications において、AppsFlyerのエンドポイントがSandbox Server URLとして設定されていることを確認してください。

  

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

1. 開発担当者に、Android、iOS、Unity向けの手順に従ってSDK Connectorのサンドボックス環境を設定してもらいます。
2. Google Playのライセンステスターを使用してテスト購入またはサブスクリプション登録を行います。またはiOSの場合は、TestFlightを使用します。注意：サブスクリプション商品は1つのデバイスにつき1回しかテストできません。実際には、同じデバイスで同一サブスクリプション商品のテスト購入を複数回行うことはできず、追加の試行は記録されません。
3. Google PlayのライセンステスターおよびiOSのTestFlightを使用して、返金、サブスクリプション更新、またはサブスクリプション解約のテストを行います。注意：サブスクリプション商品をテストする場合は、AppsFlyerがストアからサーバー通知を受信するまで待機してください。通常、通知は初回購入から数分以内に送信されます。
4. Verify SDK connector implementation のステップで Test SDK implementation をクリックします。過去7日間にPurchase ConnectorからSDKペイロードが正常に受信されたかどうかが表示されます。

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

   • Live Event Viewerでイベントを確認する
   • マイダッシュボードのアクティビティビューでイベントデータを確認する
6. アクティビティダッシュボードにイベントが表示されていることを確認します。AppsFlyerの管理画面上で、 分析 > アクティビティ に移動し、Activity Trend Chartの アプリ内イベントタブを開いてテスト対象のイベントを選択します。自動更新型サブスクリプション購入イベントは af_ars_s2s_sandbox として記録されます。このイベントには以下が含まれます。
   • 収益値：0（AppsFlyerの実際のレポートへ影響を与えないため）
   • 購入された商品の収益額を含む af_sandbox_revenue パラメーター（正しい収益がレポートされるようにするため）