发送订阅信息

您可以用 Adjust SDK 记录 App Store 和 Play 应用商店的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 AdjustAppStoreSubscription 或 AdjustPlayStoreSubscription 实例。

1. 实例化订阅对象

要开始设置，先创建一个包含订阅购买细节的订阅对象。

App Store
Play 商店

constructor(price: string, currency: string, transactionId: string: string)

创建一个 AdjustAppStoreSubscription 对象，属性如下：

|参数 |数据类型 |描述 | | --------------- | --------- | -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------- | --- | | price | string |订阅价格 | | currency | string |订阅的币种。格式为 priceLocale对象的currencyCode | | transactionId | string | 交易的 ID | |

1
var subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId,
5
);
6
Adjust.trackAppStoreSubscription(subscription);

constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string)

创建一个 AdjustPlayStoreSubscription 对象，属性如下：

参数	数据类型	描述
`price`	`string`	订阅价格
`currency`	`string`	订阅使用的币种
`sku`	`string`	产品 ID
`orderId`	`string`	您的交易 ID
`signature`	`string`	购买数据的签名
`purchaseToken`	`string`	交易唯一识别码。请参考Google 的文档，了解更多信息。

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

记录购买日期

您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。

App Store
Play 商店

public setTransactionDate(transactionDate: string): void

在您的订阅对象上调用 setTransactionDate 方法来记录订阅的时间戳。

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

7
subscription.setTransactionDate(transactionDate);
8
Adjust.trackAppStoreSubscription(subscription);

public setPurchaseTime(purchaseTime: string): void

在您的订阅对象上调用 setPurchaseTime 方法来记录订阅的时间戳。

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

记录购买地区 (仅限 iOS)

public setSalesRegion(salesRegion: string): void

您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 setSalesRegion 方法并将国家代码作为 string 传递。此信息格式需为 Storefront 对象的 countryCode。

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

7
subscription.setSalesRegion(salesRegion);
8
Adjust.trackPlayStoreSubscription(subscription);

添加回传参数

您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 addCallbackParameter 方法。多次调用该方法可添加多个回传参数。

App Store
Play 商店

public addCallbackParameter(key: string, value: string): void

1
var subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId,
5
);
6
subscription.setTransactionDate(transactionDate);
7
subscription.setSalesRegion(salesRegion);
8

9
subscription.addCallbackParameter("key1", "value1");
10
subscription.addCallbackParameter("key2", "value2");
11

12
Adjust.trackAppStoreSubscription(subscription);

public addCallbackParameter(key: string, value: string): void

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

10
subscription.addCallbackParameter("key1", "value1");
11
subscription.addCallbackParameter("key2", "value2");

添加合作伙伴参数

您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用addPartnerParameter方法。多次调用该方法可添加多个合作伙伴参数。

App Store
Play 商店

public addPartnerParameter(key: string, value: string): void

1
var subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId,
5
);
6
subscription.setTransactionDate(transactionDate);
7
subscription.setSalesRegion(salesRegion);
8

9
subscription.addPartnerParameter("key1", "value1");
10
subscription.addPartnerParameter("key2", "value2");
11

12
Adjust.trackAppStoreSubscription(subscription);

public addPartnerParameter(key: string, value: string): void

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

10
subscription.addPartnerParameter("key1", "value1");
11
subscription.addPartnerParameter("key2", "value2");

2. 记录订阅信息

设置好订阅对象后，您就可以通过 Adjust SDK 对其进行记录了。

App Store
Play 商店

trackAppStoreSubscription: (subscription: AdjustAppStoreSubscription) => void

将订阅对象传送至 trackAppStoreSubscription 方法，以记录用户订阅购买。

1
var subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId,
5
);
6
subscription.setTransactionDate(transactionDate);
7
subscription.setSalesRegion(salesRegion);
8

9
Adjust.trackAppStoreSubscription(subscription);

trackPlayStoreSubscription: (subscription: AdjustPlayStoreSubscription) => void

将订阅对象传送至 trackPlayStoreSubscription 方法，以记录用户订阅购买。

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

11
Adjust.trackPlayStoreSubscription(subscription);