Skip to content

Commit

Permalink
File src/content/docs/en/sdk/flutter/v5/features/subscriptions.mdx wa…
Browse files Browse the repository at this point in the history 
…s translated to zh-CN locale
  • Loading branch information
@smartling-github-connector
smartling-github-connector[bot] authored Jan 14, 2025
1 parent 20cb5e2 commit 09c258c
Showing 1 changed file with 63 additions and 82 deletions.
145 changes: 63 additions & 82 deletions src/content/docs/zh/sdk/flutter/v5/features/subscriptions.mdx
View file
Original file line number Diff line number Diff line change
@@ -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"
---
<callout type="important">

<Callout type="important">

下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。

</Callout>
下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。
</Callout>

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

## 1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\}
1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\}
------------------------------------------------------------

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

<Tabs>
<Tab title="App Store" sync="appstore" icon="PlatformIos"> <CodeBlock title="方法签名">
<tabs> <tab title="App Store" sync="appstore" icon="PlatformIos"> <codeblock title="方法签名">

```dart
AdjustAppStoreSubscription(String _price, String _currency, String _transactionId)
```

</CodeBlock>
</CodeBlock>

创建一个 `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(
Expand All @@ -45,25 +44,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
transactionId);
```

</Tab>
<Tab title="Play 商店" sync="playstore" icon="PlatformGooglePlay"> <CodeBlock title="方法签名">
</Tab> <tab title="Play 商店" sync="playstore" icon="PlatformGooglePlay"> <codeblock title="方法签名">

```dart
AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken)
```

</CodeBlock>
</CodeBlock>

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

| 参数 | 数据类型 | 描述 |
| --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `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()>)，了解更多信息。 |
| 参数 | 数据类型 | 描述 |
|-----------------|----------|------------------------------------------------------------------------------------------------------------------------------------|
| `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(
Expand All @@ -75,25 +73,21 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
purchaseToken);
```

</Tab>
</Tabs>
</Tab> </Tabs>

### 记录购买日期{#record-the-purchase-date}
### 记录购买日期\{\#record\-the\-purchase\-date\}

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

<Tabs>
<Tab title="App Store" sync="appstore" icon="PlatformIos">
<tabs> <tab title="App Store" sync="appstore" icon="PlatformIos">

在`AdjustAppStoreSubscription`类中添加`transactionDate`属性。

<CodeBlock title="属性声明">
<codeblock title="属性声明">

```dart
String? transactionDate
```

</CodeBlock>
</CodeBlock>

为`subscription`实例的`transactionDate`属性设置时间戳，记录用户购买订阅的日期。

Expand All @@ -106,18 +100,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
subscription.transactionDate = 'transactionDate';
```

</Tab>
<Tab title="Play 商店" sync="playstore" icon="PlatformGooglePlay">
</Tab> <tab title="Play 商店" sync="playstore" icon="PlatformGooglePlay">

在`AdjustPlayStoreSubscription`类中添加`purchaseTime`属性。

<CodeBlock title="属性声明">
<codeblock title="属性声明">

```dart
String? purchaseTime;
```

</CodeBlock>
</CodeBlock>

为`subscription`实例的`purchaseTime`属性设置时间戳，记录用户购买订阅的日期。

Expand All @@ -132,18 +124,17 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
subscription.purchaseTime = 'purchase-time';
```

</Tab>
</Tabs>
</Tab> </Tabs>

### 记录购买地区 \(仅限 iOS\){#record-the-purchase-region-ios-only}
### 记录购买地区 \(仅限 iOS\)\{\#record\-the\-purchase\-region\-ios\-only\}

<CodeBlock title="方法签名">
<codeblock title="方法签名">

```dart
String? salesRegion
```

</CodeBlock>
</CodeBlock>

您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `String` 传递。此信息格式需为 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) 对象的 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront)。

Expand All @@ -156,18 +147,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
subscription.salesRegion = 'sales-region';
```

