发送订阅信息

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

1. Instantiate a subscription object

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

App Store
Play 商店

AdjustAppStoreSubscription(String _price, String _currency, String _transactionId, String _receipt)

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

参数	数据类型	描述
`price`	`String`	订阅价格
`currency`	`String`	订阅使用的币种。此信息格式为 `priceLocale` 对象的 `currencyCode`。
`transactionId`	`String`	您的交易 ID
`receipt`	`String`	收据信息

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

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

void setTransactionDate(String _transactionDate)

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

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

void setPurchaseTime(String purchaseTime)

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

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

Record the purchase region (iOS only)

void setSalesRegion(String _salesRegion)

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

1
AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId,
5
   receipt);
6
//...
7
subscription.setSalesRegion(salesRegion);

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
   receipt);
6
//...
7
subscription.addCallbackParameter('key1', 'value1');
8
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
   receipt);
6
//...
7
subscription.addPartnerParameter('key1', 'value1');
8
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
   receipt);
6
subscription.setTransactionDate(transactionDate);
7
subscription.setSalesRegion(salesRegion);
8
subscription.addCallbackParameter('key1', 'value1');
9
subscription.addCallbackParameter('key2', 'value2');
10
subscription.addPartnerParameter('key1', 'value1');
11
subscription.addPartnerParameter('key2', 'value2');
12

13
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.setPurchaseTime(purchaseTime);
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);