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

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

1. Instantiate a subscription object

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

App Store
Play Store

AdjustAppStoreSubscription(String _price, String _currency, String _transactionId)

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

|パラメーター |データタイプ |説明 | | --------------- | --------- | -------------------------------------- -------------------------------------- -------------------------------------- -------------------------------------- -------------------------------------- -------------------------------------- | --- | | price | String |サブスクリプションの価格 | | currency | String |サブスクリプションの通貨。 currencyCodeオブジェクトのpriceLocaleとしてフォーマット| | transactionId | String | トランザクションのためのID| |

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

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

Record the purchase date

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

App Store
Play Store

AdjustAppStoreSubscriptionクラスにtransactionDateプロパティを追加します。

String? transactionDate

subscriptionインスタンスのtransactionDateプロパティにタイムスタンプを設定し、ユーザーがサブスクリプションを購入した日を記録します。

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

AdjustPlayStoreSubscriptionクラスにpurchaseTimeプロパティを追加します。

String? purchaseTime;

subscriptionインスタンスのpurchaseTimeプロパティにタイムスタンプを設定し、ユーザーがサブスクリプションを購入した日を記録します。

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

Record the purchase region (iOS only)

String? salesRegion

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

1
AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId);
5
//...
6
subscription.salesRegion = 'sales-region';

Add callback parameters

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

Add partner parameters

パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。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
//...
6
subscription.addPartnerParameter('key1', 'value1');
7
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
subscription.transactionDate = 'transactionDate';
6
subscription.salesRegion = 'salesRegion';
7
subscription.addCallbackParameter('key1', 'value1');
8
subscription.addCallbackParameter('key2', 'value2');
9
subscription.addPartnerParameter('key1', 'value1');
10
subscription.addPartnerParameter('key2', 'value2');
11

12
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.purchaseTime = 'purchase-time';
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);