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

App Storeのサブスクリプションを記録し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含むADJSubscriptionインスタンスを作成します。

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

- (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price
                    currency:(nonnull NSString *)currency
               transactionId:(nonnull NSString *)transactionId;

開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。これを行うには、initWithPriceメソッドを使用してADJSubscriptionオブジェクトを初期化します。さらに、以下の引数をパスします。

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

Swift
Objective-C

1
let subscription = ADJSubscription(
2
    price: price,
3
    currency: currency,
4
    transactionId: transactionId)

1
ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price
2
                                                              currency:currency
3
                                                         transactionId:transactionId];

購入データを記録する

- (void)setTransactionDate:(nonnull NSDate *)transactionDate;

ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。タイムスタンプを使用してsetTransactionDateメソッドを呼び出し、この情報を記録します。

Swift
Objective-C

1
let subscription = ADJSubscription(
2
    price: price,
3
    currency: currency,
4
    transactionId: transactionId,)
5
// ...
6
subscription.setTransactionDate(transactionDate)

1
ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price
2
                                                              currency:currency
3
                                                         transactionId:transactionId];
4
/// ...
5
[subscription setTransactionDate:transactionDate];

購入地域を記録する

- (void)setSalesRegion:(nonnull NSString *)salesRegion;

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

Swift
Objective-C

1
let subscription = ADJSubscription(
2
    price: price,
3
    currency: currency,
4
    transactionId: transactionId)
5
// ...
6
subscription.setSalesRegion(salesRegion)

1
ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price
2
                                                              currency:currency
3
                                                         transactionId:transactionId];
4
/// ...
5
[subscription setSalesRegion:salesRegion];

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

- (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value;

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

Swift
Objective-C

1
let subscription = ADJSubscription(
2
    price: price,
3
    currency: currency,
4
    transactionId: transactionId)
5
// ...
6
subscription.addCallbackParameter("key1", value: "value1")
7
subscription.addCallbackParameter("key2", value: "value2")

1
ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price
2
                                                              currency:currency
3
                                                         transactionId:transactionId];
4
/// ...
5
[subscription addCallbackParameter:@"key1" value:@"value1"];
6
[subscription addCallbackParameter:@"key2" value:@"value2"];

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

- (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value;

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

Swift
Objective-C

1
let subscription = ADJSubscription(
2
    price: price,
3
    currency: currency,
4
    transactionId: transactionId)
5
// ...
6
subscription.addParameterParameter("key1", value: "value1")
7
subscription.addParameterParameter("key2", value: "value2")

1
ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price
2
                                                              currency:currency
3
                                                         transactionId:transactionId];
4
/// ...
5
[subscription addParameterParameter:@"key1" value:@"value1"];
6
[subscription addParameterParameter:@"key2" value:@"value2"];

2. サブスクリプション情報を送信する {#send-subscription-information}

+ (void)trackSubscription:(nonnull ADJSubscription *)subscription;

サブスクリプションオブジェクトを設定したら、Adjust SDKを使用してそれをAdjustに送信できます。完了したオブジェクトを trackSubscriptionメソッドにパスして、ユーザーのサブスクリプション購入を記録します。

Swift
Objective-C

1
let subscription = ADJSubscription(
2
   price: price,
3
   currency: currency,
4
   transactionId: transactionId)
5

6
subscription.setTransactionDate(transactionDate)
7
subscription.setSalesRegion(salesRegion)
8

9
// Add callback parameters
10

11
subscription.addCallbackParameter("key1", value: "value1")
12
subscription.addCallbackParameter("key2", value: "value2")
13

14
// Add partner parameters
15

16
subscription.addPartnerParameter("key1", value: "value1")
17
subscription.addCallbackParameter("key2", value: "value2")
18

19
Adjust.trackSubscription(subscription)

1
ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price
2
                                                            currency:currency
3
                                                         transactionId:transactionId];
4
[subscription setTransactionDate:transactionDate];
5
[subscription setSalesRegion:salesRegion];
6

7
/// Add callback parameters
8
[subscription addCallbackParameter:@"key1" value:@"value1"];
9
[subscription addCallbackParameter:@"key2" value:@"value2"];
10

11
/// Add partner parameters
12
[subscription addPartnerParameter:@"key1" value:@"value1"];
13
[subscription addPartnerParameter:@"key2" value:@"value2"];
14

15
[Adjust trackSubscription:subscription];