サブスクリプション情報の送信

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

1. Instantiate a subscription object

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

App Store
Play Store

constructor(price: string, currency: string, transactionId: string, receipt: string)

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

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

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

constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string)

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

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

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

Record the purchase date

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

App Store
Play Store

setTransactionDate(transactionDate: string): void

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

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

8
subscription.setTransactionDate(transactionDate);

setPurchaseTime(purchaseTime: string): void

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

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

Record the purchase region (iOS only)

setSalesRegion(salesRegion: string): void

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

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

8
subscription.setSalesRegion(salesRegion);

Add callback parameters

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

App Store
Play Store

addCallbackParameter(key: string, value: string): void

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

8
subscription.addCallbackParameter("key1", "value1");
9
subscription.addCallbackParameter("key2", "value2");

addCallbackParameter(key: string, value: string): void

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

10
subscription.addCallbackParameter("key1", "value1");
11
subscription.addCallbackParameter("key2", "value2");

Add partner parameters

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

App Store
Play Store

addPartnerParameter(key: string, value: string): void

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

8
subscription.addPartnerParameter("key1", "value1");
9
subscription.addPartnerParameter("key2", "value2");

addPartnerParameter(key: string, value: string): void

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

10
subscription.addPartnerParameter("key1", "value1");
11
subscription.addPartnerParameter("key2", "value2");

2. Record subscription information

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

App Store
Play Store

trackAppStoreSubscription(subscription: AdjustAppStoreSubscription): void

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

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

14
Adjust.trackAppStoreSubscription(subscription);

trackPlayStoreSubscription(subscription: AdjustPlayStoreSubscription): void

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

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

15
Adjust.trackPlayStoreSubscription(subscription);