サブスクリプション（定額課金）計測ガイド

サーバー間(S2S)サブスクリプションイベント

サーバー間(S2S)でのイベント計測方法を使用すると、リアルタイムもしくはバルクでの計測が可能になります。サーバー間(S2S)イベント計測を実装するには開発バックエンドにてロジックを設計する必要があり、そのバックエンドロジックがサブスクリプションの新規申し込みと更新を管理し、必要に応じてそのイベントをAppsFlyerへ送信することになります。

サブスクリプション機能について

サブスクリプションの支払いは次のいずれかによって処理されます。

• GooglePlay内のAndroidアプリ - Google Play Billing Services
• GooglePlay外のAndroidアプリ - サードパーティの支払い処理プロバイダ(PayPal、Stripeなど)
• iOSアプリ - App Store Billing Services

AppsFlyerへのイベント送信

ユーザーによる支払いが完了すると、支払い処理プロバイダはお客様側のバックエンドサービスへ通知し、その通知をもってサブスクリプションがユーザーへ適用されます。一旦お客様のバックエンドサービス側でサブスクリプションの申込/更新がで登録された際に、以下手順を実行する必要があります。

1. お客様側のサーバーで、課金額、購読タイプ、ユーザーID、更新時期などの必要なデータを収集。
2. お客様側のサーバーからAppsFlyerに対してサブスクリプションの更新イベントとして送信。

フォーマットとイベント送信について

サブスクリプションイベントのリクエスト例:

HTTP POST https://api2.appsflyer.com/inappevent/<APP_ID>
HTTP/1.1
headers:
{
  authentication: '<YOUR_DEV_KEY>',
  Host: 'api2.appsflyer.com',
  Accept: 'application/json',
  'Content-Type': 'application/json'
}
body: 
{
 "appsflyer_id":"<APPS_FLYER_ID>",
"customer_user_id":"123456",
 "eventName":"af_subscribe",
 "eventValue":"{\"af_revenue\":\"200\",\"af_content_id\":\"092\",\"renewal\":\"true\"}",
 "eventCurrency":"USD",
 "ip":"1.0.0.0",
 "eventTime":"2018-07-09 4:17:00.000",
"af_events_api" :"true"
}

フォーマットとAppsFlyerへのイベント送信方法の詳細については、サーバ間(S2S)イベントの送信のページをご参照ください。

アプリ内イベントでの計測

サブスクリプション特有の機能を有効化させるために、アプリにてサブスクリプションのステータス確認をしばしば行う必要があります。まさにこの仕組みをAppsFlyerでのサブスクリプションイベント計測に使用し、一旦アプリがサブスクリプションの申込(課金)、更新を認識すればイベントの送信が可能です。

アプリ内でのステータス確認

サーバーと通信するか、サブスクリプションに関するデータをプッシュ通知で受け取ることで、アプリはサブスクリプションのステータスを確認することができます。

サブスクリプションのステータスをアプリ内で確認するよう設定するには、以下2つの方法があります。

1. アプリ側でサブスクリプションのステータスと関連データ(有効か無効か、購読タイプ、有効期限など)を確認する。
2. アプリ側で、サブスクリプションの申込み/更新に関するPush通知を受け取る。

サブスクリプション関連のアプリ内イベントの送信について

アプリ側でサブスクリプションに関するデータを取得した際には、以下手順を実行する必要があります。

1. アプリ側でそのサブスクリプションイベントが新規申込みか更新を確認。
2. アプリ側で関連するデータ(課金額、content_id,、新規申込み or 更新、など)を取得。
3. SDKを使用して、そのサブスクリプションイベントをAppsFlyerへ送信。

サブスクリプションイベントの例

イベントコード例

以下のコードスニペットは、SDKを使用したイベントの設定・送信方法を示しています。

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.REVENUE, 200);
eventValue.put(AFInAppEventParameterName.CURRENCY, "USD");
eventValue.put(AFInAppEventParameterName.CONTENT_ID, "092"); 
eventValue.put("renewal",true); 
AppsFlyerLib.getInstance().trackEvent(getApplicationContext(),AFInAppEventType.SUBSCRIBE, eventValue);

[[AppsFlyerTracker sharedTracker] trackEvent:(AFEventSubscribe) withValues: @{
  AFEventParamRevenue: @200,
  AFEventParamCurrency: @"USD",
  AFEventParamContentId: @"092",
  @"renewal": @TRUE
}];

AppsFlyerTracker.shared().trackEvent(AFEventSubscribe,withValues: [
 AFEventParamRevenue: 200,
 AFEventParamCurrency: "USD",
 AFEventParamContentId: "092",
 "renewal": true
]);

Dictionary<string, string> SubscriptionEvent = new Dictionary<string, string>();
SubscriptionEvent.Add("af_revenue", "200");
SubscriptionEvent.Add("af_currency", "USD");
SubscriptionEvent.Add("af_content_id", "092");
SubscriptionEvent.Add("renewal", "true");
AppsFlyer.trackRichEvent("af_subscribe", SubscriptionEvent);