发送订阅信息

您可以用 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`	收据信息

AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
   price,
   currency,
   transactionId,
   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 的文档，了解更多信息。

AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
   price,
   currency,
   sku,
   orderId,
   signature,
   purchaseToken);

Record the purchase date

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

App Store
Play 商店

void setTransactionDate(String _transactionDate)

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

AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
   price,
   currency,
   transactionId,
   receipt);
//...
subscription.setTransactionDate(transactionDate);

void setPurchaseTime(String purchaseTime)

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

AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
   price,
   currency,
   sku,
   orderId,
   signature,
   purchaseToken);
subscription.setPurchaseTime(purchaseTime);

Record the purchase region (iOS only)

void setSalesRegion(String _salesRegion)

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

AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
   price,
   currency,
   transactionId,
   receipt);
//...
subscription.setSalesRegion(salesRegion);

Add callback parameters

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

App Store
Play 商店

void addCallbackParameter(String key, String value)

AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
   price,
   currency,
   transactionId,
   receipt);
//...
subscription.addCallbackParameter('key1', 'value1');
subscription.addCallbackParameter('key2', 'value2');

void addCallbackParameter(String key, String value)

AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
   price,
   currency,
   sku,
   orderId,
   signature,
   purchaseToken);
//...
subscription.addCallbackParameter('key1', 'value1');
subscription.addCallbackParameter('key2', 'value2');

Add partner parameters

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

App Store
Play 商店

void addPartnerParameter(String key, String value)

AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
   price,
   currency,
   transactionId,
   receipt);
//...
subscription.addPartnerParameter('key1', 'value1');
subscription.addPartnerParameter('key2', 'value2');

void addPartnerParameter(String key, String value)

AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
   price,
   currency,
   sku,
   orderId,
   signature,
   purchaseToken);
//...
subscription.addPartnerParameter('key1', 'value1');
subscription.addPartnerParameter('key2', 'value2');

2. Record subscription information

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

App Store
Play 商店

static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription)

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

AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
   price,
   currency,
   transactionId,
   receipt);
subscription.setTransactionDate(transactionDate);
subscription.setSalesRegion(salesRegion);
subscription.addCallbackParameter('key1', 'value1');
subscription.addCallbackParameter('key2', 'value2');
subscription.addPartnerParameter('key1', 'value1');
subscription.addPartnerParameter('key2', 'value2');

Adjust.trackAppStoreSubscription(subscription);

static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription)

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

AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
   price,
   currency,
   sku,
   orderId,
   signature,
   purchaseToken);
subscription.setPurchaseTime(purchaseTime);
subscription.addCallbackParameter('key1', 'value1');
subscription.addCallbackParameter('key2', 'value2');
subscription.addPartnerParameter('key1', 'value1');
subscription.addPartnerParameter('key2', 'value2');

Adjust.trackPlayStoreSubscription(subscription);