发送订阅信息

您可以用 Adjust SDK 记录 App Store 和 Play 应用商店的订阅，并验证这些订阅是否有效。

工作原理

用户购买订阅后，创建一个 AdjustAppStoreSubscription2dx 或 AdjustPlayStoreSubscription2dx 实例。这些类包含表示订阅详细信息的属性，允许 Adjust 监测订阅事件。

App Store 订阅

AdjustAppStoreSubscription2dx类代表 App Store 订阅信息。您可以创建该类的多个实例来向 Adjust 发送订阅信息。

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

实例化 App Store 订阅对象

使用以下参数实例化AdjustAppStoreSubscription2dx对象：

price (std::string): 订阅价格
currency (std::string): 订阅使用的币种。此信息格式为priceLocale对象的 currencyCode。
transactionId (std::string): 您的交易 ID。

1
AdjustAppStoreSubscription2dx subscription = AdjustAppStoreSubscription2dx(
2
   "1.00", // price
3
   "EUR", // currency
4
   "44da840e-3f70-4bc0-95d2-4b9638e1d7eb" // transactionId
5
);

记录购买日期

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

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

transactionDate (std::string): 订阅时间戳

1
AdjustAppStoreSubscription2dx subscription = AdjustAppStoreSubscription2dx(
2
   "1.00", // price
3
   "EUR", // currency
4
   "44da840e-3f70-4bc0-95d2-4b9638e1d7eb" // transactionId
5
);
6
subscription.setTransactionDate("txn_20230918T123456Z");

记录购买地区

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

salesRegion (std::string): 订阅的国家代码。

1
AdjustAppStoreSubscription2dx subscription = AdjustAppStoreSubscription2dx(
2
   "1.00", // price
3
   "EUR", // currency
4
   "44da840e-3f70-4bc0-95d2-4b9638e1d7eb" // transactionId
5
);
6
subscription.setSalesRegion("US");

添加回传参数

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

1
AdjustAppStoreSubscription2dx subscription = AdjustAppStoreSubscription2dx(
2
   "1.00", // price
3
   "EUR", // currency
4
   "44da840e-3f70-4bc0-95d2-4b9638e1d7eb" // transactionId
5
);
6
subscription.addCallbackParameter("key", ,"value");
7
subscription.addCallbackParameter("foo", ,"bar");

添加合作伙伴参数

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

1
AdjustAppStoreSubscription2dx subscription = AdjustAppStoreSubscription2dx(
2
   "1.00", // price
3
   "EUR", // currency
4
   "44da840e-3f70-4bc0-95d2-4b9638e1d7eb" // transactionId
5
);
6
subscription.addPartnerParameter("key", ,"value");
7
subscription.addPartnerParameter("foo", ,"bar");

App Store 订阅教程

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

本教程将展示如何使用AdjustAppStoreSubscription2dx和AdjustPlayStoreSubscription2dx类向 Adjust 发送订阅信息。您可了解到：

如何创建并填充AdjustAppStoreSubscription2dx或AdjustPlayStoreSubscription2dx实例。
如何在应用中使用AdjustAppStoreSubscription2dx和AdjustPlayStoreSubscription2dx类向 Adjust 发送订阅信息。

如需向 Adjust 发送订阅信息，请按照下列步骤操作：

使用price 、 currency和transactionId实例化并填充AdjustAppStoreSubscription2dx对象。下方示例中使用了以下值：
- price 为 {variables.subscription.appStoreSubscription.price} 。
- currency 为 {variables.subscription.appStoreSubscription.currency} 。
- transactionId 为 {variables.subscription.appStoreSubscription.transactionId} 。
下方示例中设置了以下属性：
- 交易日期设置为 {variables.subscription.appStoreSubscription.transactionDate} 。
- 销售地区设置为 {variables.subscription.appStoreSubscription.salesRegion} 。
- 回传参数设置为 {variables.subscription.key1} 和 {variables.subscription.key2} 。
- 合作伙伴参数设置为 {variables.subscription.key1} 和 {variables.subscription.key2} 。
在函数末尾，使用AdjustAppStoreSubscription2dx实例作为参数调用trackAppStoreSubscription，以此将信息发送至 Adjust。

1
#include "Adjust/Adjust2dx.h"
2

3
std::string appToken = "{YOUR_APP_TOKEN}";
4
std::string environment = AdjustEnvironmentSandbox2dx;
5

6
AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment);
7
Adjust2dx::initSdk(adjustConfig);
8

9
AdjustAppStoreSubscription2dx subscription = AdjustAppStoreSubscription2dx(
10
   "1.00", // price
11
   "EUR", // currency
12
   "44da840e-3f70-4bc0-95d2-4b9638e1d7eb" // transactionId
13
);
14
subscription.setTransactionDate({variables.subscription.appStoreSubscription.transactionDate%});
15
subscription.setSalesRegion("US");
16
subscription.addCallbackParameter("key", ,"value");
17
subscription.addCallbackParameter("foo", ,"bar");
18
subscription.addPartnerParameter("key", ,"value");
19
subscription.addPartnerParameter("foo", ,"bar");
20
Adjust2dx::trackAppStoreSubscription(subscription);

Play 商店订阅

AdjustPlayStoreSubscription2dx类代表 App Store 订阅信息。您可以创建该类的多个实例来向 Adjust 发送订阅信息。

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

实例化 Play 应用商店订阅对象

使用以下参数实例化AdjustPlayStoreSubscription2dx对象：

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

1
AdjustPlayStoreSubscription2dx subscription = AdjustPlayStoreSubscription2dx(
2
   "1.00", // price
3
   "EUR", // currency
4
   "47411084-12dd-41f6-9e4b-2c59e380945e", // sku
5
   "63469457-d777-4698-9957-f07a3d14c7bf", // orderId
6
   "1c37d91e-a3e6-4236-90a7-86c69051fc39", // signature
7
   "4afa8869-0dc6-43ff-be28-d07d454cb357" // purchaseToken
8
);