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

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

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

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

App Store
Play Store

public AdjustAppStoreSubscription(string price, string currency, string transactionId);

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

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

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

public 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
AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   sku,
5
   orderId,
6
   signature,
7
   purchaseToken);

購入データを記録する

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

App Store
Play Store

public string TransactionDate { get; set; }

AdjustAppStoreSubscriptionインスタンスのsetTransactionDateプロパティを設定し、サブスクリプションのタイムスタンプを記録します。

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

public string PurchaseTime { get; set; }

AdjustPlayStoreSubscriptionインスタンスのPurchaseTimeプロパティを設定し、サブスクリプションのタイムスタンプを記録します。

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

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

public string SalesRegion { get; set; }

ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、 AdjustPlayStoreSubscriptionインスタンスのSalesRegionプロパティをstringとして国コードに設定します。これは、StorefrontオブジェクトのcountryCodeとしてフォーマットされる必要があります。

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

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

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

App Store
Play Store

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

public 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

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

public 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

public static void TrackAppStoreSubscription(AdjustAppStoreSubscription subscription);

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

1
AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId);
5
subscription.TransactionDate = transactionDate;
6
subscription.AalesRegion = 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);

public static void TrackPlayStoreSubscription(AdjustPlayStoreSubscription subscription);

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

1
AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
2
   price,
3
   currency,
4
   sku,
5
   orderId,
6
   signature,
7
   purchaseToken);
8
subscription.PurchaseTime = 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);