File src/content/docs/en/sdk/cocos2dx/v5/features/subscriptions.mdoc …

…was translated to zh-CN locale
adjust · Nov 12, 2024 · 83145d3 · 83145d3
1 parent c7445a8
commit 83145d3
Showing 1 changed file with 81 additions and 80 deletions.
diff --git a/src/content/docs/zh/sdk/cocos2dx/v5/features/subscriptions.mdoc b/src/content/docs/zh/sdk/cocos2dx/v5/features/subscriptions.mdoc
@@ -1,50 +1,53 @@
 ---
-title: 发送订阅信息
-description: 使用这些方法向 Adjust 发送订阅信息。
-slug: zh/sdk/cocos2dx/features/subscriptions
-versions:
-- label: v5
-  value: v5
-  default: true
-- label: v4
-  value: v4
-redirects:
-  v4: /zh/sdk/cocos2dx/v4/features/subscriptions
+title: "发送订阅信息"
+description: "使用这些方法向 Adjust 发送订阅信息。"
+slug: "en/sdk/cocos2dx/features/subscriptions"
+versions: 
+    - 
+        label: "v5"
+        value: "v5"
+        default: true
+    - 
+        label: "v4"
+        value: "v4"
+redirects: 
+    v4: "/en/sdk/cocos2dx/v4/features/subscriptions"
 ---
-
-{% callout type="important" %}
-The following steps only set up subscription measurement within the Adjust SDK. To enable the feature, follow the steps at [Set up subscriptions for your app](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app).
-{% /callout %}
+\{% callout type="important" %\}
+下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。
+\{% /callout %\}
 
 您可以用 Adjust SDK 记录 App Store 和 Play 应用商店的订阅，并验证这些订阅是否有效。
 
-## 工作原理{% #how-it-works %}
+工作原理\{% \#how\-it\-works %\}
+---------------------------------
 
 用户购买订阅后，创建一个 `AdjustAppStoreSubscription2dx` 或 `AdjustPlayStoreSubscription2dx` 实例。这些类包含表示订阅详细信息的属性，允许 Adjust 监测订阅事件。
 
-## App Store 订阅 {% #app-store-subscriptions %}
+App Store 订阅 \{% \#app\-store\-subscriptions %\}
+-----------------------------------------------------
 
 `AdjustAppStoreSubscription2dx`类代表 App Store 订阅信息。您可以创建该类的多个实例来向 Adjust 发送订阅信息。
 
 要开始设置，先实例化一个包含订阅购买细节的订阅对象。
 
-### 实例化 App Store 订阅对象{% #instantiate-an-app-store-subscription-object %}
+### 实例化 App Store 订阅对象\{% \#instantiate\-an\-app\-store\-subscription\-object %\}
 
 使用以下参数实例化`AdjustAppStoreSubscription2dx`对象：
 
-{% deflist %}
-`price` (`std::string`)
+\{% deflist %\}
+`price` \(`std::string`\)
 
 : 订阅价格
 
-`currency` (`std::string`)
+`currency` \(`std::string`\)
 
 : 订阅使用的币种。此信息格式为[`priceLocale`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc)对象的 [`currencyCode`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc)。
 
-`transactionId` (`std::string`)
+`transactionId` \(`std::string`\)
 
 : 您的交易 ID。
-{% /deflist %}
+\{% /deflist %\}
 
 ```cpp
 AdjustAppStoreSubscription2dx subscription = AdjustAppStoreSubscription2dx(
@@ -54,17 +57,17 @@ AdjustAppStoreSubscription2dx subscription = AdjustAppStoreSubscription2dx(
 );
 ```
 
-### 记录购买日期{% #record-the-purchase-date-app-store %}
+### 记录购买日期\{% \#record\-the\-purchase\-date\-app\-store %\}
 
 您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。
 
 在您的订阅对象上调用 `setTransactionDate` 方法来记录订阅的时间戳。
 
-{% deflist %}
-`transactionDate` (`std::string`)
+\{% deflist %\}
+`transactionDate` \(`std::string`\)
 
 : 订阅时间戳
-{% /deflist %}
+\{% /deflist %\}
 
 ```cpp
 AdjustAppStoreSubscription2dx subscription = AdjustAppStoreSubscription2dx(
@@ -75,15 +78,15 @@ AdjustAppStoreSubscription2dx subscription = AdjustAppStoreSubscription2dx(
 subscription.setTransactionDate({% $variables.subscription.appStoreSubscription.transactionDate %});
 ```
 
-### 记录购买地区{% #record-the-purchase-region %}
+### 记录购买地区\{% \#record\-the\-purchase\-region %\}
 
 您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 **字符串** 传递。此信息格式需为 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) 对象 的 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront) 。
 
