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

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

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

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

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

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

購入データを記録する

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

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

購入地域を記録する

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

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

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

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

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

パートナーパラメーターの追加

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

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

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

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

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