サブスクリプション情報を送信する

App StoreおよびPlay Storeのサブスクリプションを計測し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含むAdjustAppStoreSubscriptionまたはAdjustPlayStoreSubscriptionを作成してください。

1. サブスクリプションオブジェクトをインスタンス化する {#instantiate-a-subscription-object}

開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。

App Store
Play Store

AdjustAppStoreSubscription(String _price, String _currency, String _transactionId, String _receipt)

以下のプロパティを含むAdjustAppStoreSubscriptionオブジェクトを作成します：

パラメーター	データタイプ	説明
`price`	`String`	サブスクリプションの価格
`currency`	`String`	サブスクリプションの通貨。`priceLocale`オブジェクトの`currencyCode`としてフォーマットされる
`transactionId`	`String`	トランザクションID
`receipt`	`String`	レシート情報

1
AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId,
5
   receipt);

AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken)

以下のプロパティを含むAdjustPlayStoreSubscriptionオブジェクトを作成します：

パラメーター	データタイプ	説明
`price`	`String`	サブスクリプションの価格
`currency`	`String`	サブスクリプション通貨
`sku`	`String`	プロダクトID
`orderId`	`String`	トランザクションID
`signature`	`String`	購入データのシグネチャー
`purchaseToken`	`String`	トランザクションの一意のトークン。詳細はGoogleのドキュメントを参照してください

1
AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
2
   price,
3
   currency,
4
   sku,
5
   orderId,
6
   signature,
7
   purchaseToken);

購入データを記録する

ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。

App Store
Play Store

void setTransactionDate(String _transactionDate)

サブスクリプションオブジェクトでsetTransactionDateメソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。

1
AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId,
5
   receipt);
6
//...
7
subscription.setTransactionDate(transactionDate);

void setPurchaseTime(String purchaseTime)

サブスクリプションオブジェクトでsetPurchaseTimeメソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。

1
AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
2
   price,
3
   currency,
4
   sku,
5
   orderId,
6
   signature,
7
   purchaseToken);
8
subscription.setPurchaseTime(purchaseTime);

購入地域を記録する（iOSのみ）

void setSalesRegion(String _salesRegion)

ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトのsetSalesRegionメソッドを呼び、国コードをStringとしてパスします。これは、priceLocaleオブジェクトのcountryCodeとしてフォーマットされる必要があります。

1
AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId,
5
   receipt);
6
//...
7
subscription.setSalesRegion(salesRegion);

コールバックパラメーターを追加する

コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトのaddCallbackParameterメソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。

App Store
Play Store

void addCallbackParameter(String key, String value)

1
AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId,
5
   receipt);
6
//...
7
subscription.addCallbackParameter('key1', 'value1');
8
subscription.addCallbackParameter('key2', 'value2');

void addCallbackParameter(String key, String value)

1
AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
2
   price,
3
   currency,
4
   sku,
5
   orderId,
6
   signature,
7
   purchaseToken);
8
//...
9
subscription.addCallbackParameter('key1', 'value1');
10
subscription.addCallbackParameter('key2', 'value2');

パートナーパラメーターを追加する

パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトのaddPartnerParameterメソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。

App Store
Play Store

void addPartnerParameter(String key, String value)

1
AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId,
5
   receipt);
6
//...
7
subscription.addPartnerParameter('key1', 'value1');
8
subscription.addPartnerParameter('key2', 'value2');

void addPartnerParameter(String key, String value)

1
AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
2
   price,
3
   currency,
4
   sku,
5
   orderId,
6
   signature,
7
   purchaseToken);
8
//...
9
subscription.addPartnerParameter('key1', 'value1');
10
subscription.addPartnerParameter('key2', 'value2');

2. サブスクリプション情報を記録する {#record-subscription-information}

サブスクリプションオブジェクトを設定したら、Adjust SDKを使用して記録することが可能です。

App Store
Play Store

static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription)

完了したオブジェクトを trackAppStoreSubscriptionメソッドにパスして、ユーザーのサブスクリプション購入を記録します。

1
AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId,
5
   receipt);
6
subscription.setTransactionDate(transactionDate);
7
subscription.setSalesRegion(salesRegion);
8
subscription.addCallbackParameter('key1', 'value1');
9
subscription.addCallbackParameter('key2', 'value2');
10
subscription.addPartnerParameter('key1', 'value1');
11
subscription.addPartnerParameter('key2', 'value2');
12

13
Adjust.trackAppStoreSubscription(subscription);

static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription)

完了したオブジェクトを trackPlayStoreSubscriptionメソッドにパスして、ユーザーのサブスクリプション購入を記録します。

1
AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
2
   price,
3
   currency,
4
   sku,
5
   orderId,
6
   signature,
7
   purchaseToken);
8
subscription.setPurchaseTime(purchaseTime);
9
subscription.addCallbackParameter('key1', 'value1');
10
subscription.addCallbackParameter('key2', 'value2');
11
subscription.addPartnerParameter('key1', 'value1');
12
subscription.addPartnerParameter('key2', 'value2');
13

14
Adjust.trackPlayStoreSubscription(subscription);