ROI360 アプリ内課金 (IAP) とサブスクリプションの収益計測

1. Google Play Console で、 Google Play ディベロッパーアカウントに移動します。
2. アカウントを Google Cloud プロジェクトにリンクします。手順については、 こちらの Google ヘルプのトピックを参照してください。
3. Google Play Developer API を有効にします。手順については、 こちらの Google ヘルプのトピックを参照してください。

1. Google Cloud に移動し、1.1 でリンクしたプロジェクトを開きます。
2. プロジェクトで IAM and Admin (IAM と管理者 ) > Service Accounts (サービスアカウント) に移動し、Create service account (サービスアカウントの作成) をクリックします。

3. サービスアカウントの作成ページで、サービスアカウントの詳細ステップを入力します。

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

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

1. サービスアカウントページで、関連する サービスアカウントを見つけ、    キーの管理をクリックします。

2. サービスアカウントページの Keysタブで、ADD KEY > Crete new key をクリックします。

3. Create private keyダイアログで、JSONキータイプを選択します。
4.  Createをクリックしてください。プライベートキーのJSONファイルがダウンロードされます。
5. AppsFlyer管理画面 左メニューから、設定 > 収益設定を選択します。

6. リストから対象のアプリを選択します。
7. Purchases and subscriptionsタブで、をクリックしてJSONファイルをアップロードします。 

1. Google Play Consoleでユーザーと権限に移動します。
2. ユーザーと権限リストで、1.2で作成したサービスアカウントを見つけて、管理をクリックします。

3. Premissions セクションで、Account permissions に移動し、以下の両方を選択してください：
   • View financial data
   • 注文とサブスクリプションの管理。

4. Invite userをクリックし、Send invitationをクリックします。

Google Playから IAP と定期購入の収益データを受け取るために使用する 2つの方法のいずれかを選択します。

以下のいずれかから選択してください。

• AppsFlyer が Google Playから RTDN通知を直接受信するトピックを作成します（この手順に進みます）。

または

• AppsFlyer を既存の PUB/SUB トピックの購読者として設定します（次の手順に進みます）。

AppsFlyer が RTDN通知を直接受信するトピックを作成するには、次の手順を実行します：

1. AppsFlyer管理画面左メニュー 設定 > 収益設定 > 購入＆サブスクリプション を選択し、AppsFlyerトピックがGoogleから直接RTDNメッセージを取得することを許可するを選択します。
   
2. AppsFlyer トピックをクリップボードにコピーします。
3. Google Play コンソール > すべてのアプリでアプリを選択します。ダッシュボードが開きます。
   
4. 収益設定に移動し、Google Play Billingセクションのトピック名フィールドに、サブステップ2でコピーしたAppsFlyerのトピックアドレスを貼り付けます。 
   
5. 通知内容で、サブスクリプション、無効化された購入、およびすべての都度課金アイテムを選択します。
   
6. 変更の保存をクリックします。

IAPとサブスクリプションの通知を受け取る他の方法は、Google Playから通知を受け取る既存のトピックがすでにある場合に適用できます。この場合、新しいトピックを作成する代わりに、AppsFlyerを、既存の PUB/SUB トピックのサブスクライバーとしてサブスクライバーとしてセットします。

既存のPUB/SUBトピックのサブスクライバーとしてAppsFlyerを設定

1. AppsFlyer管理画面 左メニュー 設定 > 収益設定 > 購入＆サブスクリプションタブで、RTDNトピックメッセージをAppsFlyerに転送するを選択します。
2. エンドポイントURLをクリップボードにコピーします。
   
3. Google Cloud Platformのプロジェクトで、 Pub/Subを検索します。
   
4. Pub/Subで トピックセクションに移動し、サブスクリプション専用の pub/sub トピックがあることを確認します。
   
5. Subscriptionセクションで、Create subscriptionをクリックします。
6. Subscription IDを入力します。
7. ドロップダウンから関連するサブスクリプションのパブ/サブスクライブのトピックを選択してください。
   