-{% deflist %}
-`salesRegion` (`std::string`)
+\{% deflist %\}
+`salesRegion` \(`std::string`\)
 
 : 订阅的国家代码。
-{% /deflist %}
+\{% /deflist %\}
 
 ```cpp
 AdjustAppStoreSubscription2dx subscription = AdjustAppStoreSubscription2dx(
@@ -94,7 +97,7 @@ AdjustAppStoreSubscription2dx subscription = AdjustAppStoreSubscription2dx(
 subscription.setSalesRegion({% $variables.subscription.appStoreSubscription.salesRegion %});
 ```
 
-### 添加回传参数{% #add-callback-parameters-app-store %}
+### 添加回传参数\{% \#add\-callback\-parameters\-app\-store %\}
 
 您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。
 
@@ -108,7 +111,7 @@ subscription.addCallbackParameter({% $variables.subscription.key1 %});
 subscription.addCallbackParameter({% $variables.subscription.key2 %});
 ```
 
-### 添加合作伙伴参数{% #add-partner-parameters-app-store %}
+### 添加合作伙伴参数\{% \#add\-partner\-parameters\-app\-store %\}
 
 您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。
 
@@ -122,31 +125,29 @@ subscription.addPartnerParameter({% $variables.subscription.key1 %});
 subscription.addPartnerParameter({% $variables.subscription.key2 %});
 ```
 
-### App Store 订阅教程{% #tutorial-app-store %}
+### App Store 订阅教程\{% \#tutorial\-app\-store %\}
 
 设置好订阅对象后，您就可以通过 Adjust SDK 对其进行记录了。
 
 本教程将展示如何使用`AdjustAppStoreSubscription2dx`和`AdjustPlayStoreSubscription2dx`类向 Adjust 发送订阅信息。您可了解到：
 
 1. 如何创建并填充`AdjustAppStoreSubscription2dx`或`AdjustPlayStoreSubscription2dx`实例。
-1. 如何在应用中使用`AdjustAppStoreSubscription2dx`和`AdjustPlayStoreSubscription2dx`类向 Adjust 发送订阅信息。
+2. 如何在应用中使用`AdjustAppStoreSubscription2dx`和`AdjustPlayStoreSubscription2dx`类向 Adjust 发送订阅信息。
 
 如需向 Adjust 发送订阅信息，请按照下列步骤操作：
 
-1. 使用`price` 、 `currency`和`transactionId`实例化并填充`AdjustAppStoreSubscription2dx`对象。下方示例中使用了以下值：
-
-   * `price`为 *{% $variables.subscription.appStoreSubscription.price %}* 。
-   * `currency`为 *{% $variables.subscription.appStoreSubscription.currency %}* 。
-   * `transactionId`为 *{% $variables.subscription.appStoreSubscription.transactionId %}*
-
-1. 下方示例中设置了以下属性：
+1. 使用`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 %}* 。
+2. 下方示例中设置了以下属性： 
+   * 交易日期设为 *\{% $variables.subscription.appStoreSubscription.transactionDate %\}* 
+   * 销售地区设为 *\{% $variables.subscription.appStoreSubscription.salesRegion %\}* 。
+   * 回传参数设为 *\{% $variables.subscription.key1 %\}* 和 *\{% $variables.subscription.key2 %\}* 。
+   * 合作伙伴参数设为 *\{% $variables.subscription.key1 %\}* 和 *\{% $variables.subscription.key2 %\}* 。
 
-1. 在函数末尾，使用`AdjustAppStoreSubscription2dx`实例作为参数调用`trackAppStoreSubscription`，以此将信息发送至 Adjust。
+3. 在函数末尾，使用`AdjustAppStoreSubscription2dx`实例作为参数调用`trackAppStoreSubscription`，以此将信息发送至 Adjust。
 
 ```cpp
 #include "Adjust/Adjust2dx.h"
