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

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

1. サブスクリプションオブジェクトをインスタンス化する

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

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
);

購入データを記録する

ユーザーがサブスクリプションを購入した日を記録することができます。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);

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

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);

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

コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。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");

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

パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。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. サブスクリプション情報を記録する

サブスクリプションオブジェクトを設定したら、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);