### 添加回传参数{#add-callback-parameters}
### 添加回传参数\{\#add\-callback\-parameters\}

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

<Tabs>
<Tab title="App Store" sync="appstore" icon="PlatformIos"> <CodeBlock title="方法签名">
<tabs> <tab title="App Store" sync="appstore" icon="PlatformIos"> <codeblock title="方法签名">

```dart
void addCallbackParameter(String key, String value)
```

</CodeBlock>
</CodeBlock>

```dart
AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
Expand All @@ -179,14 +168,13 @@ subscription.addCallbackParameter('key1', 'value1');
subscription.addCallbackParameter('key2', 'value2');
```

</Tab>
<Tab title="Play 商店" sync="playstore" icon="PlatformGooglePlay"> <CodeBlock title="方法签名">
</Tab> <tab title="Play 商店" sync="playstore" icon="PlatformGooglePlay"> <codeblock title="方法签名">

```dart
void addCallbackParameter(String key, String value)
```

</CodeBlock>
</CodeBlock>

```dart
AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
Expand All @@ -201,21 +189,18 @@ subscription.addCallbackParameter('key1', 'value1');
subscription.addCallbackParameter('key2', 'value2');
```

</Tab>
</Tabs>
</Tab> </Tabs>

### 添加合作伙伴参数{#add-partner-parameters}
### 添加合作伙伴参数\{\#add\-partner\-parameters\}

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

<Tabs>
<Tab title="App Store" sync="appstore" icon="PlatformIos"> <CodeBlock title="方法签名">
<tabs> <tab title="App Store" sync="appstore" icon="PlatformIos"> <codeblock title="方法签名">

```dart
void addPartnerParameter(String key, String value)
```

</CodeBlock>
</CodeBlock>

```dart
AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
Expand All @@ -227,14 +212,13 @@ subscription.addPartnerParameter('key1', 'value1');
subscription.addPartnerParameter('key2', 'value2');
```

</Tab>
<Tab title="Play 商店" sync="playstore" icon="PlatformGooglePlay"> <CodeBlock title="方法签名">
</Tab> <tab title="Play 商店" sync="playstore" icon="PlatformGooglePlay"> <codeblock title="方法签名">

```dart
void addPartnerParameter(String key, String value)
```

</CodeBlock>
</CodeBlock>

```dart
AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
Expand All @@ -249,21 +233,19 @@ subscription.addPartnerParameter('key1', 'value1');
subscription.addPartnerParameter('key2', 'value2');
```

</Tab>
</Tabs>
</Tab> </Tabs>

## 2\. 记录订阅信息\{\#record\-subscription\-information\}
2\. 记录订阅信息\{\#record\-subscription\-information\}
-------------------------------------------------------

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

<Tabs>
<Tab title="App Store" sync="appstore" icon="PlatformIos"> <CodeBlock title="方法签名">
<tabs> <tab title="App Store" sync="appstore" icon="PlatformIos"> <codeblock title="方法签名">

```dart
static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription)
```

</CodeBlock>
</CodeBlock>

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

Expand All @@ -282,14 +264,13 @@ subscription.addPartnerParameter('key2', 'value2');
Adjust.trackAppStoreSubscription(subscription);
```

</Tab>
<Tab title="Play 商店" sync="playstore" icon="PlatformGooglePlay"> <CodeBlock title="方法签名">
</Tab> <tab title="Play 商店" sync="playstore" icon="PlatformGooglePlay"> <codeblock title="方法签名">

```dart
static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription)
```

</CodeBlock>
</CodeBlock>

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

Expand All @@ -310,5 +291,5 @@ subscription.addPartnerParameter('key2', 'value2');
Adjust.trackPlayStoreSubscription(subscription);
```

</Tab>
</Tabs>
</Tab> </Tabs>

0 comments on commit 09c258c

Please sign in to comment.