8. 配信の種類 で、プッシュ を選択してください。
9. ステップ2で取得したエンドポイントURL を入力します。
10. Expiry periodは、Never expireを選択します。
11.  [Save]（保存）をクリックします。
12. Scriptionsセクションで、トピック名をクリップボードにコピーします。
    
13. Google Play Consoleで 収益設定に移動し、 Google Playの お支払い情報セクションのトピック 名  項目に、前の手順でコピーした トピック名を貼り付けます。
    
14. 通知内容で、サブスクリプション、無効化された購入、およびすべての都度課金アイテムを選択します。
    
15.  [Save]（保存）をクリックします。

1. AppsFlyer管理画面 左メニュー 設定 > 収益設定 > 購入＆サブスクリプションタブで、次のどちらか、もしくは両方をオンします：
   
   • Google Playで課金データを検証する
   • 自動更新サブスクリプションを計測する

2. [オプション][ AppsFlyerに、すでにレポートされたトランザクションの重複排除を許可するをオンにします。これにより、重複するトランザクションが記録されなくなります。
3.  [Save]（保存）をクリックします。

サンドボックス環境：

• 初回購入イベントだけが、SDKコネクタがAppsFlyerによって記録されるイベントを生成します。IAPイベントは af_purchase_sandbox_sdk、サブスクリプションイベントは af_ars_sandbox_sdkです。
• 他のすべての購入イベントは削除されるため、ARS SDKコネクタはイベントを生成しません。
• 受信サーバー通知は、SDKコネクタが最初に元のトランザクションを記録する場合にのみ処理されます。この場合、 af_purchase_sandbox_s2sと呼ばれるアプリ内購入イベントが生成されます。サブスクリプションは、イベント名 af_ars_sandbox_s2s と生成されます。
• SDKコネクタが最初に元のトランザクションを記録しなかったサーバー通知に対してイベントは生成されません。
• iOSの場合、App Store connectのApp Store Server Notificationsで、AppsFlyerのエンドポイントがSandbox ServerのURLとして設定されていることを確認してください。
  
• Android の場合、SDK のサンドボックス環境が構成されていない場合でも、ライセンステスターによって実行されるテストではサンドボックスイベントが発生します。

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

1. 開発者に、  Android 、iOS 、および Unity  の 手順に従って SDK Connector でサンドボックス環境を構成するように依頼してください。
2. テスト購入を行います。Google Play の License Tester と iOS の TestFlight から実行されるトランザクションもサポートされています。
   注意： サブスクリプションプロダクトは、各テストデバイスから一度だけテストできます。つまり、同一デバイスから同一サブスクリプションの複数のテスト購入は、記録されないため登録することはできません。
3. AppsFlyer管理画面「アクティビティ」ダッシュボードにイベントが表示されることを確認してください。
   　アプリ内購入はイベント名 af_purchase_sandbox_sdkと計測されます。
   　サブスクリプションはイベント名 af_ars_sandbox_sdk と呼ばれます。
   　　これらのイベントには、次のデータが含まれます：
   
   • 収益値： 0（実際のAppsFlyerレポートを歪めないようにするため）
   • af_sandbox_revenue パラメータに、テスト購入したプロダクトの収益値を含みます。
     このパラメータ値を参照して、正しい収益が計測されていることを確認してください。
4. サブスクリプション計測をテストしている場合は、AppsFlyerがサーバーからサーバー通知を受け取るまでしばらくお待ちください。
   通常、これは最初の購入後数分以内に発生します。
5. AppsFlyer管理画面「アクティビティ」ダッシュボードにイベントが表示されることを確認してください。
   自動更新サブスクリプションの購入は イベント名 af_ars_sandbox_s2s と計測されます。
   イベントには以下のデータが含まれます：
   • 収益値： 0（実際のAppsFlyerレポートを歪めないようにするため）
   • af_sandbox_revenue パラメータに、テスト購入したプロダクトの収益値を含みます。
     このパラメータ値を参照して、正しい収益が計測されていることを確認してください。

説明

ユーザーが購入したときに計測されます。

パラメーター 

• 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

説明

ユーザーが購入をキャンセルしたときに計測されます。

パラメーター 

• 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

説明

ユーザーが購入を実行したが、支払いがまだ処理されていない場合に記録されます。

パラメーター 

• 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

説明

購入が払い戻し（返金）されたときに記録されます。

パラメーター 

• 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 （収益がゼロを超えるイベントに含まれます）
• af_revenue_usd
• 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

説明

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

説明

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

説明

サブスクリプションユーザーがトライアル期間を開始したときに記録されます。

パラメーター 

• 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

説明

トライアル期間中にサブスクライブユーザーがサブスクリプションの自動更新をキャンセルしたときに記録されます。
ユーザーがトライアル期間内に自動更新を復元しない場合、解約イベントが続きます。

パラメーター 

• 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

説明

トライアル期間後にサブスクライブユーザーが解約したときに記録されます。これは、自動更新のキャンセルとトライアル期間の満了後に発生します。また、課金や技術的な問題に続いて、更新によって解約が発生することもあります。

パラメーター 

• 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

説明

トライアル期間後、正規価格の更新が開始されたときに記録されます。

パラメーター 

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

説明

割引または完全価格のサブスクリプションが開始されたときに記録されます。

注記：

• 新しいサブスクリプションは、SDKコネクタを介してのみ記録できます。
• iOSの場合、サブスクライブユーザーが既に所有しているサブスクリプションを再購入すると、SDKコネクタはレシートの検証が成功したことをアプリにレポートしますが、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 （収益がゼロを超えるイベントに含まれます）
• af_revenue_usd
• 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

説明

請求期間の途中で自動更新サブスクリプションがキャンセルされたときに記録されます。ユーザーが同じ請求期間内に自動更新を復元しない場合、解約イベントが続きます。

パラメーター 

• 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

説明

ユーザーがアクティブなサブスクリプションを一時停止したときに記録されます。

パラメーター 

• 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

説明

解約または返金されたサブスクリプションの後に、完全価格のサブスクリプションが再開されたときに記録されます。

パラメーター 

• 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 （イベント収益がゼロを超えるイベントに含まれます）
• af_revenue_usd
• af_revenue
• af_net_revenue
• af_net_revenue_factors

説明

サブスクライブユーザーが解約したときに記録されます。これは通常、自動更新のキャンセルまたは請求期間の満了後に発生します。また、課金や技術的な問題に続いて、更新によって解約が発生することもあります。

パラメーター 

• 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

説明

加入者が払い戻しを受けたときに記録されます。

注記：

• このイベントは通常、マイナス値と共に生成されます。どのトランザクションが返金されたかを検出できない場合、または返金の詳細が通知に含まれていない場合、返金イベントには何の値も表示されません。

パラメーター 

• 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 （収益がゼロを超えるイベントに含まれます）
• af_product_id
• android_id
• idfa
• ip
• appsflyer_id
• af_store
• af_environment
• af_period_type
• af_revenue_usd
• 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

説明

請求の問題が原因でサブスクリプションの更新に失敗し、サブスクライブユーザーが請求猶予期間に入ったときに記録されます。

パラメーター 

• 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

説明

自動更新サブスクリプションがいつ行われたかを記録します。

パラメーター 

• 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 （収益がゼロを超えるイベントに含まれます）
• af_revenue_usd
• af_revenue
• af_net_revenue
• af_net_revenue_factors

説明

サブスクライブユーザーが別のサービスにアップグレード、ダウングレード、またはプラン変更したときに記録されます。

パラメーター 

• 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 （収益がゼロを超えるイベントに含まれます）
• af_revenue_usd
• af_revenue
• af_net_revenue
• af_net_revenue_factors

説明

サブスクライバーを別の関連するライフサイクル ステージに移行させるフォローアップサーバー通知を取得する前に、SDKコネクタが請求サイクルの途中でサブスクライバーについて通知されたときに記録されます。このイベントは通常、オンボーディングとSDKコネクタの導入期間中に生成されます。

パラメーター 

• 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

説明

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

説明

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