@@ -171,41 +172,42 @@ subscription.addPartnerParameter({% $variables.subscription.key2 %});
 Adjust2dx::trackAppStoreSubscription(subscription);
 ```
 
-## Play 商店订阅 {% #play-store-subscriptions %}
+Play 商店订阅 \{% \#play\-store\-subscriptions %\}
+---------------------------------------------------
 
 `AdjustPlayStoreSubscription2dx`类代表 App Store 订阅信息。您可以创建该类的多个实例来向 Adjust 发送订阅信息。
 
 要开始设置，先实例化一个包含订阅购买细节的订阅对象。
 
-### 实例化 Play 应用商店订阅对象{% #instantiate-a-play-store-subscription-object %}
+### 实例化 Play 应用商店订阅对象\{% \#instantiate\-a\-play\-store\-subscription\-object %\}
 
 使用以下参数实例化`AdjustPlayStoreSubscription2dx`对象：
 
-{% deflist %}
-`price` (`std::string`)
+\{% deflist %\}
+`price` \(`std::string`\)
 
 : 订阅价格
 
-`currency` (`std::string`)
+`currency` \(`std::string`\)
 
 : 订阅使用的币种
 
-`sku` (`std::string`)
+`sku` \(`std::string`\)
 
 : 产品 ID
 
-`orderId` (`std::string`)
+`orderId` \(`std::string`\)
 
 : 您的交易 ID
 
-`signature` (`std::string`)
+`signature` \(`std::string`\)
 
 : 购买数据的签名
 
-`purchaseToken` (`std::string`)
+`purchaseToken` \(`std::string`\)
 
-: 交易唯一识别码。请参考 [Google 的文档](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken\(\))，了解更多信息
-{% /deflist %}
+: 交易唯一识别码。请参考 [Google 的文档](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken())，了解更多信息
+\{% /deflist %\}
 
 ```cpp
 AdjustPlayStoreSubscription2dx subscription = AdjustPlayStoreSubscription2dx(
@@ -218,17 +220,17 @@ AdjustPlayStoreSubscription2dx subscription = AdjustPlayStoreSubscription2dx(
 );
 ```
 
-### 记录购买日期{% #record-the-purchase-date-play-store %}
+### 记录购买日期\{% \#record\-the\-purchase\-date\-play\-store %\}
 
 您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。
 
 在您的订阅对象上调用 `setPurchaseTime` 方法来记录订阅的时间戳。
 
-{% deflist %}
-`purchaseTime` (`std::string`)
+\{% deflist %\}
+`purchaseTime` \(`std::string`\)
 
 : 订阅时间戳。
-{% /deflist %}
+\{% /deflist %\}
 
 ```cpp
 AdjustPlayStoreSubscription2dx subscription = AdjustPlayStoreSubscription2dx(
@@ -242,7 +244,7 @@ AdjustPlayStoreSubscription2dx subscription = AdjustPlayStoreSubscription2dx(
 subscription.setPurchaseTime({% $variables.subscription.playStoreSubscription.purchaseTime%});
 ```
 
-### 添加回传参数{% #add-callback-parameters-play-store %}
+### 添加回传参数\{% \#add\-callback\-parameters\-play\-store %\}
 
 您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。
 
@@ -259,7 +261,7 @@ subscription.addCallbackParameter({% $variables.subscription.key1 %});
 subscription.addCallbackParameter({% $variables.subscription.key2 %});
 ```
 
-### 添加合作伙伴参数{% #add-partner-parameters-play-store %}
+### 添加合作伙伴参数\{% \#add\-partner\-parameters\-play\-store %\}
 
 您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。
 
@@ -276,33 +278,31 @@ subscription.addPartnerParameter({% $variables.subscription.key1 %});
 subscription.addPartnerParameter({% $variables.subscription.key2 %});
 ```
 
-### Play 商店订阅教程 {% #tutorial-play-store %}
+### Play 商店订阅教程 \{% \#tutorial\-play\-store %\}
 
 设置好订阅对象后，您就可以通过 Adjust SDK 对其进行记录了。
 
 本教程将展示如何使用`AdjustAppStoreSubscription2dx`和`AdjustPlayStoreSubscription2dx`类向 Adjust 发送订阅信息。您可了解到：
 
 1. 如何创建并填充`AdjustAppStoreSubscription2dx`或`AdjustPlayStoreSubscription2dx`实例。
-1. 如何在应用中使用`AdjustAppStoreSubscription2dx`和`AdjustPlayStoreSubscription2dx`类向 Adjust 发送订阅信息。
+2. 如何在应用中使用`AdjustAppStoreSubscription2dx`和`AdjustPlayStoreSubscription2dx`类向 Adjust 发送订阅信息。
 
 如需向 Adjust 发送订阅信息，请按照下列步骤操作：
 
-1. 使用`price` 、 `currency` 、 `sku` 、 `orderId` 、 `signature` 、 `purchaseToken`实例化并填充`AdjustPlayStoreSubscription2dx`对象。下方示例中使用了以下值：
+1. 使用`price` 、 `currency` 、 `sku` 、 `orderId` 、 `signature` 、 `purchaseToken`实例化并填充`AdjustPlayStoreSubscription2dx`对象。下方示例中使用了以下值： 
+   * `price`为 *\{% $variables.subscription.playStoreSubscription.price %\}* 。
+   * `currency`为 *\{% $variables.subscription.playStoreSubscription.currency %\}* 。
+   * `sku`为 *\{% $variables.subscription.playStoreSubscription.sku %\}* 。
+   * `orderId`为 *\{% $variables.subscription.playStoreSubscription.orderId %\}* 。
+   * `signature`为 *\{% $variables.subscription.playStoreSubscription.signature %\}* 。
+   * `purchaseToken`为 *\{% $variables.subscription.playStoreSubscription.purchaseToken %\}* 。
 
-   * `price`为 *{% $variables.subscription.playStoreSubscription.price %}* 。
-   * `currency`为 *{% $variables.subscription.playStoreSubscription.currency %}* 。
-   * `sku`为 *{% $variables.subscription.playStoreSubscription.sku %}* 。
-   * `orderId`为 *{% $variables.subscription.playStoreSubscription.orderId %}* 。
-   * `signature`为 *{% $variables.subscription.playStoreSubscription.signature %}* 。
-   * `purchaseToken`为 *{% $variables.subscription.playStoreSubscription.purchaseToken %}* 。
+2. 下方示例中设置了以下属性： 
+   * 购买时间设置为 *\{% $variables.subscription.playStoreSubscription.purchaseTime %\}* 
+   * 回传参数设为 *\{% $variables.subscription.key1 %\}* 和 *\{% $variables.subscription.key2 %\}* 。
+   * 合作伙伴参数设为 *\{% $variables.subscription.key1 %\}* 和 *\{% $variables.subscription.key2 %\}* 。
 
-1. 下方示例中设置了以下属性：
-
-   * 购买时间设置为 *{% $variables.subscription.playStoreSubscription.purchaseTime %}*
-   * 回传参数设为 *{% $variables.subscription.key1 %}* 和 *{% $variables.subscription.key2 %}* 。
-   * 合作伙伴参数设为 *{% $variables.subscription.key1 %}* 和 *{% $variables.subscription.key2 %}* 。
-
-1. 在函数末尾，使用`AdjustAppStoreSubscription2dx`实例作为参数调用`trackPlayStoreSubscription`，以此将信息发送至 Adjust。
+3. 在函数末尾，使用`AdjustAppStoreSubscription2dx`实例作为参数调用`trackPlayStoreSubscription`，以此将信息发送至 Adjust。
 
 ```cpp
 #include "Adjust/Adjust2dx.h"
@@ -328,3 +328,4 @@ subscription.addPartnerParameter({% $variables.subscription.key1 %});
 subscription.addPartnerParameter({% $variables.subscription.key2 %});
 Adjust2dx::trackPlayStoreSubscription(subscription);
 ```
+