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

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

1. Instantiate a subscription object

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

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

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

Swift
Objective-C

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

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

Record the purchase date

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

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

Swift
Objective-C

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

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

Record the purchase region

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

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

Swift
Objective-C

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

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

Add callback parameters

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

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

Swift
Objective-C

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

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

Add partner parameters

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

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

Swift
Objective-C

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

1
ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription 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)trackAppStoreSubscription:(nonnull ADJAppStoreSubscription *)subscription;

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

Swift
Objective-C

1
let subscription = ADJAppStoreSubscription(
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.trackAppStoreSubscription(subscription)

1
ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription 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 trackAppStoreSubscription:subscription];