发送订阅信息

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

1. Instantiate a subscription object

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

App Store
Play 商店

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

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

Record the purchase date

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

App Store
Play 商店

在AdjustAppStoreSubscription类中添加transactionDate属性。

String? transactionDate

为subscription实例的transactionDate属性设置时间戳，记录用户购买订阅的日期。

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

在AdjustPlayStoreSubscription类中添加purchaseTime属性。

String? purchaseTime;

为subscription实例的purchaseTime属性设置时间戳，记录用户购买订阅的日期。

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

Record the purchase region (iOS only)

String? salesRegion

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

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

Add callback parameters

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

App Store
Play 商店

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');

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');

Add partner parameters

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

App Store
Play 商店

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');

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 商店

static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription)

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

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

static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription)

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

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