From 09c258ca6ed35a02a3cff81ef9112381c7bb0743 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 14 Jan 2025 16:08:36 +0000 Subject: [PATCH] File src/content/docs/en/sdk/flutter/v5/features/subscriptions.mdx was translated to zh-CN locale --- .../sdk/flutter/v5/features/subscriptions.mdx | 145 ++++++++---------- 1 file changed, 63 insertions(+), 82 deletions(-) diff --git a/src/content/docs/zh/sdk/flutter/v5/features/subscriptions.mdx b/src/content/docs/zh/sdk/flutter/v5/features/subscriptions.mdx index ce9c1809e..abc601848 100644 --- a/src/content/docs/zh/sdk/flutter/v5/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/flutter/v5/features/subscriptions.mdx @@ -1,42 +1,41 @@ --- -title: 发送订阅信息 -description: 使用这些方法向 Adjust 发送订阅信息。 -slug: zh/sdk/flutter/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /zh/sdk/flutter/v4/features/subscriptions +title: "发送订阅信息" +description: "使用这些方法向 Adjust 发送订阅信息。" +slug: "en/sdk/flutter/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/flutter/v4/features/subscriptions" --- + - - -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 - - +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 + 您可以用 Adjust SDK 记录 App Store 和 Play 应用商店的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `AdjustAppStoreSubscription` 或 `AdjustPlayStoreSubscription` 实例。 -## 1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} +1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} +------------------------------------------------------------ 要开始设置，先创建一个包含订阅购买细节的订阅对象。 - - - + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId) ``` - + 创建一个 `AdjustAppStoreSubscription` 对象，属性如下： \|参数 \|数据类型 \|描述 \| \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| \| `price` \| `String` \|订阅价格 \| \| `currency` \| `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` \| `String` \| 交易的 ID \| \| +\| `transactionId` \| `String` \| 交易的 ID \| \| ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -45,25 +44,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - - + ```dart 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 的文档]()，了解更多信息。 | +| 参数 | 数据类型 | 描述 | +|-----------------|----------|------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `String` | 订阅价格 | +| `currency` | `String` | 订阅使用的币种 | +| `sku` | `String` | 产品 ID | +| `orderId` | `String` | 您的交易 ID | +| `signature` | `String` | 购买数据的签名 | +| `purchaseToken` | `String` | 交易唯一识别码。请参考[Google 的文档](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken())，了解更多信息。 | ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -75,25 +73,21 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - - + -### 记录购买日期{#record-the-purchase-date} +### 记录购买日期\{\#record\-the\-purchase\-date\} 您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。 - - - + 在`AdjustAppStoreSubscription`类中添加`transactionDate`属性。 - - + ```dart String? transactionDate ``` - + 为`subscription`实例的`transactionDate`属性设置时间戳，记录用户购买订阅的日期。 @@ -106,18 +100,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.transactionDate = 'transactionDate'; ``` - - + 在`AdjustPlayStoreSubscription`类中添加`purchaseTime`属性。 - - + ```dart String? purchaseTime; ``` - + 为`subscription`实例的`purchaseTime`属性设置时间戳，记录用户购买订阅的日期。 @@ -132,18 +124,17 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.purchaseTime = 'purchase-time'; ``` - - + -### 记录购买地区 \(仅限 iOS\){#record-the-purchase-region-ios-only} +### 记录购买地区 \(仅限 iOS\)\{\#record\-the\-purchase\-region\-ios\-only\} - + ```dart String? salesRegion ``` - + 您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `String` 传递。此信息格式需为 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) 对象的 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront)。 @@ -156,18 +147,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.salesRegion = 'sales-region'; ``` -### 添加回传参数{#add-callback-parameters} +### 添加回传参数\{\#add\-callback\-parameters\} 您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 - - - + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -179,14 +168,13 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -201,21 +189,18 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - + -### 添加合作伙伴参数{#add-partner-parameters} +### 添加合作伙伴参数\{\#add\-partner\-parameters\} 您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 - - - + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -227,14 +212,13 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -249,21 +233,19 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + -## 2\. 记录订阅信息\{\#record\-subscription\-information\} +2\. 记录订阅信息\{\#record\-subscription\-information\} +------------------------------------------------------- 设置好订阅对象后，您就可以通过 Adjust SDK 对其进行记录了。 - - - + ```dart static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription) ``` - + 将订阅对象传送至 `trackAppStoreSubscription` 方法，以记录用户订阅购买。 @@ -282,14 +264,13 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + 将订阅对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 @@ -310,5 +291,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + +