From 39cd855726944545e7ecd58af1bfe0aede080c90 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:01:51 +0000 Subject: [PATCH 01/75] File src/content/docs/en/sdk/android/v4/features/subscriptions.mdx was translated to ko-KR locale --- .../sdk/android/v4/features/subscriptions.mdx | 142 ++++++++---------- 1 file changed, 63 insertions(+), 79 deletions(-) diff --git a/src/content/docs/ko/sdk/android/v4/features/subscriptions.mdx b/src/content/docs/ko/sdk/android/v4/features/subscriptions.mdx index c59ffc20c0..2f517ee1b3 100644 --- a/src/content/docs/ko/sdk/android/v4/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/android/v4/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: 구독 정보 전송 -description: 이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다. -slug: ko/sdk/android/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/android/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/android/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/android/features/subscriptions" --- + - +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 Adjust는 앱에 특화된 정보를 설정해야 합니다. 설정을 위해 [support@adjust.com](mailto:support@adjust.com)이나 담당 TAM\(테크니컬 어카운트 매니저\)에게 연락하시기 바랍니다. +You can record Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, instantiate an `AdjustPlayStoreSubscription` object containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustPlayStoreSubscription` 객체를 생성하시기 바랍니다. - -## 1\. 구독 객체 인스턴스화 {#1-instantiate-a-subscription-object} - - + ```java public AdjustPlayStoreSubscription(final long price, @@ -34,21 +35,20 @@ public AdjustPlayStoreSubscription(final long price, ``` - + -시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 인스턴스화해야 합니다. 이를 위해 새로운 `AdjustPlayStoreSubscription` 객체를 생성하고 다음 인수를 전달합니다. +To get started, you need to instantiate a subscription object containing details of the subscription purchase. To do this, create a new `AdjustPlayStoreSubscription` object and pass the following arguments: -| 파라미터 | 데이터 유형 | 설명 | -| --------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `long` | 구독료 | -| `currency` | `String` | 구독 통화 | -| `sku` | `String` | 제품 ID | -| `orderId` | `String` | 거래 ID | -| `signature` | `String` | 구매 데이터의 서명 | -| `purchaseToken` | `String` | 거래의 고유 토큰. 자세한 정보는 [Google 문서](https://developer.android.com/reference/com/android/billingclient/api/Purchase)를 참조하시기 바랍니다. | +| Parameter | Data type | Description | +|-----------------|-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `long` | The price of the subscription | +| `currency` | `String` | The currency of the subscription | +| `sku` | `String` | The ID of the product | +| `orderId` | `String` | Your ID for the transaction | +| `signature` | `String` | The signature of the purchase data | +| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase) for more information | - - + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,8 +62,7 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -77,23 +76,20 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### 구매일 기록 {#record-the-purchase-date} +### Record the purchase date \{\#record\-the\-purchase\-date\} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + -사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. 이 정보를 기록할 타임스탬프와 함께 `setPurchaseTime` 메서드를 호출합니다. - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setPurchaseTime` method with a timestamp to record this information. + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -108,8 +104,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -124,85 +119,75 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### 콜백 파라미터 추가 {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} - + ```java public void addCallbackParameter(String key, String value) ``` - - -콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 파라미터를 추가할 수 있습니다. + - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - - + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - - + -### 파트너 파라미터 추가 {#add-partner-parameters} +### Add partner parameters \{\#add\-partner\-parameters\} - + ```java public void addPartnerParameter(String key, String value) ``` - + -Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. - - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - - + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - - + -## 2\. 구독 정보 전송 {#2-send-subscription-information} +2\. Send subscription information \{\#send\-subscription\-information\} +----------------------------------------------------------------------------- - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - - -구독 객체를 설정하고 나면 Adjust SDK를 사용하여 Adjust에 전송할 수 있습니다. 완료된 객체를 `trackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. + - - +Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -217,8 +202,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -233,5 +217,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 845274d8178239bfeeb9c68871f5e4540d1808d6 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:02:03 +0000 Subject: [PATCH 02/75] File src/content/docs/en/sdk/android/v4/features/subscriptions.mdx was translated to zh-CN locale --- .../sdk/android/v4/features/subscriptions.mdx | 142 ++++++++---------- 1 file changed, 63 insertions(+), 79 deletions(-) diff --git a/src/content/docs/zh/sdk/android/v4/features/subscriptions.mdx b/src/content/docs/zh/sdk/android/v4/features/subscriptions.mdx index 5d3b72bc77..dcf4937285 100644 --- a/src/content/docs/zh/sdk/android/v4/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/android/v4/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: 发送订阅信息 -description: 使用这些方法向 Adjust 发送订阅信息。 -slug: zh/sdk/android/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/android/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/android/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/android/features/subscriptions" --- + - +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 + -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启动该功能，Adjust 需要设置应用相关的具体信息。请发送邮件至 [support@adjust.com](mailto:support@adjust.com)或与您的技术客户经理联系进行设置。 +You can record Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, instantiate an `AdjustPlayStoreSubscription` object containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -您可以用 Adjust SDK 记录 Play 商店的订阅，并验证这些订阅是否有效。用户购买订阅后，实例化一个包含细节的 `AdjustPlayStoreSubscription` 对象。 - -## 1\. 实例化订阅对象 {#1-instantiate-a-subscription-object} - - + ```java public AdjustPlayStoreSubscription(final long price, @@ -34,21 +35,20 @@ public AdjustPlayStoreSubscription(final long price, ``` - + -要开始设置，先实例化一个包含订阅购买细节的订阅对象。为此，请创建一个新的 `AdjustPlayStoreSubscription` 对象，并传送下列参数： +To get started, you need to instantiate a subscription object containing details of the subscription purchase. To do this, create a new `AdjustPlayStoreSubscription` object and pass the following arguments: -| 参数 | 数据类型 | 描述 | -| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `long` | 订阅价格 | -| `currency` | `String` | 订阅使用的币种 | -| `sku` | `String` | 产品 ID | -| `orderId` | `String` | 您的交易 ID | -| `signature` | `String` | 购买数据的签名 | -| `purchaseToken` | `String` | 交易唯一识别码。请参考[Google 的文档](https://developer.android.com/reference/com/android/billingclient/api/Purchase)，了解更多信息。 | +| Parameter | Data type | Description | +|-----------------|-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `long` | The price of the subscription | +| `currency` | `String` | The currency of the subscription | +| `sku` | `String` | The ID of the product | +| `orderId` | `String` | Your ID for the transaction | +| `signature` | `String` | The signature of the purchase data | +| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase) for more information | - - + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,8 +62,7 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -77,23 +76,20 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### 记录购买日期 {#record-the-purchase-date} +### Record the purchase date \{\#record\-the\-purchase\-date\} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + -您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。请使用时间戳调用 `setPurchaseTime` 方法，记录该信息。 - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setPurchaseTime` method with a timestamp to record this information. + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -108,8 +104,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -124,85 +119,75 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### 添加回传参数 {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} - + ```java public void addCallbackParameter(String key, String value) ``` - - -你可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 + - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - - + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - - + -### 添加合作伙伴参数 {#add-partner-parameters} +### Add partner parameters \{\#add\-partner\-parameters\} - + ```java public void addPartnerParameter(String key, String value) ``` - + -你可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 - - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - - + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - - + -## 2\. 发送订阅信息 {#2-send-subscription-information} +2\. Send subscription information \{\#send\-subscription\-information\} +----------------------------------------------------------------------------- - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - - -设置好订阅对象后，您就可以使用 Adjust SDK 将其发送给 Adjust 了。将已完成对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 + - - +Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -217,8 +202,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -233,5 +217,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 4ef60052a4ac05d56b758a1a43b0e598655bfbc1 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:02:10 +0000 Subject: [PATCH 03/75] File src/content/docs/en/sdk/android/v4/features/subscriptions.mdx was translated to ja-JP locale --- .../sdk/android/v4/features/subscriptions.mdx | 142 ++++++++---------- 1 file changed, 63 insertions(+), 79 deletions(-) diff --git a/src/content/docs/ja/sdk/android/v4/features/subscriptions.mdx b/src/content/docs/ja/sdk/android/v4/features/subscriptions.mdx index 0ab67f75b8..00aa2c4f8c 100644 --- a/src/content/docs/ja/sdk/android/v4/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/android/v4/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: サブスクリプション情報の送信 -description: Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。 -slug: ja/sdk/android/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/android/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/android/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/android/features/subscriptions" --- + - +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、アプリ固有の情報を別途追加する必要があります。設定のサポートをいたしますので、[support@adjust.com](mailto:support@adjust.com)または担当のテクニカルアカウントマネージャーまでお問い合わせください。 +You can record Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, instantiate an `AdjustPlayStoreSubscription` object containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -Playストアのサブスクリプションを記録し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションを購入したら、詳細を含む `AdjustPlayStoreSubscription`オブジェクトをインスタンス化します。 - -## 1\. サブスクリプションオブジェクトをインスタンス化する {#1-instantiate-a-subscription-object} - - + ```java public AdjustPlayStoreSubscription(final long price, @@ -34,21 +35,20 @@ public AdjustPlayStoreSubscription(final long price, ``` - + -開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトをインスタンス化する必要があります。これを行うには、新しい`AdjustPlayStoreSubscription`を作成して次の引数をパスします： +To get started, you need to instantiate a subscription object containing details of the subscription purchase. To do this, create a new `AdjustPlayStoreSubscription` object and pass the following arguments: -| パラメーター | データタイプ | 説明 | -| --------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `long` | サブスクリプションの価格 | -| `currency` | `String` | サブスクリプション通貨 | -| `sku` | `String` | プロダクトID | -| `orderId` | `String` | トランザクションID | -| `signature` | `String` | 購入データのシグネチャー | -| `purchaseToken` | `String` | トランザクションの一意のトークン。詳細は[Googleのドキュメント](https://developer.android.com/reference/com/android/billingclient/api/Purchase)を参照してください | +| Parameter | Data type | Description | +|-----------------|-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `long` | The price of the subscription | +| `currency` | `String` | The currency of the subscription | +| `sku` | `String` | The ID of the product | +| `orderId` | `String` | Your ID for the transaction | +| `signature` | `String` | The signature of the purchase data | +| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase) for more information | - - + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,8 +62,7 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -77,23 +76,20 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### 購入データを記録する {#record-the-purchase-date} +### Record the purchase date \{\#record\-the\-purchase\-date\} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + -ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。タイムスタンプを使用して`setPurchaseTime`メソッドを呼び出し、この情報を記録します。 - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setPurchaseTime` method with a timestamp to record this information. + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -108,8 +104,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -124,85 +119,75 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### コールバックパラメーターを追加する {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} - + ```java public void addCallbackParameter(String key, String value) ``` - - -コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - - + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - - + -### パートナーパラメーターの追加 {#add-partner-parameters} +### Add partner parameters \{\#add\-partner\-parameters\} - + ```java public void addPartnerParameter(String key, String value) ``` - + -パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - - + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - - + -## 2\. サブスクリプション情報を送信する {#2-send-subscription-information} +2\. Send subscription information \{\#send\-subscription\-information\} +----------------------------------------------------------------------------- - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - - -サブスクリプションオブジェクトを設定したら、Adjust SDKを使用してそれをAdjustに送信できます。完了したオブジェクトを `trackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 + - - +Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -217,8 +202,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -233,5 +217,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From a41def51577988ec3f1078fcb9c0d4deffdaf7b8 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:02:17 +0000 Subject: [PATCH 04/75] File src/content/docs/en/sdk/android/v5/features/subscriptions.mdx was translated to ko-KR locale --- .../sdk/android/v5/features/subscriptions.mdx | 142 ++++++++---------- 1 file changed, 63 insertions(+), 79 deletions(-) diff --git a/src/content/docs/ko/sdk/android/v5/features/subscriptions.mdx b/src/content/docs/ko/sdk/android/v5/features/subscriptions.mdx index bb96245ecf..004069a5a2 100644 --- a/src/content/docs/ko/sdk/android/v5/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/android/v5/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: 구독 정보 전송 -description: 이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다. -slug: ko/sdk/android/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/sdk/android/v4/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/android/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/android/v4/features/subscriptions" --- + - +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 Adjust는 앱에 특화된 정보를 설정해야 합니다. 설정을 위해 [support@adjust.com](mailto:support@adjust.com)이나 담당 TAM\(테크니컬 어카운트 매니저\)에게 연락하시기 바랍니다. +You can record Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, instantiate an `AdjustPlayStoreSubscription` object containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustPlayStoreSubscription` 객체를 생성하시기 바랍니다. - -## 1\. 구독 객체 인스턴스화 {#1-instantiate-a-subscription-object} - - + ```java public AdjustPlayStoreSubscription(final long price, @@ -34,21 +35,20 @@ public AdjustPlayStoreSubscription(final long price, ``` - + -시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 인스턴스화해야 합니다. 이를 위해 새로운 `AdjustPlayStoreSubscription` 객체를 생성하고 다음 인수를 전달합니다. +To get started, you need to instantiate a subscription object containing details of the subscription purchase. To do this, create a new `AdjustPlayStoreSubscription` object and pass the following arguments: -| 파라미터 | 데이터 유형 | 설명 | -| --------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `long` | 구독료 | -| `currency` | `String` | 구독 통화 | -| `sku` | `String` | 제품 ID | -| `orderId` | `String` | 거래 ID | -| `signature` | `String` | 구매 데이터의 서명 | -| `purchaseToken` | `String` | 거래의 고유 토큰. 자세한 정보는 [Google 문서](https://developer.android.com/reference/com/android/billingclient/api/Purchase)를 참조하시기 바랍니다. | +| Parameter | Data type | Description | +|-----------------|-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `long` | The price of the subscription | +| `currency` | `String` | The currency of the subscription | +| `sku` | `String` | The ID of the product | +| `orderId` | `String` | Your ID for the transaction | +| `signature` | `String` | The signature of the purchase data | +| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase) for more information | - - + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,8 +62,7 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -77,23 +76,20 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### 구매일 기록 {#record-the-purchase-date} +### Record the purchase date \{\#record\-the\-purchase\-date\} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + -사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. 이 정보를 기록할 타임스탬프와 함께 `setPurchaseTime` 메서드를 호출합니다. - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setPurchaseTime` method with a timestamp to record this information. + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -108,8 +104,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -124,85 +119,75 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### 콜백 파라미터 추가 {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} - + ```java public void addCallbackParameter(String key, String value) ``` - - -콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 파라미터를 추가할 수 있습니다. + - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - - + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - - + -### 파트너 파라미터 추가 {#add-partner-parameters} +### Add partner parameters \{\#add\-partner\-parameters\} - + ```java public void addPartnerParameter(String key, String value) ``` - + -Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. - - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - - + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - - + -## 2\. 구독 정보 전송 {#2-send-subscription-information} +2\. Send subscription information \{\#send\-subscription\-information\} +----------------------------------------------------------------------------- - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - - -구독 객체를 설정하고 나면 Adjust SDK를 사용하여 Adjust에 전송할 수 있습니다. 완료된 객체를 `trackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. + - - +Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -217,8 +202,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -233,5 +217,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 36239a29523e701f4df0f14795b423d749473163 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:02:24 +0000 Subject: [PATCH 05/75] File src/content/docs/en/sdk/android/v5/features/subscriptions.mdx was translated to zh-CN locale --- .../sdk/android/v5/features/subscriptions.mdx | 142 ++++++++---------- 1 file changed, 63 insertions(+), 79 deletions(-) diff --git a/src/content/docs/zh/sdk/android/v5/features/subscriptions.mdx b/src/content/docs/zh/sdk/android/v5/features/subscriptions.mdx index c99050cd4b..6477a1daf9 100644 --- a/src/content/docs/zh/sdk/android/v5/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/android/v5/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: 发送订阅信息 -description: 使用这些方法向 Adjust 发送订阅信息。 -slug: zh/sdk/android/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /zh/sdk/android/v4/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/android/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/android/v4/features/subscriptions" --- + - +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 + -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启动该功能，Adjust 需要设置应用相关的具体信息。请发送邮件至 [support@adjust.com](mailto:support@adjust.com)或与您的技术客户经理联系进行设置。 +You can record Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, instantiate an `AdjustPlayStoreSubscription` object containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -您可以用 Adjust SDK 记录 Play 商店的订阅，并验证这些订阅是否有效。用户购买订阅后，实例化一个包含细节的 `AdjustPlayStoreSubscription` 对象。 - -## 1\. 实例化订阅对象 {#1-instantiate-a-subscription-object} - - + ```java public AdjustPlayStoreSubscription(final long price, @@ -34,21 +35,20 @@ public AdjustPlayStoreSubscription(final long price, ``` - + -要开始设置，先实例化一个包含订阅购买细节的订阅对象。为此，请创建一个新的 `AdjustPlayStoreSubscription` 对象，并传送下列参数： +To get started, you need to instantiate a subscription object containing details of the subscription purchase. To do this, create a new `AdjustPlayStoreSubscription` object and pass the following arguments: -| 参数 | 数据类型 | 描述 | -| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `long` | 订阅价格 | -| `currency` | `String` | 订阅使用的币种 | -| `sku` | `String` | 产品 ID | -| `orderId` | `String` | 您的交易 ID | -| `signature` | `String` | 购买数据的签名 | -| `purchaseToken` | `String` | 交易唯一识别码。请参考[Google 的文档](https://developer.android.com/reference/com/android/billingclient/api/Purchase)，了解更多信息。 | +| Parameter | Data type | Description | +|-----------------|-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `long` | The price of the subscription | +| `currency` | `String` | The currency of the subscription | +| `sku` | `String` | The ID of the product | +| `orderId` | `String` | Your ID for the transaction | +| `signature` | `String` | The signature of the purchase data | +| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase) for more information | - - + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,8 +62,7 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -77,23 +76,20 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### 记录购买日期 {#record-the-purchase-date} +### Record the purchase date \{\#record\-the\-purchase\-date\} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + -您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。请使用时间戳调用 `setPurchaseTime` 方法，记录该信息。 - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setPurchaseTime` method with a timestamp to record this information. + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -108,8 +104,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -124,85 +119,75 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### 添加回传参数 {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} - + ```java public void addCallbackParameter(String key, String value) ``` - - -你可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 + - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - - + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - - + -### 添加合作伙伴参数 {#add-partner-parameters} +### Add partner parameters \{\#add\-partner\-parameters\} - + ```java public void addPartnerParameter(String key, String value) ``` - + -你可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 - - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - - + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - - + -## 2\. 发送订阅信息 {#2-send-subscription-information} +2\. Send subscription information \{\#send\-subscription\-information\} +----------------------------------------------------------------------------- - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - - -设置好订阅对象后，您就可以使用 Adjust SDK 将其发送给 Adjust 了。将已完成对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 + - - +Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -217,8 +202,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -233,5 +217,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 7eedcc88f9e00880effaefb5302371c7b6fcb7bd Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:02:26 +0000 Subject: [PATCH 06/75] File src/content/docs/en/sdk/android/v5/features/subscriptions.mdx was translated to ja-JP locale --- .../sdk/android/v5/features/subscriptions.mdx | 142 ++++++++---------- 1 file changed, 63 insertions(+), 79 deletions(-) diff --git a/src/content/docs/ja/sdk/android/v5/features/subscriptions.mdx b/src/content/docs/ja/sdk/android/v5/features/subscriptions.mdx index 4d8bfea309..c236c48736 100644 --- a/src/content/docs/ja/sdk/android/v5/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/android/v5/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: サブスクリプション情報の送信 -description: Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。 -slug: ja/sdk/android/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ja/sdk/android/v4/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/android/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/android/v4/features/subscriptions" --- + - +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、アプリ固有の情報を別途追加する必要があります。設定のサポートをいたしますので、[support@adjust.com](mailto:support@adjust.com)または担当のテクニカルアカウントマネージャーまでお問い合わせください。 +You can record Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, instantiate an `AdjustPlayStoreSubscription` object containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -Playストアのサブスクリプションを記録し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションを購入したら、詳細を含む `AdjustPlayStoreSubscription`オブジェクトをインスタンス化します。 - -## 1\. サブスクリプションオブジェクトをインスタンス化する {#1-instantiate-a-subscription-object} - - + ```java public AdjustPlayStoreSubscription(final long price, @@ -34,21 +35,20 @@ public AdjustPlayStoreSubscription(final long price, ``` - + -開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトをインスタンス化する必要があります。これを行うには、新しい`AdjustPlayStoreSubscription`を作成して次の引数をパスします： +To get started, you need to instantiate a subscription object containing details of the subscription purchase. To do this, create a new `AdjustPlayStoreSubscription` object and pass the following arguments: -| パラメーター | データタイプ | 説明 | -| --------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `long` | サブスクリプションの価格 | -| `currency` | `String` | サブスクリプション通貨 | -| `sku` | `String` | プロダクトID | -| `orderId` | `String` | トランザクションID | -| `signature` | `String` | 購入データのシグネチャー | -| `purchaseToken` | `String` | トランザクションの一意のトークン。詳細は[Googleのドキュメント](https://developer.android.com/reference/com/android/billingclient/api/Purchase)を参照してください | +| Parameter | Data type | Description | +|-----------------|-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `long` | The price of the subscription | +| `currency` | `String` | The currency of the subscription | +| `sku` | `String` | The ID of the product | +| `orderId` | `String` | Your ID for the transaction | +| `signature` | `String` | The signature of the purchase data | +| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase) for more information | - - + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,8 +62,7 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -77,23 +76,20 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### 購入データを記録する {#record-the-purchase-date} +### Record the purchase date \{\#record\-the\-purchase\-date\} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + -ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。タイムスタンプを使用して`setPurchaseTime`メソッドを呼び出し、この情報を記録します。 - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setPurchaseTime` method with a timestamp to record this information. + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -108,8 +104,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -124,85 +119,75 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### コールバックパラメーターを追加する {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} - + ```java public void addCallbackParameter(String key, String value) ``` - - -コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - - + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - - + -### パートナーパラメーターの追加 {#add-partner-parameters} +### Add partner parameters \{\#add\-partner\-parameters\} - + ```java public void addPartnerParameter(String key, String value) ``` - + -パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - - + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - - + -## 2\. サブスクリプション情報を送信する {#2-send-subscription-information} +2\. Send subscription information \{\#send\-subscription\-information\} +----------------------------------------------------------------------------- - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - - -サブスクリプションオブジェクトを設定したら、Adjust SDKを使用してそれをAdjustに送信できます。完了したオブジェクトを `trackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 + - - +Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -217,8 +202,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -233,5 +217,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From e787043d28e7b354240157d0e89431e8b2a37106 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:02:29 +0000 Subject: [PATCH 07/75] File src/content/docs/en/sdk/cordova/v4/features/subscriptions.mdx was translated to ko-KR locale --- .../sdk/cordova/v4/features/subscriptions.mdx | 185 ++++++++---------- 1 file changed, 79 insertions(+), 106 deletions(-) diff --git a/src/content/docs/ko/sdk/cordova/v4/features/subscriptions.mdx b/src/content/docs/ko/sdk/cordova/v4/features/subscriptions.mdx index f0d091ce4b..53cee9ede4 100644 --- a/src/content/docs/ko/sdk/cordova/v4/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/cordova/v4/features/subscriptions.mdx @@ -1,47 +1,45 @@ --- -title: 구독 정보 전송 -description: 이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다. -slug: ko/sdk/cordova/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/cordova/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/cordova/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/cordova/features/subscriptions" --- + - +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + -다음 단계는 Adjust SDK 내의 구독 트래킹만을 설정합니다. 이 기능을 활성화하려면 Adjust는 앱에 특화된 정보를 설정해야 합니다. 설정을 위해 [support@adjust.com](mailto:support@adjust.com)이나 담당 TAM\(테크니컬 어카운트 매니저\)에게 연락하시기 바랍니다. +You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -앱 스토어 및 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustAppStoreSubscription` 또는 `AdjustPlayStoreSubscription` 인스턴스를 생성하시기 바랍니다. - -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - -시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. - - - - +To get started, you need to create a subscription object containing details of the subscription purchase. + ```js constructor(price: string, currency: string, transactionId: string, receipt: string) ``` - + -다음 속성을 포함하는 `AdjustAppStoreSubscription` 객체를 생성합니다. +Create an `AdjustAppStoreSubscription` object with the following properties: -| 파라미터 | 데이터 유형 | 설명 | -| --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | Number | 구독료 | -| `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 | -| `receipt` | String | 영수증 정보 | +| Parameter | Data type | Description | +|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | Number | The price of the subscription | +| `currency` | String | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | +| `transactionId` | String | Your ID for the transaction | +| `receipt` | String | The receipt information | ```js var subscription = new AdjustAppStoreSubscription( @@ -52,26 +50,24 @@ var subscription = new AdjustAppStoreSubscription( ); ``` - - - + ```js constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + -다음 속성을 포함하는 `AdjustPlayStoreSubscription` 객체를 생성합니다. +Create an `AdjustPlayStoreSubscription` object with the following properties: -| 파라미터 | 데이터 유형 | 설명 | -| --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | Number | 구독료 | -| `currency` | String | 구독 통화 | -| `sku` | String | 제품 ID | -| `orderId` | String | 거래 ID | -| `signature` | String | 구매 데이터의 서명 | -| `purchaseToken` | String | 거래의 고유 토큰. 자세한 정보는 [Google 문서]()를 참조하시기 바랍니다. | +| Parameter | Data type | Description | +|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | Number | The price of the subscription | +| `currency` | String | The currency of the subscription | +| `sku` | String | The ID of the product | +| `orderId` | String | Your ID for the transaction | +| `signature` | String | The signature of the purchase data | +| `purchaseToken` | String | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | ```js var subscription = new AdjustPlayStoreSubscription( @@ -84,24 +80,20 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. +### Record the purchase date \{\#record\-the\-purchase\-date\} - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. + ```js setTransactionDate(transactionDate: string): void ``` - + -구독 객체의 `setTransactionDate` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. +Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. ```js var subscription = new AdjustAppStoreSubscription( @@ -114,17 +106,15 @@ var subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - - - + ```js setPurchaseTime(purchaseTime: string): void ``` - + -구독 객체의 `setPurchaseTime` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. +Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. ```js var subscription = new AdjustPlayStoreSubscription( @@ -138,20 +128,19 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```js setSalesRegion(salesRegion: string): void ``` - + -사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `string`로 전달합니다. 이는 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)로 포맷되어야 합니다. +You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. ```js var subscription = new AdjustAppStoreSubscription( @@ -164,19 +153,16 @@ var subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} -콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. - - - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -190,15 +176,13 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - - + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -214,22 +198,18 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - - -### Add partner parameters {#add-partner-parameters} + -Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. +### Add partner parameters \{\#add\-partner\-parameters\} - - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -243,15 +223,13 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - - + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -267,24 +245,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - + -## 2\. Record subscription information {#2-record-subscription-information} +2\. Record subscription information \{\#record\-subscription\-information\} +--------------------------------------------------------------------------------- -구독 객체를 설정하고 나면 Adjust SDK를 사용하여 기록을 시작할 수 있습니다. - - - - +Once you have set up your subscription object, you can record it using the Adjust SDK. + ```js trackAppStoreSubscription(subscription: AdjustAppStoreSubscription): void ``` - + -구독 객체를 `trackAppStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. +Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. ```js var subscription = new AdjustAppStoreSubscription( @@ -303,17 +278,15 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - - - + ```js trackPlayStoreSubscription(subscription: AdjustPlayStoreSubscription): void ``` - + -구독 객체를 `trackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. +Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. ```js var subscription = new AdjustPlayStoreSubscription( @@ -333,5 +306,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 618b775ae24607e211a7a422c4b073dc59154ac7 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:02:32 +0000 Subject: [PATCH 08/75] File src/content/docs/en/sdk/cordova/v4/features/subscriptions.mdx was translated to zh-CN locale --- .../sdk/cordova/v4/features/subscriptions.mdx | 185 ++++++++---------- 1 file changed, 79 insertions(+), 106 deletions(-) diff --git a/src/content/docs/zh/sdk/cordova/v4/features/subscriptions.mdx b/src/content/docs/zh/sdk/cordova/v4/features/subscriptions.mdx index 2868219ccf..bee636fde9 100644 --- a/src/content/docs/zh/sdk/cordova/v4/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/cordova/v4/features/subscriptions.mdx @@ -1,47 +1,45 @@ --- -title: 发送订阅信息 -description: 使用这些方法向 Adjust 发送订阅信息。 -slug: zh/sdk/cordova/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/cordova/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/cordova/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/cordova/features/subscriptions" --- + - +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 + -下列步骤仅会在 Adjust SDK 中设置订阅跟踪。要启动该功能，Adjust 需要设置应用相关的具体信息。请发送邮件至 [support@adjust.com](mailto:support@adjust.com)或与您的技术客户经理联系进行设置。 +You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -您可以用 Adjust SDK 记录 App Store 和 Play 应用商店的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `AdjustAppStoreSubscription` 或 `AdjustPlayStoreSubscription` 实例。 - -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - -要开始设置，先创建一个包含订阅购买细节的订阅对象。 - - - - +To get started, you need to create a subscription object containing details of the subscription purchase. + ```js constructor(price: string, currency: string, transactionId: string, receipt: string) ``` - + -创建一个 `AdjustAppStoreSubscription` 对象，属性如下： +Create an `AdjustAppStoreSubscription` object with the following properties: -| 参数 | 数据类型 | 描述 | -| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `price` | 数字 | 订阅价格 | -| `currency` | 字符串 | 订阅使用的币种。此信息格式为 [`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` | 字符串 | 您的交易 ID | -| `receipt` | 字符串 | 收据信息 | +| Parameter | Data type | Description | +|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | Number | The price of the subscription | +| `currency` | String | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | +| `transactionId` | String | Your ID for the transaction | +| `receipt` | String | The receipt information | ```js var subscription = new AdjustAppStoreSubscription( @@ -52,26 +50,24 @@ var subscription = new AdjustAppStoreSubscription( ); ``` - - - + ```js constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + -创建一个 `AdjustPlayStoreSubscription` 对象，属性如下： +Create an `AdjustPlayStoreSubscription` object with the following properties: -| 参数 | 数据类型 | 描述 | -| --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | 数字 | 订阅价格 | -| `currency` | 字符串 | 订阅使用的币种 | -| `sku` | 字符串 | 产品 ID | -| `orderId` | 字符串 | 您的交易 ID | -| `signature` | 字符串 | 购买数据的签名 | -| `purchaseToken` | 字符串 | 交易唯一识别码。请参考[Google 的文档]()，了解更多信息。 | +| Parameter | Data type | Description | +|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | Number | The price of the subscription | +| `currency` | String | The currency of the subscription | +| `sku` | String | The ID of the product | +| `orderId` | String | Your ID for the transaction | +| `signature` | String | The signature of the purchase data | +| `purchaseToken` | String | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | ```js var subscription = new AdjustPlayStoreSubscription( @@ -84,24 +80,20 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。 +### Record the purchase date \{\#record\-the\-purchase\-date\} - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. + ```js setTransactionDate(transactionDate: string): void ``` - + -在您的订阅对象上调用 `setTransactionDate` 方法来记录订阅的时间戳。 +Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. ```js var subscription = new AdjustAppStoreSubscription( @@ -114,17 +106,15 @@ var subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - - - + ```js setPurchaseTime(purchaseTime: string): void ``` - + -在您的订阅对象上调用 `setPurchaseTime` 方法来记录订阅的时间戳。 +Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. ```js var subscription = new AdjustPlayStoreSubscription( @@ -138,20 +128,19 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```js setSalesRegion(salesRegion: string): void ``` - + -您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `string` 传递。此信息格式需为 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) 对象的 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)。 +You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. ```js var subscription = new AdjustAppStoreSubscription( @@ -164,19 +153,16 @@ var subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} -您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 - - - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -190,15 +176,13 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - - + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -214,22 +198,18 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - - -### Add partner parameters {#add-partner-parameters} + -您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 +### Add partner parameters \{\#add\-partner\-parameters\} - - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -243,15 +223,13 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - - + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -267,24 +245,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - + -## 2\. Record subscription information {#2-record-subscription-information} +2\. Record subscription information \{\#record\-subscription\-information\} +--------------------------------------------------------------------------------- -设置好订阅对象后，您就可以通过 Adjust SDK 对其进行记录了。 - - - - +Once you have set up your subscription object, you can record it using the Adjust SDK. + ```js trackAppStoreSubscription(subscription: AdjustAppStoreSubscription): void ``` - + -将订阅对象传送至 `trackAppStoreSubscription` 方法，以记录用户订阅购买。 +Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. ```js var subscription = new AdjustAppStoreSubscription( @@ -303,17 +278,15 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - - - + ```js trackPlayStoreSubscription(subscription: AdjustPlayStoreSubscription): void ``` - + -将订阅对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 +Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. ```js var subscription = new AdjustPlayStoreSubscription( @@ -333,5 +306,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From f68c8d70f15eeb5159c8fa3dc80831825eb53fbc Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:02:39 +0000 Subject: [PATCH 09/75] File src/content/docs/en/sdk/cordova/v4/features/subscriptions.mdx was translated to ja-JP locale --- .../sdk/cordova/v4/features/subscriptions.mdx | 185 ++++++++---------- 1 file changed, 79 insertions(+), 106 deletions(-) diff --git a/src/content/docs/ja/sdk/cordova/v4/features/subscriptions.mdx b/src/content/docs/ja/sdk/cordova/v4/features/subscriptions.mdx index 8c4b625cb0..bc8458d58d 100644 --- a/src/content/docs/ja/sdk/cordova/v4/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/cordova/v4/features/subscriptions.mdx @@ -1,47 +1,45 @@ --- -title: サブスクリプション情報の送信 -description: Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。 -slug: ja/sdk/cordova/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/cordova/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/cordova/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/cordova/features/subscriptions" --- + - +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、アプリ固有の情報を別途追加する必要があります。設定のサポートをいたしますので、[support@adjust.com](mailto:support@adjust.com)または担当のテクニカルアカウントマネージャーまでお問い合わせください。 +You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -App StoreおよびPlay Storeのサブスクリプションを計測し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`AdjustAppStoreSubscription`または`AdjustPlayStoreSubscription`を作成してください。 - -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - -開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。 - - - - +To get started, you need to create a subscription object containing details of the subscription purchase. + ```js constructor(price: string, currency: string, transactionId: string, receipt: string) ``` - + -以下のプロパティを含む`AdjustAppStoreSubscription`オブジェクトを作成します： +Create an `AdjustAppStoreSubscription` object with the following properties: -| パラメーター | データタイプ | 説明 | -| --------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | 数値 | サブスクリプションの価格 | -| `currency` | 文字列 | サブスクリプションの通貨。[`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` | 文字列 | トランザクションID | -| `receipt` | 文字列 | レシート情報 | +| Parameter | Data type | Description | +|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | Number | The price of the subscription | +| `currency` | String | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | +| `transactionId` | String | Your ID for the transaction | +| `receipt` | String | The receipt information | ```js var subscription = new AdjustAppStoreSubscription( @@ -52,26 +50,24 @@ var subscription = new AdjustAppStoreSubscription( ); ``` - - - + ```js constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + -以下のプロパティを含む`AdjustPlayStoreSubscription`オブジェクトを作成します： +Create an `AdjustPlayStoreSubscription` object with the following properties: -| パラメーター | データタイプ | 説明 | -| --------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | 数値 | サブスクリプションの価格 | -| `currency` | 文字列 | サブスクリプション通貨 | -| `sku` | 文字列 | プロダクトID | -| `orderId` | 文字列 | トランザクションID | -| `signature` | 文字列 | 購入データのシグネチャー | -| `purchaseToken` | 文字列 | トランザクションの一意のトークン。詳細は[Googleのドキュメント]()を参照してください | +| Parameter | Data type | Description | +|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | Number | The price of the subscription | +| `currency` | String | The currency of the subscription | +| `sku` | String | The ID of the product | +| `orderId` | String | Your ID for the transaction | +| `signature` | String | The signature of the purchase data | +| `purchaseToken` | String | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | ```js var subscription = new AdjustPlayStoreSubscription( @@ -84,24 +80,20 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。 +### Record the purchase date \{\#record\-the\-purchase\-date\} - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. + ```js setTransactionDate(transactionDate: string): void ``` - + -サブスクリプションオブジェクトで`setTransactionDate`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 +Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. ```js var subscription = new AdjustAppStoreSubscription( @@ -114,17 +106,15 @@ var subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - - - + ```js setPurchaseTime(purchaseTime: string): void ``` - + -サブスクリプションオブジェクトで`setPurchaseTime`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 +Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. ```js var subscription = new AdjustPlayStoreSubscription( @@ -138,20 +128,19 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```js setSalesRegion(salesRegion: string): void ``` - + -ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトの`setSalesRegion`メソッドを呼び、国コードを`string`としてパスします。これは、[`Storefront`](https://developer.apple.com/documentation/storekit/storefront)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)としてフォーマットされる必要があります。 +You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. ```js var subscription = new AdjustAppStoreSubscription( @@ -164,19 +153,16 @@ var subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} -コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - - - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -190,15 +176,13 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - - + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -214,22 +198,18 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - - -### Add partner parameters {#add-partner-parameters} + -パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 +### Add partner parameters \{\#add\-partner\-parameters\} - - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -243,15 +223,13 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - - + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -267,24 +245,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - + -## 2\. Record subscription information {#2-record-subscription-information} +2\. Record subscription information \{\#record\-subscription\-information\} +--------------------------------------------------------------------------------- -サブスクリプションオブジェクトを設定したら、Adjust SDKを使用して記録することが可能です。 - - - - +Once you have set up your subscription object, you can record it using the Adjust SDK. + ```js trackAppStoreSubscription(subscription: AdjustAppStoreSubscription): void ``` - + -完了したオブジェクトを `trackAppStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 +Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. ```js var subscription = new AdjustAppStoreSubscription( @@ -303,17 +278,15 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - - - + ```js trackPlayStoreSubscription(subscription: AdjustPlayStoreSubscription): void ``` - + -完了したオブジェクトを `trackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 +Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. ```js var subscription = new AdjustPlayStoreSubscription( @@ -333,5 +306,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 7c3d054f18151b2c99991b669c4d647bd03cb2e6 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:02:44 +0000 Subject: [PATCH 10/75] File src/content/docs/en/sdk/cordova/v5/features/subscriptions.mdx was translated to ko-KR locale --- .../sdk/cordova/v5/features/subscriptions.mdx | 237 ++++++++---------- 1 file changed, 103 insertions(+), 134 deletions(-) diff --git a/src/content/docs/ko/sdk/cordova/v5/features/subscriptions.mdx b/src/content/docs/ko/sdk/cordova/v5/features/subscriptions.mdx index 1e223aa3bb..e6ccfabbd5 100644 --- a/src/content/docs/ko/sdk/cordova/v5/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/cordova/v5/features/subscriptions.mdx @@ -1,77 +1,72 @@ --- -title: 구독 정보 전송 -description: 이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다. -slug: ko/sdk/cordova/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/sdk/cordova/v4/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/cordova/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/cordova/v4/features/subscriptions" --- + - +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + -다음 단계는 Adjust SDK 내의 구독 트래킹만을 설정합니다. 이 기능을 활성화하려면 Adjust는 앱에 특화된 정보를 설정해야 합니다. 설정을 위해 [support@adjust.com](mailto:support@adjust.com)이나 담당 TAM\(테크니컬 어카운트 매니저\)에게 연락하시기 바랍니다. +You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -앱 스토어 및 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustAppStoreSubscription` 또는 `AdjustPlayStoreSubscription` 인스턴스를 생성하시기 바랍니다. +To get started, you need to create a subscription object containing details of the subscription purchase. + -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - -시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. - - - - - -```js -constructor(price: string, currency: string, transactionId: string, receipt: string) +```ts +constructor(price: string, currency: string, transactionId: string) ``` - + -다음 속성을 포함하는 `AdjustAppStoreSubscription` 객체를 생성합니다. +Create an `AdjustAppStoreSubscription` object with the following properties -| 파라미터 | 데이터 유형 | 설명 | -| --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | Number | 구독료 | -| `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 | -| `receipt` | String | 영수증 정보 | +\| Parameter \| Data type \| Description \| +\| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| +\| `price` \| `string` \| The price of the subscription \| +\| `currency` \| `string` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| +\| `transactionId` \| `string` \| Your ID for the transaction \| \| ```js var subscription = new AdjustAppStoreSubscription( price, currency, transactionId, - receipt, ); +Adjust.trackAppStoreSubscription(subscription); ``` - - - + -```js +```ts constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + -다음 속성을 포함하는 `AdjustPlayStoreSubscription` 객체를 생성합니다. +Create an `AdjustPlayStoreSubscription` object with the following properties -| 파라미터 | 데이터 유형 | 설명 | -| --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | Number | 구독료 | -| `currency` | String | 구독 통화 | -| `sku` | String | 제품 ID | -| `orderId` | String | 거래 ID | -| `signature` | String | 구매 데이터의 서명 | -| `purchaseToken` | String | 거래의 고유 토큰. 자세한 정보는 [Google 문서]()를 참조하시기 바랍니다. | +| Parameter | Data type | Description | +|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription | +| `sku` | `string` | The ID of the product | +| `orderId` | `string` | Your ID for the transaction | +| `signature` | `string` | The signature of the purchase data | +| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | ```js var subscription = new AdjustPlayStoreSubscription( @@ -84,47 +79,41 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. +### Record the purchase date \{\#record\-the\-purchase\-date\} - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. + -```js +```ts setTransactionDate(transactionDate: string): void ``` - + -구독 객체의 `setTransactionDate` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. +Call the `setTransactionDate` method method on your subscription object to record the timestamp of the subscription. ```js var subscription = new AdjustAppStoreSubscription( price, currency, transactionId, - receipt, ); subscription.setTransactionDate(transactionDate); +Adjust.trackAppStoreSubscription(subscription); ``` - - - + -```js +```ts setPurchaseTime(purchaseTime: string): void ``` - + -구독 객체의 `setPurchaseTime` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. +Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. ```js var subscription = new AdjustPlayStoreSubscription( @@ -138,67 +127,64 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} - + -```js +```ts setSalesRegion(salesRegion: string): void ``` - + -사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `string`로 전달합니다. 이는 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)로 포맷되어야 합니다. +You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. ```js var subscription = new AdjustAppStoreSubscription( price, currency, transactionId, - receipt, ); subscription.setSalesRegion(salesRegion); +Adjust.trackPlayStoreSubscription(subscription); ``` -### Add callback parameters {#add-callback-parameters} - -콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. +### Add callback parameters \{\#add\-callback\-parameters\} - - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + -```js +```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( price, currency, transactionId, - receipt, ); +subscription.setTransactionDate(transactionDate); +subscription.setSalesRegion(salesRegion); subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); + +Adjust.trackAppStoreSubscription(subscription); ``` - - - + -```js +```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -214,44 +200,41 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - + -### Add partner parameters {#add-partner-parameters} +### Add partner parameters \{\#add\-partner\-parameters\} -Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + - - - - -```js +```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( price, currency, transactionId, - receipt, ); +subscription.setTransactionDate(transactionDate); +subscription.setSalesRegion(salesRegion); subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); + +Adjust.trackAppStoreSubscription(subscription); ``` - - - + -```js +```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -267,53 +250,43 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - - -## 2\. Record subscription information {#2-record-subscription-information} + -구독 객체를 설정하고 나면 Adjust SDK를 사용하여 기록을 시작할 수 있습니다. +2\. Record subscription information \{\#record\-subscription\-information\} +--------------------------------------------------------------------------------- - - - +Once you have set up your subscription object, you can record it using the Adjust SDK. + -```js -trackAppStoreSubscription(subscription: AdjustAppStoreSubscription): void +```ts +trackAppStoreSubscription(adjustAppStoreSubscription: AdjustAppStoreSubscription): void ``` - + -구독 객체를 `trackAppStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. +Pass your subscription object to the `trackAppStoreSubscription` method method to record the user's subscription purchase. ```js var 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); ``` - - - + -```js -trackPlayStoreSubscription(subscription: AdjustPlayStoreSubscription): void +```ts +trackPlayStoreSubscription(adjustPlayStoreSubscription: AdjustPlayStoreSubscription): void ``` - + -구독 객체를 `trackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. +Pass your subscription object to the `trackPlayStoreSubscription` method method to record the user's subscription purchase. ```js var subscription = new AdjustPlayStoreSubscription( @@ -325,13 +298,9 @@ var subscription = new AdjustPlayStoreSubscription( purchaseToken, ); subscription.setPurchaseTime(purchaseTime); -subscription.addCallbackParameter("key1", "value1"); -subscription.addCallbackParameter("key2", "value2"); -subscription.addPartnerParameter("key1", "value1"); -subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 53448a900137d232ba51075c1a5c018d178b2de0 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:02:46 +0000 Subject: [PATCH 11/75] File src/content/docs/en/sdk/cordova/v5/features/subscriptions.mdx was translated to zh-CN locale --- .../sdk/cordova/v5/features/subscriptions.mdx | 237 ++++++++---------- 1 file changed, 103 insertions(+), 134 deletions(-) diff --git a/src/content/docs/zh/sdk/cordova/v5/features/subscriptions.mdx b/src/content/docs/zh/sdk/cordova/v5/features/subscriptions.mdx index 92383918d5..2fffb67287 100644 --- a/src/content/docs/zh/sdk/cordova/v5/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/cordova/v5/features/subscriptions.mdx @@ -1,77 +1,72 @@ --- -title: 发送订阅信息 -description: 使用这些方法向 Adjust 发送订阅信息。 -slug: zh/sdk/cordova/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /zh/sdk/cordova/v4/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/cordova/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/cordova/v4/features/subscriptions" --- + - +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 + -下列步骤仅会在 Adjust SDK 中设置订阅跟踪。要启动该功能，Adjust 需要设置应用相关的具体信息。请发送邮件至 [support@adjust.com](mailto:support@adjust.com)或与您的技术客户经理联系进行设置。 +You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -您可以用 Adjust SDK 记录 App Store 和 Play 应用商店的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `AdjustAppStoreSubscription` 或 `AdjustPlayStoreSubscription` 实例。 +To get started, you need to create a subscription object containing details of the subscription purchase. + -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - -要开始设置，先创建一个包含订阅购买细节的订阅对象。 - - - - - -```js -constructor(price: string, currency: string, transactionId: string, receipt: string) +```ts +constructor(price: string, currency: string, transactionId: string) ``` - + -创建一个 `AdjustAppStoreSubscription` 对象，属性如下： +Create an `AdjustAppStoreSubscription` object with the following properties -| 参数 | 数据类型 | 描述 | -| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `price` | 数字 | 订阅价格 | -| `currency` | 字符串 | 订阅使用的币种。此信息格式为 [`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` | 字符串 | 您的交易 ID | -| `receipt` | 字符串 | 收据信息 | +\| Parameter \| Data type \| Description \| +\| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| +\| `price` \| `string` \| The price of the subscription \| +\| `currency` \| `string` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| +\| `transactionId` \| `string` \| Your ID for the transaction \| \| ```js var subscription = new AdjustAppStoreSubscription( price, currency, transactionId, - receipt, ); +Adjust.trackAppStoreSubscription(subscription); ``` - - - + -```js +```ts constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + -创建一个 `AdjustPlayStoreSubscription` 对象，属性如下： +Create an `AdjustPlayStoreSubscription` object with the following properties -| 参数 | 数据类型 | 描述 | -| --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | 数字 | 订阅价格 | -| `currency` | 字符串 | 订阅使用的币种 | -| `sku` | 字符串 | 产品 ID | -| `orderId` | 字符串 | 您的交易 ID | -| `signature` | 字符串 | 购买数据的签名 | -| `purchaseToken` | 字符串 | 交易唯一识别码。请参考[Google 的文档]()，了解更多信息。 | +| Parameter | Data type | Description | +|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription | +| `sku` | `string` | The ID of the product | +| `orderId` | `string` | Your ID for the transaction | +| `signature` | `string` | The signature of the purchase data | +| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | ```js var subscription = new AdjustPlayStoreSubscription( @@ -84,47 +79,41 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。 +### Record the purchase date \{\#record\-the\-purchase\-date\} - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. + -```js +```ts setTransactionDate(transactionDate: string): void ``` - + -在您的订阅对象上调用 `setTransactionDate` 方法来记录订阅的时间戳。 +Call the `setTransactionDate` method method on your subscription object to record the timestamp of the subscription. ```js var subscription = new AdjustAppStoreSubscription( price, currency, transactionId, - receipt, ); subscription.setTransactionDate(transactionDate); +Adjust.trackAppStoreSubscription(subscription); ``` - - - + -```js +```ts setPurchaseTime(purchaseTime: string): void ``` - + -在您的订阅对象上调用 `setPurchaseTime` 方法来记录订阅的时间戳。 +Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. ```js var subscription = new AdjustPlayStoreSubscription( @@ -138,67 +127,64 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} - + -```js +```ts setSalesRegion(salesRegion: string): void ``` - + -您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `string` 传递。此信息格式需为 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) 对象的 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)。 +You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. ```js var subscription = new AdjustAppStoreSubscription( price, currency, transactionId, - receipt, ); subscription.setSalesRegion(salesRegion); +Adjust.trackPlayStoreSubscription(subscription); ``` -### Add callback parameters {#add-callback-parameters} - -您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 +### Add callback parameters \{\#add\-callback\-parameters\} - - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + -```js +```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( price, currency, transactionId, - receipt, ); +subscription.setTransactionDate(transactionDate); +subscription.setSalesRegion(salesRegion); subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); + +Adjust.trackAppStoreSubscription(subscription); ``` - - - + -```js +```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -214,44 +200,41 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - + -### Add partner parameters {#add-partner-parameters} +### Add partner parameters \{\#add\-partner\-parameters\} -您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + - - - - -```js +```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( price, currency, transactionId, - receipt, ); +subscription.setTransactionDate(transactionDate); +subscription.setSalesRegion(salesRegion); subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); + +Adjust.trackAppStoreSubscription(subscription); ``` - - - + -```js +```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -267,53 +250,43 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - - -## 2\. Record subscription information {#2-record-subscription-information} + -设置好订阅对象后，您就可以通过 Adjust SDK 对其进行记录了。 +2\. Record subscription information \{\#record\-subscription\-information\} +--------------------------------------------------------------------------------- - - - +Once you have set up your subscription object, you can record it using the Adjust SDK. + -```js -trackAppStoreSubscription(subscription: AdjustAppStoreSubscription): void +```ts +trackAppStoreSubscription(adjustAppStoreSubscription: AdjustAppStoreSubscription): void ``` - + -将订阅对象传送至 `trackAppStoreSubscription` 方法，以记录用户订阅购买。 +Pass your subscription object to the `trackAppStoreSubscription` method method to record the user's subscription purchase. ```js var 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); ``` - - - + -```js -trackPlayStoreSubscription(subscription: AdjustPlayStoreSubscription): void +```ts +trackPlayStoreSubscription(adjustPlayStoreSubscription: AdjustPlayStoreSubscription): void ``` - + -将订阅对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 +Pass your subscription object to the `trackPlayStoreSubscription` method method to record the user's subscription purchase. ```js var subscription = new AdjustPlayStoreSubscription( @@ -325,13 +298,9 @@ var subscription = new AdjustPlayStoreSubscription( purchaseToken, ); subscription.setPurchaseTime(purchaseTime); -subscription.addCallbackParameter("key1", "value1"); -subscription.addCallbackParameter("key2", "value2"); -subscription.addPartnerParameter("key1", "value1"); -subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From bc248514eabf484a6bace7f0e5c34befccad8d45 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:02:49 +0000 Subject: [PATCH 12/75] File src/content/docs/en/sdk/cordova/v5/features/subscriptions.mdx was translated to ja-JP locale --- .../sdk/cordova/v5/features/subscriptions.mdx | 237 ++++++++---------- 1 file changed, 103 insertions(+), 134 deletions(-) diff --git a/src/content/docs/ja/sdk/cordova/v5/features/subscriptions.mdx b/src/content/docs/ja/sdk/cordova/v5/features/subscriptions.mdx index 13a6cf8658..0c3da196c5 100644 --- a/src/content/docs/ja/sdk/cordova/v5/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/cordova/v5/features/subscriptions.mdx @@ -1,77 +1,72 @@ --- -title: サブスクリプション情報の送信 -description: Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。 -slug: ja/sdk/cordova/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ja/sdk/cordova/v4/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/cordova/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/cordova/v4/features/subscriptions" --- + - +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、アプリ固有の情報を別途追加する必要があります。設定のサポートをいたしますので、[support@adjust.com](mailto:support@adjust.com)または担当のテクニカルアカウントマネージャーまでお問い合わせください。 +You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -App StoreおよびPlay Storeのサブスクリプションを計測し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`AdjustAppStoreSubscription`または`AdjustPlayStoreSubscription`を作成してください。 +To get started, you need to create a subscription object containing details of the subscription purchase. + -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - -開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。 - - - - - -```js -constructor(price: string, currency: string, transactionId: string, receipt: string) +```ts +constructor(price: string, currency: string, transactionId: string) ``` - + -以下のプロパティを含む`AdjustAppStoreSubscription`オブジェクトを作成します： +Create an `AdjustAppStoreSubscription` object with the following properties -| パラメーター | データタイプ | 説明 | -| --------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | 数値 | サブスクリプションの価格 | -| `currency` | 文字列 | サブスクリプションの通貨。[`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` | 文字列 | トランザクションID | -| `receipt` | 文字列 | レシート情報 | +\| Parameter \| Data type \| Description \| +\| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| +\| `price` \| `string` \| The price of the subscription \| +\| `currency` \| `string` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| +\| `transactionId` \| `string` \| Your ID for the transaction \| \| ```js var subscription = new AdjustAppStoreSubscription( price, currency, transactionId, - receipt, ); +Adjust.trackAppStoreSubscription(subscription); ``` - - - + -```js +```ts constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + -以下のプロパティを含む`AdjustPlayStoreSubscription`オブジェクトを作成します： +Create an `AdjustPlayStoreSubscription` object with the following properties -| パラメーター | データタイプ | 説明 | -| --------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | 数値 | サブスクリプションの価格 | -| `currency` | 文字列 | サブスクリプション通貨 | -| `sku` | 文字列 | プロダクトID | -| `orderId` | 文字列 | トランザクションID | -| `signature` | 文字列 | 購入データのシグネチャー | -| `purchaseToken` | 文字列 | トランザクションの一意のトークン。詳細は[Googleのドキュメント]()を参照してください | +| Parameter | Data type | Description | +|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription | +| `sku` | `string` | The ID of the product | +| `orderId` | `string` | Your ID for the transaction | +| `signature` | `string` | The signature of the purchase data | +| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | ```js var subscription = new AdjustPlayStoreSubscription( @@ -84,47 +79,41 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。 +### Record the purchase date \{\#record\-the\-purchase\-date\} - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. + -```js +```ts setTransactionDate(transactionDate: string): void ``` - + -サブスクリプションオブジェクトで`setTransactionDate`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 +Call the `setTransactionDate` method method on your subscription object to record the timestamp of the subscription. ```js var subscription = new AdjustAppStoreSubscription( price, currency, transactionId, - receipt, ); subscription.setTransactionDate(transactionDate); +Adjust.trackAppStoreSubscription(subscription); ``` - - - + -```js +```ts setPurchaseTime(purchaseTime: string): void ``` - + -サブスクリプションオブジェクトで`setPurchaseTime`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 +Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. ```js var subscription = new AdjustPlayStoreSubscription( @@ -138,67 +127,64 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} - + -```js +```ts setSalesRegion(salesRegion: string): void ``` - + -ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトの`setSalesRegion`メソッドを呼び、国コードを`string`としてパスします。これは、[`Storefront`](https://developer.apple.com/documentation/storekit/storefront)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)としてフォーマットされる必要があります。 +You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. ```js var subscription = new AdjustAppStoreSubscription( price, currency, transactionId, - receipt, ); subscription.setSalesRegion(salesRegion); +Adjust.trackPlayStoreSubscription(subscription); ``` -### Add callback parameters {#add-callback-parameters} - -コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 +### Add callback parameters \{\#add\-callback\-parameters\} - - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + -```js +```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( price, currency, transactionId, - receipt, ); +subscription.setTransactionDate(transactionDate); +subscription.setSalesRegion(salesRegion); subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); + +Adjust.trackAppStoreSubscription(subscription); ``` - - - + -```js +```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -214,44 +200,41 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - + -### Add partner parameters {#add-partner-parameters} +### Add partner parameters \{\#add\-partner\-parameters\} -パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + - - - - -```js +```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( price, currency, transactionId, - receipt, ); +subscription.setTransactionDate(transactionDate); +subscription.setSalesRegion(salesRegion); subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); + +Adjust.trackAppStoreSubscription(subscription); ``` - - - + -```js +```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -267,53 +250,43 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - - -## 2\. Record subscription information {#2-record-subscription-information} + -サブスクリプションオブジェクトを設定したら、Adjust SDKを使用して記録することが可能です。 +2\. Record subscription information \{\#record\-subscription\-information\} +--------------------------------------------------------------------------------- - - - +Once you have set up your subscription object, you can record it using the Adjust SDK. + -```js -trackAppStoreSubscription(subscription: AdjustAppStoreSubscription): void +```ts +trackAppStoreSubscription(adjustAppStoreSubscription: AdjustAppStoreSubscription): void ``` - + -完了したオブジェクトを `trackAppStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 +Pass your subscription object to the `trackAppStoreSubscription` method method to record the user's subscription purchase. ```js var 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); ``` - - - + -```js -trackPlayStoreSubscription(subscription: AdjustPlayStoreSubscription): void +```ts +trackPlayStoreSubscription(adjustPlayStoreSubscription: AdjustPlayStoreSubscription): void ``` - + -完了したオブジェクトを `trackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 +Pass your subscription object to the `trackPlayStoreSubscription` method method to record the user's subscription purchase. ```js var subscription = new AdjustPlayStoreSubscription( @@ -325,13 +298,9 @@ var subscription = new AdjustPlayStoreSubscription( purchaseToken, ); subscription.setPurchaseTime(purchaseTime); -subscription.addCallbackParameter("key1", "value1"); -subscription.addCallbackParameter("key2", "value2"); -subscription.addPartnerParameter("key1", "value1"); -subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From d5fe9e3d78c25c36c6fd8996e578a35ad3e0ddb0 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:02:55 +0000 Subject: [PATCH 13/75] File src/content/docs/en/sdk/flutter/v4/features/subscriptions.mdx was translated to ko-KR locale --- .../sdk/flutter/v4/features/subscriptions.mdx | 185 ++++++++---------- 1 file changed, 79 insertions(+), 106 deletions(-) diff --git a/src/content/docs/ko/sdk/flutter/v4/features/subscriptions.mdx b/src/content/docs/ko/sdk/flutter/v4/features/subscriptions.mdx index 4771e41767..7b37fc8973 100644 --- a/src/content/docs/ko/sdk/flutter/v4/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/flutter/v4/features/subscriptions.mdx @@ -1,47 +1,45 @@ --- -title: 구독 정보 전송 -description: 이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다. -slug: ko/sdk/flutter/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/flutter/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/flutter/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/flutter/features/subscriptions" --- + - +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 Adjust는 앱에 특화된 정보를 설정해야 합니다. 설정을 위해 [support@adjust.com](mailto:support@adjust.com)이나 담당 TAM\(테크니컬 어카운트 매니저\)에게 연락하시기 바랍니다. +You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -앱 스토어 및 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustAppStoreSubscription` 또는 `AdjustPlayStoreSubscription` 인스턴스를 생성하시기 바랍니다. - -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - -시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. - - - - +To get started, you need to create a subscription object containing details of the subscription purchase. + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId, String _receipt) ``` - + -다음 속성을 포함하는 `AdjustAppStoreSubscription` 객체를 생성합니다. +Create an `AdjustAppStoreSubscription` object with the following properties: -| 파라미터 | 데이터 유형 | 설명 | -| --------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `String` | 구독료 | -| `currency` | `String` | 구독 통화. [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) 객체의 [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc)로 포맷됨. | -| `transactionId` | `String` | 거래 ID | -| `receipt` | `String` | 영수증 정보 | +| Parameter | Data type | Description | +|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `String` | The price of the subscription | +| `currency` | `String` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | +| `transactionId` | `String` | Your ID for the transaction | +| `receipt` | `String` | The receipt information | ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -51,26 +49,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - - - + ```dart AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken) ``` - + -다음 속성을 포함하는 `AdjustPlayStoreSubscription` 객체를 생성합니다. +Create an `AdjustPlayStoreSubscription` object with the following properties: -| 파라미터 | 데이터 유형 | 설명 | -| --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `String` | 구독료 | -| `currency` | `String` | 구독 통화 | -| `sku` | `String` | 제품 ID | -| `orderId` | `String` | 거래 ID | -| `signature` | `String` | 구매 데이터의 서명 | -| `purchaseToken` | `String` | 거래의 고유 토큰. 자세한 정보는 [Google 문서]()를 참조하시기 바랍니다. | +| Parameter | Data type | Description | +|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `String` | The price of the subscription | +| `currency` | `String` | The currency of the subscription | +| `sku` | `String` | The ID of the product | +| `orderId` | `String` | Your ID for the transaction | +| `signature` | `String` | The signature of the purchase data | +| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -82,24 +78,20 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. +### Record the purchase date \{\#record\-the\-purchase\-date\} - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. + ```dart void setTransactionDate(String _transactionDate) ``` - + -구독 객체의 `setTransactionDate` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. +Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -111,17 +103,15 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - - - + ```dart void setPurchaseTime(String purchaseTime) ``` - + -구독 객체의 `setPurchaseTime` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. +Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -134,20 +124,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```dart void setSalesRegion(String _salesRegion) ``` - + -사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `String`로 전달합니다. 이는 [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) 객체의 [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift)로 포맷되어야 합니다. +You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `String`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -159,19 +148,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} -콜백 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 파라미터를 추가할 수 있습니다. - - - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -184,15 +170,13 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - - + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -207,22 +191,18 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - - -### Add partner parameters {#add-partner-parameters} + -Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. +### Add partner parameters \{\#add\-partner\-parameters\} - - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -235,15 +215,13 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - - + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -258,24 +236,21 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + -## 2\. Record subscription information {#2-record-subscription-information} +2\. Record subscription information \{\#record\-subscription\-information\} +--------------------------------------------------------------------------------- -구독 객체를 설정하고 나면 Adjust SDK를 사용하여 기록을 시작할 수 있습니다. - - - - +Once you have set up your subscription object, you can record it using the Adjust SDK. + ```dart static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription) ``` - + -구독 객체를 `trackAppStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. +Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -293,17 +268,15 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - - - + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + -구독 객체를 `trackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. +Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -322,5 +295,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From d64726967b1c53cc67cd2fba260254a3849cf8b8 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:02:58 +0000 Subject: [PATCH 14/75] File src/content/docs/en/sdk/flutter/v4/features/subscriptions.mdx was translated to zh-CN locale --- .../sdk/flutter/v4/features/subscriptions.mdx | 185 ++++++++---------- 1 file changed, 79 insertions(+), 106 deletions(-) diff --git a/src/content/docs/zh/sdk/flutter/v4/features/subscriptions.mdx b/src/content/docs/zh/sdk/flutter/v4/features/subscriptions.mdx index b87eed6791..9dd7131802 100644 --- a/src/content/docs/zh/sdk/flutter/v4/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/flutter/v4/features/subscriptions.mdx @@ -1,47 +1,45 @@ --- -title: 发送订阅信息 -description: 使用这些方法向 Adjust 发送订阅信息。 -slug: zh/sdk/flutter/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/flutter/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/flutter/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/flutter/features/subscriptions" --- + - +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 + -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启动该功能，Adjust 需要设置应用相关的具体信息。请发送邮件至 [support@adjust.com](mailto:support@adjust.com)或与您的技术客户经理联系进行设置。 +You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -您可以用 Adjust SDK 记录 App Store 和 Play 应用商店的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `AdjustAppStoreSubscription` 或 `AdjustPlayStoreSubscription` 实例。 - -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - -要开始设置，先创建一个包含订阅购买细节的订阅对象。 - - - - +To get started, you need to create a subscription object containing details of the subscription purchase. + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId, String _receipt) ``` - + -创建一个 `AdjustAppStoreSubscription` 对象，属性如下： +Create an `AdjustAppStoreSubscription` object with the following properties: -| 参数 | 数据类型 | 描述 | -| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `price` | `String` | 订阅价格 | -| `currency` | `String` | 订阅使用的币种。此信息格式为 [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) 对象的 [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc)。 | -| `transactionId` | `String` | 您的交易 ID | -| `receipt` | `String` | 收据信息 | +| Parameter | Data type | Description | +|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `String` | The price of the subscription | +| `currency` | `String` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | +| `transactionId` | `String` | Your ID for the transaction | +| `receipt` | `String` | The receipt information | ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -51,26 +49,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - - - + ```dart AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken) ``` - + -创建一个 `AdjustPlayStoreSubscription` 对象，属性如下： +Create an `AdjustPlayStoreSubscription` object with the following properties: -| 参数 | 数据类型 | 描述 | -| --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `String` | 订阅价格 | -| `currency` | `String` | 订阅使用的币种 | -| `sku` | `String` | 产品 ID | -| `orderId` | `String` | 您的交易 ID | -| `signature` | `String` | 购买数据的签名 | -| `purchaseToken` | `String` | 交易唯一识别码。请参考[Google 的文档]()，了解更多信息。 | +| Parameter | Data type | Description | +|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `String` | The price of the subscription | +| `currency` | `String` | The currency of the subscription | +| `sku` | `String` | The ID of the product | +| `orderId` | `String` | Your ID for the transaction | +| `signature` | `String` | The signature of the purchase data | +| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -82,24 +78,20 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。 +### Record the purchase date \{\#record\-the\-purchase\-date\} - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. + ```dart void setTransactionDate(String _transactionDate) ``` - + -在您的订阅对象上调用 `setTransactionDate` 方法来记录订阅的时间戳。 +Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -111,17 +103,15 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - - - + ```dart void setPurchaseTime(String purchaseTime) ``` - + -在您的订阅对象上调用 `setPurchaseTime` 方法来记录订阅的时间戳。 +Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -134,20 +124,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```dart void setSalesRegion(String _salesRegion) ``` - + -您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `String` 传递。此信息格式需为 [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) 对象的 [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift)。 +You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `String`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -159,19 +148,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} -您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 - - - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -184,15 +170,13 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - - + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -207,22 +191,18 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - - -### Add partner parameters {#add-partner-parameters} + -您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 +### Add partner parameters \{\#add\-partner\-parameters\} - - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -235,15 +215,13 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - - + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -258,24 +236,21 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + -## 2\. Record subscription information {#2-record-subscription-information} +2\. Record subscription information \{\#record\-subscription\-information\} +--------------------------------------------------------------------------------- -设置好订阅对象后，您就可以通过 Adjust SDK 对其进行记录了。 - - - - +Once you have set up your subscription object, you can record it using the Adjust SDK. + ```dart static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription) ``` - + -将订阅对象传送至 `trackAppStoreSubscription` 方法，以记录用户订阅购买。 +Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -293,17 +268,15 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - - - + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + -将订阅对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 +Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -322,5 +295,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From a9af3d95d34c0fb8f6f69227061b944cf19343a9 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:03:01 +0000 Subject: [PATCH 15/75] File src/content/docs/en/sdk/flutter/v4/features/subscriptions.mdx was translated to ja-JP locale --- .../sdk/flutter/v4/features/subscriptions.mdx | 185 ++++++++---------- 1 file changed, 79 insertions(+), 106 deletions(-) diff --git a/src/content/docs/ja/sdk/flutter/v4/features/subscriptions.mdx b/src/content/docs/ja/sdk/flutter/v4/features/subscriptions.mdx index 1d620a8ce6..5066d6dcf9 100644 --- a/src/content/docs/ja/sdk/flutter/v4/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/flutter/v4/features/subscriptions.mdx @@ -1,47 +1,45 @@ --- -title: サブスクリプション情報の送信 -description: Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。 -slug: ja/sdk/flutter/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/flutter/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/flutter/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/flutter/features/subscriptions" --- + - +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、アプリ固有の情報を別途追加する必要があります。設定のサポートをいたしますので、[support@adjust.com](mailto:support@adjust.com)または担当のテクニカルアカウントマネージャーまでお問い合わせください。 +You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -App StoreおよびPlay Storeのサブスクリプションを計測し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`AdjustAppStoreSubscription`または`AdjustPlayStoreSubscription`を作成してください。 - -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - -開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。 - - - - +To get started, you need to create a subscription object containing details of the subscription purchase. + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId, String _receipt) ``` - + -以下のプロパティを含む`AdjustAppStoreSubscription`オブジェクトを作成します： +Create an `AdjustAppStoreSubscription` object with the following properties: -| パラメーター | データタイプ | 説明 | -| --------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `String` | サブスクリプションの価格 | -| `currency` | `String` | サブスクリプションの通貨。[`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc)オブジェクトの[`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc)としてフォーマットされる | -| `transactionId` | `String` | トランザクションID | -| `receipt` | `String` | レシート情報 | +| Parameter | Data type | Description | +|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `String` | The price of the subscription | +| `currency` | `String` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | +| `transactionId` | `String` | Your ID for the transaction | +| `receipt` | `String` | The receipt information | ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -51,26 +49,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - - - + ```dart AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken) ``` - + -以下のプロパティを含む`AdjustPlayStoreSubscription`オブジェクトを作成します： +Create an `AdjustPlayStoreSubscription` object with the following properties: -| パラメーター | データタイプ | 説明 | -| --------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `String` | サブスクリプションの価格 | -| `currency` | `String` | サブスクリプション通貨 | -| `sku` | `String` | プロダクトID | -| `orderId` | `String` | トランザクションID | -| `signature` | `String` | 購入データのシグネチャー | -| `purchaseToken` | `String` | トランザクションの一意のトークン。詳細は[Googleのドキュメント]()を参照してください。 | +| Parameter | Data type | Description | +|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `String` | The price of the subscription | +| `currency` | `String` | The currency of the subscription | +| `sku` | `String` | The ID of the product | +| `orderId` | `String` | Your ID for the transaction | +| `signature` | `String` | The signature of the purchase data | +| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -82,24 +78,20 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。 +### Record the purchase date \{\#record\-the\-purchase\-date\} - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. + ```dart void setTransactionDate(String _transactionDate) ``` - + -サブスクリプションオブジェクトで`setTransactionDate`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 +Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -111,17 +103,15 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - - - + ```dart void setPurchaseTime(String purchaseTime) ``` - + -サブスクリプションオブジェクトで`setPurchaseTime`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 +Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -134,20 +124,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```dart void setSalesRegion(String _salesRegion) ``` - + -ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトの`setSalesRegion`メソッドを呼び、国コードを`String`としてパスします。これは、[`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift)としてフォーマットされる必要があります。 +You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `String`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -159,19 +148,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} -コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - - - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -184,15 +170,13 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - - + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -207,22 +191,18 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - - -### Add partner parameters {#add-partner-parameters} + -パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 +### Add partner parameters \{\#add\-partner\-parameters\} - - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -235,15 +215,13 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - - + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -258,24 +236,21 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + -## 2\. Record subscription information {#2-record-subscription-information} +2\. Record subscription information \{\#record\-subscription\-information\} +--------------------------------------------------------------------------------- -サブスクリプションオブジェクトを設定したら、Adjust SDKを使用して記録することが可能です。 - - - - +Once you have set up your subscription object, you can record it using the Adjust SDK. + ```dart static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription) ``` - + -完了したオブジェクトを `trackAppStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 +Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -293,17 +268,15 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - - - + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + -完了したオブジェクトを `trackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 +Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -322,5 +295,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From ca3c94ce42d7ca8d1ea6cb49d85fd5869c0e1e98 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:03:05 +0000 Subject: [PATCH 16/75] File src/content/docs/en/sdk/flutter/v5/features/subscriptions.mdx was translated to ko-KR locale --- .../sdk/flutter/v5/features/subscriptions.mdx | 188 ++++++++---------- 1 file changed, 82 insertions(+), 106 deletions(-) diff --git a/src/content/docs/ko/sdk/flutter/v5/features/subscriptions.mdx b/src/content/docs/ko/sdk/flutter/v5/features/subscriptions.mdx index 8df2429865..aadd558d2d 100644 --- a/src/content/docs/ko/sdk/flutter/v5/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/flutter/v5/features/subscriptions.mdx @@ -1,43 +1,44 @@ --- -title: 구독 정보 전송 -description: 이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다. -slug: ko/sdk/flutter/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/sdk/flutter/v4/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to 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/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 Adjust는 앱에 특화된 정보를 설정해야 합니다. 설정을 위해 [support@adjust.com](mailto:support@adjust.com)이나 담당 TAM\(테크니컬 어카운트 매니저\)에게 연락하시기 바랍니다. +You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -앱 스토어 및 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustAppStoreSubscription` 또는 `AdjustPlayStoreSubscription` 인스턴스를 생성하시기 바랍니다. - -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - -시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. - - - - +To get started, you need to create a subscription object containing details of the subscription purchase. + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId) ``` - + -다음 속성을 포함하는 `AdjustAppStoreSubscription` 객체를 생성합니다. +Create an `AdjustAppStoreSubscription` object with the following properties: -\| 파라미터 \| 데이터 유형 \| 설명 \| \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| \| `price` \| `String` \| 구독 요금 \| \| `currency` \| `String` \| 구독 통화. [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) 객체의 [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc)로 형식화됨 \| -\|`transactionId` \| `String` \| \| 트랜잭션 ID \| \| +\| Parameter \| Data type \| Description \| +\| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| +\| `price` \| `String` \| The price of the subscription \| +\| `currency` \| `String` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| +\| `transactionId` \| `String` \| Your ID for the transaction \| \| ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -46,26 +47,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - - - + ```dart AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken) ``` - + -다음 속성을 포함하는 `AdjustPlayStoreSubscription` 객체를 생성합니다. +Create an `AdjustPlayStoreSubscription` object with the following properties: -| 파라미터 | 데이터 유형 | 설명 | -| --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `String` | 구독료 | -| `currency` | `String` | 구독 통화 | -| `sku` | `String` | 제품 ID | -| `orderId` | `String` | 거래 ID | -| `signature` | `String` | 구매 데이터의 서명 | -| `purchaseToken` | `String` | 거래의 고유 토큰. 자세한 정보는 [Google 문서]()를 참조하시기 바랍니다. | +| Parameter | Data type | Description | +|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `String` | The price of the subscription | +| `currency` | `String` | The currency of the subscription | +| `sku` | `String` | The ID of the product | +| `orderId` | `String` | Your ID for the transaction | +| `signature` | `String` | The signature of the purchase data | +| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -77,27 +76,23 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} - -사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. + - - +### Record the purchase date \{\#record\-the\-purchase\-date\} -`AdjustAppStoreSubscription` 클래스에 `transactionDate` 속성을 추가합니다. +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. + - +Add the `transactionDate` property in the `AdjustAppStoreSubscription` class. + ```dart String? transactionDate ``` - + -사용자가 구독을 구매한 날짜를 기록하기 위해 `subscription` 인스턴스의 `transactionDate` 속성에 타임스탬프를 설정합니다. +Set a timestamp to the `transactionDate` property of your `subscription` instance to record the date on which the user purchased a subscription. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -108,20 +103,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.transactionDate = 'transactionDate'; ``` - - + -`AdjustPlayStoreSubscription` 클래스에 `purchaseTime` 속성을 추가합니다. - - +Add the `purchaseTime` property in the `AdjustPlayStoreSubscription` class. + ```dart String? purchaseTime; ``` - + -사용자가 구독을 구매한 날짜를 기록하기 위해 `subscription` 인스턴스의 `purchaseTime` 속성에 타임스탬프를 설정합니다. +Set a timestamp to the `purchaseTime` property of your `subscription` instance to record the date on which the user purchased a subscription. ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -134,20 +127,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.purchaseTime = 'purchase-time'; ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```dart String? salesRegion ``` - + -사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `String`로 전달합니다. 이는 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)로 포맷되어야 합니다. +You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `String`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -158,19 +150,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.salesRegion = 'sales-region'; ``` -### Add callback parameters {#add-callback-parameters} - -콜백 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 파라미터를 추가할 수 있습니다. +### Add callback parameters \{\#add\-callback\-parameters\} - - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -182,15 +171,13 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - - + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -205,22 +192,18 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - - -### Add partner parameters {#add-partner-parameters} + -Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. +### Add partner parameters \{\#add\-partner\-parameters\} - - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -232,15 +215,13 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - - + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -255,24 +236,21 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + -## 2\. Record subscription information {#2-record-subscription-information} +2\. Record subscription information \{\#record\-subscription\-information\} +--------------------------------------------------------------------------------- -구독 객체를 설정하고 나면 Adjust SDK를 사용하여 기록을 시작할 수 있습니다. - - - - +Once you have set up your subscription object, you can record it using the Adjust SDK. + ```dart static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription) ``` - + -구독 객체를 `trackAppStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. +Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -289,17 +267,15 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - - - + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + -구독 객체를 `trackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. +Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -318,5 +294,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 693c26d3d645e0042bbbf96a91ee92c682d4396c Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:03:10 +0000 Subject: [PATCH 17/75] File src/content/docs/en/sdk/flutter/v5/features/subscriptions.mdx was translated to zh-CN locale --- .../sdk/flutter/v5/features/subscriptions.mdx | 188 ++++++++---------- 1 file changed, 82 insertions(+), 106 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 c5366efec4..2fd1512665 100644 --- a/src/content/docs/zh/sdk/flutter/v5/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/flutter/v5/features/subscriptions.mdx @@ -1,43 +1,44 @@ --- -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: "Send subscription information" +description: "Use these methods send subscription information to 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/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 + -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启动该功能，Adjust 需要设置应用相关的具体信息。请发送邮件至 [support@adjust.com](mailto:support@adjust.com)或与您的技术客户经理联系进行设置。 +You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -您可以用 Adjust SDK 记录 App Store 和 Play 应用商店的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `AdjustAppStoreSubscription` 或 `AdjustPlayStoreSubscription` 实例。 - -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - -要开始设置，先创建一个包含订阅购买细节的订阅对象。 - - - - +To get started, you need to create a subscription object containing details of the subscription purchase. + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId) ``` - + -创建一个 `AdjustAppStoreSubscription` 对象，属性如下： +Create an `AdjustAppStoreSubscription` object with the following properties: -\|参数 \|数据类型 \|描述 \| \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| \| `price` \| `String` \|订阅价格 \| \| `currency` \| `String` \|订阅的币种。格式为 [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc)对象的[`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) \| -\| `transactionId` \| `String` \| 交易的 ID \| \| +\| Parameter \| Data type \| Description \| +\| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| +\| `price` \| `String` \| The price of the subscription \| +\| `currency` \| `String` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| +\| `transactionId` \| `String` \| Your ID for the transaction \| \| ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -46,26 +47,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - - - + ```dart AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken) ``` - + -创建一个 `AdjustPlayStoreSubscription` 对象，属性如下： +Create an `AdjustPlayStoreSubscription` object with the following properties: -| 参数 | 数据类型 | 描述 | -| --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `String` | 订阅价格 | -| `currency` | `String` | 订阅使用的币种 | -| `sku` | `String` | 产品 ID | -| `orderId` | `String` | 您的交易 ID | -| `signature` | `String` | 购买数据的签名 | -| `purchaseToken` | `String` | 交易唯一识别码。请参考[Google 的文档]()，了解更多信息。 | +| Parameter | Data type | Description | +|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `String` | The price of the subscription | +| `currency` | `String` | The currency of the subscription | +| `sku` | `String` | The ID of the product | +| `orderId` | `String` | Your ID for the transaction | +| `signature` | `String` | The signature of the purchase data | +| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -77,27 +76,23 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} - -您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。 + - - +### Record the purchase date \{\#record\-the\-purchase\-date\} -在`AdjustAppStoreSubscription`类中添加`transactionDate`属性。 +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. + - +Add the `transactionDate` property in the `AdjustAppStoreSubscription` class. + ```dart String? transactionDate ``` - + -为`subscription`实例的`transactionDate`属性设置时间戳，记录用户购买订阅的日期。 +Set a timestamp to the `transactionDate` property of your `subscription` instance to record the date on which the user purchased a subscription. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -108,20 +103,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.transactionDate = 'transactionDate'; ``` - - + -在`AdjustPlayStoreSubscription`类中添加`purchaseTime`属性。 - - +Add the `purchaseTime` property in the `AdjustPlayStoreSubscription` class. + ```dart String? purchaseTime; ``` - + -为`subscription`实例的`purchaseTime`属性设置时间戳，记录用户购买订阅的日期。 +Set a timestamp to the `purchaseTime` property of your `subscription` instance to record the date on which the user purchased a subscription. ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -134,20 +127,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.purchaseTime = 'purchase-time'; ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```dart String? salesRegion ``` - + -您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `String` 传递。此信息格式需为 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) 对象的 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)。 +You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `String`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -158,19 +150,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.salesRegion = 'sales-region'; ``` -### Add callback parameters {#add-callback-parameters} - -您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 +### Add callback parameters \{\#add\-callback\-parameters\} - - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -182,15 +171,13 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - - + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -205,22 +192,18 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - - -### Add partner parameters {#add-partner-parameters} + -您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 +### Add partner parameters \{\#add\-partner\-parameters\} - - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -232,15 +215,13 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - - + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -255,24 +236,21 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + -## 2\. Record subscription information {#2-record-subscription-information} +2\. Record subscription information \{\#record\-subscription\-information\} +--------------------------------------------------------------------------------- -设置好订阅对象后，您就可以通过 Adjust SDK 对其进行记录了。 - - - - +Once you have set up your subscription object, you can record it using the Adjust SDK. + ```dart static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription) ``` - + -将订阅对象传送至 `trackAppStoreSubscription` 方法，以记录用户订阅购买。 +Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -289,17 +267,15 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - - - + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + -将订阅对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 +Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -318,5 +294,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 77c933f7dfeb33a50f49b2f41f07260fda32b7a8 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:03:13 +0000 Subject: [PATCH 18/75] File src/content/docs/en/sdk/flutter/v5/features/subscriptions.mdx was translated to ja-JP locale --- .../sdk/flutter/v5/features/subscriptions.mdx | 191 ++++++++---------- 1 file changed, 82 insertions(+), 109 deletions(-) diff --git a/src/content/docs/ja/sdk/flutter/v5/features/subscriptions.mdx b/src/content/docs/ja/sdk/flutter/v5/features/subscriptions.mdx index e85c014a32..dfaa87aa8c 100644 --- a/src/content/docs/ja/sdk/flutter/v5/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/flutter/v5/features/subscriptions.mdx @@ -1,46 +1,44 @@ --- -title: サブスクリプション情報の送信 -description: Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。 -slug: ja/sdk/flutter/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ja/sdk/flutter/v4/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to 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/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、アプリ固有の情報を別途追加する必要があります。設定のサポートをいたしますので、[support@adjust.com](mailto:support@adjust.com)または担当のテクニカルアカウントマネージャーまでお問い合わせください。 +You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -App StoreおよびPlay Storeのサブスクリプションを計測し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`AdjustAppStoreSubscription`または`AdjustPlayStoreSubscription`を作成してください。 - -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - -開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。 - - - - +To get started, you need to create a subscription object containing details of the subscription purchase. + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId) ``` - + -以下のプロパティを含む`AdjustAppStoreSubscription`オブジェクトを作成します： +Create an `AdjustAppStoreSubscription` object with the following properties: -\|パラメーター \|データタイプ \|説明 \| -\| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| -\| `price` \| `String` \|サブスクリプションの価格 \| -\| `currency` \| `String` \|サブスクリプションの通貨。 [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc)オブジェクトの[`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc)としてフォーマット\| -\| `transactionId` \| `String` \| トランザクションのためのID\| \| +\| Parameter \| Data type \| Description \| +\| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| +\| `price` \| `String` \| The price of the subscription \| +\| `currency` \| `String` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| +\| `transactionId` \| `String` \| Your ID for the transaction \| \| ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -49,26 +47,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - - - + ```dart AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken) ``` - + -以下のプロパティを含む`AdjustPlayStoreSubscription`オブジェクトを作成します： +Create an `AdjustPlayStoreSubscription` object with the following properties: -| パラメーター | データタイプ | 説明 | -| --------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `String` | サブスクリプションの価格 | -| `currency` | `String` | サブスクリプション通貨 | -| `sku` | `String` | プロダクトID | -| `orderId` | `String` | トランザクションID | -| `signature` | `String` | 購入データのシグネチャー | -| `purchaseToken` | `String` | トランザクションの一意のトークン。詳細は[Googleのドキュメント]()を参照してください。 | +| Parameter | Data type | Description | +|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `String` | The price of the subscription | +| `currency` | `String` | The currency of the subscription | +| `sku` | `String` | The ID of the product | +| `orderId` | `String` | Your ID for the transaction | +| `signature` | `String` | The signature of the purchase data | +| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -80,27 +76,23 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} - -ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。 + - - +### Record the purchase date \{\#record\-the\-purchase\-date\} -`AdjustAppStoreSubscription`クラスに`transactionDate`プロパティを追加します。 +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. + - +Add the `transactionDate` property in the `AdjustAppStoreSubscription` class. + ```dart String? transactionDate ``` - + -`subscription`インスタンスの`transactionDate`プロパティにタイムスタンプを設定し、ユーザーがサブスクリプションを購入した日を記録します。 +Set a timestamp to the `transactionDate` property of your `subscription` instance to record the date on which the user purchased a subscription. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -111,20 +103,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.transactionDate = 'transactionDate'; ``` - - + -`AdjustPlayStoreSubscription`クラスに`purchaseTime`プロパティを追加します。 - - +Add the `purchaseTime` property in the `AdjustPlayStoreSubscription` class. + ```dart String? purchaseTime; ``` - + -`subscription`インスタンスの`purchaseTime`プロパティにタイムスタンプを設定し、ユーザーがサブスクリプションを購入した日を記録します。 +Set a timestamp to the `purchaseTime` property of your `subscription` instance to record the date on which the user purchased a subscription. ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -137,20 +127,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.purchaseTime = 'purchase-time'; ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```dart String? salesRegion ``` - + -ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトの`setSalesRegion`メソッドを呼び、国コードを`String`としてパスします。これは、[`Storefront`](https://developer.apple.com/documentation/storekit/storefront)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)としてフォーマットされる必要があります。 +You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `String`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -161,19 +150,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.salesRegion = 'sales-region'; ``` -### Add callback parameters {#add-callback-parameters} - -コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 +### Add callback parameters \{\#add\-callback\-parameters\} - - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -185,15 +171,13 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - - + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -208,22 +192,18 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - - -### Add partner parameters {#add-partner-parameters} + -パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 +### Add partner parameters \{\#add\-partner\-parameters\} - - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -235,15 +215,13 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - - + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -258,24 +236,21 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + -## 2\. Record subscription information {#2-record-subscription-information} +2\. Record subscription information \{\#record\-subscription\-information\} +--------------------------------------------------------------------------------- -サブスクリプションオブジェクトを設定したら、Adjust SDKを使用して記録することが可能です。 - - - - +Once you have set up your subscription object, you can record it using the Adjust SDK. + ```dart static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription) ``` - + -完了したオブジェクトを `trackAppStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 +Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -292,17 +267,15 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - - - + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + -完了したオブジェクトを `trackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 +Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -321,5 +294,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 9d4a02d599c78ab3f8edd06089c5ad7d16650265 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:03:17 +0000 Subject: [PATCH 19/75] File src/content/docs/en/sdk/ios/v4/features/subscriptions.mdx was translated to ko-KR locale --- .../ko/sdk/ios/v4/features/subscriptions.mdx | 156 ++++++++---------- 1 file changed, 68 insertions(+), 88 deletions(-) diff --git a/src/content/docs/ko/sdk/ios/v4/features/subscriptions.mdx b/src/content/docs/ko/sdk/ios/v4/features/subscriptions.mdx index 3c0b16f547..1090cc3938 100644 --- a/src/content/docs/ko/sdk/ios/v4/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/ios/v4/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: 구독 정보 전송 -description: 이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다. -slug: ko/sdk/ios/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/ios/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/ios/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/ios/features/subscriptions" --- + - +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 Adjust는 앱에 특화된 정보를 설정해야 합니다. 설정을 위해 [support@adjust.com](mailto:support@adjust.com)이나 담당 TAM\(테크니컬 어카운트 매니저\)에게 연락하시기 바랍니다. +You can record App Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `ADJSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -앱 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `ADJSubscription` 인스턴스를 생성하시기 바랍니다. - -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -31,19 +32,18 @@ redirects: ``` - + -시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. 이 작업을 위해서는 `initWithPrice` 메서드를 사용해 `ADJSubscription` 객체를 초기화합니다. 다음 인수를 전달합니다. +To get started, you need to create a subscription object containing details of the subscription purchase. To do this, initialize an `ADJSubscription` object using the `initWithPrice` method. Pass the following arguments: -| 파라미터 | 데이터 유형 | 설명 | -| --------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `NSDecimalNumber` | 구독료 | -| `currency` | `NSString` | 구독 통화. [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) 객체의 [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc)로 포맷됨 | -| `transactionId` | `NSString` | 거래 ID | -| `receipt` | `NSString` | 영수증 정보 | +| Parameter | Data type | Description | +|-----------------|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `NSDecimalNumber` | The price of the subscription | +| `currency` | `NSString` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | +| `transactionId` | `NSString` | Your ID for the transaction | +| `receipt` | `NSString` | The receipt information | - - + ```swift let subscription = ADJSubscription( @@ -52,8 +52,7 @@ let subscription = ADJSubscription( transactionId: transactionId) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -61,23 +60,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price transactionId:transactionId]; ``` - - + -### Record the purchase date {#record-the-purchase-date} +### Record the purchase date \{\#record\-the\-purchase\-date\} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - + -사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. 이 정보를 기록할 타임스탬프와 함께 `setTransactionDate` 메서드를 호출합니다. - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setTransactionDate` method with a timestamp to record this information. + ```swift let subscription = ADJSubscription( @@ -88,8 +84,7 @@ let subscription = ADJSubscription( subscription.setTransactionDate(transactionDate) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -99,23 +94,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setTransactionDate:transactionDate]; ``` - - + -### Record the purchase region {#record-the-purchase-region} +### Record the purchase region \{\#record\-the\-purchase\-region\} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - - -사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `NSString`로 전달합니다. 이는 [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) 객체의 [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift)로 포맷되어야 합니다. + - - +You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as an `NSString`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. + ```swift let subscription = ADJSubscription( @@ -126,8 +118,7 @@ let subscription = ADJSubscription( subscription.setSalesRegion(salesRegion) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -137,23 +128,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setSalesRegion:salesRegion]; ``` - - + -### Add callback parameters {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + -콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. - - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```swift let subscription = ADJSubscription( @@ -165,8 +153,7 @@ subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -177,23 +164,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - - + -### Add partner parameters {#add-partner-parameters} +### Add partner parameters \{\#add\-partner\-parameters\} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - - -Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. + - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```swift let subscription = ADJSubscription( @@ -205,8 +189,7 @@ subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -217,23 +200,21 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - - + -## 2\. Send subscription information {#2-send-subscription-information} +2\. Send subscription information \{\#send\-subscription\-information\} +----------------------------------------------------------------------------- - + ```objc + (void)trackSubscription:(nonnull ADJSubscription *)subscription; ``` - + -구독 객체를 설정하고 나면 Adjust SDK를 사용하여 Adjust에 전송할 수 있습니다. 완료된 객체를 `trackSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. - - - +Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackSubscription` method to record the user's subscription purchase. + ```swift let subscription = ADJSubscription( @@ -257,8 +238,7 @@ subscription.addCallbackParameter("key2", value: "value2") Adjust.trackSubscription(subscription) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -278,5 +258,5 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [Adjust trackSubscription:subscription]; ``` - - + + From e7d361e0454f6e5e825cf76dfa3b6efd6d78823e Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:03:20 +0000 Subject: [PATCH 20/75] File src/content/docs/en/sdk/ios/v4/features/subscriptions.mdx was translated to zh-CN locale --- .../zh/sdk/ios/v4/features/subscriptions.mdx | 156 ++++++++---------- 1 file changed, 68 insertions(+), 88 deletions(-) diff --git a/src/content/docs/zh/sdk/ios/v4/features/subscriptions.mdx b/src/content/docs/zh/sdk/ios/v4/features/subscriptions.mdx index b6d010e88c..5fe7f8cdd3 100644 --- a/src/content/docs/zh/sdk/ios/v4/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/ios/v4/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: 发送订阅信息 -description: 使用这些方法向 Adjust 发送订阅信息。 -slug: zh/sdk/ios/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/ios/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/ios/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/ios/features/subscriptions" --- + - +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 + -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启动该功能，Adjust 需要设置应用相关的具体信息。请发送邮件至 [support@adjust.com](mailto:support@adjust.com)或与您的技术客户经理联系进行设置。 +You can record App Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `ADJSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -您可以用 Adjust SDK 记录 App Store 的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `ADJSubscription` 实例。 - -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -31,19 +32,18 @@ redirects: ``` - + -要开始设置，先创建一个包含订阅购买细节的订阅对象。为此，请使用 `initWithPrice` 方法初始化一个 `ADJSubscription` 对象。传递以下参数： +To get started, you need to create a subscription object containing details of the subscription purchase. To do this, initialize an `ADJSubscription` object using the `initWithPrice` method. Pass the following arguments: -| 参数 | 数据类型 | 描述 | -| --------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `price` | `NSDecimalNumber` | 订阅价格 | -| `currency` | `NSString` | 订阅使用的币种。此信息格式为 [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) 对象的 [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc)。 | -| `transactionId` | `NSString` | 您的交易 ID | -| `receipt` | `NSString` | 收据信息 | +| Parameter | Data type | Description | +|-----------------|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `NSDecimalNumber` | The price of the subscription | +| `currency` | `NSString` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | +| `transactionId` | `NSString` | Your ID for the transaction | +| `receipt` | `NSString` | The receipt information | - - + ```swift let subscription = ADJSubscription( @@ -52,8 +52,7 @@ let subscription = ADJSubscription( transactionId: transactionId) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -61,23 +60,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price transactionId:transactionId]; ``` - - + -### Record the purchase date {#record-the-purchase-date} +### Record the purchase date \{\#record\-the\-purchase\-date\} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - + -您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。请使用时间戳调用 `setTransactionDate` 方法，记录该信息。 - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setTransactionDate` method with a timestamp to record this information. + ```swift let subscription = ADJSubscription( @@ -88,8 +84,7 @@ let subscription = ADJSubscription( subscription.setTransactionDate(transactionDate) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -99,23 +94,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setTransactionDate:transactionDate]; ``` - - + -### Record the purchase region {#record-the-purchase-region} +### Record the purchase region \{\#record\-the\-purchase\-region\} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - - -您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `NSString` 传递。此信息格式需为 [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) 对象的 [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift)。 + - - +You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as an `NSString`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. + ```swift let subscription = ADJSubscription( @@ -126,8 +118,7 @@ let subscription = ADJSubscription( subscription.setSalesRegion(salesRegion) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -137,23 +128,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setSalesRegion:salesRegion]; ``` - - + -### Add callback parameters {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + -您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 - - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```swift let subscription = ADJSubscription( @@ -165,8 +153,7 @@ subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -177,23 +164,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - - + -### Add partner parameters {#add-partner-parameters} +### Add partner parameters \{\#add\-partner\-parameters\} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - - -您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 + - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```swift let subscription = ADJSubscription( @@ -205,8 +189,7 @@ subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -217,23 +200,21 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - - + -## 2\. Send subscription information {#2-send-subscription-information} +2\. Send subscription information \{\#send\-subscription\-information\} +----------------------------------------------------------------------------- - + ```objc + (void)trackSubscription:(nonnull ADJSubscription *)subscription; ``` - + -设置好订阅对象后，您就可以使用 Adjust SDK 将其发送给 Adjust 了。将已完成对象传送至 `trackSubscription` 方法，以记录用户订阅购买。 - - - +Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackSubscription` method to record the user's subscription purchase. + ```swift let subscription = ADJSubscription( @@ -257,8 +238,7 @@ subscription.addCallbackParameter("key2", value: "value2") Adjust.trackSubscription(subscription) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -278,5 +258,5 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [Adjust trackSubscription:subscription]; ``` - - + + From 20950e3cbed3b60c1435d52fa1f1cd6a2681535d Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:03:26 +0000 Subject: [PATCH 21/75] File src/content/docs/en/sdk/ios/v4/features/subscriptions.mdx was translated to ja-JP locale --- .../ja/sdk/ios/v4/features/subscriptions.mdx | 156 ++++++++---------- 1 file changed, 68 insertions(+), 88 deletions(-) diff --git a/src/content/docs/ja/sdk/ios/v4/features/subscriptions.mdx b/src/content/docs/ja/sdk/ios/v4/features/subscriptions.mdx index 8eec80dbac..006f9edc59 100644 --- a/src/content/docs/ja/sdk/ios/v4/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/ios/v4/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: サブスクリプション情報の送信 -description: Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。 -slug: ja/sdk/ios/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/ios/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/ios/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/ios/features/subscriptions" --- + - +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、アプリ固有の情報を別途追加する必要があります。設定のサポートをいたしますので、[support@adjust.com](mailto:support@adjust.com)または担当のテクニカルアカウントマネージャーまでお問い合わせください。 +You can record App Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `ADJSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -App Storeのサブスクリプションを記録し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`ADJSubscription`インスタンスを作成します。 - -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -31,19 +32,18 @@ App Storeのサブスクリプションを記録し、それぞれの有効性 ``` - + -開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。これを行うには、`initWithPrice`メソッドを使用して`ADJSubscription`オブジェクトを初期化します。さらに、以下の引数をパスします。 +To get started, you need to create a subscription object containing details of the subscription purchase. To do this, initialize an `ADJSubscription` object using the `initWithPrice` method. Pass the following arguments: -| パラメーター | データタイプ | 説明 | -| --------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `NSDecimalNumber` | サブスクリプションの価格 | -| `currency` | `NSString` | サブスクリプションの通貨。[`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` | `NSString` | トランザクションID | -| `receipt` | `NSString` | レシート情報 | +| Parameter | Data type | Description | +|-----------------|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `NSDecimalNumber` | The price of the subscription | +| `currency` | `NSString` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | +| `transactionId` | `NSString` | Your ID for the transaction | +| `receipt` | `NSString` | The receipt information | - - + ```swift let subscription = ADJSubscription( @@ -52,8 +52,7 @@ let subscription = ADJSubscription( transactionId: transactionId) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -61,23 +60,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price transactionId:transactionId]; ``` - - + -### Record the purchase date {#record-the-purchase-date} +### Record the purchase date \{\#record\-the\-purchase\-date\} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - + -ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。タイムスタンプを使用して`setTransactionDate`メソッドを呼び出し、この情報を記録します。 - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setTransactionDate` method with a timestamp to record this information. + ```swift let subscription = ADJSubscription( @@ -88,8 +84,7 @@ let subscription = ADJSubscription( subscription.setTransactionDate(transactionDate) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -99,23 +94,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setTransactionDate:transactionDate]; ``` - - + -### Record the purchase region {#record-the-purchase-region} +### Record the purchase region \{\#record\-the\-purchase\-region\} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - - -ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトの`setSalesRegion`メソッドを呼び、国コードを`NSString`としてパスします。これは、[`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift)としてフォーマットされる必要があります。 + - - +You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as an `NSString`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. + ```swift let subscription = ADJSubscription( @@ -126,8 +118,7 @@ let subscription = ADJSubscription( subscription.setSalesRegion(salesRegion) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -137,23 +128,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setSalesRegion:salesRegion]; ``` - - + -### Add callback parameters {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + -コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```swift let subscription = ADJSubscription( @@ -165,8 +153,7 @@ subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -177,23 +164,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - - + -### Add partner parameters {#add-partner-parameters} +### Add partner parameters \{\#add\-partner\-parameters\} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - - -パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```swift let subscription = ADJSubscription( @@ -205,8 +189,7 @@ subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -217,23 +200,21 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - - + -## 2\. Send subscription information {#2-send-subscription-information} +2\. Send subscription information \{\#send\-subscription\-information\} +----------------------------------------------------------------------------- - + ```objc + (void)trackSubscription:(nonnull ADJSubscription *)subscription; ``` - + -サブスクリプションオブジェクトを設定したら、Adjust SDKを使用してそれをAdjustに送信できます。完了したオブジェクトを `trackSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 - - - +Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackSubscription` method to record the user's subscription purchase. + ```swift let subscription = ADJSubscription( @@ -257,8 +238,7 @@ subscription.addCallbackParameter("key2", value: "value2") Adjust.trackSubscription(subscription) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -278,5 +258,5 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [Adjust trackSubscription:subscription]; ``` - - + + From 638fac0ab312fc7e14dc2b53550443588f9512a8 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:03:29 +0000 Subject: [PATCH 22/75] File src/content/docs/en/sdk/ios/v5/features/subscriptions.mdx was translated to ko-KR locale --- .../ko/sdk/ios/v5/features/subscriptions.mdx | 180 ++++++++---------- 1 file changed, 79 insertions(+), 101 deletions(-) diff --git a/src/content/docs/ko/sdk/ios/v5/features/subscriptions.mdx b/src/content/docs/ko/sdk/ios/v5/features/subscriptions.mdx index d154a10899..4ae7dff0c5 100644 --- a/src/content/docs/ko/sdk/ios/v5/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/ios/v5/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: 구독 정보 전송 -description: 이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다. -slug: ko/sdk/ios/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/sdk/ios/v4/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/ios/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/ios/v4/features/subscriptions" --- + - +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 Adjust는 앱에 특화된 정보를 설정해야 합니다. 설정을 위해 [support@adjust.com](mailto:support@adjust.com)이나 담당 TAM\(테크니컬 어카운트 매니저\)에게 연락하시기 바랍니다. +You can record App Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `ADJAppStoreSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -앱 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `ADJAppStoreSubscription` 인스턴스를 생성하시기 바랍니다. - -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -30,18 +31,17 @@ redirects: transactionId:(nonnull NSString *)transactionId; ``` - + -시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. 이 작업을 위해서는 `initWithPrice` 메서드를 사용해 `ADJAppStoreSubscription` 객체를 초기화합니다. 다음 인수를 전달합니다. +To get started, you need to create a subscription object containing details of the subscription purchase. To do this, initialize an `ADJAppStoreSubscription` object using the `initWithPrice` method. Pass the following arguments: -| 파라미터 | 데이터 유형 | 설명 | -| --------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `NSDecimalNumber` | 구독료 | -| `currency` | `NSString` | 구독 통화. [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) 객체의 [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc)로 포맷됨 | -| `transactionId` | `NSString` | 거래 ID | +| Parameter | Data type | Description | +|-----------------|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `NSDecimalNumber` | The price of the subscription | +| `currency` | `NSString` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | +| `transactionId` | `NSString` | Your ID for the transaction | - - + ```swift let subscription = ADJAppStoreSubscription( @@ -50,8 +50,7 @@ let subscription = ADJAppStoreSubscription( transactionId: transactionId ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -59,35 +58,31 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit transactionId:transactionId]; ``` - - + -### Record the purchase date {#record-the-purchase-date} +### Record the purchase date \{\#record\-the\-purchase\-date\} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - - -사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. 이 정보를 기록할 타임스탬프와 함께 `setTransactionDate` 메서드를 호출합니다. + - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setTransactionDate` method with a timestamp to record this information. + ```swift -let subscription = ADJAppStoreSubscription( +guard let subscription = ADJAppStoreSubscription( price: price, currency: currency, - transactionId: transactionId) + transactionId: transactionId) else { return } // ... subscription.setTransactionDate(transactionDate) ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -97,35 +92,31 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setTransactionDate:transactionDate]; ``` - - + -### Record the purchase region {#record-the-purchase-region} +### Record the purchase region \{\#record\-the\-purchase\-region\} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - - -사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `NSString`로 전달합니다. 이는 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)로 포맷되어야 합니다. + - - +You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as an `NSString`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. + ```swift -let subscription = ADJAppStoreSubscription( +guard let subscription = ADJAppStoreSubscription( price: price, currency: currency, - transactionId: transactionId) + transactionId: transactionId) else { return } // ... subscription.setSalesRegion(salesRegion) ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -135,36 +126,32 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setSalesRegion:salesRegion]; ``` - - + -### Add callback parameters {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - - -콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. + - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```swift -let subscription = ADJAppStoreSubscription( +guard let subscription = ADJAppStoreSubscription( price: price, currency: currency, - transactionId: transactionId) + transactionId: transactionId) else { return } // ... subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -175,36 +162,32 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - - + -### Add partner parameters {#add-partner-parameters} +### Add partner parameters \{\#add\-partner\-parameters\} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - - -Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. + - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```swift -let subscription = ADJAppStoreSubscription( +guard let subscription = ADJAppStoreSubscription( price: price, currency: currency, - transactionId: transactionId) + transactionId: transactionId) else { return } // ... subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -215,48 +198,43 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - - + -## 2\. Send subscription information {#2-send-subscription-information} +2\. Send subscription information \{\#send\-subscription\-information\} +----------------------------------------------------------------------------- - + ```objc + (void)trackAppStoreSubscription:(nonnull ADJAppStoreSubscription *)subscription; ``` - - -구독 객체를 설정하고 나면 Adjust SDK를 사용하여 Adjust에 전송할 수 있습니다. 완료된 객체를 `trackAppStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. + - - +Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackAppStoreSubscription` method to record the user's subscription purchase. + ```swift -let subscription = ADJAppStoreSubscription( - price: price, - currency: currency, - transactionId: transactionId) +guard let subscription = ADJAppStoreSubscription( + price: price, + currency: currency, + transactionId: transactionId) else { return } subscription.setTransactionDate(transactionDate) subscription.setSalesRegion(salesRegion) // Add callback parameters - subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") // Add partner parameters - subscription.addPartnerParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") Adjust.trackAppStoreSubscription(subscription) ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -276,5 +254,5 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [Adjust trackAppStoreSubscription:subscription]; ``` - - + + From 0844335a5908bf67096cac6f0c4b2df676df72e4 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:03:32 +0000 Subject: [PATCH 23/75] File src/content/docs/en/sdk/ios/v5/features/subscriptions.mdx was translated to zh-CN locale --- .../zh/sdk/ios/v5/features/subscriptions.mdx | 180 ++++++++---------- 1 file changed, 79 insertions(+), 101 deletions(-) diff --git a/src/content/docs/zh/sdk/ios/v5/features/subscriptions.mdx b/src/content/docs/zh/sdk/ios/v5/features/subscriptions.mdx index 37e26a6a9a..c4a67adf31 100644 --- a/src/content/docs/zh/sdk/ios/v5/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/ios/v5/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: 发送订阅信息 -description: 使用这些方法向 Adjust 发送订阅信息。 -slug: zh/sdk/ios/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /zh/sdk/ios/v4/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/ios/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/ios/v4/features/subscriptions" --- + - +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 + -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启动该功能，Adjust 需要设置应用相关的具体信息。请发送邮件至 [support@adjust.com](mailto:support@adjust.com)或与您的技术客户经理联系进行设置。 +You can record App Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `ADJAppStoreSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -您可以用 Adjust SDK 记录 App Store 的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `ADJAppStoreSubscription` 实例。 - -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -30,18 +31,17 @@ redirects: transactionId:(nonnull NSString *)transactionId; ``` - + -要开始设置，先创建一个包含订阅购买细节的订阅对象。为此，请使用 `initWithPrice` 方法初始化一个 `ADJAppStoreSubscription` 对象。传递以下参数： +To get started, you need to create a subscription object containing details of the subscription purchase. To do this, initialize an `ADJAppStoreSubscription` object using the `initWithPrice` method. Pass the following arguments: -| 参数 | 数据类型 | 描述 | -| --------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `price` | `NSDecimalNumber` | 订阅价格 | -| `currency` | `NSString` | 订阅使用的币种。此信息格式为 [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) 对象的 [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc)。 | -| `transactionId` | `NSString` | 您的交易 ID | +| Parameter | Data type | Description | +|-----------------|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `NSDecimalNumber` | The price of the subscription | +| `currency` | `NSString` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | +| `transactionId` | `NSString` | Your ID for the transaction | - - + ```swift let subscription = ADJAppStoreSubscription( @@ -50,8 +50,7 @@ let subscription = ADJAppStoreSubscription( transactionId: transactionId ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -59,35 +58,31 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit transactionId:transactionId]; ``` - - + -### Record the purchase date {#record-the-purchase-date} +### Record the purchase date \{\#record\-the\-purchase\-date\} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - - -您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。请使用时间戳调用 `setTransactionDate` 方法，记录该信息。 + - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setTransactionDate` method with a timestamp to record this information. + ```swift -let subscription = ADJAppStoreSubscription( +guard let subscription = ADJAppStoreSubscription( price: price, currency: currency, - transactionId: transactionId) + transactionId: transactionId) else { return } // ... subscription.setTransactionDate(transactionDate) ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -97,35 +92,31 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setTransactionDate:transactionDate]; ``` - - + -### Record the purchase region {#record-the-purchase-region} +### Record the purchase region \{\#record\-the\-purchase\-region\} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - - -您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `NSString` 传递。此信息格式需为 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) 对象的 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)。 + - - +You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as an `NSString`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. + ```swift -let subscription = ADJAppStoreSubscription( +guard let subscription = ADJAppStoreSubscription( price: price, currency: currency, - transactionId: transactionId) + transactionId: transactionId) else { return } // ... subscription.setSalesRegion(salesRegion) ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -135,36 +126,32 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setSalesRegion:salesRegion]; ``` - - + -### Add callback parameters {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - - -您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 + - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```swift -let subscription = ADJAppStoreSubscription( +guard let subscription = ADJAppStoreSubscription( price: price, currency: currency, - transactionId: transactionId) + transactionId: transactionId) else { return } // ... subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -175,36 +162,32 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - - + -### Add partner parameters {#add-partner-parameters} +### Add partner parameters \{\#add\-partner\-parameters\} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - - -您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 + - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```swift -let subscription = ADJAppStoreSubscription( +guard let subscription = ADJAppStoreSubscription( price: price, currency: currency, - transactionId: transactionId) + transactionId: transactionId) else { return } // ... subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -215,48 +198,43 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - - + -## 2\. Send subscription information {#2-send-subscription-information} +2\. Send subscription information \{\#send\-subscription\-information\} +----------------------------------------------------------------------------- - + ```objc + (void)trackAppStoreSubscription:(nonnull ADJAppStoreSubscription *)subscription; ``` - - -设置好订阅对象后，您就可以使用 Adjust SDK 将其发送给 Adjust 了。将已完成对象传送至 `trackAppStoreSubscription` 方法，以记录用户订阅购买。 + - - +Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackAppStoreSubscription` method to record the user's subscription purchase. + ```swift -let subscription = ADJAppStoreSubscription( - price: price, - currency: currency, - transactionId: transactionId) +guard let subscription = ADJAppStoreSubscription( + price: price, + currency: currency, + transactionId: transactionId) else { return } subscription.setTransactionDate(transactionDate) subscription.setSalesRegion(salesRegion) // Add callback parameters - subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") // Add partner parameters - subscription.addPartnerParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") Adjust.trackAppStoreSubscription(subscription) ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -276,5 +254,5 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [Adjust trackAppStoreSubscription:subscription]; ``` - - + + From d761d66640f4162caafa3c11132c439c7c77a22c Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:03:35 +0000 Subject: [PATCH 24/75] File src/content/docs/en/sdk/ios/v5/features/subscriptions.mdx was translated to ja-JP locale --- .../ja/sdk/ios/v5/features/subscriptions.mdx | 180 ++++++++---------- 1 file changed, 79 insertions(+), 101 deletions(-) diff --git a/src/content/docs/ja/sdk/ios/v5/features/subscriptions.mdx b/src/content/docs/ja/sdk/ios/v5/features/subscriptions.mdx index 3513a031ef..79ef387a0f 100644 --- a/src/content/docs/ja/sdk/ios/v5/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/ios/v5/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: サブスクリプション情報の送信 -description: Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。 -slug: ja/sdk/ios/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ja/sdk/ios/v4/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/ios/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/ios/v4/features/subscriptions" --- + - +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、アプリ固有の情報を別途追加する必要があります。設定のサポートをいたしますので、[support@adjust.com](mailto:support@adjust.com)または担当のテクニカルアカウントマネージャーまでお問い合わせください。 +You can record App Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `ADJAppStoreSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -App Storeのサブスクリプションを記録し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`ADJAppStoreSubscription`インスタンスを作成します。 - -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -30,18 +31,17 @@ App Storeのサブスクリプションを記録し、それぞれの有効性 transactionId:(nonnull NSString *)transactionId; ``` - + -開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。これを行うには、`initWithPrice`メソッドを使用して`ADJAppStoreSubscription`オブジェクトを初期化します。さらに、以下の引数をパスします。 +To get started, you need to create a subscription object containing details of the subscription purchase. To do this, initialize an `ADJAppStoreSubscription` object using the `initWithPrice` method. Pass the following arguments: -| パラメーター | データタイプ | 説明 | -| --------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `NSDecimalNumber` | サブスクリプションの価格 | -| `currency` | `NSString` | サブスクリプションの通貨。[`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` | `NSString` | トランザクションID | +| Parameter | Data type | Description | +|-----------------|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `NSDecimalNumber` | The price of the subscription | +| `currency` | `NSString` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | +| `transactionId` | `NSString` | Your ID for the transaction | - - + ```swift let subscription = ADJAppStoreSubscription( @@ -50,8 +50,7 @@ let subscription = ADJAppStoreSubscription( transactionId: transactionId ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -59,35 +58,31 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit transactionId:transactionId]; ``` - - + -### Record the purchase date {#record-the-purchase-date} +### Record the purchase date \{\#record\-the\-purchase\-date\} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - - -ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。タイムスタンプを使用して`setTransactionDate`メソッドを呼び出し、この情報を記録します。 + - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setTransactionDate` method with a timestamp to record this information. + ```swift -let subscription = ADJAppStoreSubscription( +guard let subscription = ADJAppStoreSubscription( price: price, currency: currency, - transactionId: transactionId) + transactionId: transactionId) else { return } // ... subscription.setTransactionDate(transactionDate) ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -97,35 +92,31 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setTransactionDate:transactionDate]; ``` - - + -### Record the purchase region {#record-the-purchase-region} +### Record the purchase region \{\#record\-the\-purchase\-region\} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - - -ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトの`setSalesRegion`メソッドを呼び、国コードを`NSString`としてパスします。これは、[`Storefront`](https://developer.apple.com/documentation/storekit/storefront)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)としてフォーマットされる必要があります。 + - - +You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as an `NSString`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. + ```swift -let subscription = ADJAppStoreSubscription( +guard let subscription = ADJAppStoreSubscription( price: price, currency: currency, - transactionId: transactionId) + transactionId: transactionId) else { return } // ... subscription.setSalesRegion(salesRegion) ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -135,36 +126,32 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setSalesRegion:salesRegion]; ``` - - + -### Add callback parameters {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - - -コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```swift -let subscription = ADJAppStoreSubscription( +guard let subscription = ADJAppStoreSubscription( price: price, currency: currency, - transactionId: transactionId) + transactionId: transactionId) else { return } // ... subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -175,36 +162,32 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - - + -### Add partner parameters {#add-partner-parameters} +### Add partner parameters \{\#add\-partner\-parameters\} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - - -パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```swift -let subscription = ADJAppStoreSubscription( +guard let subscription = ADJAppStoreSubscription( price: price, currency: currency, - transactionId: transactionId) + transactionId: transactionId) else { return } // ... subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -215,48 +198,43 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - - + -## 2\. Send subscription information {#2-send-subscription-information} +2\. Send subscription information \{\#send\-subscription\-information\} +----------------------------------------------------------------------------- - + ```objc + (void)trackAppStoreSubscription:(nonnull ADJAppStoreSubscription *)subscription; ``` - - -サブスクリプションオブジェクトを設定したら、Adjust SDKを使用してそれをAdjustに送信できます。完了したオブジェクトを `trackAppStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 + - - +Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackAppStoreSubscription` method to record the user's subscription purchase. + ```swift -let subscription = ADJAppStoreSubscription( - price: price, - currency: currency, - transactionId: transactionId) +guard let subscription = ADJAppStoreSubscription( + price: price, + currency: currency, + transactionId: transactionId) else { return } subscription.setTransactionDate(transactionDate) subscription.setSalesRegion(salesRegion) // Add callback parameters - subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") // Add partner parameters - subscription.addPartnerParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") Adjust.trackAppStoreSubscription(subscription) ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -276,5 +254,5 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [Adjust trackAppStoreSubscription:subscription]; ``` - - + + From d8d70e51dfeccb8331d5a70bf9aaaf345961bd68 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:03:38 +0000 Subject: [PATCH 25/75] File src/content/docs/en/sdk/testing/subscription-recording.mdx was translated to ko-KR locale --- .../ko/sdk/testing/subscription-recording.mdx | 69 ++++++++----------- 1 file changed, 30 insertions(+), 39 deletions(-) diff --git a/src/content/docs/ko/sdk/testing/subscription-recording.mdx b/src/content/docs/ko/sdk/testing/subscription-recording.mdx index a36e34666f..1c24f44917 100644 --- a/src/content/docs/ko/sdk/testing/subscription-recording.mdx +++ b/src/content/docs/ko/sdk/testing/subscription-recording.mdx @@ -1,52 +1,43 @@ --- -title: 구독 기록 테스트 -description: Adjust SDK가 Adjust로 구독 정보를 전송하는지 테스트 -slug: ko/sdk/testing/subscription-recording -sidebar-label: 구독 기록 +title: "Test subscription recording" +description: "Test that the Adjust SDK is sending subscription information to Adjust" +slug: "en/sdk/testing/subscription-recording" +sidebar-label: "Subscription recording" sidebar-position: 3 --- +You can use the Adjust SDK to record information about subscription purchases in your app. + - +Make sure to set your SDK environment to **Production** after you finish testing. This ensures your app works in production mode. + -Adjust는 신규 고객에 대해 구독 기록을 더 이상 지원하지 않습니다. 이미 구독 기록을 설정한 경우, 담당 어카운트 매니저 또는 [support@adjust.com](mailto:support@adjust.com) 으로 연락주시기 바랍니다. +Use these tools to test the SDK: - +* The Adjust testing console, available in [AppView](https://help.adjust.com/en/article/testing-console). +* The [Adjust Device API](/en/api/device-api/inspect). +* Your IDE's log output. -Adjust SDK를 사용하면 유료 구독 정보를 기록할 수 있습니다. +To test that this is working: - +1. Follow the integration guide for your platform to integrate the Adjust SDK. +2. Set the environment to **sandbox** . This ensures that your app only sends information to the testing console. +3. Set your log level to **verbose** to capture all logging information from your app. +4. Set up a test device or an emulated device and find the device's advertising ID. You can install the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808) to find this information. +5. If you've previously used the device for testing: + 1. Delete your app from the test device. + 2. Clear the device's advertising ID from the testing console. Follow the instructions for the [Testing console in AppView](https://help.adjust.com/en/article/testing-console#forget-device). + 3. Alternatively, call the [forget device endpoint](/en/api/device-api/forget/) to remove existing information about the device. -테스트가 완료되면 SDK 환경을 반드시 **Production** 으로 변경하여, 앱이 프로덕션 모드에서 작동하도록 하시기 바랍니다. +6. Download and open the test version of your app that contains the Adjust SDK. +7. Trigger a test purchase. +8. Open the testing console and check the device's advertising ID status. - +If the subscription is recorded successfully, the following fields are populated in the console output: -SDK는 다음의 툴을 통해 테스트할 수 있습니다. +* **Last Subscription Event Type** +* [**Last Subscription Event Subtype**](https://help.adjust.com/en/article/manage-subscription-data#subscription-event-subtypes) +* **Last Subscription Event Timestamp** +* **Product ID** -- Adjust 테스팅 콘솔은 [AppView](https://help.adjust.com/ko/article/testing-console)에서 사용 가능합니다. -- [Adjust 디바이스 API](/ko/api/device-api/inspect). -- IDE의 로그 아웃풋. +![The Adjust testing console](@images/sdk-testing/subscription/testing-console.png) -테스트 방법: - -1. 플랫폼별 Adjust SDK 시작 가이드를 참조하여 연동을 완료합니다. -2. **샌드박스** 모드로 환경을 설정하여, 앱이 테스트용 콘솔로만 정보를 전송하도록 합니다. -3. 로그 레벨을 **verbose** 로 설정하여 앱으로부터의 모든 로깅 정보를 포착합니다. -4. 테스트용 기기 또는 에뮬레이션 기기를 설정한 뒤 기기의 광고 ID를 찾습니다. 광고 ID는 [Adjust Insights 앱](https://apps.apple.com/us/app/adjust-insights/id1125517808)을 설치하여 찾을 수 있습니다. -5. 이전에 테스트 목적으로 해당 기기를 사용한 적이 있다면 다음을 수행하시기 바랍니다. - - 1. 테스트용 기기에서 앱을 삭제합니다. - 2. 테스팅 콘솔에서 기기의 광고 ID를 삭제합니다. [AppView의 테스팅 콘솔 페이지](https://help.adjust.com/ko/article/testing-console#forget-device)의 지침을 참고하시기 바랍니다. - 3. 대안으로, [forget device 엔드포인트](/ko/api/device-api/forget/)를 호출하여 기기의 기존 정보를 삭제할 수도 있습니다. - -6. Adjust SDK가 포함된 앱의 테스트 버전을 다운로드하고, 실행합니다. -7. 테스트용 구매를 트리거합니다. -8. 테스팅 콘솔을 실행한 후, 기기의 광고 ID 상태를 확인합니다. - -구독이 성공적으로 기록되었다면, 콘솔 아웃풋의 다음 영역에 정보가 입력됩니다. - -- **LastSubscriptionEventType** -- [**마지막 구독 이벤트 하위 유형**](https://help.adjust.com/ko/article/manage-subscription-data#subscription-event-subtypes) -- **LastSubscriptionEventTimestamp** -- **제품 ID** - -![Adjust 테스팅 콘솔](@images/sdk-testing/subscription/testing-console.png) From 36c8a8ba9c4b07e87287df8269f4cf8f782c568f Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:03:42 +0000 Subject: [PATCH 26/75] File src/content/docs/en/sdk/testing/subscription-recording.mdx was translated to zh-CN locale --- .../zh/sdk/testing/subscription-recording.mdx | 69 ++++++++----------- 1 file changed, 30 insertions(+), 39 deletions(-) diff --git a/src/content/docs/zh/sdk/testing/subscription-recording.mdx b/src/content/docs/zh/sdk/testing/subscription-recording.mdx index 2ec5538885..1c24f44917 100644 --- a/src/content/docs/zh/sdk/testing/subscription-recording.mdx +++ b/src/content/docs/zh/sdk/testing/subscription-recording.mdx @@ -1,52 +1,43 @@ --- -title: 测试订阅记录 -description: 测试 Adjust SDK 是否正在向 Adjust 发送订阅信息 -slug: zh/sdk/testing/subscription-recording -sidebar-label: 订阅记录 +title: "Test subscription recording" +description: "Test that the Adjust SDK is sending subscription information to Adjust" +slug: "en/sdk/testing/subscription-recording" +sidebar-label: "Subscription recording" sidebar-position: 3 --- +You can use the Adjust SDK to record information about subscription purchases in your app. + - +Make sure to set your SDK environment to **Production** after you finish testing. This ensures your app works in production mode. + -Adjust 已不再为新客户提供订阅记录服务。如果您已经设置了订阅记录，请联系您的专属技术客户经理或发送邮件至 [support@adjust.com](mailto:support@adjust.com) 。 +Use these tools to test the SDK: - +* The Adjust testing console, available in [AppView](https://help.adjust.com/en/article/testing-console). +* The [Adjust Device API](/en/api/device-api/inspect). +* Your IDE's log output. -您可以通过 Adjust SDK 来记录应用内订阅购买的相关信息。 +To test that this is working: - +1. Follow the integration guide for your platform to integrate the Adjust SDK. +2. Set the environment to **sandbox** . This ensures that your app only sends information to the testing console. +3. Set your log level to **verbose** to capture all logging information from your app. +4. Set up a test device or an emulated device and find the device's advertising ID. You can install the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808) to find this information. +5. If you've previously used the device for testing: + 1. Delete your app from the test device. + 2. Clear the device's advertising ID from the testing console. Follow the instructions for the [Testing console in AppView](https://help.adjust.com/en/article/testing-console#forget-device). + 3. Alternatively, call the [forget device endpoint](/en/api/device-api/forget/) to remove existing information about the device. -完成测试后请确保将 SDK 环境设置为 **Production** 。这请确保应用在生产环境中正常运行。 +6. Download and open the test version of your app that contains the Adjust SDK. +7. Trigger a test purchase. +8. Open the testing console and check the device's advertising ID status. - +If the subscription is recorded successfully, the following fields are populated in the console output: -使用这些工具测试 SDK： +* **Last Subscription Event Type** +* [**Last Subscription Event Subtype**](https://help.adjust.com/en/article/manage-subscription-data#subscription-event-subtypes) +* **Last Subscription Event Timestamp** +* **Product ID** -- 位于[AppView](https://help.adjust.com/zh/article/testing-console)中的测试控制台。 -- [Adjust 设备 API](/zh/api/device-api/inspect)。 -- 您的 IDE 日志输出。 +![The Adjust testing console](@images/sdk-testing/subscription/testing-console.png) -要测试此功能是否正常运转： - -1. 按照对应平台的集成指南来集成 Adjust SDK。 -2. 将环境设为 **Sandbox** 。这能保证您的应用只向测试控制台发送信息。 -3. 将日志级别设为 **verbose** 来抓取来自应用的全部记录信息。 -4. 设置一台测试设备或模拟设备，找到设备的广告 ID。您可以安装 [Adjust Insights 应用](https://apps.apple.com/us/app/adjust-insights/id1125517808)来找到此信息。 -5. 如果您此前曾使用此设备进行测试： - - 1. 从测试设备中删除您的应用。 - 2. 在测试控制台中清除设备的广告 ID。请按照[AppView 中的测试控制台](https://help.adjust.com/zh/article/testing-console#forget-device)中的说明进行操作。 - 3. 另外，还可以调用[遗忘设备终端](/zh/api/device-api/forget/)来移除已有设备信息。 - -6. 下载并打开包含 Adjust SDK 的测试版本应用。 -7. 触发一次购买作为测试。 -8. 打开测试控制台，查看设备的广告 ID 状态。 - -如果订阅已被成功记录，那么控制台输出中以下字段会被填充： - -- **最后订阅事件类型** -- [**最后订阅事件子类型**](https://help.adjust.com/zh/article/manage-subscription-data#subscription-event-subtypes) -- **LastSubscriptionEventTimestamp** -- **产品 ID** - -![Adjust 测试控制台](@images/sdk-testing/subscription/testing-console.png) From 05a83c1ee42d5792440b7a5b80be75c84da55437 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:03:45 +0000 Subject: [PATCH 27/75] File src/content/docs/en/sdk/testing/subscription-recording.mdx was translated to ja-JP locale --- .../ja/sdk/testing/subscription-recording.mdx | 69 ++++++++----------- 1 file changed, 30 insertions(+), 39 deletions(-) diff --git a/src/content/docs/ja/sdk/testing/subscription-recording.mdx b/src/content/docs/ja/sdk/testing/subscription-recording.mdx index e50193644d..1c24f44917 100644 --- a/src/content/docs/ja/sdk/testing/subscription-recording.mdx +++ b/src/content/docs/ja/sdk/testing/subscription-recording.mdx @@ -1,52 +1,43 @@ --- -title: サブスクリプション記録のテスト -description: Adjust SDKがAdjustにサブスクリプション情報を送信していることをテストする -slug: ja/sdk/testing/subscription-recording -sidebar-label: サブスクリプション計測 +title: "Test subscription recording" +description: "Test that the Adjust SDK is sending subscription information to Adjust" +slug: "en/sdk/testing/subscription-recording" +sidebar-label: "Subscription recording" sidebar-position: 3 --- +You can use the Adjust SDK to record information about subscription purchases in your app. + - +Make sure to set your SDK environment to **Production** after you finish testing. This ensures your app works in production mode. + -Adjustは新規顧客のサブスクリプションの記録を終了しました。すでにサブスクリプションの記録を設定している場合は、専任のアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)までお問い合わせください。 +Use these tools to test the SDK: - +* The Adjust testing console, available in [AppView](https://help.adjust.com/en/article/testing-console). +* The [Adjust Device API](/en/api/device-api/inspect). +* Your IDE's log output. -Adjust SDKを使用して、アプリ内でのサブスクリプション購入に関する情報を記録できます。 +To test that this is working: - +1. Follow the integration guide for your platform to integrate the Adjust SDK. +2. Set the environment to **sandbox** . This ensures that your app only sends information to the testing console. +3. Set your log level to **verbose** to capture all logging information from your app. +4. Set up a test device or an emulated device and find the device's advertising ID. You can install the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808) to find this information. +5. If you've previously used the device for testing: + 1. Delete your app from the test device. + 2. Clear the device's advertising ID from the testing console. Follow the instructions for the [Testing console in AppView](https://help.adjust.com/en/article/testing-console#forget-device). + 3. Alternatively, call the [forget device endpoint](/en/api/device-api/forget/) to remove existing information about the device. -テストが終了したら、SDK環境を **本番用** に設定してください。これにより、アプリが本番用モードで動作します。 +6. Download and open the test version of your app that contains the Adjust SDK. +7. Trigger a test purchase. +8. Open the testing console and check the device's advertising ID status. - +If the subscription is recorded successfully, the following fields are populated in the console output: -SDKのテストには以下のツールを使用できます。 +* **Last Subscription Event Type** +* [**Last Subscription Event Subtype**](https://help.adjust.com/en/article/manage-subscription-data#subscription-event-subtypes) +* **Last Subscription Event Timestamp** +* **Product ID** -- Adjustテストコンソール（[AppView](https://help.adjust.com/ja/article/testing-console)でご利用可能）。 -- [AdjustデバイスAPI](/ja/api/device-api/inspect) -- IDEのログアウトプット +![The Adjust testing console](@images/sdk-testing/subscription/testing-console.png) -これが機能していることをテストするには、以下の手順に従ってください。 - -1. お使いのプラットフォーム向けの開始ガイドに従って、Adjust SDKを連携します。 -2. 環境を **サンドボックス** に設定します。これにより、アプリからはテストコンソールにのみ情報が送信されるようになります。 -3. アプリから全てのログ情報を取得するために、ログレベルを **verbose** に設定します。 -4. テストデバイスまたはエミュレートされたデバイスを設定し、デバイスの広告IDを確認します。[Adjust Insightsアプリ](https://apps.apple.com/us/app/adjust-insights/id1125517808)をインストールして、この情報を見つけることができます。 -5. 以前にこのデバイスをテストに使用したことがある場合は、以下の手順に従ってください。 - - 1. テスト用デバイスからアプリを削除します。 - 2. テストコンソールからデバイスの広告IDを消去します。[AppViewのテストコンソール](https://help.adjust.com/ja/article/testing-console#forget-device)向けの手順に従ってください。 - 3. または、[Forget deviceのエンドポイント](/ja/api/device-api/forget/)を呼び出して、デバイスに関する既存の情報を削除することができます。 - -6. Adjust SDKを含むアプリのテストバージョンをダウンロードして開きます。 -7. テスト購入をトリガーします。 -8. テストコンソールを開き、デバイスの広告IDのステータスを確認します。 - -サブスクリプションが正常に記録されている場合、コンソール出力で次のフィールドの値が入力されます。 - -- **LastSubscriptionEventType** -- [**Last Subscription Event Subtype**](https://help.adjust.com/ja/article/manage-subscription-data#subscription-event-subtypes) -- **LastSubscriptionEventTimestamp** -- **製品ID** - -![Adjustテストコンソール](@images/sdk-testing/subscription/testing-console.png) From b9a4bfa483a5e9e4a29d7ff1859b8a424204b4e8 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:03:48 +0000 Subject: [PATCH 28/75] File src/content/docs/en/sdk/unity/v4/features/subscriptions.mdx was translated to ko-KR locale --- .../sdk/unity/v4/features/subscriptions.mdx | 303 ++++++++---------- 1 file changed, 138 insertions(+), 165 deletions(-) diff --git a/src/content/docs/ko/sdk/unity/v4/features/subscriptions.mdx b/src/content/docs/ko/sdk/unity/v4/features/subscriptions.mdx index 13d6aad650..387a272473 100644 --- a/src/content/docs/ko/sdk/unity/v4/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/unity/v4/features/subscriptions.mdx @@ -1,326 +1,299 @@ --- -title: 구독 정보 전송 -description: 이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다. -slug: ko/sdk/unity/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/unity/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/unity/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/unity/features/subscriptions" --- + - +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 Adjust는 앱에 특화된 정보를 설정해야 합니다. 설정을 위해 [support@adjust.com](mailto:support@adjust.com)이나 담당 TAM\(테크니컬 어카운트 매니저\)에게 연락하시기 바랍니다. +You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -앱 스토어 및 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustAppStoreSubscription` 또는 `AdjustPlayStoreSubscription` 인스턴스를 생성하시기 바랍니다. - -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - -시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. - - - - +To get started, you need to create a subscription object containing details of the subscription purchase. + ```cs -public AdjustAppStoreSubscription\(string price, string currency, string transactionId, string receipt\) +public AdjustAppStoreSubscription(string price, string currency, string transactionId, string receipt) ``` - + -다음 속성을 포함하는 `AdjustAppStoreSubscription` 객체를 생성합니다. +Create an `AdjustAppStoreSubscription` object with the following properties: -| 파라미터 | 데이터 유형 | 설명 | -| --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | 구독료 | -| `currency` | `string` | 구독 통화. [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) 객체의 [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc)로 포맷됨 | -| `transactionId` | `string` | 거래 ID | -| `receipt` | `string` | 영수증 정보 | +| Parameter | Data type | Description | +|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | +| `transactionId` | `string` | Your ID for the transaction | +| `receipt` | `string` | The receipt information | ```cs -AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription\( +AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( price, currency, transactionId, - receipt\); + receipt); ``` - - - + ```cs -public AdjustPlayStoreSubscription\(string price, string currency, string sku, string orderId, string signature, string purchaseToken\) +public AdjustPlayStoreSubscription(string price, string currency, string sku, string orderId, string signature, string purchaseToken) ``` - + -다음 속성을 포함하는 `AdjustPlayStoreSubscription` 객체를 생성합니다. +Create an `AdjustPlayStoreSubscription` object with the following properties: -| 파라미터 | 데이터 유형 | 설명 | -| --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | 구독료 | -| `currency` | `string` | 구독 통화 | -| `sku` | `string` | 제품 ID | -| `orderId` | `string` | 거래 ID | -| `signature` | `string` | 구매 데이터의 서명 | -| `purchaseToken` | `string` | 거래의 고유 토큰. 자세한 정보는 [Google 문서]()를 참조하시기 바랍니다. | +| Parameter | Data type | Description | +|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription | +| `sku` | `string` | The ID of the product | +| `orderId` | `string` | Your ID for the transaction | +| `signature` | `string` | The signature of the purchase data | +| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | ```cs -AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription\( +AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( price, currency, sku, orderId, signature, - purchaseToken\); + purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. +### Record the purchase date \{\#record\-the\-purchase\-date\} - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. + ```cs -public void setTransactionDate\(string transactionDate\); +public void setTransactionDate(string transactionDate); ``` - + -구독 객체의 `setTransactionDate` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. +Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. ```cs -AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription\( +AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( price, currency, transactionId, - receipt\); + receipt); //... -subscription.setTransactionDate\(transactionDate\); +subscription.setTransactionDate(transactionDate); ``` - - - + ```cs -public void setPurchaseTime\(string purchaseTime\); +public void setPurchaseTime(string purchaseTime); ``` - + -구독 객체의 `setPurchaseTime` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. +Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. ```cs -AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription\( +AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( price, currency, sku, orderId, signature, - purchaseToken\); -subscription.setPurchaseTime\(purchaseTime\); + purchaseToken); +subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```cs -public void setSalesRegion\(string salesRegion\); +public void setSalesRegion(string salesRegion); ``` - + -사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `string`로 전달합니다. 이는 [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) 객체의 [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift)로 포맷되어야 합니다. +You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. ```cs -AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription\( +AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( price, currency, transactionId, - receipt\); + receipt); //... -subscription.setSalesRegion\(salesRegion\); +subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} -콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. - - - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```cs -public void addCallbackParameter\(string key, string value\); +public void addCallbackParameter(string key, string value); ``` - + ```cs -AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription\( +AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( price, currency, transactionId, - receipt\); + receipt); //... -subscription.addCallbackParameter\("key1", "value1"\); -subscription.addCallbackParameter\("key2", "value2"\); +subscription.addCallbackParameter("key1", "value1"); +subscription.addCallbackParameter("key2", "value2"); ``` - - - + ```cs -public void addCallbackParameter\(string key, string value\); +public void addCallbackParameter(string key, string value); ``` - + ```cs -AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription\( +AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( price, currency, sku, orderId, signature, - purchaseToken\); + purchaseToken); //... -subscription.addCallbackParameter\("key1", "value1"\); -subscription.addCallbackParameter\("key2", "value2"\); +subscription.addCallbackParameter("key1", "value1"); +subscription.addCallbackParameter("key2", "value2"); ``` - - - -### Add partner parameters {#add-partner-parameters} + -Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. +### Add partner parameters \{\#add\-partner\-parameters\} - - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```cs -public void addPartnerParameter\(string key, string value\); +public void addPartnerParameter(string key, string value); ``` - + ```cs -AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription\( +AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( price, currency, transactionId, - receipt\); + receipt); //... -subscription.addPartnerParameter\("key1", "value1"\); -subscription.addPartnerParameter\("key2", "value2"\); +subscription.addPartnerParameter("key1", "value1"); +subscription.addPartnerParameter("key2", "value2"); ``` - - - + ```cs -public void addPartnerParameter\(string key, string value\); +public void addPartnerParameter(string key, string value); ``` - + ```cs -AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription\( +AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( price, currency, sku, orderId, signature, - purchaseToken\); + purchaseToken); //... -subscription.addPartnerParameter\("key1", "value1"\); -subscription.addPartnerParameter\("key2", "value2"\); +subscription.addPartnerParameter("key1", "value1"); +subscription.addPartnerParameter("key2", "value2"); ``` - - + -## 2\. Record subscription information {#2-record-subscription-information} +2\. Record subscription information \{\#record\-subscription\-information\} +--------------------------------------------------------------------------------- -구독 객체를 설정하고 나면 Adjust SDK를 사용하여 기록을 시작할 수 있습니다. - - - - +Once you have set up your subscription object, you can record it using the Adjust SDK. + ```cs -public static void trackAppStoreSubscription\(AdjustAppStoreSubscription subscription\); +public static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + -구독 객체를 `trackAppStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. +Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. ```cs -AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription\( +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\); + 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); ``` - - - + ```cs -public static void trackPlayStoreSubscription\(AdjustPlayStoreSubscription subscription\); +public static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + -구독 객체를 `trackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. +Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. ```cs -AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription\( +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\); + purchaseToken); +subscription.setPurchaseTime(purchaseTime); +subscription.addCallbackParameter("key1", "value1"); +subscription.addCallbackParameter("key2", "value2"); +subscription.addPartnerParameter("key1", "value1"); +subscription.addPartnerParameter("key2", "value2"); + +Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 4552ffdcec0c08c91691d5ae8b1b0920611f5154 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:03:50 +0000 Subject: [PATCH 29/75] File src/content/docs/en/sdk/unity/v4/features/subscriptions.mdx was translated to zh-CN locale --- .../sdk/unity/v4/features/subscriptions.mdx | 185 ++++++++---------- 1 file changed, 79 insertions(+), 106 deletions(-) diff --git a/src/content/docs/zh/sdk/unity/v4/features/subscriptions.mdx b/src/content/docs/zh/sdk/unity/v4/features/subscriptions.mdx index 21eb7539d7..d313b7b02b 100644 --- a/src/content/docs/zh/sdk/unity/v4/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/unity/v4/features/subscriptions.mdx @@ -1,47 +1,45 @@ --- -title: 发送订阅信息 -description: 使用这些方法向 Adjust 发送订阅信息。 -slug: zh/sdk/unity/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/unity/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/unity/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/unity/features/subscriptions" --- + - +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 + -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启动该功能，Adjust 需要设置应用相关的具体信息。请发送邮件至 [support@adjust.com](mailto:support@adjust.com)或与您的技术客户经理联系进行设置。 +You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -您可以用 Adjust SDK 记录 App Store 和 Play 应用商店的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `AdjustAppStoreSubscription` 或 `AdjustPlayStoreSubscription` 实例。 - -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - -要开始设置，先创建一个包含订阅购买细节的订阅对象。 - - - - +To get started, you need to create a subscription object containing details of the subscription purchase. + ```cs public AdjustAppStoreSubscription(string price, string currency, string transactionId, string receipt) ``` - + -创建一个 `AdjustAppStoreSubscription` 对象，属性如下： +Create an `AdjustAppStoreSubscription` object with the following properties: -| 参数 | 数据类型 | 描述 | -| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `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 | -| `receipt` | `string` | 收据信息 | +| Parameter | Data type | Description | +|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | +| `transactionId` | `string` | Your ID for the transaction | +| `receipt` | `string` | The receipt information | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -51,26 +49,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - - - + ```cs public AdjustPlayStoreSubscription(string price, string currency, string sku, string orderId, string signature, string purchaseToken) ``` - + -创建一个 `AdjustPlayStoreSubscription` 对象，属性如下： +Create an `AdjustPlayStoreSubscription` object with the following properties: -| 参数 | 数据类型 | 描述 | -| --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | 订阅价格 | -| `currency` | `string` | 订阅使用的币种 | -| `sku` | `string` | 产品 ID | -| `orderId` | `string` | 您的交易 ID | -| `signature` | `string` | 购买数据的签名 | -| `purchaseToken` | `string` | 交易唯一识别码。请参考[Google 的文档]()，了解更多信息。 | +| Parameter | Data type | Description | +|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription | +| `sku` | `string` | The ID of the product | +| `orderId` | `string` | Your ID for the transaction | +| `signature` | `string` | The signature of the purchase data | +| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -82,24 +78,20 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。 +### Record the purchase date \{\#record\-the\-purchase\-date\} - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. + ```cs public void setTransactionDate(string transactionDate); ``` - + -在您的订阅对象上调用 `setTransactionDate` 方法来记录订阅的时间戳。 +Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -111,17 +103,15 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - - - + ```cs public void setPurchaseTime(string purchaseTime); ``` - + -在您的订阅对象上调用 `setPurchaseTime` 方法来记录订阅的时间戳。 +Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -134,20 +124,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```cs public void setSalesRegion(string salesRegion); ``` - + -您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `string` 传递。此信息格式需为 [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) 对象的 [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift)。 +You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -159,19 +148,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} -您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 - - - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -184,15 +170,13 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - - + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -207,22 +191,18 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - - -### Add partner parameters {#add-partner-parameters} + -您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 +### Add partner parameters \{\#add\-partner\-parameters\} - - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -235,15 +215,13 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - - + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -258,24 +236,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - + -## 2\. Record subscription information {#2-record-subscription-information} +2\. Record subscription information \{\#record\-subscription\-information\} +--------------------------------------------------------------------------------- -设置好订阅对象后，您就可以通过 Adjust SDK 对其进行记录了。 - - - - +Once you have set up your subscription object, you can record it using the Adjust SDK. + ```cs public static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + -将订阅对象传送至 `trackAppStoreSubscription` 方法，以记录用户订阅购买。 +Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -293,17 +268,15 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - - - + ```cs public static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + -将订阅对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 +Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -322,5 +295,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 4c6e4b40f115cbd280a7319b79e0e5fa1c508bfb Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:03:55 +0000 Subject: [PATCH 30/75] File src/content/docs/en/sdk/unity/v4/features/subscriptions.mdx was translated to ja-JP locale --- .../sdk/unity/v4/features/subscriptions.mdx | 185 ++++++++---------- 1 file changed, 79 insertions(+), 106 deletions(-) diff --git a/src/content/docs/ja/sdk/unity/v4/features/subscriptions.mdx b/src/content/docs/ja/sdk/unity/v4/features/subscriptions.mdx index dbda54d121..3e08500877 100644 --- a/src/content/docs/ja/sdk/unity/v4/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/unity/v4/features/subscriptions.mdx @@ -1,47 +1,45 @@ --- -title: サブスクリプション情報の送信 -description: Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。 -slug: ja/sdk/unity/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/unity/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/unity/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/unity/features/subscriptions" --- + - +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、アプリ固有の情報を別途追加する必要があります。設定のサポートをいたしますので、[support@adjust.com](mailto:support@adjust.com)または担当のテクニカルアカウントマネージャーまでお問い合わせください。 +You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -App StoreおよびPlay Storeのサブスクリプションを計測し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`AdjustAppStoreSubscription`または`AdjustPlayStoreSubscription`を作成してください。 - -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - -開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。 - - - - +To get started, you need to create a subscription object containing details of the subscription purchase. + ```cs public AdjustAppStoreSubscription(string price, string currency, string transactionId, string receipt) ``` - + -以下のプロパティを含む`AdjustAppStoreSubscription`オブジェクトを作成します： +Create an `AdjustAppStoreSubscription` object with the following properties: -| パラメーター | データタイプ | 説明 | -| --------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `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 | -| `receipt` | `string` | レシート情報 | +| Parameter | Data type | Description | +|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | +| `transactionId` | `string` | Your ID for the transaction | +| `receipt` | `string` | The receipt information | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -51,26 +49,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - - - + ```cs public AdjustPlayStoreSubscription(string price, string currency, string sku, string orderId, string signature, string purchaseToken) ``` - + -以下のプロパティを含む`AdjustPlayStoreSubscription`オブジェクトを作成します： +Create an `AdjustPlayStoreSubscription` object with the following properties: -| パラメーター | データタイプ | 説明 | -| --------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | サブスクリプションの価格 | -| `currency` | `string` | サブスクリプション通貨 | -| `sku` | `string` | プロダクトID | -| `orderId` | `string` | トランザクションID | -| `signature` | `string` | 購入データのシグネチャー | -| `purchaseToken` | `string` | トランザクションの一意のトークン。詳細は[Googleのドキュメント]()を参照してください。 | +| Parameter | Data type | Description | +|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription | +| `sku` | `string` | The ID of the product | +| `orderId` | `string` | Your ID for the transaction | +| `signature` | `string` | The signature of the purchase data | +| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -82,24 +78,20 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。 +### Record the purchase date \{\#record\-the\-purchase\-date\} - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. + ```cs public void setTransactionDate(string transactionDate); ``` - + -サブスクリプションオブジェクトで`setTransactionDate`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 +Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -111,17 +103,15 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - - - + ```cs public void setPurchaseTime(string purchaseTime); ``` - + -サブスクリプションオブジェクトで`setPurchaseTime`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 +Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -134,20 +124,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```cs public void setSalesRegion(string salesRegion); ``` - + -ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトの`setSalesRegion`メソッドを呼び、国コードを`string`としてパスします。これは、[`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift)としてフォーマットされる必要があります。 +You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -159,19 +148,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} -コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - - - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -184,15 +170,13 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - - + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -207,22 +191,18 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - - -### Add partner parameters {#add-partner-parameters} + -パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 +### Add partner parameters \{\#add\-partner\-parameters\} - - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -235,15 +215,13 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - - + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -258,24 +236,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - + -## 2\. Record subscription information {#2-record-subscription-information} +2\. Record subscription information \{\#record\-subscription\-information\} +--------------------------------------------------------------------------------- -サブスクリプションオブジェクトを設定したら、Adjust SDKを使用して記録することが可能です。 - - - - +Once you have set up your subscription object, you can record it using the Adjust SDK. + ```cs public static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + -完了したオブジェクトを `trackAppStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 +Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -293,17 +268,15 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - - - + ```cs public static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + -完了したオブジェクトを `trackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 +Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -322,5 +295,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From b72bd4ab3563957e46c9ffa675f440b0c926e506 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:03:59 +0000 Subject: [PATCH 31/75] File src/content/docs/en/sdk/unity/v5/features/subscriptions.mdx was translated to ko-KR locale --- .../sdk/unity/v5/features/subscriptions.mdx | 259 ++++++++---------- 1 file changed, 116 insertions(+), 143 deletions(-) diff --git a/src/content/docs/ko/sdk/unity/v5/features/subscriptions.mdx b/src/content/docs/ko/sdk/unity/v5/features/subscriptions.mdx index 5427406f5c..bb4c928229 100644 --- a/src/content/docs/ko/sdk/unity/v5/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/unity/v5/features/subscriptions.mdx @@ -1,46 +1,44 @@ --- -title: 구독 정보 전송 -description: 이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다. -slug: ko/sdk/unity/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/sdk/unity/v4/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/unity/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/unity/v4/features/subscriptions" --- + - +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 Adjust는 앱에 특화된 정보를 설정해야 합니다. 설정을 위해 [support@adjust.com](mailto:support@adjust.com)이나 담당 TAM\(테크니컬 어카운트 매니저\)에게 연락하시기 바랍니다. +You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -앱 스토어 및 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustAppStoreSubscription` 또는 `AdjustPlayStoreSubscription` 인스턴스를 생성하시기 바랍니다. - -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - -시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. - - - - +To get started, you need to create a subscription object containing details of the subscription purchase. + ```cs public AdjustAppStoreSubscription(string price, string currency, string transactionId); ``` - + -다음 속성을 포함하는 `AdjustAppStoreSubscription` 객체를 생성합니다. +Create an `AdjustAppStoreSubscription` object with the following properties: -| 파라미터 | 데이터 유형 | 설명 | -| --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | 구독료 | -| `currency` | `string` | 구독 통화. [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) 객체의 [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc)로 포맷됨 | -| `transactionId` | `string` | 거래 ID | +| Parameter | Data type | Description | +|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | +| `transactionId` | `string` | Your ID for the transaction | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -49,26 +47,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - - - + ```cs public AdjustPlayStoreSubscription(string price, string currency, string sku, string orderId, string signature, string purchaseToken) ``` - + -다음 속성을 포함하는 `AdjustPlayStoreSubscription` 객체를 생성합니다. +Create an `AdjustPlayStoreSubscription` object with the following properties: -| 파라미터 | 데이터 유형 | 설명 | -| --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | 구독료 | -| `currency` | `string` | 구독 통화 | -| `sku` | `string` | 제품 ID | -| `orderId` | `string` | 거래 ID | -| `signature` | `string` | 구매 데이터의 서명 | -| `purchaseToken` | `string` | 거래의 고유 토큰. 자세한 정보는 [Google 문서]()를 참조하시기 바랍니다. | +| Parameter | Data type | Description | +|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription | +| `sku` | `string` | The ID of the product | +| `orderId` | `string` | Your ID for the transaction | +| `signature` | `string` | The signature of the purchase data | +| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -80,24 +76,20 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - - + -### Record the purchase date {#record-the-purchase-date} +### Record the purchase date \{\#record\-the\-purchase\-date\} -사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. - - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. + ```cs public string TransactionDate { get; set; } ``` - + -`AdjustAppStoreSubscription` 인스턴스의 `setTransactionDate` 속성을 설정하여 구독의 타임스탬프를 기록합니다. +Set the `setTransactionDate` property of your `AdjustAppStoreSubscription` instance to record the timestamp of the subscription. ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -108,17 +100,15 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.TransactionDate = transactionDate; ``` - - - + ```cs public string PurchaseTime { get; set; } ``` - + -`AdjustPlayStoreSubscription` 인스턴스의 `PurchaseTime` 속성을 설정하여 구독의 타임스탬프를 기록합니다. +Set the `PurchaseTime` property of your `AdjustPlayStoreSubscription` instance to record the timestamp of the subscription. ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -131,189 +121,172 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.PurchaseTime = purchaseTime; ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```cs public string SalesRegion { get; set; } ``` - + -사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 `AdjustPlayStoreSubscription` 인스턴스의 `SalesRegion` 속성을 `string` 의 국가 코드로 설정합니다. 이는 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)로 포맷되어야 합니다. +You can record the region in which the user purchased a subscription. To do this, set the `SalesRegion` property of your `AdjustPlayStoreSubscription` instance to the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. ```cs -AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription\( +AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( price, currency, - transactionId\); + transactionId); //... subscription.SalesRegiom = salesRegion; ``` -### Add callback parameters {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} -콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `AddCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. - - - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `AddCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```cs -public void AddCallbackParameter\(string key, string value\); +public void AddCallbackParameter(string key, string value); ``` - + ```cs -AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription\( +AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( price, currency, - transactionId\); + transactionId); //... -subscription.AddCallbackParameter\("key1", "value1"\); -subscription.AddCallbackParameter\("key2", "value2"\); +subscription.AddCallbackParameter("key1", "value1"); +subscription.AddCallbackParameter("key2", "value2"); ``` - - - + ```cs -public void AddCallbackParameter\(string key, string value\); +public void AddCallbackParameter(string key, string value); ``` - + ```cs -AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription\( +AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( price, currency, sku, orderId, signature, - purchaseToken\); + purchaseToken); //... -subscription.AddCallbackParameter\("key1", "value1"\); -subscription.AddCallbackParameter\("key2", "value2"\); +subscription.AddCallbackParameter("key1", "value1"); +subscription.AddCallbackParameter("key2", "value2"); ``` - - + -### Add partner parameters {#add-partner-parameters} +### Add partner parameters \{\#add\-partner\-parameters\} -Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `AddPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. - - - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `AddPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```cs -public void AddPartnerParameter\(string key, string value\); +public void AddPartnerParameter(string key, string value); ``` - + ```cs -AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription\( +AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( price, currency, - transactionId\); + transactionId); //... -subscription.AddPartnerParameter\("key1", "value1"\); -subscription.AddPartnerParameter\("key2", "value2"\); +subscription.AddPartnerParameter("key1", "value1"); +subscription.AddPartnerParameter("key2", "value2"); ``` - - - + ```cs -public void AddPartnerParameter\(string key, string value\); +public void AddPartnerParameter(string key, string value); ``` - + ```cs -AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription\( +AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( price, currency, sku, orderId, signature, - purchaseToken\); + purchaseToken); //... -subscription.AddPartnerParameter\("key1", "value1"\); -subscription.AddPartnerParameter\("key2", "value2"\); +subscription.AddPartnerParameter("key1", "value1"); +subscription.AddPartnerParameter("key2", "value2"); ``` - - - -## 2\. Record subscription information {#2-record-subscription-information} + -구독 객체를 설정하고 나면 Adjust SDK를 사용하여 기록을 시작할 수 있습니다. +2\. Record subscription information \{\#record\-subscription\-information\} +--------------------------------------------------------------------------------- - - - +Once you have set up your subscription object, you can record it using the Adjust SDK. + ```cs -public static void TrackAppStoreSubscription\(AdjustAppStoreSubscription subscription\); +public static void TrackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + -구독 객체를 `Adjust.TrackAppStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. +Pass your subscription object to the `Adjust.TrackAppStoreSubscription` method to record the user's subscription purchase. ```cs -AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription\( +AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( price, currency, - transactionId\); + transactionId); subscription.TransactionDate = transactionDate; subscription.AalesRegion = salesRegion; -subscription.AddCallbackParameter\("key1", "value1"\); -subscription.AddCallbackParameter\("key2", "value2"\); -subscription.AddPartnerParameter\("key1", "value1"\); -subscription.AddPartnerParameter\("key2", "value2"\); +subscription.AddCallbackParameter("key1", "value1"); +subscription.AddCallbackParameter("key2", "value2"); +subscription.AddPartnerParameter("key1", "value1"); +subscription.AddPartnerParameter("key2", "value2"); -Adjust.TrackAppStoreSubscription\(subscription\); +Adjust.TrackAppStoreSubscription(subscription); ``` - - - + ```cs -public static void TrackPlayStoreSubscription\(AdjustPlayStoreSubscription subscription\); +public static void TrackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + -구독 객체를 `Adjust.TrackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. +Pass your subscription object to the `Adjust.TrackPlayStoreSubscription` method to record the user's subscription purchase. ```cs -AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription\( +AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( price, currency, sku, orderId, signature, - purchaseToken\); + purchaseToken); subscription.PurchaseTime = purchaseTime; -subscription.AddCallbackParameter\("key1", "value1"\); -subscription.AddCallbackParameter\("key2", "value2"\); -subscription.AddPartnerParameter\("key1", "value1"\); -subscription.AddPartnerParameter\("key2", "value2"\); +subscription.AddCallbackParameter("key1", "value1"); +subscription.AddCallbackParameter("key2", "value2"); +subscription.AddPartnerParameter("key1", "value1"); +subscription.AddPartnerParameter("key2", "value2"); -Adjust.TrackPlayStoreSubscription\(subscription\); +Adjust.TrackPlayStoreSubscription(subscription); ``` - - + + From 97df0a27b983224f01fcf87f657a32967e336d74 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:04:02 +0000 Subject: [PATCH 32/75] File src/content/docs/en/sdk/unity/v5/features/subscriptions.mdx was translated to zh-CN locale --- .../sdk/unity/v5/features/subscriptions.mdx | 183 ++++++++---------- 1 file changed, 78 insertions(+), 105 deletions(-) diff --git a/src/content/docs/zh/sdk/unity/v5/features/subscriptions.mdx b/src/content/docs/zh/sdk/unity/v5/features/subscriptions.mdx index f282f76054..3b51d69271 100644 --- a/src/content/docs/zh/sdk/unity/v5/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/unity/v5/features/subscriptions.mdx @@ -1,46 +1,44 @@ --- -title: 发送订阅信息 -description: 使用这些方法向 Adjust 发送订阅信息。 -slug: zh/sdk/unity/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /zh/sdk/unity/v4/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/unity/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/unity/v4/features/subscriptions" --- + - +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 + -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启动该功能，Adjust 需要设置应用相关的具体信息。请发送邮件至 [support@adjust.com](mailto:support@adjust.com)或与您的技术客户经理联系进行设置。 +You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -您可以用 Adjust SDK 记录 App Store 和 Play 应用商店的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `AdjustAppStoreSubscription` 或 `AdjustPlayStoreSubscription` 实例。 - -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - -要开始设置，先创建一个包含订阅购买细节的订阅对象。 - - - - +To get started, you need to create a subscription object containing details of the subscription purchase. + ```cs public AdjustAppStoreSubscription(string price, string currency, string transactionId); ``` - + -创建一个 `AdjustAppStoreSubscription` 对象，属性如下： +Create an `AdjustAppStoreSubscription` object with the following properties: -| 参数 | 数据类型 | 描述 | -| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `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 | +| Parameter | Data type | Description | +|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | +| `transactionId` | `string` | Your ID for the transaction | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -49,26 +47,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - - - + ```cs public AdjustPlayStoreSubscription(string price, string currency, string sku, string orderId, string signature, string purchaseToken) ``` - + -创建一个 `AdjustPlayStoreSubscription` 对象，属性如下： +Create an `AdjustPlayStoreSubscription` object with the following properties: -| 参数 | 数据类型 | 描述 | -| --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | 订阅价格 | -| `currency` | `string` | 订阅使用的币种 | -| `sku` | `string` | 产品 ID | -| `orderId` | `string` | 您的交易 ID | -| `signature` | `string` | 购买数据的签名 | -| `purchaseToken` | `string` | 交易唯一识别码。请参考[Google 的文档]()，了解更多信息。 | +| Parameter | Data type | Description | +|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription | +| `sku` | `string` | The ID of the product | +| `orderId` | `string` | Your ID for the transaction | +| `signature` | `string` | The signature of the purchase data | +| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -80,24 +76,20 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。 +### Record the purchase date \{\#record\-the\-purchase\-date\} - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. + ```cs public string TransactionDate { get; set; } ``` - + -设置`AdjustAppStoreSubscription`实例的`setTransactionDate`属性来记录订阅的时间戳。 +Set the `setTransactionDate` property of your `AdjustAppStoreSubscription` instance to record the timestamp of the subscription. ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -108,17 +100,15 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.TransactionDate = transactionDate; ``` - - - + ```cs public string PurchaseTime { get; set; } ``` - + -设置`AdjustPlayStoreSubscription`实例的`PurchaseTime`属性来记录订阅的时间戳。 +Set the `PurchaseTime` property of your `AdjustPlayStoreSubscription` instance to record the timestamp of the subscription. ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -131,20 +121,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.PurchaseTime = purchaseTime; ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```cs public string SalesRegion { get; set; } ``` - + -您可以记录用户购买订阅的地区。为此，请将`AdjustPlayStoreSubscription`实例的`SalesRegion`属性设置为`string`形式的国家代码。此信息需为[`Storefront`](https://developer.apple.com/documentation/storekit/storefront)对象的[`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)。 +You can record the region in which the user purchased a subscription. To do this, set the `SalesRegion` property of your `AdjustPlayStoreSubscription` instance to the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -155,19 +144,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.SalesRegiom = salesRegion; ``` -### Add callback parameters {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} -您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `AddCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 - - - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `AddCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -179,15 +165,13 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - - - + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -202,22 +186,18 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - - - -### Add partner parameters {#add-partner-parameters} + -您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`AddPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 +### Add partner parameters \{\#add\-partner\-parameters\} - - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `AddPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -229,15 +209,13 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - - - + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -252,24 +230,21 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - - + -## 2\. Record subscription information {#2-record-subscription-information} +2\. Record subscription information \{\#record\-subscription\-information\} +--------------------------------------------------------------------------------- -设置好订阅对象后，您就可以通过 Adjust SDK 对其进行记录了。 - - - - +Once you have set up your subscription object, you can record it using the Adjust SDK. + ```cs public static void TrackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + -将订阅对象传送至 `Adjust.TrackAppStoreSubscription` 方法，以记录用户订阅购买。 +Pass your subscription object to the `Adjust.TrackAppStoreSubscription` method to record the user's subscription purchase. ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -286,17 +261,15 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackAppStoreSubscription(subscription); ``` - - - + ```cs public static void TrackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + -将订阅对象传送至 `Adjust.TrackPlayStoreSubscription` 方法，以记录用户订阅购买。 +Pass your subscription object to the `Adjust.TrackPlayStoreSubscription` method to record the user's subscription purchase. ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -315,5 +288,5 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackPlayStoreSubscription(subscription); ``` - - + + From 6381d8290ccd71916b79ce75e74efefb5ad83dfc Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 09:04:05 +0000 Subject: [PATCH 33/75] File src/content/docs/en/sdk/unity/v5/features/subscriptions.mdx was translated to ja-JP locale --- .../sdk/unity/v5/features/subscriptions.mdx | 183 ++++++++---------- 1 file changed, 78 insertions(+), 105 deletions(-) diff --git a/src/content/docs/ja/sdk/unity/v5/features/subscriptions.mdx b/src/content/docs/ja/sdk/unity/v5/features/subscriptions.mdx index 14b70922ce..4ff2831c6c 100644 --- a/src/content/docs/ja/sdk/unity/v5/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/unity/v5/features/subscriptions.mdx @@ -1,46 +1,44 @@ --- -title: サブスクリプション情報の送信 -description: Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。 -slug: ja/sdk/unity/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ja/sdk/unity/v4/features/subscriptions +title: "Send subscription information" +description: "Use these methods send subscription information to Adjust." +slug: "en/sdk/unity/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/unity/v4/features/subscriptions" --- + - +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、アプリ固有の情報を別途追加する必要があります。設定のサポートをいたしますので、[support@adjust.com](mailto:support@adjust.com)または担当のテクニカルアカウントマネージャーまでお問い合わせください。 +You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - +1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} +--------------------------------------------------------------------------------------- -App StoreおよびPlay Storeのサブスクリプションを計測し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`AdjustAppStoreSubscription`または`AdjustPlayStoreSubscription`を作成してください。 - -## 1\. Instantiate a subscription object {#1-instantiate-a-subscription-object} - -開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。 - - - - +To get started, you need to create a subscription object containing details of the subscription purchase. + ```cs public AdjustAppStoreSubscription(string price, string currency, string transactionId); ``` - + -以下のプロパティを含む`AdjustAppStoreSubscription`オブジェクトを作成します： +Create an `AdjustAppStoreSubscription` object with the following properties: -| パラメーター | データタイプ | 説明 | -| --------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `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 | +| Parameter | Data type | Description | +|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | +| `transactionId` | `string` | Your ID for the transaction | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -49,26 +47,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - - - + ```cs public AdjustPlayStoreSubscription(string price, string currency, string sku, string orderId, string signature, string purchaseToken) ``` - + -以下のプロパティを含む`AdjustPlayStoreSubscription`オブジェクトを作成します： +Create an `AdjustPlayStoreSubscription` object with the following properties: -| パラメーター | データタイプ | 説明 | -| --------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | サブスクリプションの価格 | -| `currency` | `string` | サブスクリプション通貨 | -| `sku` | `string` | プロダクトID | -| `orderId` | `string` | トランザクションID | -| `signature` | `string` | 購入データのシグネチャー | -| `purchaseToken` | `string` | トランザクションの一意のトークン。詳細は[Googleのドキュメント]()を参照してください。 | +| Parameter | Data type | Description | +|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription | +| `sku` | `string` | The ID of the product | +| `orderId` | `string` | Your ID for the transaction | +| `signature` | `string` | The signature of the purchase data | +| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -80,24 +76,20 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。 +### Record the purchase date \{\#record\-the\-purchase\-date\} - - - +You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. + ```cs public string TransactionDate { get; set; } ``` - + -`AdjustAppStoreSubscription`インスタンスの`setTransactionDate`プロパティを設定し、サブスクリプションのタイムスタンプを記録します。 +Set the `setTransactionDate` property of your `AdjustAppStoreSubscription` instance to record the timestamp of the subscription. ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -108,17 +100,15 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.TransactionDate = transactionDate; ``` - - - + ```cs public string PurchaseTime { get; set; } ``` - + -`AdjustPlayStoreSubscription`インスタンスの`PurchaseTime`プロパティを設定し、サブスクリプションのタイムスタンプを記録します。 +Set the `PurchaseTime` property of your `AdjustPlayStoreSubscription` instance to record the timestamp of the subscription. ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -131,20 +121,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.PurchaseTime = purchaseTime; ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```cs public string SalesRegion { get; set; } ``` - + -ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、 `AdjustPlayStoreSubscription`インスタンスの`SalesRegion`プロパティを`string`として国コードに設定します。これは、[`Storefront`](https://developer.apple.com/documentation/storekit/storefront)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)としてフォーマットされる必要があります。 +You can record the region in which the user purchased a subscription. To do this, set the `SalesRegion` property of your `AdjustPlayStoreSubscription` instance to the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -155,19 +144,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.SalesRegiom = salesRegion; ``` -### Add callback parameters {#add-callback-parameters} +### Add callback parameters \{\#add\-callback\-parameters\} -コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`AddCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - - - - +You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `AddCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -179,15 +165,13 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - - - + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -202,22 +186,18 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - - - -### Add partner parameters {#add-partner-parameters} + -パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`AddPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 +### Add partner parameters \{\#add\-partner\-parameters\} - - - +You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `AddPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -229,15 +209,13 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - - - + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -252,24 +230,21 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - - + -## 2\. Record subscription information {#2-record-subscription-information} +2\. Record subscription information \{\#record\-subscription\-information\} +--------------------------------------------------------------------------------- -サブスクリプションオブジェクトを設定したら、Adjust SDKを使用して記録することが可能です。 - - - - +Once you have set up your subscription object, you can record it using the Adjust SDK. + ```cs public static void TrackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + -完了したオブジェクトを `Adjust.TrackAppStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 +Pass your subscription object to the `Adjust.TrackAppStoreSubscription` method to record the user's subscription purchase. ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -286,17 +261,15 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackAppStoreSubscription(subscription); ``` - - - + ```cs public static void TrackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + -完了したオブジェクトを `Adjust.TrackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 +Pass your subscription object to the `Adjust.TrackPlayStoreSubscription` method to record the user's subscription purchase. ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -315,5 +288,5 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackPlayStoreSubscription(subscription); ``` - - + + From 373ef9d1fd186f25031be4dbd411dcb0b48af028 Mon Sep 17 00:00:00 2001 From: github-actions <41898282+github-actions[bot]@users.noreply.github.com> Date: Wed, 8 Jan 2025 09:32:43 +0000 Subject: [PATCH 34/75] Fix translated and formatted files --- .../sdk/android/v4/features/subscriptions.mdx | 118 ++++++++------ .../sdk/android/v5/features/subscriptions.mdx | 118 ++++++++------ .../sdk/cordova/v4/features/subscriptions.mdx | 141 +++++++++------- .../sdk/cordova/v5/features/subscriptions.mdx | 145 +++++++++-------- .../sdk/flutter/v4/features/subscriptions.mdx | 141 +++++++++------- .../sdk/flutter/v5/features/subscriptions.mdx | 151 ++++++++++-------- .../ja/sdk/ios/v4/features/subscriptions.mdx | 134 +++++++++------- .../ja/sdk/ios/v5/features/subscriptions.mdx | 134 +++++++++------- .../ja/sdk/testing/subscription-recording.mdx | 37 +++-- .../sdk/unity/v4/features/subscriptions.mdx | 141 +++++++++------- .../sdk/unity/v5/features/subscriptions.mdx | 141 +++++++++------- .../sdk/android/v4/features/subscriptions.mdx | 118 ++++++++------ .../sdk/android/v5/features/subscriptions.mdx | 118 ++++++++------ .../sdk/cordova/v4/features/subscriptions.mdx | 141 +++++++++------- .../sdk/cordova/v5/features/subscriptions.mdx | 145 +++++++++-------- .../sdk/flutter/v4/features/subscriptions.mdx | 141 +++++++++------- .../sdk/flutter/v5/features/subscriptions.mdx | 151 ++++++++++-------- .../ko/sdk/ios/v4/features/subscriptions.mdx | 134 +++++++++------- .../ko/sdk/ios/v5/features/subscriptions.mdx | 134 +++++++++------- .../ko/sdk/testing/subscription-recording.mdx | 37 +++-- .../sdk/unity/v4/features/subscriptions.mdx | 141 +++++++++------- .../sdk/unity/v5/features/subscriptions.mdx | 141 +++++++++------- .../sdk/android/v4/features/subscriptions.mdx | 118 ++++++++------ .../sdk/android/v5/features/subscriptions.mdx | 118 ++++++++------ .../sdk/cordova/v4/features/subscriptions.mdx | 141 +++++++++------- .../sdk/cordova/v5/features/subscriptions.mdx | 145 +++++++++-------- .../sdk/flutter/v4/features/subscriptions.mdx | 141 +++++++++------- .../sdk/flutter/v5/features/subscriptions.mdx | 151 ++++++++++-------- .../zh/sdk/ios/v4/features/subscriptions.mdx | 134 +++++++++------- .../zh/sdk/ios/v5/features/subscriptions.mdx | 134 +++++++++------- .../zh/sdk/testing/subscription-recording.mdx | 37 +++-- .../sdk/unity/v4/features/subscriptions.mdx | 141 +++++++++------- .../sdk/unity/v5/features/subscriptions.mdx | 141 +++++++++------- 33 files changed, 2370 insertions(+), 1833 deletions(-) diff --git a/src/content/docs/ja/sdk/android/v4/features/subscriptions.mdx b/src/content/docs/ja/sdk/android/v4/features/subscriptions.mdx index 00aa2c4f8c..16305b36e7 100644 --- a/src/content/docs/ja/sdk/android/v4/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/android/v4/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/android/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/android/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: ja/sdk/android/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ja/sdk/android/features/subscriptions --- - -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 - + + +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + + You can record Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, instantiate an `AdjustPlayStoreSubscription` object containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - + ```java public AdjustPlayStoreSubscription(final long price, @@ -35,12 +34,12 @@ public AdjustPlayStoreSubscription(final long price, ``` - + To get started, you need to instantiate a subscription object containing details of the subscription purchase. To do this, create a new `AdjustPlayStoreSubscription` object and pass the following arguments: -| Parameter | Data type | Description | -|-----------------|-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | `long` | The price of the subscription | | `currency` | `String` | The currency of the subscription | | `sku` | `String` | The ID of the product | @@ -48,7 +47,8 @@ To get started, you need to instantiate a subscription object containing details | `signature` | `String` | The signature of the purchase data | | `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase) for more information | - + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,7 +62,8 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -76,20 +77,23 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setPurchaseTime` method with a timestamp to record this information. - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -104,7 +108,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -119,75 +124,85 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} - + ```java public void addCallbackParameter(String key, String value) ``` - + You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - + + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} - + ```java public void addPartnerParameter(String key, String value) ``` - + You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - + + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - + + -2\. Send subscription information \{\#send\-subscription\-information\} ------------------------------------------------------------------------------ +## 2\. Send subscription information \{\#send\-subscription\-information\} - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - + Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -202,7 +217,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -217,5 +233,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ja/sdk/android/v5/features/subscriptions.mdx b/src/content/docs/ja/sdk/android/v5/features/subscriptions.mdx index c236c48736..4c5f42287c 100644 --- a/src/content/docs/ja/sdk/android/v5/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/android/v5/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/android/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/android/v4/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: ja/sdk/android/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ja/sdk/android/v4/features/subscriptions --- - -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 - + + +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + + You can record Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, instantiate an `AdjustPlayStoreSubscription` object containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - + ```java public AdjustPlayStoreSubscription(final long price, @@ -35,12 +34,12 @@ public AdjustPlayStoreSubscription(final long price, ``` - + To get started, you need to instantiate a subscription object containing details of the subscription purchase. To do this, create a new `AdjustPlayStoreSubscription` object and pass the following arguments: -| Parameter | Data type | Description | -|-----------------|-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | `long` | The price of the subscription | | `currency` | `String` | The currency of the subscription | | `sku` | `String` | The ID of the product | @@ -48,7 +47,8 @@ To get started, you need to instantiate a subscription object containing details | `signature` | `String` | The signature of the purchase data | | `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase) for more information | - + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,7 +62,8 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -76,20 +77,23 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setPurchaseTime` method with a timestamp to record this information. - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -104,7 +108,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -119,75 +124,85 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} - + ```java public void addCallbackParameter(String key, String value) ``` - + You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - + + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} - + ```java public void addPartnerParameter(String key, String value) ``` - + You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - + + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - + + -2\. Send subscription information \{\#send\-subscription\-information\} ------------------------------------------------------------------------------ +## 2\. Send subscription information \{\#send\-subscription\-information\} - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - + Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -202,7 +217,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -217,5 +233,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ja/sdk/cordova/v4/features/subscriptions.mdx b/src/content/docs/ja/sdk/cordova/v4/features/subscriptions.mdx index bc8458d58d..29a4e4ecb8 100644 --- a/src/content/docs/ja/sdk/cordova/v4/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/cordova/v4/features/subscriptions.mdx @@ -1,41 +1,42 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/cordova/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/cordova/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: ja/sdk/cordova/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ja/sdk/cordova/features/subscriptions --- - -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 - + + +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + + You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} To get started, you need to create a subscription object containing details of the subscription purchase. - + + + ```js constructor(price: string, currency: string, transactionId: string, receipt: string) ``` - + Create an `AdjustAppStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | Number | The price of the subscription | | `currency` | String | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | | `transactionId` | String | Your ID for the transaction | @@ -50,24 +51,25 @@ var subscription = new AdjustAppStoreSubscription( ); ``` - + + ```js constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + Create an `AdjustPlayStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | Number | The price of the subscription | -| `currency` | String | The currency of the subscription | -| `sku` | String | The ID of the product | -| `orderId` | String | Your ID for the transaction | -| `signature` | String | The signature of the purchase data | -| `purchaseToken` | String | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | +| Parameter | Data type | Description | +| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | Number | The price of the subscription | +| `currency` | String | The currency of the subscription | +| `sku` | String | The ID of the product | +| `orderId` | String | Your ID for the transaction | +| `signature` | String | The signature of the purchase data | +| `purchaseToken` | String | The unique token of the transaction. See [Google's documentation]() for more information | ```js var subscription = new AdjustPlayStoreSubscription( @@ -80,18 +82,21 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. - + + + ```js setTransactionDate(transactionDate: string): void ``` - + Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. @@ -106,13 +111,14 @@ var subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - + + ```js setPurchaseTime(purchaseTime: string): void ``` - + Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. @@ -128,17 +134,18 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} +### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} - + ```js setSalesRegion(salesRegion: string): void ``` - + You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. @@ -153,16 +160,18 @@ var subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -176,13 +185,14 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -198,18 +208,21 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -223,13 +236,14 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -245,19 +259,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + -2\. Record subscription information \{\#record\-subscription\-information\} ---------------------------------------------------------------------------------- +## 2\. Record subscription information \{\#record\-subscription\-information\} Once you have set up your subscription object, you can record it using the Adjust SDK. - + + + ```js trackAppStoreSubscription(subscription: AdjustAppStoreSubscription): void ``` - + Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. @@ -278,13 +294,14 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```js trackPlayStoreSubscription(subscription: AdjustPlayStoreSubscription): void ``` - + Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. @@ -306,5 +323,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ja/sdk/cordova/v5/features/subscriptions.mdx b/src/content/docs/ja/sdk/cordova/v5/features/subscriptions.mdx index 0c3da196c5..1068c4232f 100644 --- a/src/content/docs/ja/sdk/cordova/v5/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/cordova/v5/features/subscriptions.mdx @@ -1,44 +1,45 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/cordova/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/cordova/v4/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: ja/sdk/cordova/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ja/sdk/cordova/v4/features/subscriptions --- - -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 - + + +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + + You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} To get started, you need to create a subscription object containing details of the subscription purchase. - + + + ```ts constructor(price: string, currency: string, transactionId: string) ``` - + Create an `AdjustAppStoreSubscription` object with the following properties -\| Parameter \| Data type \| Description \| +\| Parameter \| Data type \| Description \| \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| -\| `price` \| `string` \| The price of the subscription \| -\| `currency` \| `string` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| -\| `transactionId` \| `string` \| Your ID for the transaction \| \| +\| `price` \| `string` \| The price of the subscription \| +\| `currency` \| `string` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| +\| `transactionId` \| `string` \| Your ID for the transaction \| \| ```js var subscription = new AdjustAppStoreSubscription( @@ -49,24 +50,25 @@ var subscription = new AdjustAppStoreSubscription( Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + Create an `AdjustPlayStoreSubscription` object with the following properties -| Parameter | Data type | Description | -|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription | -| `sku` | `string` | The ID of the product | -| `orderId` | `string` | Your ID for the transaction | -| `signature` | `string` | The signature of the purchase data | -| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | +| Parameter | Data type | Description | +| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription | +| `sku` | `string` | The ID of the product | +| `orderId` | `string` | Your ID for the transaction | +| `signature` | `string` | The signature of the purchase data | +| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation]() for more information | ```js var subscription = new AdjustPlayStoreSubscription( @@ -79,18 +81,21 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. - + + + ```ts setTransactionDate(transactionDate: string): void ``` - + Call the `setTransactionDate` method method on your subscription object to record the timestamp of the subscription. @@ -105,13 +110,14 @@ subscription.setTransactionDate(transactionDate); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts setPurchaseTime(purchaseTime: string): void ``` - + Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. @@ -127,17 +133,18 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} +### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} - + ```ts setSalesRegion(salesRegion: string): void ``` - + You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. @@ -152,16 +159,18 @@ subscription.setSalesRegion(salesRegion); Adjust.trackPlayStoreSubscription(subscription); ``` -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -178,13 +187,14 @@ subscription.addCallbackParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -200,18 +210,21 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -228,13 +241,14 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -250,19 +264,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + -2\. Record subscription information \{\#record\-subscription\-information\} ---------------------------------------------------------------------------------- +## 2\. Record subscription information \{\#record\-subscription\-information\} Once you have set up your subscription object, you can record it using the Adjust SDK. - + + + ```ts trackAppStoreSubscription(adjustAppStoreSubscription: AdjustAppStoreSubscription): void ``` - + Pass your subscription object to the `trackAppStoreSubscription` method method to record the user's subscription purchase. @@ -278,13 +294,14 @@ subscription.setSalesRegion(salesRegion); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts trackPlayStoreSubscription(adjustPlayStoreSubscription: AdjustPlayStoreSubscription): void ``` - + Pass your subscription object to the `trackPlayStoreSubscription` method method to record the user's subscription purchase. @@ -302,5 +319,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ja/sdk/flutter/v4/features/subscriptions.mdx b/src/content/docs/ja/sdk/flutter/v4/features/subscriptions.mdx index 5066d6dcf9..3f8ea502ee 100644 --- a/src/content/docs/ja/sdk/flutter/v4/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/flutter/v4/features/subscriptions.mdx @@ -1,41 +1,42 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/flutter/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/flutter/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: ja/sdk/flutter/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ja/sdk/flutter/features/subscriptions --- - -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 - + + +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + + You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} To get started, you need to create a subscription object containing details of the subscription purchase. - + + + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId, String _receipt) ``` - + Create an `AdjustAppStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | `String` | The price of the subscription | | `currency` | `String` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | | `transactionId` | `String` | Your ID for the transaction | @@ -49,24 +50,25 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - + + ```dart AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken) ``` - + Create an `AdjustPlayStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `String` | The price of the subscription | -| `currency` | `String` | The currency of the subscription | -| `sku` | `String` | The ID of the product | -| `orderId` | `String` | Your ID for the transaction | -| `signature` | `String` | The signature of the purchase data | -| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | +| Parameter | Data type | Description | +| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `String` | The price of the subscription | +| `currency` | `String` | The currency of the subscription | +| `sku` | `String` | The ID of the product | +| `orderId` | `String` | Your ID for the transaction | +| `signature` | `String` | The signature of the purchase data | +| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation]() for more information | ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -78,18 +80,21 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. - + + + ```dart void setTransactionDate(String _transactionDate) ``` - + Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. @@ -103,13 +108,14 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - + + ```dart void setPurchaseTime(String purchaseTime) ``` - + Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. @@ -124,17 +130,18 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} +### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} - + ```dart void setSalesRegion(String _salesRegion) ``` - + You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `String`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. @@ -148,16 +155,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -170,13 +179,14 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -191,18 +201,21 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -215,13 +228,14 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - + + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -236,19 +250,21 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - + + -2\. Record subscription information \{\#record\-subscription\-information\} ---------------------------------------------------------------------------------- +## 2\. Record subscription information \{\#record\-subscription\-information\} Once you have set up your subscription object, you can record it using the Adjust SDK. - + + + ```dart static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription) ``` - + Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. @@ -268,13 +284,14 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. @@ -295,5 +312,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ja/sdk/flutter/v5/features/subscriptions.mdx b/src/content/docs/ja/sdk/flutter/v5/features/subscriptions.mdx index dfaa87aa8c..d7ac0c88f2 100644 --- a/src/content/docs/ja/sdk/flutter/v5/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/flutter/v5/features/subscriptions.mdx @@ -1,44 +1,45 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to 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" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: ja/sdk/flutter/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ja/sdk/flutter/v4/features/subscriptions --- - -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 - + + +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + + You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} To get started, you need to create a subscription object containing details of the subscription purchase. - + + + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId) ``` - + Create an `AdjustAppStoreSubscription` object with the following properties: -\| Parameter \| Data type \| Description \| +\| Parameter \| Data type \| Description \| \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| -\| `price` \| `String` \| The price of the subscription \| -\| `currency` \| `String` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| -\| `transactionId` \| `String` \| Your ID for the transaction \| \| +\| `price` \| `String` \| The price of the subscription \| +\| `currency` \| `String` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| +\| `transactionId` \| `String` \| Your ID for the transaction \| \| ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -47,24 +48,25 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - + + ```dart AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken) ``` - + Create an `AdjustPlayStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `String` | The price of the subscription | -| `currency` | `String` | The currency of the subscription | -| `sku` | `String` | The ID of the product | -| `orderId` | `String` | Your ID for the transaction | -| `signature` | `String` | The signature of the purchase data | -| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | +| Parameter | Data type | Description | +| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `String` | The price of the subscription | +| `currency` | `String` | The currency of the subscription | +| `sku` | `String` | The ID of the product | +| `orderId` | `String` | Your ID for the transaction | +| `signature` | `String` | The signature of the purchase data | +| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation]() for more information | ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -76,21 +78,25 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. - + + + Add the `transactionDate` property in the `AdjustAppStoreSubscription` class. - + + ```dart String? transactionDate ``` - + Set a timestamp to the `transactionDate` property of your `subscription` instance to record the date on which the user purchased a subscription. @@ -103,16 +109,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.transactionDate = 'transactionDate'; ``` - + + Add the `purchaseTime` property in the `AdjustPlayStoreSubscription` class. - + + ```dart String? purchaseTime; ``` - + Set a timestamp to the `purchaseTime` property of your `subscription` instance to record the date on which the user purchased a subscription. @@ -127,17 +135,18 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.purchaseTime = 'purchase-time'; ``` - + + -### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} +### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} - + ```dart String? salesRegion ``` - + You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `String`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. @@ -150,16 +159,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.salesRegion = 'sales-region'; ``` -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -171,13 +182,14 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -192,18 +204,21 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -215,13 +230,14 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - + + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -236,19 +252,21 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - + + -2\. Record subscription information \{\#record\-subscription\-information\} ---------------------------------------------------------------------------------- +## 2\. Record subscription information \{\#record\-subscription\-information\} Once you have set up your subscription object, you can record it using the Adjust SDK. - + + + ```dart static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription) ``` - + Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. @@ -267,13 +285,14 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. @@ -294,5 +313,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ja/sdk/ios/v4/features/subscriptions.mdx b/src/content/docs/ja/sdk/ios/v4/features/subscriptions.mdx index 006f9edc59..b638f26e09 100644 --- a/src/content/docs/ja/sdk/ios/v4/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/ios/v4/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/ios/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/ios/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: ja/sdk/ios/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ja/sdk/ios/features/subscriptions --- - -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 - + + +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + + You can record App Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `ADJSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -32,18 +31,19 @@ You can record App Store subscriptions and verify their validity with the Adjust ``` - + To get started, you need to create a subscription object containing details of the subscription purchase. To do this, initialize an `ADJSubscription` object using the `initWithPrice` method. Pass the following arguments: -| Parameter | Data type | Description | -|-----------------|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | `NSDecimalNumber` | The price of the subscription | | `currency` | `NSString` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | | `transactionId` | `NSString` | Your ID for the transaction | | `receipt` | `NSString` | The receipt information | - + + ```swift let subscription = ADJSubscription( @@ -52,7 +52,8 @@ let subscription = ADJSubscription( transactionId: transactionId) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -60,20 +61,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price transactionId:transactionId]; ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - + You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setTransactionDate` method with a timestamp to record this information. - + + + ```swift let subscription = ADJSubscription( @@ -84,7 +88,8 @@ let subscription = ADJSubscription( subscription.setTransactionDate(transactionDate) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -94,20 +99,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setTransactionDate:transactionDate]; ``` - + + -### Record the purchase region \{\#record\-the\-purchase\-region\} +### Record the purchase region {#record-the-purchase-region} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - + You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as an `NSString`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. - + + + ```swift let subscription = ADJSubscription( @@ -118,7 +126,8 @@ let subscription = ADJSubscription( subscription.setSalesRegion(salesRegion) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -128,20 +137,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setSalesRegion:salesRegion]; ``` - + + -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```swift let subscription = ADJSubscription( @@ -153,7 +165,8 @@ subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -164,20 +177,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```swift let subscription = ADJSubscription( @@ -189,7 +205,8 @@ subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -200,21 +217,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - + + -2\. Send subscription information \{\#send\-subscription\-information\} ------------------------------------------------------------------------------ +## 2\. Send subscription information \{\#send\-subscription\-information\} - + ```objc + (void)trackSubscription:(nonnull ADJSubscription *)subscription; ``` - + Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackSubscription` method to record the user's subscription purchase. - + + + ```swift let subscription = ADJSubscription( @@ -238,7 +257,8 @@ subscription.addCallbackParameter("key2", value: "value2") Adjust.trackSubscription(subscription) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -258,5 +278,5 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [Adjust trackSubscription:subscription]; ``` - - + + diff --git a/src/content/docs/ja/sdk/ios/v5/features/subscriptions.mdx b/src/content/docs/ja/sdk/ios/v5/features/subscriptions.mdx index 79ef387a0f..2534aaa25a 100644 --- a/src/content/docs/ja/sdk/ios/v5/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/ios/v5/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/ios/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/ios/v4/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: ja/sdk/ios/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ja/sdk/ios/v4/features/subscriptions --- - -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 - + + +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + + You can record App Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `ADJAppStoreSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -31,17 +30,18 @@ You can record App Store subscriptions and verify their validity with the Adjust transactionId:(nonnull NSString *)transactionId; ``` - + To get started, you need to create a subscription object containing details of the subscription purchase. To do this, initialize an `ADJAppStoreSubscription` object using the `initWithPrice` method. Pass the following arguments: -| Parameter | Data type | Description | -|-----------------|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | `NSDecimalNumber` | The price of the subscription | | `currency` | `NSString` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | | `transactionId` | `NSString` | Your ID for the transaction | - + + ```swift let subscription = ADJAppStoreSubscription( @@ -50,7 +50,8 @@ let subscription = ADJAppStoreSubscription( transactionId: transactionId ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -58,20 +59,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit transactionId:transactionId]; ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - + You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setTransactionDate` method with a timestamp to record this information. - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -82,7 +86,8 @@ guard let subscription = ADJAppStoreSubscription( subscription.setTransactionDate(transactionDate) ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -92,20 +97,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setTransactionDate:transactionDate]; ``` - + + -### Record the purchase region \{\#record\-the\-purchase\-region\} +### Record the purchase region {#record-the-purchase-region} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - + You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as an `NSString`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -116,7 +124,8 @@ guard let subscription = ADJAppStoreSubscription( subscription.setSalesRegion(salesRegion) ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -126,20 +135,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setSalesRegion:salesRegion]; ``` - + + -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -151,7 +163,8 @@ subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -162,20 +175,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -187,7 +203,8 @@ subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -198,21 +215,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - + + -2\. Send subscription information \{\#send\-subscription\-information\} ------------------------------------------------------------------------------ +## 2\. Send subscription information \{\#send\-subscription\-information\} - + ```objc + (void)trackAppStoreSubscription:(nonnull ADJAppStoreSubscription *)subscription; ``` - + Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackAppStoreSubscription` method to record the user's subscription purchase. - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -234,7 +253,8 @@ subscription.addCallbackParameter("key2", value: "value2") Adjust.trackAppStoreSubscription(subscription) ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -254,5 +274,5 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [Adjust trackAppStoreSubscription:subscription]; ``` - - + + diff --git a/src/content/docs/ja/sdk/testing/subscription-recording.mdx b/src/content/docs/ja/sdk/testing/subscription-recording.mdx index 1c24f44917..121e550c89 100644 --- a/src/content/docs/ja/sdk/testing/subscription-recording.mdx +++ b/src/content/docs/ja/sdk/testing/subscription-recording.mdx @@ -1,21 +1,24 @@ --- -title: "Test subscription recording" -description: "Test that the Adjust SDK is sending subscription information to Adjust" -slug: "en/sdk/testing/subscription-recording" -sidebar-label: "Subscription recording" +title: Test subscription recording +description: Test that the Adjust SDK is sending subscription information to Adjust +slug: ja/sdk/testing/subscription-recording +sidebar-label: Subscription recording sidebar-position: 3 --- + You can use the Adjust SDK to record information about subscription purchases in your app. - + + Make sure to set your SDK environment to **Production** after you finish testing. This ensures your app works in production mode. - + + Use these tools to test the SDK: -* The Adjust testing console, available in [AppView](https://help.adjust.com/en/article/testing-console). -* The [Adjust Device API](/en/api/device-api/inspect). -* Your IDE's log output. +- The Adjust testing console, available in [AppView](https://help.adjust.com/ja/article/testing-console). +- The [Adjust Device API](/ja/api/device-api/inspect). +- Your IDE's log output. To test that this is working: @@ -23,10 +26,11 @@ To test that this is working: 2. Set the environment to **sandbox** . This ensures that your app only sends information to the testing console. 3. Set your log level to **verbose** to capture all logging information from your app. 4. Set up a test device or an emulated device and find the device's advertising ID. You can install the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808) to find this information. -5. If you've previously used the device for testing: +5. If you've previously used the device for testing: + 1. Delete your app from the test device. - 2. Clear the device's advertising ID from the testing console. Follow the instructions for the [Testing console in AppView](https://help.adjust.com/en/article/testing-console#forget-device). - 3. Alternatively, call the [forget device endpoint](/en/api/device-api/forget/) to remove existing information about the device. + 2. Clear the device's advertising ID from the testing console. Follow the instructions for the [Testing console in AppView](https://help.adjust.com/ja/article/testing-console#forget-device). + 3. Alternatively, call the [forget device endpoint](/ja/api/device-api/forget/) to remove existing information about the device. 6. Download and open the test version of your app that contains the Adjust SDK. 7. Trigger a test purchase. @@ -34,10 +38,9 @@ To test that this is working: If the subscription is recorded successfully, the following fields are populated in the console output: -* **Last Subscription Event Type** -* [**Last Subscription Event Subtype**](https://help.adjust.com/en/article/manage-subscription-data#subscription-event-subtypes) -* **Last Subscription Event Timestamp** -* **Product ID** +- **Last Subscription Event Type** +- [**Last Subscription Event Subtype**](https://help.adjust.com/ja/article/manage-subscription-data#subscription-event-subtypes) +- **Last Subscription Event Timestamp** +- **Product ID** ![The Adjust testing console](@images/sdk-testing/subscription/testing-console.png) - diff --git a/src/content/docs/ja/sdk/unity/v4/features/subscriptions.mdx b/src/content/docs/ja/sdk/unity/v4/features/subscriptions.mdx index 3e08500877..7de755d983 100644 --- a/src/content/docs/ja/sdk/unity/v4/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/unity/v4/features/subscriptions.mdx @@ -1,41 +1,42 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/unity/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/unity/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: ja/sdk/unity/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ja/sdk/unity/features/subscriptions --- - -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 - + + +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + + You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} To get started, you need to create a subscription object containing details of the subscription purchase. - + + + ```cs public AdjustAppStoreSubscription(string price, string currency, string transactionId, string receipt) ``` - + Create an `AdjustAppStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | `string` | The price of the subscription | | `currency` | `string` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | | `transactionId` | `string` | Your ID for the transaction | @@ -49,24 +50,25 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - + + ```cs public AdjustPlayStoreSubscription(string price, string currency, string sku, string orderId, string signature, string purchaseToken) ``` - + Create an `AdjustPlayStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription | -| `sku` | `string` | The ID of the product | -| `orderId` | `string` | Your ID for the transaction | -| `signature` | `string` | The signature of the purchase data | -| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | +| Parameter | Data type | Description | +| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription | +| `sku` | `string` | The ID of the product | +| `orderId` | `string` | Your ID for the transaction | +| `signature` | `string` | The signature of the purchase data | +| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation]() for more information | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -78,18 +80,21 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. - + + + ```cs public void setTransactionDate(string transactionDate); ``` - + Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. @@ -103,13 +108,14 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - + + ```cs public void setPurchaseTime(string purchaseTime); ``` - + Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. @@ -124,17 +130,18 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} +### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} - + ```cs public void setSalesRegion(string salesRegion); ``` - + You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. @@ -148,16 +155,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -170,13 +179,14 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -191,18 +201,21 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -215,13 +228,14 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -236,19 +250,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + -2\. Record subscription information \{\#record\-subscription\-information\} ---------------------------------------------------------------------------------- +## 2\. Record subscription information \{\#record\-subscription\-information\} Once you have set up your subscription object, you can record it using the Adjust SDK. - + + + ```cs public static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. @@ -268,13 +284,14 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```cs public static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. @@ -295,5 +312,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ja/sdk/unity/v5/features/subscriptions.mdx b/src/content/docs/ja/sdk/unity/v5/features/subscriptions.mdx index 4ff2831c6c..0747b96abe 100644 --- a/src/content/docs/ja/sdk/unity/v5/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/unity/v5/features/subscriptions.mdx @@ -1,41 +1,42 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/unity/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/unity/v4/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: ja/sdk/unity/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ja/sdk/unity/v4/features/subscriptions --- - -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 - + + +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + + You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} To get started, you need to create a subscription object containing details of the subscription purchase. - + + + ```cs public AdjustAppStoreSubscription(string price, string currency, string transactionId); ``` - + Create an `AdjustAppStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | `string` | The price of the subscription | | `currency` | `string` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | | `transactionId` | `string` | Your ID for the transaction | @@ -47,24 +48,25 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - + + ```cs public AdjustPlayStoreSubscription(string price, string currency, string sku, string orderId, string signature, string purchaseToken) ``` - + Create an `AdjustPlayStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription | -| `sku` | `string` | The ID of the product | -| `orderId` | `string` | Your ID for the transaction | -| `signature` | `string` | The signature of the purchase data | -| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | +| Parameter | Data type | Description | +| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription | +| `sku` | `string` | The ID of the product | +| `orderId` | `string` | Your ID for the transaction | +| `signature` | `string` | The signature of the purchase data | +| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation]() for more information | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -76,18 +78,21 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. - + + + ```cs public string TransactionDate { get; set; } ``` - + Set the `setTransactionDate` property of your `AdjustAppStoreSubscription` instance to record the timestamp of the subscription. @@ -100,13 +105,14 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.TransactionDate = transactionDate; ``` - + + ```cs public string PurchaseTime { get; set; } ``` - + Set the `PurchaseTime` property of your `AdjustPlayStoreSubscription` instance to record the timestamp of the subscription. @@ -121,17 +127,18 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.PurchaseTime = purchaseTime; ``` - + + -### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} +### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} - + ```cs public string SalesRegion { get; set; } ``` - + You can record the region in which the user purchased a subscription. To do this, set the `SalesRegion` property of your `AdjustPlayStoreSubscription` instance to the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. @@ -144,16 +151,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.SalesRegiom = salesRegion; ``` -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `AddCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -165,13 +174,14 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - + + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -186,18 +196,21 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `AddPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -209,13 +222,14 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - + + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -230,19 +244,21 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - + + -2\. Record subscription information \{\#record\-subscription\-information\} ---------------------------------------------------------------------------------- +## 2\. Record subscription information \{\#record\-subscription\-information\} Once you have set up your subscription object, you can record it using the Adjust SDK. - + + + ```cs public static void TrackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + Pass your subscription object to the `Adjust.TrackAppStoreSubscription` method to record the user's subscription purchase. @@ -261,13 +277,14 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackAppStoreSubscription(subscription); ``` - + + ```cs public static void TrackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + Pass your subscription object to the `Adjust.TrackPlayStoreSubscription` method to record the user's subscription purchase. @@ -288,5 +305,5 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ko/sdk/android/v4/features/subscriptions.mdx b/src/content/docs/ko/sdk/android/v4/features/subscriptions.mdx index 2f517ee1b3..77911c7819 100644 --- a/src/content/docs/ko/sdk/android/v4/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/android/v4/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/android/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/android/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: ko/sdk/android/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ko/sdk/android/features/subscriptions --- - -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. - + + +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + + You can record Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, instantiate an `AdjustPlayStoreSubscription` object containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - + ```java public AdjustPlayStoreSubscription(final long price, @@ -35,12 +34,12 @@ public AdjustPlayStoreSubscription(final long price, ``` - + To get started, you need to instantiate a subscription object containing details of the subscription purchase. To do this, create a new `AdjustPlayStoreSubscription` object and pass the following arguments: -| Parameter | Data type | Description | -|-----------------|-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | `long` | The price of the subscription | | `currency` | `String` | The currency of the subscription | | `sku` | `String` | The ID of the product | @@ -48,7 +47,8 @@ To get started, you need to instantiate a subscription object containing details | `signature` | `String` | The signature of the purchase data | | `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase) for more information | - + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,7 +62,8 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -76,20 +77,23 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setPurchaseTime` method with a timestamp to record this information. - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -104,7 +108,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -119,75 +124,85 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} - + ```java public void addCallbackParameter(String key, String value) ``` - + You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - + + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} - + ```java public void addPartnerParameter(String key, String value) ``` - + You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - + + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - + + -2\. Send subscription information \{\#send\-subscription\-information\} ------------------------------------------------------------------------------ +## 2\. Send subscription information \{\#send\-subscription\-information\} - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - + Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -202,7 +217,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -217,5 +233,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ko/sdk/android/v5/features/subscriptions.mdx b/src/content/docs/ko/sdk/android/v5/features/subscriptions.mdx index 004069a5a2..52649747cc 100644 --- a/src/content/docs/ko/sdk/android/v5/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/android/v5/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/android/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/android/v4/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: ko/sdk/android/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ko/sdk/android/v4/features/subscriptions --- - -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. - + + +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + + You can record Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, instantiate an `AdjustPlayStoreSubscription` object containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - + ```java public AdjustPlayStoreSubscription(final long price, @@ -35,12 +34,12 @@ public AdjustPlayStoreSubscription(final long price, ``` - + To get started, you need to instantiate a subscription object containing details of the subscription purchase. To do this, create a new `AdjustPlayStoreSubscription` object and pass the following arguments: -| Parameter | Data type | Description | -|-----------------|-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | `long` | The price of the subscription | | `currency` | `String` | The currency of the subscription | | `sku` | `String` | The ID of the product | @@ -48,7 +47,8 @@ To get started, you need to instantiate a subscription object containing details | `signature` | `String` | The signature of the purchase data | | `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase) for more information | - + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,7 +62,8 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -76,20 +77,23 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setPurchaseTime` method with a timestamp to record this information. - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -104,7 +108,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -119,75 +124,85 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} - + ```java public void addCallbackParameter(String key, String value) ``` - + You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - + + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} - + ```java public void addPartnerParameter(String key, String value) ``` - + You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - + + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - + + -2\. Send subscription information \{\#send\-subscription\-information\} ------------------------------------------------------------------------------ +## 2\. Send subscription information \{\#send\-subscription\-information\} - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - + Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -202,7 +217,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -217,5 +233,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ko/sdk/cordova/v4/features/subscriptions.mdx b/src/content/docs/ko/sdk/cordova/v4/features/subscriptions.mdx index 53cee9ede4..098e3ea42d 100644 --- a/src/content/docs/ko/sdk/cordova/v4/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/cordova/v4/features/subscriptions.mdx @@ -1,41 +1,42 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/cordova/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/cordova/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: ko/sdk/cordova/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ko/sdk/cordova/features/subscriptions --- - -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. - + + +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + + You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} To get started, you need to create a subscription object containing details of the subscription purchase. - + + + ```js constructor(price: string, currency: string, transactionId: string, receipt: string) ``` - + Create an `AdjustAppStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | Number | The price of the subscription | | `currency` | String | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | | `transactionId` | String | Your ID for the transaction | @@ -50,24 +51,25 @@ var subscription = new AdjustAppStoreSubscription( ); ``` - + + ```js constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + Create an `AdjustPlayStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | Number | The price of the subscription | -| `currency` | String | The currency of the subscription | -| `sku` | String | The ID of the product | -| `orderId` | String | Your ID for the transaction | -| `signature` | String | The signature of the purchase data | -| `purchaseToken` | String | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | +| Parameter | Data type | Description | +| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | Number | The price of the subscription | +| `currency` | String | The currency of the subscription | +| `sku` | String | The ID of the product | +| `orderId` | String | Your ID for the transaction | +| `signature` | String | The signature of the purchase data | +| `purchaseToken` | String | The unique token of the transaction. See [Google's documentation]() for more information | ```js var subscription = new AdjustPlayStoreSubscription( @@ -80,18 +82,21 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. - + + + ```js setTransactionDate(transactionDate: string): void ``` - + Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. @@ -106,13 +111,14 @@ var subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - + + ```js setPurchaseTime(purchaseTime: string): void ``` - + Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. @@ -128,17 +134,18 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} +### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} - + ```js setSalesRegion(salesRegion: string): void ``` - + You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. @@ -153,16 +160,18 @@ var subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -176,13 +185,14 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -198,18 +208,21 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -223,13 +236,14 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -245,19 +259,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + -2\. Record subscription information \{\#record\-subscription\-information\} ---------------------------------------------------------------------------------- +## 2\. Record subscription information \{\#record\-subscription\-information\} Once you have set up your subscription object, you can record it using the Adjust SDK. - + + + ```js trackAppStoreSubscription(subscription: AdjustAppStoreSubscription): void ``` - + Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. @@ -278,13 +294,14 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```js trackPlayStoreSubscription(subscription: AdjustPlayStoreSubscription): void ``` - + Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. @@ -306,5 +323,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ko/sdk/cordova/v5/features/subscriptions.mdx b/src/content/docs/ko/sdk/cordova/v5/features/subscriptions.mdx index e6ccfabbd5..8d53e319de 100644 --- a/src/content/docs/ko/sdk/cordova/v5/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/cordova/v5/features/subscriptions.mdx @@ -1,44 +1,45 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/cordova/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/cordova/v4/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: ko/sdk/cordova/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ko/sdk/cordova/v4/features/subscriptions --- - -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. - + + +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + + You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} To get started, you need to create a subscription object containing details of the subscription purchase. - + + + ```ts constructor(price: string, currency: string, transactionId: string) ``` - + Create an `AdjustAppStoreSubscription` object with the following properties -\| Parameter \| Data type \| Description \| +\| Parameter \| Data type \| Description \| \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| -\| `price` \| `string` \| The price of the subscription \| -\| `currency` \| `string` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| -\| `transactionId` \| `string` \| Your ID for the transaction \| \| +\| `price` \| `string` \| The price of the subscription \| +\| `currency` \| `string` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| +\| `transactionId` \| `string` \| Your ID for the transaction \| \| ```js var subscription = new AdjustAppStoreSubscription( @@ -49,24 +50,25 @@ var subscription = new AdjustAppStoreSubscription( Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + Create an `AdjustPlayStoreSubscription` object with the following properties -| Parameter | Data type | Description | -|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription | -| `sku` | `string` | The ID of the product | -| `orderId` | `string` | Your ID for the transaction | -| `signature` | `string` | The signature of the purchase data | -| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | +| Parameter | Data type | Description | +| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription | +| `sku` | `string` | The ID of the product | +| `orderId` | `string` | Your ID for the transaction | +| `signature` | `string` | The signature of the purchase data | +| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation]() for more information | ```js var subscription = new AdjustPlayStoreSubscription( @@ -79,18 +81,21 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. - + + + ```ts setTransactionDate(transactionDate: string): void ``` - + Call the `setTransactionDate` method method on your subscription object to record the timestamp of the subscription. @@ -105,13 +110,14 @@ subscription.setTransactionDate(transactionDate); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts setPurchaseTime(purchaseTime: string): void ``` - + Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. @@ -127,17 +133,18 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} +### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} - + ```ts setSalesRegion(salesRegion: string): void ``` - + You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. @@ -152,16 +159,18 @@ subscription.setSalesRegion(salesRegion); Adjust.trackPlayStoreSubscription(subscription); ``` -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -178,13 +187,14 @@ subscription.addCallbackParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -200,18 +210,21 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -228,13 +241,14 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -250,19 +264,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + -2\. Record subscription information \{\#record\-subscription\-information\} ---------------------------------------------------------------------------------- +## 2\. Record subscription information \{\#record\-subscription\-information\} Once you have set up your subscription object, you can record it using the Adjust SDK. - + + + ```ts trackAppStoreSubscription(adjustAppStoreSubscription: AdjustAppStoreSubscription): void ``` - + Pass your subscription object to the `trackAppStoreSubscription` method method to record the user's subscription purchase. @@ -278,13 +294,14 @@ subscription.setSalesRegion(salesRegion); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts trackPlayStoreSubscription(adjustPlayStoreSubscription: AdjustPlayStoreSubscription): void ``` - + Pass your subscription object to the `trackPlayStoreSubscription` method method to record the user's subscription purchase. @@ -302,5 +319,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ko/sdk/flutter/v4/features/subscriptions.mdx b/src/content/docs/ko/sdk/flutter/v4/features/subscriptions.mdx index 7b37fc8973..ae12dac97f 100644 --- a/src/content/docs/ko/sdk/flutter/v4/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/flutter/v4/features/subscriptions.mdx @@ -1,41 +1,42 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/flutter/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/flutter/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: ko/sdk/flutter/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ko/sdk/flutter/features/subscriptions --- - -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. - + + +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + + You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} To get started, you need to create a subscription object containing details of the subscription purchase. - + + + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId, String _receipt) ``` - + Create an `AdjustAppStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | `String` | The price of the subscription | | `currency` | `String` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | | `transactionId` | `String` | Your ID for the transaction | @@ -49,24 +50,25 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - + + ```dart AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken) ``` - + Create an `AdjustPlayStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `String` | The price of the subscription | -| `currency` | `String` | The currency of the subscription | -| `sku` | `String` | The ID of the product | -| `orderId` | `String` | Your ID for the transaction | -| `signature` | `String` | The signature of the purchase data | -| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | +| Parameter | Data type | Description | +| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `String` | The price of the subscription | +| `currency` | `String` | The currency of the subscription | +| `sku` | `String` | The ID of the product | +| `orderId` | `String` | Your ID for the transaction | +| `signature` | `String` | The signature of the purchase data | +| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation]() for more information | ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -78,18 +80,21 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. - + + + ```dart void setTransactionDate(String _transactionDate) ``` - + Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. @@ -103,13 +108,14 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - + + ```dart void setPurchaseTime(String purchaseTime) ``` - + Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. @@ -124,17 +130,18 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} +### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} - + ```dart void setSalesRegion(String _salesRegion) ``` - + You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `String`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. @@ -148,16 +155,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -170,13 +179,14 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -191,18 +201,21 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -215,13 +228,14 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - + + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -236,19 +250,21 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - + + -2\. Record subscription information \{\#record\-subscription\-information\} ---------------------------------------------------------------------------------- +## 2\. Record subscription information \{\#record\-subscription\-information\} Once you have set up your subscription object, you can record it using the Adjust SDK. - + + + ```dart static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription) ``` - + Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. @@ -268,13 +284,14 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. @@ -295,5 +312,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ko/sdk/flutter/v5/features/subscriptions.mdx b/src/content/docs/ko/sdk/flutter/v5/features/subscriptions.mdx index aadd558d2d..ca6ac36cf4 100644 --- a/src/content/docs/ko/sdk/flutter/v5/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/flutter/v5/features/subscriptions.mdx @@ -1,44 +1,45 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to 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" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: ko/sdk/flutter/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ko/sdk/flutter/v4/features/subscriptions --- - -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. - + + +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + + You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} To get started, you need to create a subscription object containing details of the subscription purchase. - + + + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId) ``` - + Create an `AdjustAppStoreSubscription` object with the following properties: -\| Parameter \| Data type \| Description \| +\| Parameter \| Data type \| Description \| \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| -\| `price` \| `String` \| The price of the subscription \| -\| `currency` \| `String` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| -\| `transactionId` \| `String` \| Your ID for the transaction \| \| +\| `price` \| `String` \| The price of the subscription \| +\| `currency` \| `String` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| +\| `transactionId` \| `String` \| Your ID for the transaction \| \| ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -47,24 +48,25 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - + + ```dart AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken) ``` - + Create an `AdjustPlayStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `String` | The price of the subscription | -| `currency` | `String` | The currency of the subscription | -| `sku` | `String` | The ID of the product | -| `orderId` | `String` | Your ID for the transaction | -| `signature` | `String` | The signature of the purchase data | -| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | +| Parameter | Data type | Description | +| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `String` | The price of the subscription | +| `currency` | `String` | The currency of the subscription | +| `sku` | `String` | The ID of the product | +| `orderId` | `String` | Your ID for the transaction | +| `signature` | `String` | The signature of the purchase data | +| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation]() for more information | ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -76,21 +78,25 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. - + + + Add the `transactionDate` property in the `AdjustAppStoreSubscription` class. - + + ```dart String? transactionDate ``` - + Set a timestamp to the `transactionDate` property of your `subscription` instance to record the date on which the user purchased a subscription. @@ -103,16 +109,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.transactionDate = 'transactionDate'; ``` - + + Add the `purchaseTime` property in the `AdjustPlayStoreSubscription` class. - + + ```dart String? purchaseTime; ``` - + Set a timestamp to the `purchaseTime` property of your `subscription` instance to record the date on which the user purchased a subscription. @@ -127,17 +135,18 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.purchaseTime = 'purchase-time'; ``` - + + -### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} +### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} - + ```dart String? salesRegion ``` - + You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `String`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. @@ -150,16 +159,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.salesRegion = 'sales-region'; ``` -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -171,13 +182,14 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -192,18 +204,21 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -215,13 +230,14 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - + + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -236,19 +252,21 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - + + -2\. Record subscription information \{\#record\-subscription\-information\} ---------------------------------------------------------------------------------- +## 2\. Record subscription information \{\#record\-subscription\-information\} Once you have set up your subscription object, you can record it using the Adjust SDK. - + + + ```dart static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription) ``` - + Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. @@ -267,13 +285,14 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. @@ -294,5 +313,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ko/sdk/ios/v4/features/subscriptions.mdx b/src/content/docs/ko/sdk/ios/v4/features/subscriptions.mdx index 1090cc3938..177f7f2394 100644 --- a/src/content/docs/ko/sdk/ios/v4/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/ios/v4/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/ios/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/ios/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: ko/sdk/ios/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ko/sdk/ios/features/subscriptions --- - -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. - + + +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + + You can record App Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `ADJSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -32,18 +31,19 @@ You can record App Store subscriptions and verify their validity with the Adjust ``` - + To get started, you need to create a subscription object containing details of the subscription purchase. To do this, initialize an `ADJSubscription` object using the `initWithPrice` method. Pass the following arguments: -| Parameter | Data type | Description | -|-----------------|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | `NSDecimalNumber` | The price of the subscription | | `currency` | `NSString` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | | `transactionId` | `NSString` | Your ID for the transaction | | `receipt` | `NSString` | The receipt information | - + + ```swift let subscription = ADJSubscription( @@ -52,7 +52,8 @@ let subscription = ADJSubscription( transactionId: transactionId) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -60,20 +61,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price transactionId:transactionId]; ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - + You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setTransactionDate` method with a timestamp to record this information. - + + + ```swift let subscription = ADJSubscription( @@ -84,7 +88,8 @@ let subscription = ADJSubscription( subscription.setTransactionDate(transactionDate) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -94,20 +99,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setTransactionDate:transactionDate]; ``` - + + -### Record the purchase region \{\#record\-the\-purchase\-region\} +### Record the purchase region {#record-the-purchase-region} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - + You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as an `NSString`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. - + + + ```swift let subscription = ADJSubscription( @@ -118,7 +126,8 @@ let subscription = ADJSubscription( subscription.setSalesRegion(salesRegion) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -128,20 +137,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setSalesRegion:salesRegion]; ``` - + + -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```swift let subscription = ADJSubscription( @@ -153,7 +165,8 @@ subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -164,20 +177,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```swift let subscription = ADJSubscription( @@ -189,7 +205,8 @@ subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -200,21 +217,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - + + -2\. Send subscription information \{\#send\-subscription\-information\} ------------------------------------------------------------------------------ +## 2\. Send subscription information \{\#send\-subscription\-information\} - + ```objc + (void)trackSubscription:(nonnull ADJSubscription *)subscription; ``` - + Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackSubscription` method to record the user's subscription purchase. - + + + ```swift let subscription = ADJSubscription( @@ -238,7 +257,8 @@ subscription.addCallbackParameter("key2", value: "value2") Adjust.trackSubscription(subscription) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -258,5 +278,5 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [Adjust trackSubscription:subscription]; ``` - - + + diff --git a/src/content/docs/ko/sdk/ios/v5/features/subscriptions.mdx b/src/content/docs/ko/sdk/ios/v5/features/subscriptions.mdx index 4ae7dff0c5..2c6be8b326 100644 --- a/src/content/docs/ko/sdk/ios/v5/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/ios/v5/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/ios/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/ios/v4/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: ko/sdk/ios/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ko/sdk/ios/v4/features/subscriptions --- - -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. - + + +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + + You can record App Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `ADJAppStoreSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -31,17 +30,18 @@ You can record App Store subscriptions and verify their validity with the Adjust transactionId:(nonnull NSString *)transactionId; ``` - + To get started, you need to create a subscription object containing details of the subscription purchase. To do this, initialize an `ADJAppStoreSubscription` object using the `initWithPrice` method. Pass the following arguments: -| Parameter | Data type | Description | -|-----------------|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | `NSDecimalNumber` | The price of the subscription | | `currency` | `NSString` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | | `transactionId` | `NSString` | Your ID for the transaction | - + + ```swift let subscription = ADJAppStoreSubscription( @@ -50,7 +50,8 @@ let subscription = ADJAppStoreSubscription( transactionId: transactionId ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -58,20 +59,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit transactionId:transactionId]; ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - + You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setTransactionDate` method with a timestamp to record this information. - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -82,7 +86,8 @@ guard let subscription = ADJAppStoreSubscription( subscription.setTransactionDate(transactionDate) ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -92,20 +97,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setTransactionDate:transactionDate]; ``` - + + -### Record the purchase region \{\#record\-the\-purchase\-region\} +### Record the purchase region {#record-the-purchase-region} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - + You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as an `NSString`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -116,7 +124,8 @@ guard let subscription = ADJAppStoreSubscription( subscription.setSalesRegion(salesRegion) ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -126,20 +135,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setSalesRegion:salesRegion]; ``` - + + -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -151,7 +163,8 @@ subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -162,20 +175,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -187,7 +203,8 @@ subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -198,21 +215,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - + + -2\. Send subscription information \{\#send\-subscription\-information\} ------------------------------------------------------------------------------ +## 2\. Send subscription information \{\#send\-subscription\-information\} - + ```objc + (void)trackAppStoreSubscription:(nonnull ADJAppStoreSubscription *)subscription; ``` - + Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackAppStoreSubscription` method to record the user's subscription purchase. - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -234,7 +253,8 @@ subscription.addCallbackParameter("key2", value: "value2") Adjust.trackAppStoreSubscription(subscription) ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -254,5 +274,5 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [Adjust trackAppStoreSubscription:subscription]; ``` - - + + diff --git a/src/content/docs/ko/sdk/testing/subscription-recording.mdx b/src/content/docs/ko/sdk/testing/subscription-recording.mdx index 1c24f44917..49757ae393 100644 --- a/src/content/docs/ko/sdk/testing/subscription-recording.mdx +++ b/src/content/docs/ko/sdk/testing/subscription-recording.mdx @@ -1,21 +1,24 @@ --- -title: "Test subscription recording" -description: "Test that the Adjust SDK is sending subscription information to Adjust" -slug: "en/sdk/testing/subscription-recording" -sidebar-label: "Subscription recording" +title: Test subscription recording +description: Test that the Adjust SDK is sending subscription information to Adjust +slug: ko/sdk/testing/subscription-recording +sidebar-label: Subscription recording sidebar-position: 3 --- + You can use the Adjust SDK to record information about subscription purchases in your app. - + + Make sure to set your SDK environment to **Production** after you finish testing. This ensures your app works in production mode. - + + Use these tools to test the SDK: -* The Adjust testing console, available in [AppView](https://help.adjust.com/en/article/testing-console). -* The [Adjust Device API](/en/api/device-api/inspect). -* Your IDE's log output. +- The Adjust testing console, available in [AppView](https://help.adjust.com/ko/article/testing-console). +- The [Adjust Device API](/ko/api/device-api/inspect). +- Your IDE's log output. To test that this is working: @@ -23,10 +26,11 @@ To test that this is working: 2. Set the environment to **sandbox** . This ensures that your app only sends information to the testing console. 3. Set your log level to **verbose** to capture all logging information from your app. 4. Set up a test device or an emulated device and find the device's advertising ID. You can install the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808) to find this information. -5. If you've previously used the device for testing: +5. If you've previously used the device for testing: + 1. Delete your app from the test device. - 2. Clear the device's advertising ID from the testing console. Follow the instructions for the [Testing console in AppView](https://help.adjust.com/en/article/testing-console#forget-device). - 3. Alternatively, call the [forget device endpoint](/en/api/device-api/forget/) to remove existing information about the device. + 2. Clear the device's advertising ID from the testing console. Follow the instructions for the [Testing console in AppView](https://help.adjust.com/ko/article/testing-console#forget-device). + 3. Alternatively, call the [forget device endpoint](/ko/api/device-api/forget/) to remove existing information about the device. 6. Download and open the test version of your app that contains the Adjust SDK. 7. Trigger a test purchase. @@ -34,10 +38,9 @@ To test that this is working: If the subscription is recorded successfully, the following fields are populated in the console output: -* **Last Subscription Event Type** -* [**Last Subscription Event Subtype**](https://help.adjust.com/en/article/manage-subscription-data#subscription-event-subtypes) -* **Last Subscription Event Timestamp** -* **Product ID** +- **Last Subscription Event Type** +- [**Last Subscription Event Subtype**](https://help.adjust.com/ko/article/manage-subscription-data#subscription-event-subtypes) +- **Last Subscription Event Timestamp** +- **Product ID** ![The Adjust testing console](@images/sdk-testing/subscription/testing-console.png) - diff --git a/src/content/docs/ko/sdk/unity/v4/features/subscriptions.mdx b/src/content/docs/ko/sdk/unity/v4/features/subscriptions.mdx index 387a272473..a02d7dc8c1 100644 --- a/src/content/docs/ko/sdk/unity/v4/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/unity/v4/features/subscriptions.mdx @@ -1,41 +1,42 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/unity/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/unity/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: ko/sdk/unity/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ko/sdk/unity/features/subscriptions --- - -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. - + + +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + + You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} To get started, you need to create a subscription object containing details of the subscription purchase. - + + + ```cs public AdjustAppStoreSubscription(string price, string currency, string transactionId, string receipt) ``` - + Create an `AdjustAppStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | `string` | The price of the subscription | | `currency` | `string` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | | `transactionId` | `string` | Your ID for the transaction | @@ -49,24 +50,25 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - + + ```cs public AdjustPlayStoreSubscription(string price, string currency, string sku, string orderId, string signature, string purchaseToken) ``` - + Create an `AdjustPlayStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription | -| `sku` | `string` | The ID of the product | -| `orderId` | `string` | Your ID for the transaction | -| `signature` | `string` | The signature of the purchase data | -| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | +| Parameter | Data type | Description | +| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription | +| `sku` | `string` | The ID of the product | +| `orderId` | `string` | Your ID for the transaction | +| `signature` | `string` | The signature of the purchase data | +| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation]() for more information | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -78,18 +80,21 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. - + + + ```cs public void setTransactionDate(string transactionDate); ``` - + Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. @@ -103,13 +108,14 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - + + ```cs public void setPurchaseTime(string purchaseTime); ``` - + Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. @@ -124,17 +130,18 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} +### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} - + ```cs public void setSalesRegion(string salesRegion); ``` - + You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. @@ -148,16 +155,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -170,13 +179,14 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -191,18 +201,21 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -215,13 +228,14 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -236,19 +250,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + -2\. Record subscription information \{\#record\-subscription\-information\} ---------------------------------------------------------------------------------- +## 2\. Record subscription information \{\#record\-subscription\-information\} Once you have set up your subscription object, you can record it using the Adjust SDK. - + + + ```cs public static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. @@ -268,13 +284,14 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```cs public static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. @@ -295,5 +312,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ko/sdk/unity/v5/features/subscriptions.mdx b/src/content/docs/ko/sdk/unity/v5/features/subscriptions.mdx index bb4c928229..dd04eeaf20 100644 --- a/src/content/docs/ko/sdk/unity/v5/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/unity/v5/features/subscriptions.mdx @@ -1,41 +1,42 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/unity/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/unity/v4/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: ko/sdk/unity/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ko/sdk/unity/v4/features/subscriptions --- - -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. - + + +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + + You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} To get started, you need to create a subscription object containing details of the subscription purchase. - + + + ```cs public AdjustAppStoreSubscription(string price, string currency, string transactionId); ``` - + Create an `AdjustAppStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | `string` | The price of the subscription | | `currency` | `string` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | | `transactionId` | `string` | Your ID for the transaction | @@ -47,24 +48,25 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - + + ```cs public AdjustPlayStoreSubscription(string price, string currency, string sku, string orderId, string signature, string purchaseToken) ``` - + Create an `AdjustPlayStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription | -| `sku` | `string` | The ID of the product | -| `orderId` | `string` | Your ID for the transaction | -| `signature` | `string` | The signature of the purchase data | -| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | +| Parameter | Data type | Description | +| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription | +| `sku` | `string` | The ID of the product | +| `orderId` | `string` | Your ID for the transaction | +| `signature` | `string` | The signature of the purchase data | +| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation]() for more information | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -76,18 +78,21 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. - + + + ```cs public string TransactionDate { get; set; } ``` - + Set the `setTransactionDate` property of your `AdjustAppStoreSubscription` instance to record the timestamp of the subscription. @@ -100,13 +105,14 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.TransactionDate = transactionDate; ``` - + + ```cs public string PurchaseTime { get; set; } ``` - + Set the `PurchaseTime` property of your `AdjustPlayStoreSubscription` instance to record the timestamp of the subscription. @@ -121,17 +127,18 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.PurchaseTime = purchaseTime; ``` - + + -### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} +### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} - + ```cs public string SalesRegion { get; set; } ``` - + You can record the region in which the user purchased a subscription. To do this, set the `SalesRegion` property of your `AdjustPlayStoreSubscription` instance to the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. @@ -144,16 +151,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.SalesRegiom = salesRegion; ``` -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `AddCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -165,13 +174,14 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - + + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -186,18 +196,21 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `AddPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -209,13 +222,14 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - + + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -230,19 +244,21 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - + + -2\. Record subscription information \{\#record\-subscription\-information\} ---------------------------------------------------------------------------------- +## 2\. Record subscription information \{\#record\-subscription\-information\} Once you have set up your subscription object, you can record it using the Adjust SDK. - + + + ```cs public static void TrackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + Pass your subscription object to the `Adjust.TrackAppStoreSubscription` method to record the user's subscription purchase. @@ -261,13 +277,14 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackAppStoreSubscription(subscription); ``` - + + ```cs public static void TrackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + Pass your subscription object to the `Adjust.TrackPlayStoreSubscription` method to record the user's subscription purchase. @@ -288,5 +305,5 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/zh/sdk/android/v4/features/subscriptions.mdx b/src/content/docs/zh/sdk/android/v4/features/subscriptions.mdx index dcf4937285..42805a15f7 100644 --- a/src/content/docs/zh/sdk/android/v4/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/android/v4/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/android/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/android/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: zh/sdk/android/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /zh/sdk/android/features/subscriptions --- - -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 - + + +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 + + You can record Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, instantiate an `AdjustPlayStoreSubscription` object containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - + ```java public AdjustPlayStoreSubscription(final long price, @@ -35,12 +34,12 @@ public AdjustPlayStoreSubscription(final long price, ``` - + To get started, you need to instantiate a subscription object containing details of the subscription purchase. To do this, create a new `AdjustPlayStoreSubscription` object and pass the following arguments: -| Parameter | Data type | Description | -|-----------------|-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | `long` | The price of the subscription | | `currency` | `String` | The currency of the subscription | | `sku` | `String` | The ID of the product | @@ -48,7 +47,8 @@ To get started, you need to instantiate a subscription object containing details | `signature` | `String` | The signature of the purchase data | | `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase) for more information | - + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,7 +62,8 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -76,20 +77,23 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setPurchaseTime` method with a timestamp to record this information. - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -104,7 +108,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -119,75 +124,85 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} - + ```java public void addCallbackParameter(String key, String value) ``` - + You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - + + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} - + ```java public void addPartnerParameter(String key, String value) ``` - + You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - + + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - + + -2\. Send subscription information \{\#send\-subscription\-information\} ------------------------------------------------------------------------------ +## 2\. Send subscription information \{\#send\-subscription\-information\} - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - + Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -202,7 +217,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -217,5 +233,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/zh/sdk/android/v5/features/subscriptions.mdx b/src/content/docs/zh/sdk/android/v5/features/subscriptions.mdx index 6477a1daf9..24101f243d 100644 --- a/src/content/docs/zh/sdk/android/v5/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/android/v5/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/android/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/android/v4/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: zh/sdk/android/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /zh/sdk/android/v4/features/subscriptions --- - -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 - + + +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 + + You can record Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, instantiate an `AdjustPlayStoreSubscription` object containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - + ```java public AdjustPlayStoreSubscription(final long price, @@ -35,12 +34,12 @@ public AdjustPlayStoreSubscription(final long price, ``` - + To get started, you need to instantiate a subscription object containing details of the subscription purchase. To do this, create a new `AdjustPlayStoreSubscription` object and pass the following arguments: -| Parameter | Data type | Description | -|-----------------|-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | `long` | The price of the subscription | | `currency` | `String` | The currency of the subscription | | `sku` | `String` | The ID of the product | @@ -48,7 +47,8 @@ To get started, you need to instantiate a subscription object containing details | `signature` | `String` | The signature of the purchase data | | `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase) for more information | - + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,7 +62,8 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -76,20 +77,23 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setPurchaseTime` method with a timestamp to record this information. - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -104,7 +108,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -119,75 +124,85 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} - + ```java public void addCallbackParameter(String key, String value) ``` - + You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - + + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} - + ```java public void addPartnerParameter(String key, String value) ``` - + You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - + + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - + + -2\. Send subscription information \{\#send\-subscription\-information\} ------------------------------------------------------------------------------ +## 2\. Send subscription information \{\#send\-subscription\-information\} - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - + Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -202,7 +217,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -217,5 +233,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/zh/sdk/cordova/v4/features/subscriptions.mdx b/src/content/docs/zh/sdk/cordova/v4/features/subscriptions.mdx index bee636fde9..3f0f64dd44 100644 --- a/src/content/docs/zh/sdk/cordova/v4/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/cordova/v4/features/subscriptions.mdx @@ -1,41 +1,42 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/cordova/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/cordova/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: zh/sdk/cordova/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /zh/sdk/cordova/features/subscriptions --- - -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 - + + +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 + + You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} To get started, you need to create a subscription object containing details of the subscription purchase. - + + + ```js constructor(price: string, currency: string, transactionId: string, receipt: string) ``` - + Create an `AdjustAppStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | Number | The price of the subscription | | `currency` | String | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | | `transactionId` | String | Your ID for the transaction | @@ -50,24 +51,25 @@ var subscription = new AdjustAppStoreSubscription( ); ``` - + + ```js constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + Create an `AdjustPlayStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | Number | The price of the subscription | -| `currency` | String | The currency of the subscription | -| `sku` | String | The ID of the product | -| `orderId` | String | Your ID for the transaction | -| `signature` | String | The signature of the purchase data | -| `purchaseToken` | String | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | +| Parameter | Data type | Description | +| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | Number | The price of the subscription | +| `currency` | String | The currency of the subscription | +| `sku` | String | The ID of the product | +| `orderId` | String | Your ID for the transaction | +| `signature` | String | The signature of the purchase data | +| `purchaseToken` | String | The unique token of the transaction. See [Google's documentation]() for more information | ```js var subscription = new AdjustPlayStoreSubscription( @@ -80,18 +82,21 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. - + + + ```js setTransactionDate(transactionDate: string): void ``` - + Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. @@ -106,13 +111,14 @@ var subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - + + ```js setPurchaseTime(purchaseTime: string): void ``` - + Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. @@ -128,17 +134,18 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} +### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} - + ```js setSalesRegion(salesRegion: string): void ``` - + You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. @@ -153,16 +160,18 @@ var subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -176,13 +185,14 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -198,18 +208,21 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -223,13 +236,14 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -245,19 +259,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + -2\. Record subscription information \{\#record\-subscription\-information\} ---------------------------------------------------------------------------------- +## 2\. Record subscription information \{\#record\-subscription\-information\} Once you have set up your subscription object, you can record it using the Adjust SDK. - + + + ```js trackAppStoreSubscription(subscription: AdjustAppStoreSubscription): void ``` - + Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. @@ -278,13 +294,14 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```js trackPlayStoreSubscription(subscription: AdjustPlayStoreSubscription): void ``` - + Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. @@ -306,5 +323,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/zh/sdk/cordova/v5/features/subscriptions.mdx b/src/content/docs/zh/sdk/cordova/v5/features/subscriptions.mdx index 2fffb67287..5f8ad11d14 100644 --- a/src/content/docs/zh/sdk/cordova/v5/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/cordova/v5/features/subscriptions.mdx @@ -1,44 +1,45 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/cordova/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/cordova/v4/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: zh/sdk/cordova/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /zh/sdk/cordova/v4/features/subscriptions --- - -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 - + + +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 + + You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} To get started, you need to create a subscription object containing details of the subscription purchase. - + + + ```ts constructor(price: string, currency: string, transactionId: string) ``` - + Create an `AdjustAppStoreSubscription` object with the following properties -\| Parameter \| Data type \| Description \| +\| Parameter \| Data type \| Description \| \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| -\| `price` \| `string` \| The price of the subscription \| -\| `currency` \| `string` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| -\| `transactionId` \| `string` \| Your ID for the transaction \| \| +\| `price` \| `string` \| The price of the subscription \| +\| `currency` \| `string` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| +\| `transactionId` \| `string` \| Your ID for the transaction \| \| ```js var subscription = new AdjustAppStoreSubscription( @@ -49,24 +50,25 @@ var subscription = new AdjustAppStoreSubscription( Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + Create an `AdjustPlayStoreSubscription` object with the following properties -| Parameter | Data type | Description | -|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription | -| `sku` | `string` | The ID of the product | -| `orderId` | `string` | Your ID for the transaction | -| `signature` | `string` | The signature of the purchase data | -| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | +| Parameter | Data type | Description | +| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription | +| `sku` | `string` | The ID of the product | +| `orderId` | `string` | Your ID for the transaction | +| `signature` | `string` | The signature of the purchase data | +| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation]() for more information | ```js var subscription = new AdjustPlayStoreSubscription( @@ -79,18 +81,21 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. - + + + ```ts setTransactionDate(transactionDate: string): void ``` - + Call the `setTransactionDate` method method on your subscription object to record the timestamp of the subscription. @@ -105,13 +110,14 @@ subscription.setTransactionDate(transactionDate); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts setPurchaseTime(purchaseTime: string): void ``` - + Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. @@ -127,17 +133,18 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} +### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} - + ```ts setSalesRegion(salesRegion: string): void ``` - + You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. @@ -152,16 +159,18 @@ subscription.setSalesRegion(salesRegion); Adjust.trackPlayStoreSubscription(subscription); ``` -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -178,13 +187,14 @@ subscription.addCallbackParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -200,18 +210,21 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -228,13 +241,14 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -250,19 +264,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + -2\. Record subscription information \{\#record\-subscription\-information\} ---------------------------------------------------------------------------------- +## 2\. Record subscription information \{\#record\-subscription\-information\} Once you have set up your subscription object, you can record it using the Adjust SDK. - + + + ```ts trackAppStoreSubscription(adjustAppStoreSubscription: AdjustAppStoreSubscription): void ``` - + Pass your subscription object to the `trackAppStoreSubscription` method method to record the user's subscription purchase. @@ -278,13 +294,14 @@ subscription.setSalesRegion(salesRegion); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts trackPlayStoreSubscription(adjustPlayStoreSubscription: AdjustPlayStoreSubscription): void ``` - + Pass your subscription object to the `trackPlayStoreSubscription` method method to record the user's subscription purchase. @@ -302,5 +319,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/zh/sdk/flutter/v4/features/subscriptions.mdx b/src/content/docs/zh/sdk/flutter/v4/features/subscriptions.mdx index 9dd7131802..38a8d41348 100644 --- a/src/content/docs/zh/sdk/flutter/v4/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/flutter/v4/features/subscriptions.mdx @@ -1,41 +1,42 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/flutter/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/flutter/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: zh/sdk/flutter/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /zh/sdk/flutter/features/subscriptions --- - -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 - + + +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 + + You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} To get started, you need to create a subscription object containing details of the subscription purchase. - + + + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId, String _receipt) ``` - + Create an `AdjustAppStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | `String` | The price of the subscription | | `currency` | `String` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | | `transactionId` | `String` | Your ID for the transaction | @@ -49,24 +50,25 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - + + ```dart AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken) ``` - + Create an `AdjustPlayStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `String` | The price of the subscription | -| `currency` | `String` | The currency of the subscription | -| `sku` | `String` | The ID of the product | -| `orderId` | `String` | Your ID for the transaction | -| `signature` | `String` | The signature of the purchase data | -| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | +| Parameter | Data type | Description | +| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `String` | The price of the subscription | +| `currency` | `String` | The currency of the subscription | +| `sku` | `String` | The ID of the product | +| `orderId` | `String` | Your ID for the transaction | +| `signature` | `String` | The signature of the purchase data | +| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation]() for more information | ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -78,18 +80,21 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. - + + + ```dart void setTransactionDate(String _transactionDate) ``` - + Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. @@ -103,13 +108,14 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - + + ```dart void setPurchaseTime(String purchaseTime) ``` - + Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. @@ -124,17 +130,18 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} +### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} - + ```dart void setSalesRegion(String _salesRegion) ``` - + You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `String`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. @@ -148,16 +155,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -170,13 +179,14 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -191,18 +201,21 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -215,13 +228,14 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - + + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -236,19 +250,21 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - + + -2\. Record subscription information \{\#record\-subscription\-information\} ---------------------------------------------------------------------------------- +## 2\. Record subscription information \{\#record\-subscription\-information\} Once you have set up your subscription object, you can record it using the Adjust SDK. - + + + ```dart static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription) ``` - + Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. @@ -268,13 +284,14 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. @@ -295,5 +312,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + 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 2fd1512665..8620d77c08 100644 --- a/src/content/docs/zh/sdk/flutter/v5/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/flutter/v5/features/subscriptions.mdx @@ -1,44 +1,45 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to 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" +title: Send subscription information +description: Use these methods send subscription information to 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 --- - -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 - + + +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 + + You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} To get started, you need to create a subscription object containing details of the subscription purchase. - + + + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId) ``` - + Create an `AdjustAppStoreSubscription` object with the following properties: -\| Parameter \| Data type \| Description \| +\| Parameter \| Data type \| Description \| \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| -\| `price` \| `String` \| The price of the subscription \| -\| `currency` \| `String` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| -\| `transactionId` \| `String` \| Your ID for the transaction \| \| +\| `price` \| `String` \| The price of the subscription \| +\| `currency` \| `String` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| +\| `transactionId` \| `String` \| Your ID for the transaction \| \| ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -47,24 +48,25 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - + + ```dart AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken) ``` - + Create an `AdjustPlayStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `String` | The price of the subscription | -| `currency` | `String` | The currency of the subscription | -| `sku` | `String` | The ID of the product | -| `orderId` | `String` | Your ID for the transaction | -| `signature` | `String` | The signature of the purchase data | -| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | +| Parameter | Data type | Description | +| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `String` | The price of the subscription | +| `currency` | `String` | The currency of the subscription | +| `sku` | `String` | The ID of the product | +| `orderId` | `String` | Your ID for the transaction | +| `signature` | `String` | The signature of the purchase data | +| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation]() for more information | ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -76,21 +78,25 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. - + + + Add the `transactionDate` property in the `AdjustAppStoreSubscription` class. - + + ```dart String? transactionDate ``` - + Set a timestamp to the `transactionDate` property of your `subscription` instance to record the date on which the user purchased a subscription. @@ -103,16 +109,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.transactionDate = 'transactionDate'; ``` - + + Add the `purchaseTime` property in the `AdjustPlayStoreSubscription` class. - + + ```dart String? purchaseTime; ``` - + Set a timestamp to the `purchaseTime` property of your `subscription` instance to record the date on which the user purchased a subscription. @@ -127,17 +135,18 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.purchaseTime = 'purchase-time'; ``` - + + -### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} +### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} - + ```dart String? salesRegion ``` - + You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `String`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. @@ -150,16 +159,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.salesRegion = 'sales-region'; ``` -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -171,13 +182,14 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -192,18 +204,21 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -215,13 +230,14 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - + + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -236,19 +252,21 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - + + -2\. Record subscription information \{\#record\-subscription\-information\} ---------------------------------------------------------------------------------- +## 2\. Record subscription information \{\#record\-subscription\-information\} Once you have set up your subscription object, you can record it using the Adjust SDK. - + + + ```dart static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription) ``` - + Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. @@ -267,13 +285,14 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. @@ -294,5 +313,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/zh/sdk/ios/v4/features/subscriptions.mdx b/src/content/docs/zh/sdk/ios/v4/features/subscriptions.mdx index 5fe7f8cdd3..f6c1b71903 100644 --- a/src/content/docs/zh/sdk/ios/v4/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/ios/v4/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/ios/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/ios/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: zh/sdk/ios/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /zh/sdk/ios/features/subscriptions --- - -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 - + + +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 + + You can record App Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `ADJSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -32,18 +31,19 @@ You can record App Store subscriptions and verify their validity with the Adjust ``` - + To get started, you need to create a subscription object containing details of the subscription purchase. To do this, initialize an `ADJSubscription` object using the `initWithPrice` method. Pass the following arguments: -| Parameter | Data type | Description | -|-----------------|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | `NSDecimalNumber` | The price of the subscription | | `currency` | `NSString` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | | `transactionId` | `NSString` | Your ID for the transaction | | `receipt` | `NSString` | The receipt information | - + + ```swift let subscription = ADJSubscription( @@ -52,7 +52,8 @@ let subscription = ADJSubscription( transactionId: transactionId) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -60,20 +61,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price transactionId:transactionId]; ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - + You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setTransactionDate` method with a timestamp to record this information. - + + + ```swift let subscription = ADJSubscription( @@ -84,7 +88,8 @@ let subscription = ADJSubscription( subscription.setTransactionDate(transactionDate) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -94,20 +99,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setTransactionDate:transactionDate]; ``` - + + -### Record the purchase region \{\#record\-the\-purchase\-region\} +### Record the purchase region {#record-the-purchase-region} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - + You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as an `NSString`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. - + + + ```swift let subscription = ADJSubscription( @@ -118,7 +126,8 @@ let subscription = ADJSubscription( subscription.setSalesRegion(salesRegion) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -128,20 +137,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setSalesRegion:salesRegion]; ``` - + + -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```swift let subscription = ADJSubscription( @@ -153,7 +165,8 @@ subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -164,20 +177,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```swift let subscription = ADJSubscription( @@ -189,7 +205,8 @@ subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -200,21 +217,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - + + -2\. Send subscription information \{\#send\-subscription\-information\} ------------------------------------------------------------------------------ +## 2\. Send subscription information \{\#send\-subscription\-information\} - + ```objc + (void)trackSubscription:(nonnull ADJSubscription *)subscription; ``` - + Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackSubscription` method to record the user's subscription purchase. - + + + ```swift let subscription = ADJSubscription( @@ -238,7 +257,8 @@ subscription.addCallbackParameter("key2", value: "value2") Adjust.trackSubscription(subscription) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -258,5 +278,5 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [Adjust trackSubscription:subscription]; ``` - - + + diff --git a/src/content/docs/zh/sdk/ios/v5/features/subscriptions.mdx b/src/content/docs/zh/sdk/ios/v5/features/subscriptions.mdx index c4a67adf31..1d80bbf0e5 100644 --- a/src/content/docs/zh/sdk/ios/v5/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/ios/v5/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/ios/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/ios/v4/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: zh/sdk/ios/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /zh/sdk/ios/v4/features/subscriptions --- - -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 - + + +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 + + You can record App Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `ADJAppStoreSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -31,17 +30,18 @@ You can record App Store subscriptions and verify their validity with the Adjust transactionId:(nonnull NSString *)transactionId; ``` - + To get started, you need to create a subscription object containing details of the subscription purchase. To do this, initialize an `ADJAppStoreSubscription` object using the `initWithPrice` method. Pass the following arguments: -| Parameter | Data type | Description | -|-----------------|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | `NSDecimalNumber` | The price of the subscription | | `currency` | `NSString` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | | `transactionId` | `NSString` | Your ID for the transaction | - + + ```swift let subscription = ADJAppStoreSubscription( @@ -50,7 +50,8 @@ let subscription = ADJAppStoreSubscription( transactionId: transactionId ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -58,20 +59,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit transactionId:transactionId]; ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - + You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setTransactionDate` method with a timestamp to record this information. - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -82,7 +86,8 @@ guard let subscription = ADJAppStoreSubscription( subscription.setTransactionDate(transactionDate) ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -92,20 +97,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setTransactionDate:transactionDate]; ``` - + + -### Record the purchase region \{\#record\-the\-purchase\-region\} +### Record the purchase region {#record-the-purchase-region} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - + You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as an `NSString`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -116,7 +124,8 @@ guard let subscription = ADJAppStoreSubscription( subscription.setSalesRegion(salesRegion) ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -126,20 +135,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setSalesRegion:salesRegion]; ``` - + + -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -151,7 +163,8 @@ subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -162,20 +175,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -187,7 +203,8 @@ subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -198,21 +215,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - + + -2\. Send subscription information \{\#send\-subscription\-information\} ------------------------------------------------------------------------------ +## 2\. Send subscription information \{\#send\-subscription\-information\} - + ```objc + (void)trackAppStoreSubscription:(nonnull ADJAppStoreSubscription *)subscription; ``` - + Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackAppStoreSubscription` method to record the user's subscription purchase. - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -234,7 +253,8 @@ subscription.addCallbackParameter("key2", value: "value2") Adjust.trackAppStoreSubscription(subscription) ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -254,5 +274,5 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [Adjust trackAppStoreSubscription:subscription]; ``` - - + + diff --git a/src/content/docs/zh/sdk/testing/subscription-recording.mdx b/src/content/docs/zh/sdk/testing/subscription-recording.mdx index 1c24f44917..dd65cb32a5 100644 --- a/src/content/docs/zh/sdk/testing/subscription-recording.mdx +++ b/src/content/docs/zh/sdk/testing/subscription-recording.mdx @@ -1,21 +1,24 @@ --- -title: "Test subscription recording" -description: "Test that the Adjust SDK is sending subscription information to Adjust" -slug: "en/sdk/testing/subscription-recording" -sidebar-label: "Subscription recording" +title: Test subscription recording +description: Test that the Adjust SDK is sending subscription information to Adjust +slug: zh/sdk/testing/subscription-recording +sidebar-label: Subscription recording sidebar-position: 3 --- + You can use the Adjust SDK to record information about subscription purchases in your app. - + + Make sure to set your SDK environment to **Production** after you finish testing. This ensures your app works in production mode. - + + Use these tools to test the SDK: -* The Adjust testing console, available in [AppView](https://help.adjust.com/en/article/testing-console). -* The [Adjust Device API](/en/api/device-api/inspect). -* Your IDE's log output. +- The Adjust testing console, available in [AppView](https://help.adjust.com/zh/article/testing-console). +- The [Adjust Device API](/zh/api/device-api/inspect). +- Your IDE's log output. To test that this is working: @@ -23,10 +26,11 @@ To test that this is working: 2. Set the environment to **sandbox** . This ensures that your app only sends information to the testing console. 3. Set your log level to **verbose** to capture all logging information from your app. 4. Set up a test device or an emulated device and find the device's advertising ID. You can install the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808) to find this information. -5. If you've previously used the device for testing: +5. If you've previously used the device for testing: + 1. Delete your app from the test device. - 2. Clear the device's advertising ID from the testing console. Follow the instructions for the [Testing console in AppView](https://help.adjust.com/en/article/testing-console#forget-device). - 3. Alternatively, call the [forget device endpoint](/en/api/device-api/forget/) to remove existing information about the device. + 2. Clear the device's advertising ID from the testing console. Follow the instructions for the [Testing console in AppView](https://help.adjust.com/zh/article/testing-console#forget-device). + 3. Alternatively, call the [forget device endpoint](/zh/api/device-api/forget/) to remove existing information about the device. 6. Download and open the test version of your app that contains the Adjust SDK. 7. Trigger a test purchase. @@ -34,10 +38,9 @@ To test that this is working: If the subscription is recorded successfully, the following fields are populated in the console output: -* **Last Subscription Event Type** -* [**Last Subscription Event Subtype**](https://help.adjust.com/en/article/manage-subscription-data#subscription-event-subtypes) -* **Last Subscription Event Timestamp** -* **Product ID** +- **Last Subscription Event Type** +- [**Last Subscription Event Subtype**](https://help.adjust.com/zh/article/manage-subscription-data#subscription-event-subtypes) +- **Last Subscription Event Timestamp** +- **Product ID** ![The Adjust testing console](@images/sdk-testing/subscription/testing-console.png) - diff --git a/src/content/docs/zh/sdk/unity/v4/features/subscriptions.mdx b/src/content/docs/zh/sdk/unity/v4/features/subscriptions.mdx index d313b7b02b..38b0982cf5 100644 --- a/src/content/docs/zh/sdk/unity/v4/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/unity/v4/features/subscriptions.mdx @@ -1,41 +1,42 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/unity/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/unity/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: zh/sdk/unity/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /zh/sdk/unity/features/subscriptions --- - -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 - + + +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 + + You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} To get started, you need to create a subscription object containing details of the subscription purchase. - + + + ```cs public AdjustAppStoreSubscription(string price, string currency, string transactionId, string receipt) ``` - + Create an `AdjustAppStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | `string` | The price of the subscription | | `currency` | `string` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | | `transactionId` | `string` | Your ID for the transaction | @@ -49,24 +50,25 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - + + ```cs public AdjustPlayStoreSubscription(string price, string currency, string sku, string orderId, string signature, string purchaseToken) ``` - + Create an `AdjustPlayStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription | -| `sku` | `string` | The ID of the product | -| `orderId` | `string` | Your ID for the transaction | -| `signature` | `string` | The signature of the purchase data | -| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | +| Parameter | Data type | Description | +| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription | +| `sku` | `string` | The ID of the product | +| `orderId` | `string` | Your ID for the transaction | +| `signature` | `string` | The signature of the purchase data | +| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation]() for more information | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -78,18 +80,21 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. - + + + ```cs public void setTransactionDate(string transactionDate); ``` - + Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. @@ -103,13 +108,14 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - + + ```cs public void setPurchaseTime(string purchaseTime); ``` - + Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. @@ -124,17 +130,18 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} +### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} - + ```cs public void setSalesRegion(string salesRegion); ``` - + You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. @@ -148,16 +155,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -170,13 +179,14 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -191,18 +201,21 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -215,13 +228,14 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -236,19 +250,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + -2\. Record subscription information \{\#record\-subscription\-information\} ---------------------------------------------------------------------------------- +## 2\. Record subscription information \{\#record\-subscription\-information\} Once you have set up your subscription object, you can record it using the Adjust SDK. - + + + ```cs public static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. @@ -268,13 +284,14 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```cs public static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. @@ -295,5 +312,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/zh/sdk/unity/v5/features/subscriptions.mdx b/src/content/docs/zh/sdk/unity/v5/features/subscriptions.mdx index 3b51d69271..62d7774187 100644 --- a/src/content/docs/zh/sdk/unity/v5/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/unity/v5/features/subscriptions.mdx @@ -1,41 +1,42 @@ --- -title: "Send subscription information" -description: "Use these methods send subscription information to Adjust." -slug: "en/sdk/unity/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/unity/v4/features/subscriptions" +title: Send subscription information +description: Use these methods send subscription information to Adjust. +slug: zh/sdk/unity/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /zh/sdk/unity/v4/features/subscriptions --- - -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 - + + +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 + + You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. -1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} ---------------------------------------------------------------------------------------- +## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} To get started, you need to create a subscription object containing details of the subscription purchase. - + + + ```cs public AdjustAppStoreSubscription(string price, string currency, string transactionId); ``` - + Create an `AdjustAppStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Parameter | Data type | Description | +| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price` | `string` | The price of the subscription | | `currency` | `string` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | | `transactionId` | `string` | Your ID for the transaction | @@ -47,24 +48,25 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - + + ```cs public AdjustPlayStoreSubscription(string price, string currency, string sku, string orderId, string signature, string purchaseToken) ``` - + Create an `AdjustPlayStoreSubscription` object with the following properties: -| Parameter | Data type | Description | -|-----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription | -| `sku` | `string` | The ID of the product | -| `orderId` | `string` | Your ID for the transaction | -| `signature` | `string` | The signature of the purchase data | -| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()) for more information | +| Parameter | Data type | Description | +| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `string` | The price of the subscription | +| `currency` | `string` | The currency of the subscription | +| `sku` | `string` | The ID of the product | +| `orderId` | `string` | Your ID for the transaction | +| `signature` | `string` | The signature of the purchase data | +| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation]() for more information | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -76,18 +78,21 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - + + -### Record the purchase date \{\#record\-the\-purchase\-date\} +### Record the purchase date {#record-the-purchase-date} You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. - + + + ```cs public string TransactionDate { get; set; } ``` - + Set the `setTransactionDate` property of your `AdjustAppStoreSubscription` instance to record the timestamp of the subscription. @@ -100,13 +105,14 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.TransactionDate = transactionDate; ``` - + + ```cs public string PurchaseTime { get; set; } ``` - + Set the `PurchaseTime` property of your `AdjustPlayStoreSubscription` instance to record the timestamp of the subscription. @@ -121,17 +127,18 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.PurchaseTime = purchaseTime; ``` - + + -### Record the purchase region \(iOS only\) \{\#record\-the\-purchase\-region\-ios\-only\} +### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} - + ```cs public string SalesRegion { get; set; } ``` - + You can record the region in which the user purchased a subscription. To do this, set the `SalesRegion` property of your `AdjustPlayStoreSubscription` instance to the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. @@ -144,16 +151,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.SalesRegiom = salesRegion; ``` -### Add callback parameters \{\#add\-callback\-parameters\} +### Add callback parameters {#add-callback-parameters} You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `AddCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - + + + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -165,13 +174,14 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - + + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -186,18 +196,21 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - + + -### Add partner parameters \{\#add\-partner\-parameters\} +### Add partner parameters {#add-partner-parameters} You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `AddPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - + + + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -209,13 +222,14 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - + + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -230,19 +244,21 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - + + -2\. Record subscription information \{\#record\-subscription\-information\} ---------------------------------------------------------------------------------- +## 2\. Record subscription information \{\#record\-subscription\-information\} Once you have set up your subscription object, you can record it using the Adjust SDK. - + + + ```cs public static void TrackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + Pass your subscription object to the `Adjust.TrackAppStoreSubscription` method to record the user's subscription purchase. @@ -261,13 +277,14 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackAppStoreSubscription(subscription); ``` - + + ```cs public static void TrackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + Pass your subscription object to the `Adjust.TrackPlayStoreSubscription` method to record the user's subscription purchase. @@ -288,5 +305,5 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackPlayStoreSubscription(subscription); ``` - - + + From d3d28aaea6368c95fc8013eea4136a00466d50d8 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 9 Jan 2025 10:47:44 +0200 Subject: [PATCH 35/75] Smartling translations are completed for commit bc4efb40c005b1b041ea8481a7f29c30cc38b526 from main (#1226) --- src/content/docs/ja/api/s2s-api/sessions.mdx | 14 +++++++------- src/content/docs/ko/api/s2s-api/sessions.mdx | 14 +++++++------- src/content/docs/zh/api/s2s-api/sessions.mdx | 14 +++++++------- 3 files changed, 21 insertions(+), 21 deletions(-) diff --git a/src/content/docs/ja/api/s2s-api/sessions.mdx b/src/content/docs/ja/api/s2s-api/sessions.mdx index 010d44a3d6..4b1bb34b2e 100644 --- a/src/content/docs/ja/api/s2s-api/sessions.mdx +++ b/src/content/docs/ja/api/s2s-api/sessions.mdx @@ -14,13 +14,13 @@ sidebar-label: S2Sセッション -## 事前準備 {#before-you-begin} +## 事前準備 \{\#before\-you\-begin\} ### 認証 {#authentication} -[サーバー間（S2S）セキュリティを設定](/ja/api/s2s-api/security)して、S2Sセッションの計測を不正から守ります。そのためには、受信するリクエストごとに、Adjustダッシュボードで生成されたトークンが付与されている必要があります。トークンが付与されていないリクエスト、または不正なトークンが付与されたリクエストは、Adjustのサーバーによって拒否されます。 +[サーバー間（S2S）セキュリティを設定](/ja/api/s2s-api/security)して、サーバー間 \(S2S\) セッションの計測を不正から守ります。そのためには、受信するリクエストごとに、Adjust管理画面で生成されたトークンが付与されている必要があります。トークンが付与されていないリクエスト、または不正なトークンが付与されたリクエストは、Adjustのサーバーによって拒否されます。 -## セッションを記録する {#record-sessions} +## セッションを記録する \{\#record\-sessions\} Adjustはセッションをグループ化することでリソースを節約します。つまり、Adjustサーバーが新しいセッションをトリガーされたものとして受け取る前に、1つのセッション後に最低30分間の間隔がなければなりません。 @@ -53,7 +53,7 @@ https://s2s.adjust.com/session | `tifa` | Tizen OS 広告ID、Samsungのみ | | | `idfa` | iOS広告ID、iOSのみ | `29DDE430-CE81-4F00-A50C-689595AAD142` | | `idfv` | iOSベンダーID、iOSのみ | `59E27F41-A86B-4560-B585-63161F871C4B` | -| `gps_adid` | Google Play広告ID、Google Play 開発者サービスライブラリが追加された場合にのみ送信される。Androidのみ | `6cf94580-46c2-490c-b882-2f6ae269b579` | +| `gps_adid` | Google Play広告識別子、Google Play 開発者サービスライブラリが追加された場合にのみ送信されます。Androidのみ | `6cf94580-46c2-490c-b882-2f6ae269b579` | | `oaid` | Open Advertising（匿名）ID | `ed799bac-2537-6122-377a-edebce5db5a5` | | `imei` | 国際移動体装置識別番号 | `490154203237518` | | `android_id` | Android ID、 `gps_adid`がない場合にのみ送信される。Androidのみ | `e11a8c233efb29f3` | @@ -81,7 +81,7 @@ https://s2s.adjust.com/session | `install_receipt` | App Store、暗号化により署名されたインストールの受領証、iOSのみ。 | `Super long string representation of the receipt` | | `ip_address` | デバイスのIPアドレス。
`ip_address`パラメーターではIPv4アドレスのみを受け付けます。IPv6は現在サポートされていません。 | `ip_address=192.0.0.1` | -## Googleに同意データを提供する（デジタル市情法へのコンプライアンス） {#provide-consent-data-to-google-digital-markets-act-compliance} +## Googleに同意データを提供する（デジタル市情法へのコンプライアンス） \{\#provide\-consent\-data\-to\-google\-digital\-markets\-act\-compliance\} [EUのデジタル市場法（DMA）に準拠するため、](https://help.adjust.com/ja/article/google-compliancy-with-the-dma)Google 広告およびGoogle マーケティング プラットフォームは、AdjustからAPIへのアトリビューションリクエストを受信することに明示的な同意を必要とします。 @@ -102,7 +102,7 @@ Google 広告を使用している場合は`ad_personalization`パラメータ | `ad_user_data` | | Googleに、ユーザーが個人データが計測目的で共有されることに同意したかどうかを通知します。
この同意は、Google 広告およびGoogle マーケティング プラットフォームのUIで指定した全てのコアプラットフォームサービスCPSの広告主に適用されます。 | | `npa` | | アプリのインストール後に、Google マーケティング プラットフォームを介してパーソナライズされた広告を配信することにユーザーが同意したかどうかを通知します。 | -## 例 {#example} +## 例 \{\#example\} @@ -110,7 +110,7 @@ Google 広告を使用している場合は`ad_personalization`パラメータ curl -X "POST" \ -H 'Authorization: Bearer ADD_YOUR_AUTH_TOKEN_HERE' \ -H 'User-Agent: Adjust Streaming Job (akka-http)' \ --d "app_token=a1234b2x3a4o&app_version=Roku%2FDVP-10.5+%2810.5.0.0010%29&created_at_unix=1543915806015&environment=production&os_name=android&rida=099aa0bc-d123-4567-8999-a1b7c50767b1&s2s=1" \ +-d "app_token=a1234b2x3a4o&app_version=Roku%2FDVP-10.5+%2810.5.0.0010%29&created_at_unix=1543915806015&environment=production&os_name=roku-os&rida=099aa0bc-d123-4567-8999-a1b7c50767b1&s2s=1" \ "https://s2s.adjust.com/session" ``` diff --git a/src/content/docs/ko/api/s2s-api/sessions.mdx b/src/content/docs/ko/api/s2s-api/sessions.mdx index 9868d93945..1ab672a34d 100644 --- a/src/content/docs/ko/api/s2s-api/sessions.mdx +++ b/src/content/docs/ko/api/s2s-api/sessions.mdx @@ -14,13 +14,13 @@ Adjust는 다음의 기능을 활성화해야 합니다. 자세한 정보는 담 -## 시작에 앞서 {#before-you-begin} +## 시작에 앞서 \{\#before\-you\-begin\} ### 인증 {#authentication} [S2S 보안을 설정](/ko/api/s2s-api/security)하여 S2S 세션의 보안을 보장하고, 스푸핑된 요청으로부터 보호할 수 있습니다. 이를 위해서는 수신되는 모든 요청에 Adjust 대시보드에서 생성된 인증 토큰이 포함되어야 합니다. 토큰이 포함되어 있지 않거나 올바르지 않은 토큰을 포함한 요청은 Adjust 서버에서 거부됩니다. -## 세션 기록 {#record-sessions} +## 세션 기록 \{\#record\-sessions\} Adjust는 리소스를 저장하기 위해 세션을 그룹화합니다. Adjust 서버가 새로운 세션이 트리거된 것으로 간주하려면, 세션 간 최소 30분의 간격이 있어야 합니다. @@ -40,7 +40,7 @@ https://s2s.adjust.com/session | `X-Adjust-Forwarded-For` | 디바이스의 IP 주소 | `180.220.253.39` | | `Authorization` | `Bearer` 토큰인 Adjust 인증 토큰. | `Bearer authentication_token` | -### 페이로드 {#payload} +### 페이로드{#payload} 아래의 표에서 파라미터 전체 목록을 확인하시기 바랍니다. @@ -53,7 +53,7 @@ https://s2s.adjust.com/session | `tifa` | Tizen OS 광고 ID, Samsung만 해당 | | | `idfa` | iOS 광고 ID, iOS에만 해당 | `29DDE430-CE81-4F00-A50C-689595AAD142` | | `idfv` | Roku 벤더 ID, iOS에만 해당 | `59E27F41-A86B-4560-B585-63161F871C4B` | -| `gps_adid` | Google Play 광고 ID. Goole Play Service 라이브러리가 추가된 경우에만 전송. Android에만 해당. | `6cf94580-46c2-490c-b882-2f6ae269b579` | +| `gps_adid` | Google Play 광고 식별자. Goole Play Service 라이브러리가 추가된 경우에만 전송. Android에만 해당. | `6cf94580-46c2-490c-b882-2f6ae269b579` | | `oaid` | 공개 광고\(익명\) ID | `ed799bac-2537-6122-377a-edebce5db5a5` | | `imei` | 국제 모바일 기기 식별코드\(IMEI\) | `490154203237518` | | `android_id` | Android ID, `gps_adid`가 없는 경우에만 전송. Android에만 해당. | `e11a8c233efb29f3` | @@ -81,7 +81,7 @@ https://s2s.adjust.com/session | `install_receipt` | 앱 스토어의 암호화 서명된 설치 영수증, iOS만 해당 | `Super long string representation of the receipt` | | `ip_address` | 디바이스의 IP 주소.
`ip_address` 파라미터는 IPv4 주소만 허용하며, IPv6은 현재 지원되지 않습니다. | `ip_address=192.0.0.1` | -## Google에 동의 데이터 제공\(디지털 시장법 준수\) {#provide-consent-data-to-google-digital-markets-act-compliance} +## Google에 동의 데이터 제공\(디지털 시장법 준수\) \{\#provide\-consent\-data\-to\-google\-digital\-markets\-act\-compliance\} [EU의 디지털 시장법\(DMA\)](https://help.adjust.com/ko/article/google-compliancy-with-the-dma)에 따라 Google Ads와 Google Marketing Platform은 API에 대한 Adjust의 어트리뷰션 요청을 수신하기 위해 명시적인 동의를 받아야 합니다. @@ -102,7 +102,7 @@ Google Ads를 사용하는 경우 `ad_personalization` 파라미터를 전송하 | `ad_user_data` | | 사용자가 측정 목적의 개인 정보 공유에 동의했는지 여부를 Google에 알려줍니다.
해당 동의 정보는 광고주들이 Google Ads와 Google Marketing Platform UI에서 명시한 모든 Core Platform Services\(CPS\)에 적용됩니다. | | `npa` | | 사용자가 앱을 설치한 후 Google Marketing Platform을 통해 맞춤형 광고를 제공받는 데 동의했는지 여부를 알려줍니다. | -## 예: {#example} +## 예 \{\#example\} @@ -110,7 +110,7 @@ Google Ads를 사용하는 경우 `ad_personalization` 파라미터를 전송하 curl -X "POST" \ -H 'Authorization: Bearer ADD_YOUR_AUTH_TOKEN_HERE' \ -H 'User-Agent: Adjust Streaming Job (akka-http)' \ --d "app_token=a1234b2x3a4o&app_version=Roku%2FDVP-10.5+%2810.5.0.0010%29&created_at_unix=1543915806015&environment=production&os_name=android&rida=099aa0bc-d123-4567-8999-a1b7c50767b1&s2s=1" \ +-d "app_token=a1234b2x3a4o&app_version=Roku%2FDVP-10.5+%2810.5.0.0010%29&created_at_unix=1543915806015&environment=production&os_name=roku-os&rida=099aa0bc-d123-4567-8999-a1b7c50767b1&s2s=1" \ "https://s2s.adjust.com/session" ``` diff --git a/src/content/docs/zh/api/s2s-api/sessions.mdx b/src/content/docs/zh/api/s2s-api/sessions.mdx index 012dca7075..abb35ccd9f 100644 --- a/src/content/docs/zh/api/s2s-api/sessions.mdx +++ b/src/content/docs/zh/api/s2s-api/sessions.mdx @@ -10,17 +10,17 @@ sidebar-label: S2S 会话 -Adjust 需要为您启用该功能。请联系您的技术客户经理或发送邮件至 support@adjust.com 来完成此步骤。 +Adjust 需要为您启用该功能。请联系您的技术客户经理或发送邮件至 [support@adjust.com](mailto:support@adjust.com) 来完成此步骤。 -## 操作前须知 {#before-you-begin} +## 操作前须知 \{\#before\-you\-begin\} ### 认证{#authentication} [设置 S2S 安全](/zh/api/s2s-api/security)来保护 S2S 会话的安全，抵御欺诈请求的侵害。设置认证后，每个传入的请求都必须带有您在 Adjust 控制面板中生成的认证识别码。缺失识别码或识别码不正确的请求会被 Adjust 服务器拒绝。 -## 记录会话{#record-sessions} +## 记录会话\{\#record\-sessions\} Adjust 将会话归为组，以节省资源。也就是说，在一次会话后，必须有至少 30 分钟的间隔，Adjust 服务器才会将下一次触发的会话计为新会话。 @@ -62,7 +62,7 @@ https://s2s.adjust.com/session | `app_version_short` | 代表 iOS 中的实际应用版本号。仅限 iOS | `1.0` | | `session_count` | 包括当前会话的已记录会话总数。 | `1` | | `subsession_count` | 已记录的子会话数量。记录到的首次会话 \(即安装\) 不包含该参数。
其后的所有会话都包含前一次会话的子会话数量。 | `1` | -| `session_length` | 会话时长 \(以秒计\)。跟踪到的首次会话 \(即安装\) 不包含该参数。
其后的所有会话都包含前一次会话的时长。 | `123` | +| `session_length` | 会话时长 \(以秒计\)。记录到的首次会话 \(即安装\) 不包含该参数。
其后的所有会话都包含前一次会话的时长。 | `123` | | `time_spent` | 前次会话中活跃状态时长 | `123` | | `tracking_enabled` | 说明用户是否启用了限制广告跟踪 \(LAT\) | `1` | | `bundle_id` | Bundle ID，仅限 iOS 设备。 | `com.adjust.example` | @@ -81,7 +81,7 @@ https://s2s.adjust.com/session | `install_receipt` | 来自 App Store 的加密签名安装收据，仅限 iOS | `Super long string representation of the receipt` | | `ip_address` | 设备 IP 地址`ip_address`参数仅接受 IPv4 地址。当前不支持 IPv6。 | `ip_address=192.0.0.1` | -## 向 Google 提供许可数据 \(《数字市场法案》合规\){#provide-consent-data-to-google-digital-markets-act-compliance} +## 向 Google 提供许可数据 \(《数字市场法案》合规\)\{\#provide\-consent\-data\-to\-google\-digital\-markets\-act\-compliance\} 要[符合欧盟的《数字市场法案》\(Digital Markets Act，简称 DMA\)](https://help.adjust.com/zh/article/google-compliancy-with-the-dma)，Google Ads 和 Google Marketing Platform 需要获得明确的用户许可，才能接收 Adjust 向其 API 发送的归因请求。 @@ -102,7 +102,7 @@ https://s2s.adjust.com/session | `ad_user_data` | | 告知 Google 用户是否同意分享个人数据用于监测目的。该许可适用于广告主在 Google Ads 和 Google Marketing Platform 用户界面中指定的所有核心平台服务 \(CPS\)。 | | `npa` | | 表明用户是否同意在安装应用后通过 Google Marketing Platform 被投放个性化广告。 | -## 示例 {#example} +## 示例 \{\#example\} @@ -110,7 +110,7 @@ https://s2s.adjust.com/session curl -X "POST" \ -H 'Authorization: Bearer ADD_YOUR_AUTH_TOKEN_HERE' \ -H 'User-Agent: Adjust Streaming Job (akka-http)' \ --d "app_token=a1234b2x3a4o&app_version=Roku%2FDVP-10.5+%2810.5.0.0010%29&created_at_unix=1543915806015&environment=production&os_name=android&rida=099aa0bc-d123-4567-8999-a1b7c50767b1&s2s=1" \ +-d "app_token=a1234b2x3a4o&app_version=Roku%2FDVP-10.5+%2810.5.0.0010%29&created_at_unix=1543915806015&environment=production&os_name=roku-os&rida=099aa0bc-d123-4567-8999-a1b7c50767b1&s2s=1" \ "https://s2s.adjust.com/session" ``` From d960a2e38402dc474d07d925af9f9beee9cf44a4 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 9 Jan 2025 11:06:07 +0200 Subject: [PATCH 36/75] Smartling translations are completed for commit f2186017f4e13d6b8dc97ec845ea32be043c8154 from main (#1234) --- .../ja/sdk/android/v5/integrations/tradplus.mdx | 2 +- .../ko/sdk/android/v5/integrations/tradplus.mdx | 14 +++++++------- .../zh/sdk/android/v5/integrations/tradplus.mdx | 2 +- 3 files changed, 9 insertions(+), 9 deletions(-) diff --git a/src/content/docs/ja/sdk/android/v5/integrations/tradplus.mdx b/src/content/docs/ja/sdk/android/v5/integrations/tradplus.mdx index 830f2278de..6dc2f58bf7 100644 --- a/src/content/docs/ja/sdk/android/v5/integrations/tradplus.mdx +++ b/src/content/docs/ja/sdk/android/v5/integrations/tradplus.mdx @@ -36,7 +36,7 @@ TradPlusSdk.setGlobalImpressionListener(new GlobalImpressionManager.GlobalImpres @Override public void onImpressionSuccess(TPAdInfo tpAdInfo) { - AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("TradPlus"); + AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("tradplus_sdk"); double ecpm = Double.valueOf(tpAdInfo.ecpm) / 1000; adjustAdRevenue.setRevenue(ecpm, "USD"); adjustAdRevenue.setAdRevenueNetwork(tpAdInfo.adSourceName); diff --git a/src/content/docs/ko/sdk/android/v5/integrations/tradplus.mdx b/src/content/docs/ko/sdk/android/v5/integrations/tradplus.mdx index a2a86662dc..76f88c8e8a 100644 --- a/src/content/docs/ko/sdk/android/v5/integrations/tradplus.mdx +++ b/src/content/docs/ko/sdk/android/v5/integrations/tradplus.mdx @@ -1,6 +1,6 @@ --- -title: TradePlus SDK 연동 -description: "TradPlus 연동을 사용하여 TradPlus 정보를 Adjust 서버로 전달할 수 있습니다. " +title: TradPlus SDK 연동 +description: "TradePlus 연동을 사용하여 TradePlus 정보를 Adjust 서버로 전달할 수 있습니다. " slug: ko/sdk/android/integrations/tradplus versions: - label: v5 @@ -14,12 +14,12 @@ redirects: -TradPlus SDK의 광고 매출을 측정하고 싶다면 SDK간 연동을 사용하여 Adjust 서버로 광고 매출 정보를 전달할 수 있습니다. +TradePlus SDK의 광고 매출을 측정하고 싶다면, SDK간 연동을 사용하여 Adjust 서버로 광고 매출 정보를 전달할 수 있습니다. -Admost의 광고 매출 측정에 관한 문의는 담당 TAM\(테크니컬 어카운트 매니저\)이나 [support@adjust.com](mailto:support@adjust.com)으로 연락 주시기 바랍니다. +TradePlus의 광고 매출 측정에 관한 문의는 담당 TAM\(테크니컬 어카운트 매니저\)이나 [support@adjust.com](mailto:support@adjust.com)으로 연락 주시기 바랍니다. @@ -27,16 +27,16 @@ Admost의 광고 매출 측정에 관한 문의는 담당 TAM\(테크니컬 어 앱에 Adjust SDK를 연동하려면 [연동 가이드](/ko/sdk/android)를 참조하시기 바랍니다. -## 예시 {#example} +## 예 {#example} -Adjust와의 광고 매출 정보를 기록하려면 `TradPlusSdk.setGlobalImpressionListener` 함수 내에서 `AdjustAdRevenue` 인스턴스를 생성하시기 바랍니다. 자세한 내용은 [광고 매출 정보 전송 가이드](/ko/sdk/android/features/ad-revenue) 를 참조하시기 바랍니다. +Adjust에서 광고 수익 정보를 기록하려면, `TradPlusSdk.setGlobalImpressionListener` 함수 안에 `AdjustAdRevenue` 인스턴스를 생성하세요. 자세한 내용은 [광고 수익 정보 전송 가이드](/ko/sdk/android/features/ad-revenue)를 참고하세요. ```java TradPlusSdk.setGlobalImpressionListener(new GlobalImpressionManager.GlobalImpressionListener() { @Override public void onImpressionSuccess(TPAdInfo tpAdInfo) { - AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("TradPlus"); + AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("tradplus_sdk"); double ecpm = Double.valueOf(tpAdInfo.ecpm) / 1000; adjustAdRevenue.setRevenue(ecpm, "USD"); adjustAdRevenue.setAdRevenueNetwork(tpAdInfo.adSourceName); diff --git a/src/content/docs/zh/sdk/android/v5/integrations/tradplus.mdx b/src/content/docs/zh/sdk/android/v5/integrations/tradplus.mdx index b716196321..884c9666a5 100644 --- a/src/content/docs/zh/sdk/android/v5/integrations/tradplus.mdx +++ b/src/content/docs/zh/sdk/android/v5/integrations/tradplus.mdx @@ -36,7 +36,7 @@ TradPlusSdk.setGlobalImpressionListener(new GlobalImpressionManager.GlobalImpres @Override public void onImpressionSuccess(TPAdInfo tpAdInfo) { - AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("TradPlus"); + AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("tradplus_sdk"); double ecpm = Double.valueOf(tpAdInfo.ecpm) / 1000; adjustAdRevenue.setRevenue(ecpm, "USD"); adjustAdRevenue.setAdRevenueNetwork(tpAdInfo.adSourceName); From fc0de926ec0c333521bd1bc6129afa5c65526125 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 9 Jan 2025 13:45:49 +0200 Subject: [PATCH 37/75] Smartling translations are completed for commit d7336d9b2851df7b1cec8480d432dbd0e157e269 from main (#1240) --- .../docs/ja/sdk/ios/v5/features/att.mdx | 20 ++++++++--------- .../docs/ko/sdk/ios/v5/features/att.mdx | 18 +++++++-------- .../docs/zh/sdk/ios/v5/features/att.mdx | 22 +++++++++---------- 3 files changed, 27 insertions(+), 33 deletions(-) diff --git a/src/content/docs/ja/sdk/ios/v5/features/att.mdx b/src/content/docs/ja/sdk/ios/v5/features/att.mdx index 971148d7d8..9df5dc9ce3 100644 --- a/src/content/docs/ja/sdk/ios/v5/features/att.mdx +++ b/src/content/docs/ja/sdk/ios/v5/features/att.mdx @@ -18,7 +18,7 @@ redirects: | ステータス（Status） | コード | 説明 | | --------------------------------------------------- | ------ | ---------------------------------------------------------------- | -| `ATTrackingManagerAuthorizationStatusNotDetermined` | `0` | ユーザーがアクセスプロンプトに応答していない。 | +| `ATTrackingManagerAuthorizationStatusNotDetermined` | `0` | ユーザーがアクセスプロンプトに応答していない | | `ATTrackingManagerAuthorizationStatusRestricted` | `1` | アプリ関連データへのアクセスがデバイスレベルでブロックされている | | `ATTrackingManagerAuthorizationStatusDenied` | `2` | ユーザーがデバイス計測によるアプリ関連データへのアクセスを拒否 | | `ATTrackingManagerAuthorizationStatusAuthorized` | `3` | ユーザーがデバイス計測によるアプリ関連データへのアクセスを承認 | @@ -50,8 +50,7 @@ ATTのテキスト内容を指定する必要があります。これを行う Adjust SDKは、カスタムプロンプトを使用した場合、同意ステータスも記録します。初期化前にプロンプトを表示した場合、SDKはインストールイベントと共にステータスを送信します。プロンプトを初期化後に表示した場合は、SDKはユーザーが更新した後に、即時にAdjustサーバーにステータスを送信します。 - - + ```swift Adjust.requestAppTrackingAuthorization { status in @@ -99,7 +98,7 @@ Adjust.requestAppTrackingAuthorization { status in -## 現在の承認ステータスを取得 {#get-current-authorization-status} +## 現在の承認ステータスを取得する {#get-current-authorization-status} @@ -128,7 +127,7 @@ int authorizationStatus = [Adjust appTrackingAuthorizationStatus]; -## プロンプトのタイミングをカスタム設定 {#custom-prompt-timing} +## プロンプトのタイミングをカスタム設定する {#custom-prompt-timing} @@ -138,15 +137,14 @@ int authorizationStatus = [Adjust appTrackingAuthorizationStatus]; -アプリにオンボーディングプロセスまたはチュートリアルが含まれる場合、ユーザーがこのプロセスを完了するまで、ユーザーのATT同意ステータスの送信を遅らせたい場合があります。これを行うには、`attConsentWaitingInterval`プロパティを設定して、データの送信を **最大120秒** 遅延させ、ユーザーに最初のオンボーディングを完了する時間を与えることができます。タイムアウトが終了した後、またはユーザーが同意ステータスを設定した後に、SDKはユーザーの同意ステータスと共に遅延中に記録した全ての情報をAdjustのサーバーに送信します。 +アプリにオンボーディングプロセスまたはチュートリアルが含まれる場合、ユーザーがこのプロセスを完了するまで、ユーザーのATT同意ステータスの送信を遅らせたい場合があります。これを行うには、`attConsentWaitingInterval`プロパティを設定して、データの送信を **最大360秒** 遅延させ、ユーザーに最初のオンボーディングを完了する時間を与えることができます。タイムアウトが終了した後、またはユーザーが同意ステータスを設定した後に、SDKはユーザーの同意ステータスと共に遅延中に記録した全ての情報をAdjustのサーバーに送信します。 タイムアウトが終了する前、または同意ステータスを選択する前にユーザーがアプリを閉じた場合、アプリを再度開いたときにタイムアウトが再開されます。 - - + ```swift let yourAppToken = "{YourAppToken}" @@ -175,14 +173,14 @@ Adjust.initSdk(adjustConfig) -## iOS 17の同意への対応 {#ios-17-consent-handling} +## iOS 17の同意の取り扱い {#ios-17-consent-handling} iOS 17のリリースに伴い、Appleは開発者がサードパーティに送信するデータに関する新しいルールを導入しました。開発者がAppleのプライバシーガイドラインに準拠していることを証明できるようにするために、Adjust SDKは **同意する** ユーザーと **同意しない** ユーザーに対して2つの個別のエンドポイントを使用します。 デフォルトでは、Adjust SDKは`analytics.adjust.com`エンドポイントを使用して、 **確率的モデリング** 向けに限られたデータセットをAdjustのサーバーに送信します。このエンドポイントは次の情報を受け取り **ません** 。 -- `idfa`: The device ID For Advertisers \(IDFA\). -- `started_at`: The device startup time. +- `idfa`: 広告主のデバイスID（IDFA）。 +- `started_at`: デバイスの起動時間。 ユーザーが[ATTに同意](#app-tracking-authorization-wrapper)した場合にのみ、Adjust SDKは **確定的アトリビューション** のためのidfaとstart_atの両方のプロパティにアクセスできるようになり、 `consent.adjust.com`に完全なペイロードを送信します。 diff --git a/src/content/docs/ko/sdk/ios/v5/features/att.mdx b/src/content/docs/ko/sdk/ios/v5/features/att.mdx index 0dd40c6c8f..ae6bcf6863 100644 --- a/src/content/docs/ko/sdk/ios/v5/features/att.mdx +++ b/src/content/docs/ko/sdk/ios/v5/features/att.mdx @@ -12,7 +12,7 @@ redirects: v4: /ko/sdk/ios/v4/features/att --- -기기의 IDFA\(광고주용 ID\)를 기록하려면 사용자의 허가를 받기 위한 메시지를 표시해야 합니다. 이렇게 하려면 앱에 Apple의 ATT\(App Tracking Transparency\) 프레임워크를 포함해야 합니다. Adjust SDK는 사용자의 허가 여부를 저장하고 각 요청과 함께 Adjust 서버로 전송합니다. +IDFA\(ID for Advertisers\)를 기록하려면 사용자의 허가를 받기 위한 메시지를 표시해야 합니다. 이렇게 하려면 앱에 Apple의 ATT\(App Tracking Transparency\) 프레임워크를 포함해야 합니다. Adjust SDK는 사용자의 허가 여부를 저장하고 각 요청과 함께 Adjust 서버로 전송합니다. ## 승인 상태 {#authorization-statuses} @@ -50,8 +50,7 @@ ATT에 대한 텍스트 콘텐츠를 지정해야 합니다. 이를 위해 텍 Adjust SDK는 커스텀 프롬프트 사용 시 동의 여부도 기록합니다. 초기화 전에 프롬프트가 표시되면 SDK는 설치 이벤트와 함께 동의 여부를 전송합니다. 프롬프트가 초기화된 후 표시되면 SDK는 사용자가 업데이트한 후 즉시 Adjust 서버에 동의 여부를 전송합니다. - - + ```swift Adjust.requestAppTrackingAuthorization { status in @@ -138,15 +137,14 @@ int authorizationStatus = [Adjust appTrackingAuthorizationStatus]; -앱이 온보딩 과정이나 튜토리얼을 포함하는 경우, 사용자가 온보딩 과정이나 튜토리얼을 완료할 때까지 사용자의 ATT 동의 상태 전송을 지연시킬 수 있습니다. 이를 위해 `attConsentWaitingInterval` 속성을 설정하여 최대 **120초 동안** 데이터 전송을 지연하여 사용자가 초기 온보딩을 완료할 수 있는 시간을 제공할 수 있습니다. 타임아웃이 끝나거나 사용자가 동의 상태를 설정한 경우, SDK는 지연 기간 동안 기록된 모든 정보를 사용자의 동의 상태와 함께 Adjust 서버로 전송합니다. +앱이 온보딩 과정이나 튜토리얼을 포함하는 경우, 사용자가 온보딩 과정이나 튜토리얼을 완료할 때까지 사용자의 ATT 동의 상태 전송을 지연시킬 수 있습니다. 이를 위해 `attConsentWaitingInterval` 속성을 설정하여 최대 **360초 동안** 데이터 전송을 지연하여 사용자가 초기 온보딩을 완료할 수 있는 시간을 제공할 수 있습니다. 타임아웃이 끝나거나 사용자가 동의 상태를 설정한 경우, SDK는 지연 기간 동안 기록된 모든 정보를 사용자의 동의 상태와 함께 Adjust 서버로 전송합니다. 사용자가 타임아웃이 끝나기 전 또는 동의 상태를 선택하기 전에 앱을 종료한 경우, 앱을 다시 열면 타임아웃이 다시 시작됩니다. - - + ```swift let yourAppToken = "{YourAppToken}" @@ -179,14 +177,14 @@ Adjust.initSdk(adjustConfig) iOS 17 출시와 함께 Apple은 개발자가 서드파티에 보낼 수 있는 데이터에 관한 새로운 규정을 도입했습니다. 개발자가 Apple의 개인정보 보호정책 준수를 입증할 수 있도록 Adjust SDK는 **동의** 사용자와 **비동의** 사용자에 대해 두 엔드포인트를 별도로 사용합니다. -기본 설정에 따라 Adjust SDK는 `analytics.adjust.com` 엔드포인트를 사용한 **확률론적 모델링** 을 위해 제한된 데이터 세트를 Adjust 서버로 전송합니다. 이 엔드포인트는 다음의 정보를 수신 **하지 않습니다** . +기본적으로 Adjust SDK는 `analytics.adjust.com` 엔드포인트를 사용하여 **확률론적 모델링** 을 위해 제한된 데이터 세트를 Adjust 서버로 전송합니다. 이 엔드포인트는 다음 정보를 수신하지 **않습니다** . -- `idfa`: The device ID For Advertisers \(IDFA\). -- `started_at`: The device startup time. +- `idfa`: 광고주에 대한 기기 ID\(IDFA\). +- `started_at`: 기기 시작 시간. 사용자가 [ATT에 동의한](#app-tracking-authorization-wrapper) 경우에만 Adjust SDK는 **결정론적 어트리뷰션** 을 위해 IDFA와 started_at 속성 모두에 대한 액세스를 획득하고, 전체 페이로드를 `consent.adjust.com`로 전송합니다. -두 엔드포인트는 모든 [URL 전략](/ko/sdk/ios/features/privacy#data-residency) 에 사용할 수 있습니다. +두 엔드포인트를 모든 [URL 전략](/ko/sdk/ios/features/privacy#data-residency)에 활용할 수 있습니다. | URL 전략 | 비동의 엔드포인트 | 동의 엔드포인트 | | -------------------- | ------------------------- | ----------------------- | diff --git a/src/content/docs/zh/sdk/ios/v5/features/att.mdx b/src/content/docs/zh/sdk/ios/v5/features/att.mdx index 85a7de5a45..cd8a2c6f29 100644 --- a/src/content/docs/zh/sdk/ios/v5/features/att.mdx +++ b/src/content/docs/zh/sdk/ios/v5/features/att.mdx @@ -14,7 +14,7 @@ redirects: 如果您要记录设备的广告主 ID \(即 IDFA\)，需要先展示弹窗获得用户的授权。要达到这个目的，您需要在应用中添加 Apple 的 App Tracking Transparency \(ATT\) 框架。Adjust SDK 会存储用户的授权状态并在每次请求中将该信息发送至 Adjust 服务器。 -## 授权状态 {#authorization-statuses} +## 授权状态{#authorization-statuses} | 状态 | 代码 | 描述 | | --------------------------------------------------- | ---- | -------------------------------------------------- | @@ -29,7 +29,7 @@ SDK 无法获取 ATT 状态时，您可能会收到 `-1` 状态代码。 -## ATT 授权包装器 {#att-authorization-wrapper} +## ATT 授权包装器{#att-authorization-wrapper} @@ -50,8 +50,7 @@ Adjust SDK 包含 [Apple `requestTrackingAuthorizationWithCompletionHandler` 方 如果您使用自定义弹窗，Adjust SDK 也会记录授权状态。如果在初始化之前展示弹窗，那么 SDK 会随安装事件一同发送状态。如果在初始化之后展示弹窗，那么 SDK 会在用户更新状态后立即向 Adjust 服务器发送状态。 - - + ```swift Adjust.requestAppTrackingAuthorization { status in @@ -99,7 +98,7 @@ Adjust.requestAppTrackingAuthorization { status in -## 了解当前授权状态 {#get-current-authorization-status} +## 获取当前授权状态{#get-current-authorization-status} @@ -128,7 +127,7 @@ int authorizationStatus = [Adjust appTrackingAuthorizationStatus]; -## 自定义弹窗时机 {#custom-prompt-timing} +## 自定义弹窗时机{#custom-prompt-timing} @@ -138,15 +137,14 @@ int authorizationStatus = [Adjust appTrackingAuthorizationStatus]; -如果您的应用包含新手引导流程或教程，那么最好在用户完成新手引导流程或教程后再发送用户的 ATT 许可状态。您可以设置 `attConsentWaitingInterval` 属性将数据发送延迟最多 **120 秒** ，让用户有足够的时间完成初始用户引导。延时结束或用户设置许可状态后，SDK 会将在延迟时间内记录的所有信息以及用户许可状态发送给 Adjust 服务器。 +如果您的应用包含新手引导流程或教程，那么最好在用户完成新手引导流程或教程后再发送用户的 ATT 许可状态。您可以设置 `attConsentWaitingInterval` 属性将数据发送延迟最多 **360 秒** ，让用户有足够的时间完成初始用户引导。延时结束或用户设置许可状态后，SDK 会将在延迟时间内记录的所有信息以及用户许可状态发送给 Adjust 服务器。 如果用户在延时结束前关闭应用或在选择授权状态前关闭应用，那么用户重新打开应用时延时将重新开始计时。 - - + ```swift let yourAppToken = "{YourAppToken}" @@ -175,14 +173,14 @@ Adjust.initSdk(adjustConfig) -## iOS 17 用户许可处理 {#ios-17-consent-handling} +## iOS 17 用户许可处理{#ios-17-consent-handling} 在 iOS 17 中，Apple 对于开发者可以向第三方发送哪些数据推出了全新规则。为确保开发者可以证明其操作符合 Apple 隐私规定，Adjust SDK 针对 **授权** 和 **未授权** 用户使用两个相互独立的终端。 默认情况下，Adjust SDK 使用`analytics.adjust.com`终端向 Adjust 服务器发送有限的数据集，用于 **概率模型** 。该终端 **不会** 接收以下信息： -- `idfa`: The device ID For Advertisers \(IDFA\). -- `started_at`: The device startup time. +- `idfa`: 广告主设备 ID \(IDFA\)。 +- `started_at`: 设备启动时间。 只有用户[授予 ATT 许可](#app-tracking-authorization-wrapper)时，Adjust SDK 才可访问 idfa 和 started_at 属性用于 **精确归因** 并向`consent.adjust.com`发送完整 payload。 From 03a46499b4ee7a1bf1be9c886f29abe85788a267 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 9 Jan 2025 13:56:44 +0200 Subject: [PATCH 38/75] Smartling translations are completed for commit c77af219f1407ba79b6899a289a6c682530b5e04 from main (#1247) --- src/content/docs/ja/sdk/testing/device-api.mdx | 12 ++++++------ src/content/docs/ko/sdk/testing/device-api.mdx | 16 ++++++++-------- src/content/docs/zh/sdk/testing/device-api.mdx | 10 +++++----- 3 files changed, 19 insertions(+), 19 deletions(-) diff --git a/src/content/docs/ja/sdk/testing/device-api.mdx b/src/content/docs/ja/sdk/testing/device-api.mdx index e81a960174..ff0d929dad 100644 --- a/src/content/docs/ja/sdk/testing/device-api.mdx +++ b/src/content/docs/ja/sdk/testing/device-api.mdx @@ -8,15 +8,15 @@ sidebar-position: 4 Adjust管理画面にログインしなくても、[Device API](/ja/api/device-api/)を使用してインストール情報を確認できます。[inspect deviceエンドポイント](/ja/api/device-api/inspect/)を使用して、次の情報を検査できます： -- デバイスのアトリビューション -- デバイスのリアトリビューション -- イベントデータ -- Pushトークン連携 -- サブスクリプションデータ +- デバイスのアトリビューション +- デバイスのリアトリビューション +- イベントデータ +- Pushトークン連携 +- サブスクリプションデータ Device APIを使用するには、以下の手順に従ってください： -1. お使いのプラットフォーム向けの開始ガイドに従って、Adjust SDKを連携します。 +1. お使いのプラットフォーム向けの連携ガイドに従って、Adjust SDKを連携します。 2. 環境を **サンドボックス** に設定します。これにより、アプリからはテストコンソールにのみ情報が送信されるようになります。 diff --git a/src/content/docs/ko/sdk/testing/device-api.mdx b/src/content/docs/ko/sdk/testing/device-api.mdx index ae36f304c5..8fdbcb8ace 100644 --- a/src/content/docs/ko/sdk/testing/device-api.mdx +++ b/src/content/docs/ko/sdk/testing/device-api.mdx @@ -1,22 +1,22 @@ --- title: 디바이스 API로 설치 검증 -description: Adjust SDK가 디바이스 API를 통해 Adjust에 설치 정보를 전송하는지 테스트 +description: Adjust SDK가 디바이스 API를 사용하여 Adjust로 설치 정보를 전송하는지 테스트 slug: ko/sdk/testing/device-api sidebar-label: 디바이스 API sidebar-position: 4 --- -디바이스 API를 사용하면 Adjust 대시보드에 로그인하지 않고 설치 정보를 확인할 수 있습니다. 디바이스 엔드포인트 검사\(inspect device endpoint\)를 다음의 데이터 검사에 사용하시기 바랍니다. +[디바이스 API](/ko/api/device-api/)를 사용하면 Adjust 대시보드에 로그인하지 않고 설치 정보를 확인할 수 있습니다. [디바이스 엔드포인트 검사](/ko/api/device-api/inspect/)\(inspect device endpoint\)를 다음의 데이터 검사에 사용하시기 바랍니다. -- 디바이스 어트리뷰션 -- 디바이스 리어트리뷰션 -- 이벤트 데이터 -- 푸시 토큰 연동 -- 구독 데이터 +- 디바이스 어트리뷰션 +- 디바이스 리어트리뷰션 +- 이벤트 데이터 +- 푸시 토큰 연동 +- 구독 데이터 디바이스 API 사용 방법: -1. 플랫폼별 Adjust SDK 시작 가이드를 참조하여 연동을 완료합니다. +1. 플랫폼별 Adjust SDK 연동 가이드를 참조하여 연동을 완료합니다. 2. **샌드박스** 모드로 환경을 설정하여, 앱이 테스트용 콘솔로만 정보를 전송하도록 합니다. diff --git a/src/content/docs/zh/sdk/testing/device-api.mdx b/src/content/docs/zh/sdk/testing/device-api.mdx index 2c2fa90917..683ff8fa6f 100644 --- a/src/content/docs/zh/sdk/testing/device-api.mdx +++ b/src/content/docs/zh/sdk/testing/device-api.mdx @@ -8,11 +8,11 @@ sidebar-position: 4 通过[设备 API](/zh/api/device-api/)，您无需登录 Adjust 控制面板即可验证安装信息。您可以使用[查询设备终端](/zh/api/device-api/inspect/)来查看以下信息： -- 设备归因 -- 设备再归因 -- 事件数据 -- 推送标签集成 -- 订阅数据 +- 设备归因 +- 设备再归因 +- 事件数据 +- 推送标签集成 +- 订阅数据 要使用设备 API： From 0239590f6f901e7b6fca8381c56fafe52562537c Mon Sep 17 00:00:00 2001 From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com> Date: Fri, 10 Jan 2025 20:58:00 +0000 Subject: [PATCH 39/75] chore(deps): update dependency @types/node to ^20.17.12 (#1271) Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com> --- package-lock.json | 8 ++++---- package.json | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/package-lock.json b/package-lock.json index 7ee55d178f..5d0a563c51 100644 --- a/package-lock.json +++ b/package-lock.json @@ -48,7 +48,7 @@ "@types/jsdom": "^21.1.7", "@types/lodash-es": "^4.17.12", "@types/mdast": "^4.0.4", - "@types/node": "^20.17.10", + "@types/node": "^20.17.12", "@types/react": "^18.3.18", "@types/react-dom": "^18.3.5", "@types/unist": "^3.0.3", @@ -3127,9 +3127,9 @@ } }, "node_modules/@types/node": { - "version": "20.17.10", - "resolved": "https://registry.npmjs.org/@types/node/-/node-20.17.10.tgz", - "integrity": "sha512-/jrvh5h6NXhEauFFexRin69nA0uHJ5gwk4iDivp/DeoEua3uwCUto6PC86IpRITBOs4+6i2I56K5x5b6WYGXHA==", + "version": "20.17.12", + "resolved": "https://registry.npmjs.org/@types/node/-/node-20.17.12.tgz", + "integrity": "sha512-vo/wmBgMIiEA23A/knMfn/cf37VnuF52nZh5ZoW0GWt4e4sxNquibrMRJ7UQsA06+MBx9r/H1jsI9grYjQCQlw==", "license": "MIT", "dependencies": { "undici-types": "~6.19.2" diff --git a/package.json b/package.json index 83ab774547..0b0488e9a2 100644 --- a/package.json +++ b/package.json @@ -60,7 +60,7 @@ "@types/jsdom": "^21.1.7", "@types/lodash-es": "^4.17.12", "@types/mdast": "^4.0.4", - "@types/node": "^20.17.10", + "@types/node": "^20.17.12", "@types/react": "^18.3.18", "@types/react-dom": "^18.3.5", "@types/unist": "^3.0.3", From d3a439e41c7fbdd5384dc8e9525d5035b5567eb9 Mon Sep 17 00:00:00 2001 From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com> Date: Fri, 10 Jan 2025 21:03:22 +0000 Subject: [PATCH 40/75] chore(deps): update dependency typescript to ^5.7.3 (#1272) Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com> --- package-lock.json | 8 ++++---- package.json | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/package-lock.json b/package-lock.json index 5d0a563c51..0712ab6fef 100644 --- a/package-lock.json +++ b/package-lock.json @@ -59,7 +59,7 @@ "prettier": "^3.4.2", "prettier-plugin-astro": "^0.14.1", "tiny-decode": "^0.1.3", - "typescript": "^5.7.2", + "typescript": "^5.7.3", "typescript-eslint": "^8.18.2" } }, @@ -11258,9 +11258,9 @@ } }, "node_modules/typescript": { - "version": "5.7.2", - "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.7.2.tgz", - "integrity": "sha512-i5t66RHxDvVN40HfDd1PsEThGNnlMCMT3jMUuoh9/0TaqWevNontacunWyN02LA9/fIbEWlcHZcgTKb9QoaLfg==", + "version": "5.7.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.7.3.tgz", + "integrity": "sha512-84MVSjMEHP+FQRPy3pX9sTVV/INIex71s9TL2Gm5FG/WG1SqXeKyZ0k7/blY/4FdOzI12CBy1vGc4og/eus0fw==", "license": "Apache-2.0", "bin": { "tsc": "bin/tsc", diff --git a/package.json b/package.json index 0b0488e9a2..d09e3386e1 100644 --- a/package.json +++ b/package.json @@ -71,7 +71,7 @@ "prettier": "^3.4.2", "prettier-plugin-astro": "^0.14.1", "tiny-decode": "^0.1.3", - "typescript": "^5.7.2", + "typescript": "^5.7.3", "typescript-eslint": "^8.18.2" } } From 2ae67ed44890a90238f2e6d9a736a2f3c707fe0e Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Mon, 13 Jan 2025 12:06:47 +0200 Subject: [PATCH 41/75] Smartling translations are completed for commit e1cfbcac2fdeb56d94f7ee58f674e07b5a262283 from main (#1248) --- .../ja/sdk/unity/v5/features/attribution.mdx | 14 ++++++++----- .../ko/sdk/unity/v5/features/attribution.mdx | 20 +++++++++++-------- .../zh/sdk/unity/v5/features/attribution.mdx | 18 ++++++++++------- 3 files changed, 32 insertions(+), 20 deletions(-) diff --git a/src/content/docs/ja/sdk/unity/v5/features/attribution.mdx b/src/content/docs/ja/sdk/unity/v5/features/attribution.mdx index a4773966dc..5ec78c2497 100644 --- a/src/content/docs/ja/sdk/unity/v5/features/attribution.mdx +++ b/src/content/docs/ja/sdk/unity/v5/features/attribution.mdx @@ -22,9 +22,14 @@ redirects: 以下の値は、[`AdjustConfig`インスタンスの`IsCostDataInAttributionEnabled`プロパティ](/ja/sdk/android/configuration#enable-cost-data-sending)が`true`になっている場合にのみアクセスできます： -- `costType` -- `costAmount` -- `costCurrency` +- `costType` +- `costAmount` +- `costCurrency` + + + + +AdjustのデバイスIDを取得するには、`Adjust.getAdid`メソッドを使用してください。詳細については、[デバイス情報の取得](/ja/sdk/android/features/device-info#adjust-device-identifier)をご覧ください。 @@ -37,7 +42,6 @@ redirects: | `adgroup` | `string` | デバイスが現在アトリビュートされているアドグループの名前 | | `creative` | `string` | デバイスが現在アトリビュートされているクリエイティブの名前 | | `clickLabel` | `string` | インストールがタグされている[クリックラベル](https://help.adjust.com/ja/article/user-rewards) | -| `adid` | `string` | デバイスに割り当てられた一意のAdjust ID | | `costType` | `string` | キャンペーン価格モデル（例：cpi） | | `costAmount` | `double` | インストールのコスト | | `costCurrency` | `string` | コストに関連する[3文字のISO 4217通貨コード](https://www.iban.com/currency-codes) | @@ -84,7 +88,7 @@ public class ExampleGUI : MonoBehaviour { -## 現在のアトリビューション情報を取得 {#get-current-attribution-information} +## 現在のアトリビューション情報を取得する {#get-current-attribution-information} diff --git a/src/content/docs/ko/sdk/unity/v5/features/attribution.mdx b/src/content/docs/ko/sdk/unity/v5/features/attribution.mdx index 81a033b160..62c0719a25 100644 --- a/src/content/docs/ko/sdk/unity/v5/features/attribution.mdx +++ b/src/content/docs/ko/sdk/unity/v5/features/attribution.mdx @@ -12,7 +12,7 @@ redirects: v4: /ko/sdk/unity/v4/features/attribution --- -사용자가 Adjust 링크와 상호작용하면 어트리뷰션 정보가 업데이트됩니다. 이는 사용자가 [딥 링크](https://help.adjust.com/ko/article/deep-links)와 상호작용하는 경우에 발생할 수 있습니다. 사용자의 어트리뷰션 관련 정보는 `AdjustAttribution` 클래스에 나타납니다. +사용자가 Adjust 링크와 상호작용하면 어트리뷰션 정보가 업데이트됩니다. 이는 사용자가 [딥링크](https://help.adjust.com/ko/article/deep-links)와 상호작용하는 경우에 발생할 수 있습니다. 사용자의 어트리뷰션 관련 정보는 `AdjustAttribution` 클래스에 나타납니다. ## AdjustAttribution 클래스 속성 {#adjustattribution-class-properties} @@ -22,9 +22,14 @@ redirects: 다음 값은 [`AdjustConfig` 인스턴스의 `IsCostDataInAttributionEnabled` 속성](/ko/sdk/android/configuration#enable-cost-data-sending)이 `true`인 경우에만 액세스할 수 있습니다. -- `costType` -- `costAmount` -- `costCurrency` +- `costType` +- `costAmount` +- `costCurrency` + + + + +Adjust 기기 ID를 가져오려면 `Adjust.getAdid` 메서드를 사용합니다. 자세한 내용은 [디바이스 정보 확인](/ko/sdk/android/features/device-info#adjust-device-identifier)을 참조하시기 바랍니다. @@ -37,7 +42,6 @@ redirects: | `adgroup` | `string` | 디바이스가 현재 어트리뷰션된 광고그룹의 이름 | | `creative` | `string` | 디바이스가 현재 어트리뷰션된 크리에이티브의 이름 | | `clickLabel` | `string` | 설치가 태그된 [click label](https://help.adjust.com/ko/article/user-rewards) | -| `adid` | `string` | 디바이스에 할당된 고유한 Adjust ID | | `costType` | `string` | 캠페인 가격 모델\(예: CPI\) | | `costAmount` | `double` | 설치 비용 | | `costCurrency` | `string` | 비용 관련 [3자 ISO 4217 통화 코드](https://www.iban.com/currency-codes). | @@ -53,11 +57,11 @@ public Action AttributionChangedDelegate { get; set; } -SDK는 어트리뷰션 변경 사항을 받고 업데이트가 감지되면 함수를 호출합니다. 콜백 함수를 구성하려면 함수를 config 인스턴스의 `AttributionChangedDelegate` 속성에 할당합니다. +SDK는 어트리뷰션 변경 사항을 받고 업데이트가 감지되면 함수를 호출합니다. 콜백 함수를 구성하려면 함수를 `AdjustConfig` 인스턴스의 `AttributionChangedDelegate`에 할당합니다. -앱에서 Adjust SDK를 초기화 **하기 전에** 이 속성을 설정해야 합니다. +앱에서 Adjust SDK를 초기화하기 **이전** 에 이 속성을 설정해야 합니다. @@ -94,7 +98,7 @@ public static void GetAttribution(Action callback) -사용자가 앱을 설치하면 Adjust는 해당 설치를 캠페인에 어트리뷰션합니다. Adjust SDK를 사용하면 설치 캠페인 어트리뷰션 정보에 액세스할 수 있습니다. 이 정보를 반환하려면 `Adjust.GetAttribution` 메서드를 호출하고 콜백 함수를 전달하시기 바랍니다. SDK는 비동기적으로 어트리뷰션 정보를 가져와 이 정보를 completion handler 코드에 `AdjustAttribution` 객체로 전달합니다. +사용자가 앱을 설치하면 Adjust는 해당 설치를 캠페인에 어트리뷰션합니다. Adjust SDK를 사용하면 설치 캠페인 어트리뷰션 정보에 액세스할 수 있습니다. 이 정보를 반환하려면 `Adjust.GetAttribution` 메서드를 호출하고 콜백 함수를 전달합니다. SDK는 비동기적으로 어트리뷰션 정보를 가져와 이 정보를 completion handler에 `AdjustAttribution` 객체로 전달합니다. ```cs Adjust.GetAttribution(attribution => diff --git a/src/content/docs/zh/sdk/unity/v5/features/attribution.mdx b/src/content/docs/zh/sdk/unity/v5/features/attribution.mdx index 16788fa0b3..0d6932845f 100644 --- a/src/content/docs/zh/sdk/unity/v5/features/attribution.mdx +++ b/src/content/docs/zh/sdk/unity/v5/features/attribution.mdx @@ -14,7 +14,7 @@ redirects: 用户与 Adjust 链接交互时，其归因信息会发生更新。用户与[深度链接](https://help.adjust.com/zh/article/deep-links)交互时可能会发生这种情况。用户归因相关信息会在 `AdjustAttribution` 类中展现。 -## AdjustAttribution 类属性 {#adjustattribution-class-properties} +## AdjustAttribution 类属性{#adjustattribution-class-properties} `AdjustAttribution` 类包含设备当前归因状态的细节。任何未针对用户填充的值都会返回 `null` 值。 @@ -22,9 +22,14 @@ redirects: 只有在[您的 `AdjustConfig` 实例 `IsCostDataInAttributionEnabled` 属性](/zh/sdk/android/configuration#enable-cost-data-sending)为 `true` 的情况下，才能访问下列值： -- `costType` -- `costAmount` -- `costCurrency` +- `costType` +- `costAmount` +- `costCurrency` + + + + +要获取 Adjust 设备 ID，请使用 `Adjust.getAdid` 方法。更多详情，请参阅[获取设备信息](/zh/sdk/android/features/device-info#adjust-device-identifier)。 @@ -37,13 +42,12 @@ redirects: | `adgroup` | `string` | 设备当前归因广告组的名称 | | `creative` | `string` | 设备当前归因素材的名称 | | `clickLabel` | `string` | 用于标记安装的[点击标签](https://help.adjust.com/zh/article/user-rewards) | -| `adid` | `string` | 设备的唯一 Adjust ID | | `costType` | `string` | 推广活动定价模型 \(如 cpi\) | | `costAmount` | `double` | 安装成本 | | `costCurrency` | `string` | 与成本关联的货币的 [3 字符 ISO 4217 代码](https://www.iban.com/currency-codes)。 | | `fbInstallReferrer` | `string` | [Facebook install referrer](https://developers.facebook.com/docs/app-ads/install-referrer/)， _仅限安卓_ 。 | -## 发生归因变化时触发函数 {#trigger-a-function-when-attribution-changes} +## 发生归因变化时触发函数{#trigger-a-function-when-attribution-changes} @@ -84,7 +88,7 @@ public class ExampleGUI : MonoBehaviour { -## 获取当前归因信息 {#get-current-attribution-information} +## 获取当前归因信息{#get-current-attribution-information} From ddb78f01ae3c5343cbd9199c9131ac65c11b1a0a 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 08:58:22 +0000 Subject: [PATCH 42/75] File src/content/docs/en/sdk/android/v4/features/subscriptions.mdx was translated to ko-KR locale --- .../sdk/android/v4/features/subscriptions.mdx | 142 ++++++++---------- 1 file changed, 63 insertions(+), 79 deletions(-) diff --git a/src/content/docs/ko/sdk/android/v4/features/subscriptions.mdx b/src/content/docs/ko/sdk/android/v4/features/subscriptions.mdx index 77911c7819..326c5847a5 100644 --- a/src/content/docs/ko/sdk/android/v4/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/android/v4/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: ko/sdk/android/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/android/features/subscriptions +title: "구독 정보 전송" +description: "이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다." +slug: "en/sdk/android/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/android/features/subscriptions" --- + - +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. +플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustPlayStoreSubscription` 객체를 생성하시기 바랍니다. - +1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} +----------------------------------------------------------------- -You can record Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, instantiate an `AdjustPlayStoreSubscription` object containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - - + ```java public AdjustPlayStoreSubscription(final long price, @@ -34,21 +35,20 @@ public AdjustPlayStoreSubscription(final long price, ``` - + -To get started, you need to instantiate a subscription object containing details of the subscription purchase. To do this, create a new `AdjustPlayStoreSubscription` object and pass the following arguments: +시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 인스턴스화해야 합니다. 이를 위해 새로운 `AdjustPlayStoreSubscription` 객체를 생성하고 다음 인수를 전달합니다. -| Parameter | Data type | Description | -| --------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `long` | The price of the subscription | -| `currency` | `String` | The currency of the subscription | -| `sku` | `String` | The ID of the product | -| `orderId` | `String` | Your ID for the transaction | -| `signature` | `String` | The signature of the purchase data | -| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase) for more information | +| 파라미터 | 데이터 유형 | 설명 | +|-----------------|----------|-----------------------------------------------------------------------------------------------------------------------------| +| `price` | `long` | 구독료 | +| `currency` | `String` | 구독 통화 | +| `sku` | `String` | 제품 ID | +| `orderId` | `String` | 거래 ID | +| `signature` | `String` | 구매 데이터의 서명 | +| `purchaseToken` | `String` | 거래의 고유 토큰. 자세한 정보는 [Google 문서](https://developer.android.com/reference/com/android/billingclient/api/Purchase)를 참조하시기 바랍니다. | - - + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,8 +62,7 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -77,23 +76,20 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### Record the purchase date {#record-the-purchase-date} +### 구매일 기록 \{\#record\-the\-purchase\-date\} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setPurchaseTime` method with a timestamp to record this information. - - - +사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. 이 정보를 기록할 타임스탬프와 함께 `setPurchaseTime` 메서드를 호출합니다. + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -108,8 +104,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -124,85 +119,75 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### Add callback parameters {#add-callback-parameters} +### 콜백 파라미터 추가 \{\#add\-callback\-parameters\} - + ```java public void addCallbackParameter(String key, String value) ``` - - -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + - - +콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - - + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - - + -### Add partner parameters {#add-partner-parameters} +### 파트너 파라미터 추가 \{\#add\-partner\-parameters\} - + ```java public void addPartnerParameter(String key, String value) ``` - + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - - - +Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - - + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - - + -## 2\. Send subscription information \{\#send\-subscription\-information\} +2\. 구독 정보 전송 \{\#send\-subscription\-information\} +-------------------------------------------------------- - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - - -Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. + - - +구독 객체를 설정하고 나면 Adjust SDK를 사용하여 Adjust에 전송할 수 있습니다. 완료된 객체를 `trackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -217,8 +202,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -233,5 +217,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From a6055bbb6f4a6526bc5125370e3b285ebd262ab1 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 08:58:24 +0000 Subject: [PATCH 43/75] File src/content/docs/en/sdk/android/v4/features/subscriptions.mdx was translated to zh-CN locale --- .../sdk/android/v4/features/subscriptions.mdx | 142 ++++++++---------- 1 file changed, 63 insertions(+), 79 deletions(-) diff --git a/src/content/docs/zh/sdk/android/v4/features/subscriptions.mdx b/src/content/docs/zh/sdk/android/v4/features/subscriptions.mdx index 42805a15f7..b842676829 100644 --- a/src/content/docs/zh/sdk/android/v4/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/android/v4/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: zh/sdk/android/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/android/features/subscriptions +title: "发送订阅信息" +description: "使用这些方法向 Adjust 发送订阅信息。" +slug: "en/sdk/android/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/android/features/subscriptions" --- + - +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 + -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 +您可以用 Adjust SDK 记录 Play 商店的订阅，并验证这些订阅是否有效。用户购买订阅后，实例化一个包含细节的 `AdjustPlayStoreSubscription` 对象。 - +1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} +------------------------------------------------------------ -You can record Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, instantiate an `AdjustPlayStoreSubscription` object containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - - + ```java public AdjustPlayStoreSubscription(final long price, @@ -34,21 +35,20 @@ public AdjustPlayStoreSubscription(final long price, ``` - + -To get started, you need to instantiate a subscription object containing details of the subscription purchase. To do this, create a new `AdjustPlayStoreSubscription` object and pass the following arguments: +要开始设置，先实例化一个包含订阅购买细节的订阅对象。为此，请创建一个新的 `AdjustPlayStoreSubscription` 对象，并传送下列参数： -| Parameter | Data type | Description | -| --------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `long` | The price of the subscription | -| `currency` | `String` | The currency of the subscription | -| `sku` | `String` | The ID of the product | -| `orderId` | `String` | Your ID for the transaction | -| `signature` | `String` | The signature of the purchase data | -| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase) for more information | +| 参数 | 数据类型 | 描述 | +|-----------------|----------|-----------------------------------------------------------------------------------------------------------------| +| `price` | `long` | 订阅价格 | +| `currency` | `String` | 订阅使用的币种 | +| `sku` | `String` | 产品 ID | +| `orderId` | `String` | 您的交易 ID | +| `signature` | `String` | 购买数据的签名 | +| `purchaseToken` | `String` | 交易唯一识别码。请参考[Google 的文档](https://developer.android.com/reference/com/android/billingclient/api/Purchase)，了解更多信息。 | - - + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,8 +62,7 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -77,23 +76,20 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### Record the purchase date {#record-the-purchase-date} +### 记录购买日期\{\#record\-the\-purchase\-date\} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setPurchaseTime` method with a timestamp to record this information. - - - +您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。请使用时间戳调用 `setPurchaseTime` 方法，记录该信息。 + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -108,8 +104,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -124,85 +119,75 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### Add callback parameters {#add-callback-parameters} +### 添加回传参数\{\#add\-callback\-parameters\} - + ```java public void addCallbackParameter(String key, String value) ``` - - -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + - - +您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - - + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - - + -### Add partner parameters {#add-partner-parameters} +### 添加合作伙伴参数\{\#add\-partner\-parameters\} - + ```java public void addPartnerParameter(String key, String value) ``` - + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - - - +您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - - + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - - + -## 2\. Send subscription information \{\#send\-subscription\-information\} +2\. 发送订阅信息 \{\#send\-subscription\-information\} +------------------------------------------------------ - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - - -Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. + - - +设置好订阅对象后，您就可以使用 Adjust SDK 将其发送给 Adjust 了。将已完成对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -217,8 +202,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -233,5 +217,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 82877831375de49d9652a141ddff79f3b9354a51 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 08:58:26 +0000 Subject: [PATCH 44/75] File src/content/docs/en/sdk/android/v4/features/subscriptions.mdx was translated to ja-JP locale --- .../sdk/android/v4/features/subscriptions.mdx | 142 ++++++++---------- 1 file changed, 63 insertions(+), 79 deletions(-) diff --git a/src/content/docs/ja/sdk/android/v4/features/subscriptions.mdx b/src/content/docs/ja/sdk/android/v4/features/subscriptions.mdx index 16305b36e7..4ecbd79408 100644 --- a/src/content/docs/ja/sdk/android/v4/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/android/v4/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: ja/sdk/android/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/android/features/subscriptions +title: "サブスクリプション情報を送信する" +description: "Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。" +slug: "en/sdk/android/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/android/features/subscriptions" --- + - +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 +Playストアのサブスクリプションを記録し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションを購入したら、詳細を含む `AdjustPlayStoreSubscription`オブジェクトをインスタンス化します。 - +1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} +------------------------------------------------------------------------------- -You can record Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, instantiate an `AdjustPlayStoreSubscription` object containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - - + ```java public AdjustPlayStoreSubscription(final long price, @@ -34,21 +35,20 @@ public AdjustPlayStoreSubscription(final long price, ``` - + -To get started, you need to instantiate a subscription object containing details of the subscription purchase. To do this, create a new `AdjustPlayStoreSubscription` object and pass the following arguments: +開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトをインスタンス化する必要があります。これを行うには、新しい`AdjustPlayStoreSubscription`を作成して次の引数をパスします： -| Parameter | Data type | Description | -| --------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `long` | The price of the subscription | -| `currency` | `String` | The currency of the subscription | -| `sku` | `String` | The ID of the product | -| `orderId` | `String` | Your ID for the transaction | -| `signature` | `String` | The signature of the purchase data | -| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase) for more information | +| パラメーター | データタイプ | 説明 | +|-----------------|----------|------------------------------------------------------------------------------------------------------------------------------| +| `price` | `long` | サブスクリプションの価格 | +| `currency` | `String` | サブスクリプション通貨 | +| `sku` | `String` | プロダクトID | +| `orderId` | `String` | トランザクションID | +| `signature` | `String` | 購入データのシグネチャー | +| `purchaseToken` | `String` | トランザクションの一意のトークン。詳細は[Googleのドキュメント](https://developer.android.com/reference/com/android/billingclient/api/Purchase)を参照してください | - - + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,8 +62,7 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -77,23 +76,20 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### Record the purchase date {#record-the-purchase-date} +### 購入データを記録する \{\#record\-the\-purchase\-date\} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setPurchaseTime` method with a timestamp to record this information. - - - +ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。タイムスタンプを使用して`setPurchaseTime`メソッドを呼び出し、この情報を記録します。 + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -108,8 +104,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -124,85 +119,75 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### Add callback parameters {#add-callback-parameters} +### コールバックパラメーターを追加する \{\#add\-callback\-parameters\} - + ```java public void addCallbackParameter(String key, String value) ``` - - -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + - - +コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - - + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - - + -### Add partner parameters {#add-partner-parameters} +### パートナーパラメーターを追加する \{\#add\-partner\-parameters\} - + ```java public void addPartnerParameter(String key, String value) ``` - + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - - - +パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - - + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - - + -## 2\. Send subscription information \{\#send\-subscription\-information\} +2\. サブスクリプション情報を送信する \{\#send\-subscription\-information\} +---------------------------------------------------------------- - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - - -Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. + - - +サブスクリプションオブジェクトを設定したら、Adjust SDKを使用してそれをAdjustに送信できます。完了したオブジェクトを `trackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -217,8 +202,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -233,5 +217,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 8c5cb6856255ffde346982bf65a6607532270dbe 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 08:58:28 +0000 Subject: [PATCH 45/75] File src/content/docs/en/sdk/android/v5/features/subscriptions.mdx was translated to ko-KR locale --- .../sdk/android/v5/features/subscriptions.mdx | 142 ++++++++---------- 1 file changed, 63 insertions(+), 79 deletions(-) diff --git a/src/content/docs/ko/sdk/android/v5/features/subscriptions.mdx b/src/content/docs/ko/sdk/android/v5/features/subscriptions.mdx index 52649747cc..402910de81 100644 --- a/src/content/docs/ko/sdk/android/v5/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/android/v5/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: ko/sdk/android/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/sdk/android/v4/features/subscriptions +title: "구독 정보 전송" +description: "이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다." +slug: "en/sdk/android/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/android/v4/features/subscriptions" --- + - +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. +플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustPlayStoreSubscription` 객체를 생성하시기 바랍니다. - +1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} +----------------------------------------------------------------- -You can record Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, instantiate an `AdjustPlayStoreSubscription` object containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - - + ```java public AdjustPlayStoreSubscription(final long price, @@ -34,21 +35,20 @@ public AdjustPlayStoreSubscription(final long price, ``` - + -To get started, you need to instantiate a subscription object containing details of the subscription purchase. To do this, create a new `AdjustPlayStoreSubscription` object and pass the following arguments: +시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 인스턴스화해야 합니다. 이를 위해 새로운 `AdjustPlayStoreSubscription` 객체를 생성하고 다음 인수를 전달합니다. -| Parameter | Data type | Description | -| --------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `long` | The price of the subscription | -| `currency` | `String` | The currency of the subscription | -| `sku` | `String` | The ID of the product | -| `orderId` | `String` | Your ID for the transaction | -| `signature` | `String` | The signature of the purchase data | -| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase) for more information | +| 파라미터 | 데이터 유형 | 설명 | +|-----------------|----------|-----------------------------------------------------------------------------------------------------------------------------| +| `price` | `long` | 구독료 | +| `currency` | `String` | 구독 통화 | +| `sku` | `String` | 제품 ID | +| `orderId` | `String` | 거래 ID | +| `signature` | `String` | 구매 데이터의 서명 | +| `purchaseToken` | `String` | 거래의 고유 토큰. 자세한 정보는 [Google 문서](https://developer.android.com/reference/com/android/billingclient/api/Purchase)를 참조하시기 바랍니다. | - - + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,8 +62,7 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -77,23 +76,20 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### Record the purchase date {#record-the-purchase-date} +### 구매일 기록 \{\#record\-the\-purchase\-date\} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setPurchaseTime` method with a timestamp to record this information. - - - +사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. 이 정보를 기록할 타임스탬프와 함께 `setPurchaseTime` 메서드를 호출합니다. + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -108,8 +104,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -124,85 +119,75 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### Add callback parameters {#add-callback-parameters} +### 콜백 파라미터 추가 \{\#add\-callback\-parameters\} - + ```java public void addCallbackParameter(String key, String value) ``` - - -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + - - +콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - - + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - - + -### Add partner parameters {#add-partner-parameters} +### 파트너 파라미터 추가 \{\#add\-partner\-parameters\} - + ```java public void addPartnerParameter(String key, String value) ``` - + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - - - +Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - - + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - - + -## 2\. Send subscription information \{\#send\-subscription\-information\} +2\. 구독 정보 전송 \{\#send\-subscription\-information\} +-------------------------------------------------------- - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - - -Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. + - - +구독 객체를 설정하고 나면 Adjust SDK를 사용하여 Adjust에 전송할 수 있습니다. 완료된 객체를 `trackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -217,8 +202,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -233,5 +217,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 37eebfc1e3485b3b6f4e333e0c90e6abbc6462d6 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 08:58:30 +0000 Subject: [PATCH 46/75] File src/content/docs/en/sdk/android/v5/features/subscriptions.mdx was translated to zh-CN locale --- .../sdk/android/v5/features/subscriptions.mdx | 142 ++++++++---------- 1 file changed, 63 insertions(+), 79 deletions(-) diff --git a/src/content/docs/zh/sdk/android/v5/features/subscriptions.mdx b/src/content/docs/zh/sdk/android/v5/features/subscriptions.mdx index 24101f243d..742e03fc86 100644 --- a/src/content/docs/zh/sdk/android/v5/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/android/v5/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: zh/sdk/android/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /zh/sdk/android/v4/features/subscriptions +title: "发送订阅信息" +description: "使用这些方法向 Adjust 发送订阅信息。" +slug: "en/sdk/android/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/android/v4/features/subscriptions" --- + - +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 + -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 +您可以用 Adjust SDK 记录 Play 商店的订阅，并验证这些订阅是否有效。用户购买订阅后，实例化一个包含细节的 `AdjustPlayStoreSubscription` 对象。 - +1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} +------------------------------------------------------------ -You can record Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, instantiate an `AdjustPlayStoreSubscription` object containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - - + ```java public AdjustPlayStoreSubscription(final long price, @@ -34,21 +35,20 @@ public AdjustPlayStoreSubscription(final long price, ``` - + -To get started, you need to instantiate a subscription object containing details of the subscription purchase. To do this, create a new `AdjustPlayStoreSubscription` object and pass the following arguments: +要开始设置，先实例化一个包含订阅购买细节的订阅对象。为此，请创建一个新的 `AdjustPlayStoreSubscription` 对象，并传送下列参数： -| Parameter | Data type | Description | -| --------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `long` | The price of the subscription | -| `currency` | `String` | The currency of the subscription | -| `sku` | `String` | The ID of the product | -| `orderId` | `String` | Your ID for the transaction | -| `signature` | `String` | The signature of the purchase data | -| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase) for more information | +| 参数 | 数据类型 | 描述 | +|-----------------|----------|-----------------------------------------------------------------------------------------------------------------| +| `price` | `long` | 订阅价格 | +| `currency` | `String` | 订阅使用的币种 | +| `sku` | `String` | 产品 ID | +| `orderId` | `String` | 您的交易 ID | +| `signature` | `String` | 购买数据的签名 | +| `purchaseToken` | `String` | 交易唯一识别码。请参考[Google 的文档](https://developer.android.com/reference/com/android/billingclient/api/Purchase)，了解更多信息。 | - - + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,8 +62,7 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -77,23 +76,20 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### Record the purchase date {#record-the-purchase-date} +### 记录购买日期\{\#record\-the\-purchase\-date\} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setPurchaseTime` method with a timestamp to record this information. - - - +您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。请使用时间戳调用 `setPurchaseTime` 方法，记录该信息。 + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -108,8 +104,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -124,85 +119,75 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### Add callback parameters {#add-callback-parameters} +### 添加回传参数\{\#add\-callback\-parameters\} - + ```java public void addCallbackParameter(String key, String value) ``` - - -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + - - +您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - - + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - - + -### Add partner parameters {#add-partner-parameters} +### 添加合作伙伴参数\{\#add\-partner\-parameters\} - + ```java public void addPartnerParameter(String key, String value) ``` - + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - - - +您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - - + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - - + -## 2\. Send subscription information \{\#send\-subscription\-information\} +2\. 发送订阅信息 \{\#send\-subscription\-information\} +------------------------------------------------------ - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - - -Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. + - - +设置好订阅对象后，您就可以使用 Adjust SDK 将其发送给 Adjust 了。将已完成对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -217,8 +202,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -233,5 +217,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 94765d16ac2351e353c1c1439aa344c35e373f3e 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 08:58:32 +0000 Subject: [PATCH 47/75] File src/content/docs/en/sdk/android/v5/features/subscriptions.mdx was translated to ja-JP locale --- .../sdk/android/v5/features/subscriptions.mdx | 142 ++++++++---------- 1 file changed, 63 insertions(+), 79 deletions(-) diff --git a/src/content/docs/ja/sdk/android/v5/features/subscriptions.mdx b/src/content/docs/ja/sdk/android/v5/features/subscriptions.mdx index 4c5f42287c..1e4e4f9519 100644 --- a/src/content/docs/ja/sdk/android/v5/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/android/v5/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: ja/sdk/android/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ja/sdk/android/v4/features/subscriptions +title: "サブスクリプション情報を送信する" +description: "Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。" +slug: "en/sdk/android/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/android/v4/features/subscriptions" --- + - +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 +Playストアのサブスクリプションを記録し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションを購入したら、詳細を含む `AdjustPlayStoreSubscription`オブジェクトをインスタンス化します。 - +1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} +------------------------------------------------------------------------------- -You can record Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, instantiate an `AdjustPlayStoreSubscription` object containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - - + ```java public AdjustPlayStoreSubscription(final long price, @@ -34,21 +35,20 @@ public AdjustPlayStoreSubscription(final long price, ``` - + -To get started, you need to instantiate a subscription object containing details of the subscription purchase. To do this, create a new `AdjustPlayStoreSubscription` object and pass the following arguments: +開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトをインスタンス化する必要があります。これを行うには、新しい`AdjustPlayStoreSubscription`を作成して次の引数をパスします： -| Parameter | Data type | Description | -| --------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `long` | The price of the subscription | -| `currency` | `String` | The currency of the subscription | -| `sku` | `String` | The ID of the product | -| `orderId` | `String` | Your ID for the transaction | -| `signature` | `String` | The signature of the purchase data | -| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation](https://developer.android.com/reference/com/android/billingclient/api/Purchase) for more information | +| パラメーター | データタイプ | 説明 | +|-----------------|----------|------------------------------------------------------------------------------------------------------------------------------| +| `price` | `long` | サブスクリプションの価格 | +| `currency` | `String` | サブスクリプション通貨 | +| `sku` | `String` | プロダクトID | +| `orderId` | `String` | トランザクションID | +| `signature` | `String` | 購入データのシグネチャー | +| `purchaseToken` | `String` | トランザクションの一意のトークン。詳細は[Googleのドキュメント](https://developer.android.com/reference/com/android/billingclient/api/Purchase)を参照してください | - - + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,8 +62,7 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -77,23 +76,20 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### Record the purchase date {#record-the-purchase-date} +### 購入データを記録する \{\#record\-the\-purchase\-date\} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setPurchaseTime` method with a timestamp to record this information. - - - +ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。タイムスタンプを使用して`setPurchaseTime`メソッドを呼び出し、この情報を記録します。 + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -108,8 +104,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -124,85 +119,75 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + -### Add callback parameters {#add-callback-parameters} +### コールバックパラメーターを追加する \{\#add\-callback\-parameters\} - + ```java public void addCallbackParameter(String key, String value) ``` - - -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. + - - +コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - - + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - - + -### Add partner parameters {#add-partner-parameters} +### パートナーパラメーターを追加する \{\#add\-partner\-parameters\} - + ```java public void addPartnerParameter(String key, String value) ``` - + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. - - - +パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - - + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - - + -## 2\. Send subscription information \{\#send\-subscription\-information\} +2\. サブスクリプション情報を送信する \{\#send\-subscription\-information\} +---------------------------------------------------------------- - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - - -Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. + - - +サブスクリプションオブジェクトを設定したら、Adjust SDKを使用してそれをAdjustに送信できます。完了したオブジェクトを `trackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -217,8 +202,7 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - - + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -233,5 +217,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 2a29fc6397b65f4eacb08e95bb22464e30a7e23b 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 08:58:34 +0000 Subject: [PATCH 48/75] File src/content/docs/en/sdk/cordova/v4/features/subscriptions.mdx was translated to ko-KR locale --- .../sdk/cordova/v4/features/subscriptions.mdx | 175 ++++++++---------- 1 file changed, 79 insertions(+), 96 deletions(-) diff --git a/src/content/docs/ko/sdk/cordova/v4/features/subscriptions.mdx b/src/content/docs/ko/sdk/cordova/v4/features/subscriptions.mdx index 098e3ea42d..2eb64ac42f 100644 --- a/src/content/docs/ko/sdk/cordova/v4/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/cordova/v4/features/subscriptions.mdx @@ -1,46 +1,45 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: ko/sdk/cordova/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/cordova/features/subscriptions +title: "구독 정보 전송" +description: "이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다." +slug: "en/sdk/cordova/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/cordova/features/subscriptions" --- + - +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. +앱 스토어 및 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustAppStoreSubscription` 또는 `AdjustPlayStoreSubscription` 인스턴스를 생성하시기 바랍니다. - +1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} +----------------------------------------------------------------- -You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - -To get started, you need to create a subscription object containing details of the subscription purchase. - - - +시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. + ```js constructor(price: string, currency: string, transactionId: string, receipt: string) ``` - + -Create an `AdjustAppStoreSubscription` object with the following properties: +다음 속성을 포함하는 `AdjustAppStoreSubscription` 객체를 생성합니다. -| Parameter | Data type | Description | -| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | Number | The price of the subscription | -| `currency` | String | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | -| `transactionId` | String | Your ID for the transaction | -| `receipt` | String | The receipt information | +| 파라미터 | 데이터 유형 | 설명 | +|-----------------|--------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | Number | 구독료 | +| `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 | +| `receipt` | String | 영수증 정보 | ```js var subscription = new AdjustAppStoreSubscription( @@ -51,25 +50,24 @@ var subscription = new AdjustAppStoreSubscription( ); ``` - - + ```js constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + -Create an `AdjustPlayStoreSubscription` object with the following properties: +다음 속성을 포함하는 `AdjustPlayStoreSubscription` 객체를 생성합니다. -| Parameter | Data type | Description | -| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | Number | The price of the subscription | -| `currency` | String | The currency of the subscription | -| `sku` | String | The ID of the product | -| `orderId` | String | Your ID for the transaction | -| `signature` | String | The signature of the purchase data | -| `purchaseToken` | String | The unique token of the transaction. See [Google's documentation]() for more information | +| 파라미터 | 데이터 유형 | 설명 | +|-----------------|--------|------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | Number | 구독료 | +| `currency` | String | 구독 통화 | +| `sku` | String | 제품 ID | +| `orderId` | String | 거래 ID | +| `signature` | String | 구매 데이터의 서명 | +| `purchaseToken` | String | 거래의 고유 토큰. 자세한 정보는 [Google 문서](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken())를 참조하시기 바랍니다. | ```js var subscription = new AdjustPlayStoreSubscription( @@ -82,23 +80,20 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. +### 구매일 기록 \{\#record\-the\-purchase\-date\} - - +사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. + ```js setTransactionDate(transactionDate: string): void ``` - + -Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. +구독 객체의 `setTransactionDate` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. ```js var subscription = new AdjustAppStoreSubscription( @@ -111,16 +106,15 @@ var subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - - + ```js setPurchaseTime(purchaseTime: string): void ``` - + -Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. +구독 객체의 `setPurchaseTime` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. ```js var subscription = new AdjustPlayStoreSubscription( @@ -134,20 +128,19 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### 구매 지역 기록\(iOS만 해당\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```js setSalesRegion(salesRegion: string): void ``` - + -You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. +사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `string`로 전달합니다. 이는 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront)로 포맷되어야 합니다. ```js var subscription = new AdjustAppStoreSubscription( @@ -160,18 +153,16 @@ var subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters {#add-callback-parameters} +### 콜백 파라미터 추가 \{\#add\-callback\-parameters\} -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - - - +콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -185,14 +176,13 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -208,21 +198,18 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - - -### Add partner parameters {#add-partner-parameters} + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. +### 파트너 파라미터 추가 \{\#add\-partner\-parameters\} - - +Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -236,14 +223,13 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -259,23 +245,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - + -## 2\. Record subscription information \{\#record\-subscription\-information\} +2\. 구독 정보 기록 \{\#record\-subscription\-information\} +---------------------------------------------------------- -Once you have set up your subscription object, you can record it using the Adjust SDK. - - - +구독 객체를 설정하고 나면 Adjust SDK를 사용하여 기록을 시작할 수 있습니다. + ```js trackAppStoreSubscription(subscription: AdjustAppStoreSubscription): void ``` - + -Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. +구독 객체를 `trackAppStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. ```js var subscription = new AdjustAppStoreSubscription( @@ -294,16 +278,15 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```js trackPlayStoreSubscription(subscription: AdjustPlayStoreSubscription): void ``` - + -Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. +구독 객체를 `trackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. ```js var subscription = new AdjustPlayStoreSubscription( @@ -323,5 +306,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 907208be6e86ba360e8dfe71c84a008e8c9e51a1 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 08:58:36 +0000 Subject: [PATCH 49/75] File src/content/docs/en/sdk/cordova/v4/features/subscriptions.mdx was translated to zh-CN locale --- .../sdk/cordova/v4/features/subscriptions.mdx | 175 ++++++++---------- 1 file changed, 79 insertions(+), 96 deletions(-) diff --git a/src/content/docs/zh/sdk/cordova/v4/features/subscriptions.mdx b/src/content/docs/zh/sdk/cordova/v4/features/subscriptions.mdx index 3f0f64dd44..162c9dd156 100644 --- a/src/content/docs/zh/sdk/cordova/v4/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/cordova/v4/features/subscriptions.mdx @@ -1,46 +1,45 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: zh/sdk/cordova/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/cordova/features/subscriptions +title: "发送订阅信息" +description: "使用这些方法向 Adjust 发送订阅信息。" +slug: "en/sdk/cordova/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/cordova/features/subscriptions" --- + - +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 + -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 +您可以用 Adjust SDK 记录 App Store 和 Play 应用商店的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `AdjustAppStoreSubscription` 或 `AdjustPlayStoreSubscription` 实例。 - +1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} +------------------------------------------------------------ -You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - -To get started, you need to create a subscription object containing details of the subscription purchase. - - - +要开始设置，先创建一个包含订阅购买细节的订阅对象。 + ```js constructor(price: string, currency: string, transactionId: string, receipt: string) ``` - + -Create an `AdjustAppStoreSubscription` object with the following properties: +创建一个 `AdjustAppStoreSubscription` 对象，属性如下： -| Parameter | Data type | Description | -| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | Number | The price of the subscription | -| `currency` | String | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | -| `transactionId` | String | Your ID for the transaction | -| `receipt` | String | The receipt information | +| 参数 | 数据类型 | 描述 | +|-----------------|------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | 数字 | 订阅价格 | +| `currency` | 字符串 | 订阅使用的币种。此信息格式为 [`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` | 字符串 | 您的交易 ID | +| `receipt` | 字符串 | 收据信息 | ```js var subscription = new AdjustAppStoreSubscription( @@ -51,25 +50,24 @@ var subscription = new AdjustAppStoreSubscription( ); ``` - - + ```js constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + -Create an `AdjustPlayStoreSubscription` object with the following properties: +创建一个 `AdjustPlayStoreSubscription` 对象，属性如下： -| Parameter | Data type | Description | -| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | Number | The price of the subscription | -| `currency` | String | The currency of the subscription | -| `sku` | String | The ID of the product | -| `orderId` | String | Your ID for the transaction | -| `signature` | String | The signature of the purchase data | -| `purchaseToken` | String | The unique token of the transaction. See [Google's documentation]() for more information | +| 参数 | 数据类型 | 描述 | +|-----------------|------|------------------------------------------------------------------------------------------------------------------------------------| +| `price` | 数字 | 订阅价格 | +| `currency` | 字符串 | 订阅使用的币种 | +| `sku` | 字符串 | 产品 ID | +| `orderId` | 字符串 | 您的交易 ID | +| `signature` | 字符串 | 购买数据的签名 | +| `purchaseToken` | 字符串 | 交易唯一识别码。请参考[Google 的文档](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken())，了解更多信息。 | ```js var subscription = new AdjustPlayStoreSubscription( @@ -82,23 +80,20 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. +### 记录购买日期\{\#record\-the\-purchase\-date\} - - +您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。 + ```js setTransactionDate(transactionDate: string): void ``` - + -Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. +在您的订阅对象上调用 `setTransactionDate` 方法来记录订阅的时间戳。 ```js var subscription = new AdjustAppStoreSubscription( @@ -111,16 +106,15 @@ var subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - - + ```js setPurchaseTime(purchaseTime: string): void ``` - + -Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. +在您的订阅对象上调用 `setPurchaseTime` 方法来记录订阅的时间戳。 ```js var subscription = new AdjustPlayStoreSubscription( @@ -134,20 +128,19 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### 记录购买地区 \(仅限 iOS\)\{\#record\-the\-purchase\-region\-ios\-only\} - + ```js setSalesRegion(salesRegion: string): void ``` - + -You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. +您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `string` 传递。此信息格式需为 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) 对象的 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront)。 ```js var subscription = new AdjustAppStoreSubscription( @@ -160,18 +153,16 @@ var subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters {#add-callback-parameters} +### 添加回传参数\{\#add\-callback\-parameters\} -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - - - +您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -185,14 +176,13 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -208,21 +198,18 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - - -### Add partner parameters {#add-partner-parameters} + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. +### 添加合作伙伴参数\{\#add\-partner\-parameters\} - - +您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -236,14 +223,13 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -259,23 +245,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - + -## 2\. Record subscription information \{\#record\-subscription\-information\} +2\. 记录订阅信息\{\#record\-subscription\-information\} +------------------------------------------------------- -Once you have set up your subscription object, you can record it using the Adjust SDK. - - - +设置好订阅对象后，您就可以通过 Adjust SDK 对其进行记录了。 + ```js trackAppStoreSubscription(subscription: AdjustAppStoreSubscription): void ``` - + -Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. +将订阅对象传送至 `trackAppStoreSubscription` 方法，以记录用户订阅购买。 ```js var subscription = new AdjustAppStoreSubscription( @@ -294,16 +278,15 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```js trackPlayStoreSubscription(subscription: AdjustPlayStoreSubscription): void ``` - + -Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. +将订阅对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 ```js var subscription = new AdjustPlayStoreSubscription( @@ -323,5 +306,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 155714f43b301a02616d7752b1801315755c3ca1 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 08:58:38 +0000 Subject: [PATCH 50/75] File src/content/docs/en/sdk/cordova/v4/features/subscriptions.mdx was translated to ja-JP locale --- .../sdk/cordova/v4/features/subscriptions.mdx | 175 ++++++++---------- 1 file changed, 79 insertions(+), 96 deletions(-) diff --git a/src/content/docs/ja/sdk/cordova/v4/features/subscriptions.mdx b/src/content/docs/ja/sdk/cordova/v4/features/subscriptions.mdx index 29a4e4ecb8..daef30c22d 100644 --- a/src/content/docs/ja/sdk/cordova/v4/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/cordova/v4/features/subscriptions.mdx @@ -1,46 +1,45 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: ja/sdk/cordova/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/cordova/features/subscriptions +title: "サブスクリプション情報を送信する" +description: "Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。" +slug: "en/sdk/cordova/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/cordova/features/subscriptions" --- + - +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 +App StoreおよびPlay Storeのサブスクリプションを計測し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`AdjustAppStoreSubscription`または`AdjustPlayStoreSubscription`を作成してください。 - +1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} +------------------------------------------------------------------------------- -You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - -To get started, you need to create a subscription object containing details of the subscription purchase. - - - +開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。 + ```js constructor(price: string, currency: string, transactionId: string, receipt: string) ``` - + -Create an `AdjustAppStoreSubscription` object with the following properties: +以下のプロパティを含む`AdjustAppStoreSubscription`オブジェクトを作成します： -| Parameter | Data type | Description | -| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | Number | The price of the subscription | -| `currency` | String | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | -| `transactionId` | String | Your ID for the transaction | -| `receipt` | String | The receipt information | +| パラメーター | データタイプ | 説明 | +|-----------------|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | 数値 | サブスクリプションの価格 | +| `currency` | 文字列 | サブスクリプションの通貨。[`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` | 文字列 | トランザクションID | +| `receipt` | 文字列 | レシート情報 | ```js var subscription = new AdjustAppStoreSubscription( @@ -51,25 +50,24 @@ var subscription = new AdjustAppStoreSubscription( ); ``` - - + ```js constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + -Create an `AdjustPlayStoreSubscription` object with the following properties: +以下のプロパティを含む`AdjustPlayStoreSubscription`オブジェクトを作成します： -| Parameter | Data type | Description | -| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | Number | The price of the subscription | -| `currency` | String | The currency of the subscription | -| `sku` | String | The ID of the product | -| `orderId` | String | Your ID for the transaction | -| `signature` | String | The signature of the purchase data | -| `purchaseToken` | String | The unique token of the transaction. See [Google's documentation]() for more information | +| パラメーター | データタイプ | 説明 | +|-----------------|--------|-------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | 数値 | サブスクリプションの価格 | +| `currency` | 文字列 | サブスクリプション通貨 | +| `sku` | 文字列 | プロダクトID | +| `orderId` | 文字列 | トランザクションID | +| `signature` | 文字列 | 購入データのシグネチャー | +| `purchaseToken` | 文字列 | トランザクションの一意のトークン。詳細は[Googleのドキュメント](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken())を参照してください | ```js var subscription = new AdjustPlayStoreSubscription( @@ -82,23 +80,20 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. +### 購入データを記録する \{\#record\-the\-purchase\-date\} - - +ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。 + ```js setTransactionDate(transactionDate: string): void ``` - + -Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. +サブスクリプションオブジェクトで`setTransactionDate`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 ```js var subscription = new AdjustAppStoreSubscription( @@ -111,16 +106,15 @@ var subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - - + ```js setPurchaseTime(purchaseTime: string): void ``` - + -Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. +サブスクリプションオブジェクトで`setPurchaseTime`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 ```js var subscription = new AdjustPlayStoreSubscription( @@ -134,20 +128,19 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### 購入地域を記録する（iOSのみ） \{\#record\-the\-purchase\-region\-ios\-only\} - + ```js setSalesRegion(salesRegion: string): void ``` - + -You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. +ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトの`setSalesRegion`メソッドを呼び、国コードを`string`としてパスします。これは、[`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/storekit/storefront)としてフォーマットされる必要があります。 ```js var subscription = new AdjustAppStoreSubscription( @@ -160,18 +153,16 @@ var subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters {#add-callback-parameters} +### コールバックパラメーターを追加する \{\#add\-callback\-parameters\} -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - - - +コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -185,14 +176,13 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -208,21 +198,18 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - - -### Add partner parameters {#add-partner-parameters} + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. +### パートナーパラメーターを追加する \{\#add\-partner\-parameters\} - - +パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -236,14 +223,13 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -259,23 +245,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - + -## 2\. Record subscription information \{\#record\-subscription\-information\} +2\. サブスクリプション情報を記録する \{\#record\-subscription\-information\} +------------------------------------------------------------------ -Once you have set up your subscription object, you can record it using the Adjust SDK. - - - +サブスクリプションオブジェクトを設定したら、Adjust SDKを使用して記録することが可能です。 + ```js trackAppStoreSubscription(subscription: AdjustAppStoreSubscription): void ``` - + -Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. +完了したオブジェクトを `trackAppStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 ```js var subscription = new AdjustAppStoreSubscription( @@ -294,16 +278,15 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```js trackPlayStoreSubscription(subscription: AdjustPlayStoreSubscription): void ``` - + -Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. +完了したオブジェクトを `trackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 ```js var subscription = new AdjustPlayStoreSubscription( @@ -323,5 +306,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 89f8846553a976180d3379394ca45e93f7974329 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 08:58:40 +0000 Subject: [PATCH 51/75] File src/content/docs/en/sdk/cordova/v5/features/subscriptions.mdx was translated to ko-KR locale --- .../sdk/cordova/v5/features/subscriptions.mdx | 170 ++++++++---------- 1 file changed, 75 insertions(+), 95 deletions(-) diff --git a/src/content/docs/ko/sdk/cordova/v5/features/subscriptions.mdx b/src/content/docs/ko/sdk/cordova/v5/features/subscriptions.mdx index 8d53e319de..94b304413e 100644 --- a/src/content/docs/ko/sdk/cordova/v5/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/cordova/v5/features/subscriptions.mdx @@ -1,45 +1,41 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: ko/sdk/cordova/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/sdk/cordova/v4/features/subscriptions +title: "구독 정보 전송" +description: "이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다." +slug: "en/sdk/cordova/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/cordova/v4/features/subscriptions" --- + - +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. +앱 스토어 및 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustAppStoreSubscription` 또는 `AdjustPlayStoreSubscription` 인스턴스를 생성하시기 바랍니다. - +1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} +----------------------------------------------------------------- -You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - -To get started, you need to create a subscription object containing details of the subscription purchase. - - - +시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. + ```ts constructor(price: string, currency: string, transactionId: string) ``` - + -Create an `AdjustAppStoreSubscription` object with the following properties +다음 속성들을 포함하는 `AdjustAppStoreSubscription` 객체를 생성합니다. -\| Parameter \| Data type \| Description \| -\| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| -\| `price` \| `string` \| The price of the subscription \| -\| `currency` \| `string` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| -\| `transactionId` \| `string` \| Your ID for the transaction \| \| +\| 파라미터 \| 데이터 유형 \| 설명 \| \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| \| `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 \| \| ```js var subscription = new AdjustAppStoreSubscription( @@ -50,25 +46,24 @@ var subscription = new AdjustAppStoreSubscription( Adjust.trackAppStoreSubscription(subscription); ``` - - + ```ts constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + -Create an `AdjustPlayStoreSubscription` object with the following properties +다음 속성들을 포함하는 `AdjustPlayStoreSubscription` 객체를 생성합니다. -| Parameter | Data type | Description | -| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription | -| `sku` | `string` | The ID of the product | -| `orderId` | `string` | Your ID for the transaction | -| `signature` | `string` | The signature of the purchase data | -| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation]() for more information | +| 파라미터 | 데이터 유형 | 설명 | +|-----------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------| +| `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())를 참조하시기 바랍니다. | ```js var subscription = new AdjustPlayStoreSubscription( @@ -81,23 +76,20 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. +### 구매일 기록 \{\#record\-the\-purchase\-date\} - - +사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. + ```ts setTransactionDate(transactionDate: string): void ``` - + -Call the `setTransactionDate` method method on your subscription object to record the timestamp of the subscription. +구독 객체의 `setTransactionDate` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. ```js var subscription = new AdjustAppStoreSubscription( @@ -110,16 +102,15 @@ subscription.setTransactionDate(transactionDate); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```ts setPurchaseTime(purchaseTime: string): void ``` - + -Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. +구독 객체의 `setPurchaseTime` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. ```js var subscription = new AdjustPlayStoreSubscription( @@ -133,20 +124,19 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### 구매 지역 기록\(iOS만 해당\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```ts setSalesRegion(salesRegion: string): void ``` - + -You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. +사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `string`로 전달합니다. 이는 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront)로 포맷되어야 합니다. ```js var subscription = new AdjustAppStoreSubscription( @@ -159,18 +149,16 @@ subscription.setSalesRegion(salesRegion); Adjust.trackPlayStoreSubscription(subscription); ``` -### Add callback parameters {#add-callback-parameters} +### 콜백 파라미터 추가 \{\#add\-callback\-parameters\} -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - - - +콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. + ```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -187,14 +175,13 @@ subscription.addCallbackParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -210,21 +197,18 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - - -### Add partner parameters {#add-partner-parameters} + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. +### 파트너 파라미터 추가 \{\#add\-partner\-parameters\} - - +Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. + ```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -241,14 +225,13 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -264,23 +247,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - + -## 2\. Record subscription information \{\#record\-subscription\-information\} +2\. 구독 정보 기록 \{\#record\-subscription\-information\} +---------------------------------------------------------- -Once you have set up your subscription object, you can record it using the Adjust SDK. - - - +구독 객체를 설정하고 나면 Adjust SDK를 사용하여 기록을 시작할 수 있습니다. + ```ts trackAppStoreSubscription(adjustAppStoreSubscription: AdjustAppStoreSubscription): void ``` - + -Pass your subscription object to the `trackAppStoreSubscription` method method to record the user's subscription purchase. +구독 객체를 `trackAppStoreSubscription` 메서드 메서드로 전달하여 사용자의 구독 구매를 기록합니다. ```js var subscription = new AdjustAppStoreSubscription( @@ -294,16 +275,15 @@ subscription.setSalesRegion(salesRegion); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```ts trackPlayStoreSubscription(adjustPlayStoreSubscription: AdjustPlayStoreSubscription): void ``` - + -Pass your subscription object to the `trackPlayStoreSubscription` method method to record the user's subscription purchase. +구독 객체를 `trackPlayStoreSubscription` 메서드 메서드로 전달하여 사용자의 구독 구매를 기록합니다. ```js var subscription = new AdjustPlayStoreSubscription( @@ -319,5 +299,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From a0260530e6bacab236be46a31c6a9a5ecb777e04 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 08:58:42 +0000 Subject: [PATCH 52/75] File src/content/docs/en/sdk/cordova/v5/features/subscriptions.mdx was translated to zh-CN locale --- .../sdk/cordova/v5/features/subscriptions.mdx | 170 ++++++++---------- 1 file changed, 75 insertions(+), 95 deletions(-) diff --git a/src/content/docs/zh/sdk/cordova/v5/features/subscriptions.mdx b/src/content/docs/zh/sdk/cordova/v5/features/subscriptions.mdx index 5f8ad11d14..36d349b04a 100644 --- a/src/content/docs/zh/sdk/cordova/v5/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/cordova/v5/features/subscriptions.mdx @@ -1,45 +1,41 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: zh/sdk/cordova/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /zh/sdk/cordova/v4/features/subscriptions +title: "发送订阅信息" +description: "使用这些方法向 Adjust 发送订阅信息。" +slug: "en/sdk/cordova/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/cordova/v4/features/subscriptions" --- + - +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 + -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 +您可以用 Adjust SDK 记录 App Store 和 Play 应用商店的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `AdjustAppStoreSubscription` 或 `AdjustPlayStoreSubscription` 实例。 - +1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} +------------------------------------------------------------ -You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - -To get started, you need to create a subscription object containing details of the subscription purchase. - - - +要开始设置，先创建一个包含订阅购买细节的订阅对象。 + ```ts constructor(price: string, currency: string, transactionId: string) ``` - + -Create an `AdjustAppStoreSubscription` object with the following properties +创建一个 `AdjustAppStoreSubscription` 对象，属性如下： -\| Parameter \| Data type \| Description \| -\| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| -\| `price` \| `string` \| The price of the subscription \| -\| `currency` \| `string` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| -\| `transactionId` \| `string` \| Your ID for the transaction \| \| +\|参数 \|数据类型 \|描述 \| \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| \| `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 \| \| ```js var subscription = new AdjustAppStoreSubscription( @@ -50,25 +46,24 @@ var subscription = new AdjustAppStoreSubscription( Adjust.trackAppStoreSubscription(subscription); ``` - - + ```ts constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + -Create an `AdjustPlayStoreSubscription` object with the following properties +创建一个 `AdjustPlayStoreSubscription` 对象，属性如下： -| Parameter | Data type | Description | -| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription | -| `sku` | `string` | The ID of the product | -| `orderId` | `string` | Your ID for the transaction | -| `signature` | `string` | The signature of the purchase data | -| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation]() for more information | +| 参数 | 数据类型 | 描述 | +|-----------------|----------|------------------------------------------------------------------------------------------------------------------------------------| +| `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())，了解更多信息。 | ```js var subscription = new AdjustPlayStoreSubscription( @@ -81,23 +76,20 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. +### 记录购买日期\{\#record\-the\-purchase\-date\} - - +您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。 + ```ts setTransactionDate(transactionDate: string): void ``` - + -Call the `setTransactionDate` method method on your subscription object to record the timestamp of the subscription. +在您的订阅对象上调用 `setTransactionDate` 方法来记录订阅的时间戳。 ```js var subscription = new AdjustAppStoreSubscription( @@ -110,16 +102,15 @@ subscription.setTransactionDate(transactionDate); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```ts setPurchaseTime(purchaseTime: string): void ``` - + -Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. +在您的订阅对象上调用 `setPurchaseTime` 方法来记录订阅的时间戳。 ```js var subscription = new AdjustPlayStoreSubscription( @@ -133,20 +124,19 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### 记录购买地区 \(仅限 iOS\)\{\#record\-the\-purchase\-region\-ios\-only\} - + ```ts setSalesRegion(salesRegion: string): void ``` - + -You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. +您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `string` 传递。此信息格式需为 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) 对象的 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront)。 ```js var subscription = new AdjustAppStoreSubscription( @@ -159,18 +149,16 @@ subscription.setSalesRegion(salesRegion); Adjust.trackPlayStoreSubscription(subscription); ``` -### Add callback parameters {#add-callback-parameters} +### 添加回传参数\{\#add\-callback\-parameters\} -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - - - +您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 + ```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -187,14 +175,13 @@ subscription.addCallbackParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -210,21 +197,18 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - - -### Add partner parameters {#add-partner-parameters} + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. +### 添加合作伙伴参数\{\#add\-partner\-parameters\} - - +您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 + ```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -241,14 +225,13 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -264,23 +247,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - + -## 2\. Record subscription information \{\#record\-subscription\-information\} +2\. 记录订阅信息\{\#record\-subscription\-information\} +------------------------------------------------------- -Once you have set up your subscription object, you can record it using the Adjust SDK. - - - +设置好订阅对象后，您就可以通过 Adjust SDK 对其进行记录了。 + ```ts trackAppStoreSubscription(adjustAppStoreSubscription: AdjustAppStoreSubscription): void ``` - + -Pass your subscription object to the `trackAppStoreSubscription` method method to record the user's subscription purchase. +将订阅对象传送至 `trackAppStoreSubscription` 方法，以记录用户订阅购买。 ```js var subscription = new AdjustAppStoreSubscription( @@ -294,16 +275,15 @@ subscription.setSalesRegion(salesRegion); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```ts trackPlayStoreSubscription(adjustPlayStoreSubscription: AdjustPlayStoreSubscription): void ``` - + -Pass your subscription object to the `trackPlayStoreSubscription` method method to record the user's subscription purchase. +将订阅对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 ```js var subscription = new AdjustPlayStoreSubscription( @@ -319,5 +299,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 65bc8181536a3521c7e10b1d68893d38b4989075 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 08:58:44 +0000 Subject: [PATCH 53/75] File src/content/docs/en/sdk/cordova/v5/features/subscriptions.mdx was translated to ja-JP locale --- .../sdk/cordova/v5/features/subscriptions.mdx | 173 ++++++++---------- 1 file changed, 78 insertions(+), 95 deletions(-) diff --git a/src/content/docs/ja/sdk/cordova/v5/features/subscriptions.mdx b/src/content/docs/ja/sdk/cordova/v5/features/subscriptions.mdx index 1068c4232f..657469cae8 100644 --- a/src/content/docs/ja/sdk/cordova/v5/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/cordova/v5/features/subscriptions.mdx @@ -1,45 +1,44 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: ja/sdk/cordova/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ja/sdk/cordova/v4/features/subscriptions +title: "サブスクリプション情報を送信する" +description: "Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。" +slug: "en/sdk/cordova/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/cordova/v4/features/subscriptions" --- + - +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 +App StoreおよびPlay Storeのサブスクリプションを計測し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`AdjustAppStoreSubscription`または`AdjustPlayStoreSubscription`を作成してください。 - +1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} +------------------------------------------------------------------------------- -You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - -To get started, you need to create a subscription object containing details of the subscription purchase. - - - +開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。 + ```ts constructor(price: string, currency: string, transactionId: string) ``` - + -Create an `AdjustAppStoreSubscription` object with the following properties +以下のプロパティを含む`AdjustAppStoreSubscription`オブジェクトを作成します。 -\| Parameter \| Data type \| Description \| -\| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| -\| `price` \| `string` \| The price of the subscription \| -\| `currency` \| `string` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| -\| `transactionId` \| `string` \| Your ID for the transaction \| \| +\|パラメーター \|データタイプ \|説明 \| +\| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| +\| `price` \| `string` \|サブスクリプションの価格 \| +\| `currency` \| `string` \|サブスクリプションの通貨。 [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc)オブジェクトの[`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc)としてフォーマット\| +\| `transactionId` \| `string` \| トランザクションのためのID\| \| ```js var subscription = new AdjustAppStoreSubscription( @@ -50,25 +49,24 @@ var subscription = new AdjustAppStoreSubscription( Adjust.trackAppStoreSubscription(subscription); ``` - - + ```ts constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + -Create an `AdjustPlayStoreSubscription` object with the following properties +以下のプロパティを含む`AdjustPlayStoreSubscription`オブジェクトを作成します。 -| Parameter | Data type | Description | -| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription | -| `sku` | `string` | The ID of the product | -| `orderId` | `string` | Your ID for the transaction | -| `signature` | `string` | The signature of the purchase data | -| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation]() for more information | +| パラメーター | データタイプ | 説明 | +|-----------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------| +| `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())を参照してください | ```js var subscription = new AdjustPlayStoreSubscription( @@ -81,23 +79,20 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. +### 購入データを記録する \{\#record\-the\-purchase\-date\} - - +ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。 + ```ts setTransactionDate(transactionDate: string): void ``` - + -Call the `setTransactionDate` method method on your subscription object to record the timestamp of the subscription. +サブスクリプションオブジェクトで`setTransactionDate`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 ```js var subscription = new AdjustAppStoreSubscription( @@ -110,16 +105,15 @@ subscription.setTransactionDate(transactionDate); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```ts setPurchaseTime(purchaseTime: string): void ``` - + -Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. +サブスクリプションオブジェクトで`setPurchaseTime`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 ```js var subscription = new AdjustPlayStoreSubscription( @@ -133,20 +127,19 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### 購入地域を記録する（iOSのみ） \{\#record\-the\-purchase\-region\-ios\-only\} - + ```ts setSalesRegion(salesRegion: string): void ``` - + -You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. +ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトの`setSalesRegion`メソッドを呼び、国コードを`string`としてパスします。これは、[`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/storekit/storefront)としてフォーマットされる必要があります。 ```js var subscription = new AdjustAppStoreSubscription( @@ -159,18 +152,16 @@ subscription.setSalesRegion(salesRegion); Adjust.trackPlayStoreSubscription(subscription); ``` -### Add callback parameters {#add-callback-parameters} +### コールバックパラメーターを追加する \{\#add\-callback\-parameters\} -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - - - +コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + ```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -187,14 +178,13 @@ subscription.addCallbackParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -210,21 +200,18 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - - -### Add partner parameters {#add-partner-parameters} + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. +### パートナーパラメーターを追加する \{\#add\-partner\-parameters\} - - +パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + ```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -241,14 +228,13 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -264,23 +250,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - + -## 2\. Record subscription information \{\#record\-subscription\-information\} +2\. サブスクリプション情報を記録する \{\#record\-subscription\-information\} +------------------------------------------------------------------ -Once you have set up your subscription object, you can record it using the Adjust SDK. - - - +サブスクリプションオブジェクトを設定したら、Adjust SDKを使用して記録することが可能です。 + ```ts trackAppStoreSubscription(adjustAppStoreSubscription: AdjustAppStoreSubscription): void ``` - + -Pass your subscription object to the `trackAppStoreSubscription` method method to record the user's subscription purchase. +完了したオブジェクトを `trackAppStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 ```js var subscription = new AdjustAppStoreSubscription( @@ -294,16 +278,15 @@ subscription.setSalesRegion(salesRegion); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```ts trackPlayStoreSubscription(adjustPlayStoreSubscription: AdjustPlayStoreSubscription): void ``` - + -Pass your subscription object to the `trackPlayStoreSubscription` method method to record the user's subscription purchase. +完了したオブジェクトを `trackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 ```js var subscription = new AdjustPlayStoreSubscription( @@ -319,5 +302,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From bbb9656563a0fa16edda5e7a406a8ea5d5cdb2ab 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 08:58:46 +0000 Subject: [PATCH 54/75] File src/content/docs/en/sdk/flutter/v4/features/subscriptions.mdx was translated to ko-KR locale --- .../sdk/flutter/v4/features/subscriptions.mdx | 175 ++++++++---------- 1 file changed, 79 insertions(+), 96 deletions(-) diff --git a/src/content/docs/ko/sdk/flutter/v4/features/subscriptions.mdx b/src/content/docs/ko/sdk/flutter/v4/features/subscriptions.mdx index ae12dac97f..de79ef7c19 100644 --- a/src/content/docs/ko/sdk/flutter/v4/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/flutter/v4/features/subscriptions.mdx @@ -1,46 +1,45 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: ko/sdk/flutter/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/flutter/features/subscriptions +title: "구독 정보 전송" +description: "이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다." +slug: "en/sdk/flutter/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/flutter/features/subscriptions" --- + - +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. +앱 스토어 및 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustAppStoreSubscription` 또는 `AdjustPlayStoreSubscription` 인스턴스를 생성하시기 바랍니다. - +1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} +----------------------------------------------------------------- -You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - -To get started, you need to create a subscription object containing details of the subscription purchase. - - - +시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId, String _receipt) ``` - + -Create an `AdjustAppStoreSubscription` object with the following properties: +다음 속성을 포함하는 `AdjustAppStoreSubscription` 객체를 생성합니다. -| Parameter | Data type | Description | -| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `String` | The price of the subscription | -| `currency` | `String` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | -| `transactionId` | `String` | Your ID for the transaction | -| `receipt` | `String` | The receipt information | +| 파라미터 | 데이터 유형 | 설명 | +|-----------------|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `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 | +| `receipt` | `String` | 영수증 정보 | ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -50,25 +49,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - - + ```dart AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken) ``` - + -Create an `AdjustPlayStoreSubscription` object with the following properties: +다음 속성을 포함하는 `AdjustPlayStoreSubscription` 객체를 생성합니다. -| Parameter | Data type | Description | -| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `String` | The price of the subscription | -| `currency` | `String` | The currency of the subscription | -| `sku` | `String` | The ID of the product | -| `orderId` | `String` | Your ID for the transaction | -| `signature` | `String` | The signature of the purchase data | -| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation]() for more information | +| 파라미터 | 데이터 유형 | 설명 | +|-----------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------| +| `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( @@ -80,23 +78,20 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. +### 구매일 기록 \{\#record\-the\-purchase\-date\} - - +사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. + ```dart void setTransactionDate(String _transactionDate) ``` - + -Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. +구독 객체의 `setTransactionDate` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -108,16 +103,15 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - - + ```dart void setPurchaseTime(String purchaseTime) ``` - + -Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. +구독 객체의 `setPurchaseTime` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -130,20 +124,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### 구매 지역 기록\(iOS만 해당\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```dart void setSalesRegion(String _salesRegion) ``` - + -You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `String`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. +사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `String`로 전달합니다. 이는 [`priceLocale`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift)로 포맷되어야 합니다. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -155,18 +148,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters {#add-callback-parameters} +### 콜백 파라미터 추가 \{\#add\-callback\-parameters\} -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - - - +콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -179,14 +170,13 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -201,21 +191,18 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - - -### Add partner parameters {#add-partner-parameters} + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. +### 파트너 파라미터 추가 \{\#add\-partner\-parameters\} - - +Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -228,14 +215,13 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -250,23 +236,21 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + -## 2\. Record subscription information \{\#record\-subscription\-information\} +2\. 구독 정보 기록 \{\#record\-subscription\-information\} +---------------------------------------------------------- -Once you have set up your subscription object, you can record it using the Adjust SDK. - - - +구독 객체를 설정하고 나면 Adjust SDK를 사용하여 기록을 시작할 수 있습니다. + ```dart static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription) ``` - + -Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. +구독 객체를 `trackAppStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -284,16 +268,15 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + -Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. +구독 객체를 `trackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -312,5 +295,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 95f5bd79c93d585c0c4a3c684dcab7f888842bd4 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 08:58:49 +0000 Subject: [PATCH 55/75] File src/content/docs/en/sdk/flutter/v4/features/subscriptions.mdx was translated to zh-CN locale --- .../sdk/flutter/v4/features/subscriptions.mdx | 175 ++++++++---------- 1 file changed, 79 insertions(+), 96 deletions(-) diff --git a/src/content/docs/zh/sdk/flutter/v4/features/subscriptions.mdx b/src/content/docs/zh/sdk/flutter/v4/features/subscriptions.mdx index 38a8d41348..a1ab049dc8 100644 --- a/src/content/docs/zh/sdk/flutter/v4/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/flutter/v4/features/subscriptions.mdx @@ -1,46 +1,45 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: zh/sdk/flutter/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/flutter/features/subscriptions +title: "发送订阅信息" +description: "使用这些方法向 Adjust 发送订阅信息。" +slug: "en/sdk/flutter/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/flutter/features/subscriptions" --- + - +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 + -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 +您可以用 Adjust SDK 记录 App Store 和 Play 应用商店的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `AdjustAppStoreSubscription` 或 `AdjustPlayStoreSubscription` 实例。 - +1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} +------------------------------------------------------------ -You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - -To get started, you need to create a subscription object containing details of the subscription purchase. - - - +要开始设置，先创建一个包含订阅购买细节的订阅对象。 + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId, String _receipt) ``` - + -Create an `AdjustAppStoreSubscription` object with the following properties: +创建一个 `AdjustAppStoreSubscription` 对象，属性如下： -| Parameter | Data type | Description | -| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `String` | The price of the subscription | -| `currency` | `String` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | -| `transactionId` | `String` | Your ID for the transaction | -| `receipt` | `String` | The receipt information | +| 参数 | 数据类型 | 描述 | +|-----------------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `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 | +| `receipt` | `String` | 收据信息 | ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -50,25 +49,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - - + ```dart AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken) ``` - + -Create an `AdjustPlayStoreSubscription` object with the following properties: +创建一个 `AdjustPlayStoreSubscription` 对象，属性如下： -| Parameter | Data type | Description | -| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `String` | The price of the subscription | -| `currency` | `String` | The currency of the subscription | -| `sku` | `String` | The ID of the product | -| `orderId` | `String` | Your ID for the transaction | -| `signature` | `String` | The signature of the purchase data | -| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation]() for more information | +| 参数 | 数据类型 | 描述 | +|-----------------|----------|------------------------------------------------------------------------------------------------------------------------------------| +| `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( @@ -80,23 +78,20 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. +### 记录购买日期\{\#record\-the\-purchase\-date\} - - +您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。 + ```dart void setTransactionDate(String _transactionDate) ``` - + -Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. +在您的订阅对象上调用 `setTransactionDate` 方法来记录订阅的时间戳。 ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -108,16 +103,15 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - - + ```dart void setPurchaseTime(String purchaseTime) ``` - + -Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. +在您的订阅对象上调用 `setPurchaseTime` 方法来记录订阅的时间戳。 ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -130,20 +124,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### 记录购买地区 \(仅限 iOS\)\{\#record\-the\-purchase\-region\-ios\-only\} - + ```dart void setSalesRegion(String _salesRegion) ``` - + -You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `String`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. +您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `String` 传递。此信息格式需为 [`priceLocale`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) 对象的 [`countryCode`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift)。 ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -155,18 +148,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters {#add-callback-parameters} +### 添加回传参数\{\#add\-callback\-parameters\} -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - - - +您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -179,14 +170,13 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -201,21 +191,18 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - - -### Add partner parameters {#add-partner-parameters} + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. +### 添加合作伙伴参数\{\#add\-partner\-parameters\} - - +您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -228,14 +215,13 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -250,23 +236,21 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + -## 2\. Record subscription information \{\#record\-subscription\-information\} +2\. 记录订阅信息\{\#record\-subscription\-information\} +------------------------------------------------------- -Once you have set up your subscription object, you can record it using the Adjust SDK. - - - +设置好订阅对象后，您就可以通过 Adjust SDK 对其进行记录了。 + ```dart static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription) ``` - + -Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. +将订阅对象传送至 `trackAppStoreSubscription` 方法，以记录用户订阅购买。 ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -284,16 +268,15 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + -Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. +将订阅对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -312,5 +295,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 4725be3913d19832b2cd6161f2d0a93f8455392d 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 08:58:51 +0000 Subject: [PATCH 56/75] File src/content/docs/en/sdk/flutter/v4/features/subscriptions.mdx was translated to ja-JP locale --- .../sdk/flutter/v4/features/subscriptions.mdx | 175 ++++++++---------- 1 file changed, 79 insertions(+), 96 deletions(-) diff --git a/src/content/docs/ja/sdk/flutter/v4/features/subscriptions.mdx b/src/content/docs/ja/sdk/flutter/v4/features/subscriptions.mdx index 3f8ea502ee..e83447821e 100644 --- a/src/content/docs/ja/sdk/flutter/v4/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/flutter/v4/features/subscriptions.mdx @@ -1,46 +1,45 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: ja/sdk/flutter/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/flutter/features/subscriptions +title: "サブスクリプション情報を送信する" +description: "Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。" +slug: "en/sdk/flutter/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/flutter/features/subscriptions" --- + - +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 +App StoreおよびPlay Storeのサブスクリプションを計測し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`AdjustAppStoreSubscription`または`AdjustPlayStoreSubscription`を作成してください。 - +1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} +------------------------------------------------------------------------------- -You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - -To get started, you need to create a subscription object containing details of the subscription purchase. - - - +開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。 + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId, String _receipt) ``` - + -Create an `AdjustAppStoreSubscription` object with the following properties: +以下のプロパティを含む`AdjustAppStoreSubscription`オブジェクトを作成します： -| Parameter | Data type | Description | -| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `String` | The price of the subscription | -| `currency` | `String` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | -| `transactionId` | `String` | Your ID for the transaction | -| `receipt` | `String` | The receipt information | +| パラメーター | データタイプ | 説明 | +|-----------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `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 | +| `receipt` | `String` | レシート情報 | ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -50,25 +49,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - - + ```dart AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken) ``` - + -Create an `AdjustPlayStoreSubscription` object with the following properties: +以下のプロパティを含む`AdjustPlayStoreSubscription`オブジェクトを作成します： -| Parameter | Data type | Description | -| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `String` | The price of the subscription | -| `currency` | `String` | The currency of the subscription | -| `sku` | `String` | The ID of the product | -| `orderId` | `String` | Your ID for the transaction | -| `signature` | `String` | The signature of the purchase data | -| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation]() for more information | +| パラメーター | データタイプ | 説明 | +|-----------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------| +| `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( @@ -80,23 +78,20 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. +### 購入データを記録する \{\#record\-the\-purchase\-date\} - - +ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。 + ```dart void setTransactionDate(String _transactionDate) ``` - + -Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. +サブスクリプションオブジェクトで`setTransactionDate`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -108,16 +103,15 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - - + ```dart void setPurchaseTime(String purchaseTime) ``` - + -Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. +サブスクリプションオブジェクトで`setPurchaseTime`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -130,20 +124,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### 購入地域を記録する（iOSのみ） \{\#record\-the\-purchase\-region\-ios\-only\} - + ```dart void setSalesRegion(String _salesRegion) ``` - + -You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `String`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. +ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトの`setSalesRegion`メソッドを呼び、国コードを`String`としてパスします。これは、[`priceLocale`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift)としてフォーマットされる必要があります。 ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -155,18 +148,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters {#add-callback-parameters} +### コールバックパラメーターを追加する \{\#add\-callback\-parameters\} -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - - - +コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -179,14 +170,13 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -201,21 +191,18 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - - -### Add partner parameters {#add-partner-parameters} + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. +### パートナーパラメーターを追加する \{\#add\-partner\-parameters\} - - +パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -228,14 +215,13 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -250,23 +236,21 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + -## 2\. Record subscription information \{\#record\-subscription\-information\} +2\. サブスクリプション情報を記録する \{\#record\-subscription\-information\} +------------------------------------------------------------------ -Once you have set up your subscription object, you can record it using the Adjust SDK. - - - +サブスクリプションオブジェクトを設定したら、Adjust SDKを使用して記録することが可能です。 + ```dart static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription) ``` - + -Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. +完了したオブジェクトを `trackAppStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -284,16 +268,15 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + -Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. +完了したオブジェクトを `trackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -312,5 +295,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 067d271a24cf43c412649eb0011828adc564e728 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 08:58:52 +0000 Subject: [PATCH 57/75] File src/content/docs/en/sdk/flutter/v5/features/subscriptions.mdx was translated to ko-KR locale --- .../sdk/flutter/v5/features/subscriptions.mdx | 180 ++++++++---------- 1 file changed, 79 insertions(+), 101 deletions(-) diff --git a/src/content/docs/ko/sdk/flutter/v5/features/subscriptions.mdx b/src/content/docs/ko/sdk/flutter/v5/features/subscriptions.mdx index ca6ac36cf4..c6b1efe1c0 100644 --- a/src/content/docs/ko/sdk/flutter/v5/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/flutter/v5/features/subscriptions.mdx @@ -1,45 +1,41 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: ko/sdk/flutter/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/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/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. +앱 스토어 및 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustAppStoreSubscription` 또는 `AdjustPlayStoreSubscription` 인스턴스를 생성하시기 바랍니다. - +1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} +----------------------------------------------------------------- -You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - -To get started, you need to create a subscription object containing details of the subscription purchase. - - - +시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId) ``` - + -Create an `AdjustAppStoreSubscription` object with the following properties: +다음 속성을 포함하는 `AdjustAppStoreSubscription` 객체를 생성합니다. -\| Parameter \| Data type \| Description \| -\| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| -\| `price` \| `String` \| The price of the subscription \| -\| `currency` \| `String` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| -\| `transactionId` \| `String` \| Your ID for the transaction \| \| +\| 파라미터 \| 데이터 유형 \| 설명 \| \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| \| `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 \| \| ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -48,25 +44,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - - + ```dart AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken) ``` - + -Create an `AdjustPlayStoreSubscription` object with the following properties: +다음 속성을 포함하는 `AdjustPlayStoreSubscription` 객체를 생성합니다. -| Parameter | Data type | Description | -| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `String` | The price of the subscription | -| `currency` | `String` | The currency of the subscription | -| `sku` | `String` | The ID of the product | -| `orderId` | `String` | Your ID for the transaction | -| `signature` | `String` | The signature of the purchase data | -| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation]() for more information | +| 파라미터 | 데이터 유형 | 설명 | +|-----------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------| +| `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( @@ -78,27 +73,23 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} - -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. + - - +### 구매일 기록 \{\#record\-the\-purchase\-date\} -Add the `transactionDate` property in the `AdjustAppStoreSubscription` class. +사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. + - +`AdjustAppStoreSubscription` 클래스에`transactionDate` 속성을 추가합니다. + ```dart String? transactionDate ``` - + -Set a timestamp to the `transactionDate` property of your `subscription` instance to record the date on which the user purchased a subscription. +`subscription` 인스턴스의 `transactionDate` 속성에 타임스탬프를 설정하면 사용자가 구독을 결제한 날을 기록할 수 있습니다. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -109,20 +100,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.transactionDate = 'transactionDate'; ``` - - + -Add the `purchaseTime` property in the `AdjustPlayStoreSubscription` class. - - +`AdjustPlayStoreSubscription` 클래스에`purchaseTime` 속성을 추가합니다. + ```dart String? purchaseTime; ``` - + -Set a timestamp to the `purchaseTime` property of your `subscription` instance to record the date on which the user purchased a subscription. +`subscription` 인스턴스의 `purchaseTime` 속성에 타임스탬프를 설정하면 사용자가 구독을 결제한 날을 기록할 수 있습니다. ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -135,20 +124,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.purchaseTime = 'purchase-time'; ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### 구매 지역 기록\(iOS만 해당\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```dart String? salesRegion ``` - + -You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `String`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. +사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `String`로 전달합니다. 이는 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront)로 포맷되어야 합니다. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -159,18 +147,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.salesRegion = 'sales-region'; ``` -### Add callback parameters {#add-callback-parameters} - -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. +### 콜백 파라미터 추가 \{\#add\-callback\-parameters\} - - +콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -182,14 +168,13 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -204,21 +189,18 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - - -### Add partner parameters {#add-partner-parameters} + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. +### 파트너 파라미터 추가 \{\#add\-partner\-parameters\} - - +Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -230,14 +212,13 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -252,23 +233,21 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + -## 2\. Record subscription information \{\#record\-subscription\-information\} +2\. 구독 정보 기록 \{\#record\-subscription\-information\} +---------------------------------------------------------- -Once you have set up your subscription object, you can record it using the Adjust SDK. - - - +구독 객체를 설정하고 나면 Adjust SDK를 사용하여 기록을 시작할 수 있습니다. + ```dart static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription) ``` - + -Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. +구독 객체를 `trackAppStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -285,16 +264,15 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + -Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. +구독 객체를 `trackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -313,5 +291,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From c6edb0084ad98b0c2fa4ab497e2d97d0545c892f 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 08:58:55 +0000 Subject: [PATCH 58/75] File src/content/docs/en/sdk/flutter/v5/features/subscriptions.mdx was translated to zh-CN locale --- .../sdk/flutter/v5/features/subscriptions.mdx | 180 ++++++++---------- 1 file changed, 79 insertions(+), 101 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 8620d77c08..abc6018485 100644 --- a/src/content/docs/zh/sdk/flutter/v5/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/flutter/v5/features/subscriptions.mdx @@ -1,45 +1,41 @@ --- -title: Send subscription information -description: Use these methods send subscription information to 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/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 + -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 +您可以用 Adjust SDK 记录 App Store 和 Play 应用商店的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `AdjustAppStoreSubscription` 或 `AdjustPlayStoreSubscription` 实例。 - +1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} +------------------------------------------------------------ -You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - -To get started, you need to create a subscription object containing details of the subscription purchase. - - - +要开始设置，先创建一个包含订阅购买细节的订阅对象。 + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId) ``` - + -Create an `AdjustAppStoreSubscription` object with the following properties: +创建一个 `AdjustAppStoreSubscription` 对象，属性如下： -\| Parameter \| Data type \| Description \| -\| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| -\| `price` \| `String` \| The price of the subscription \| -\| `currency` \| `String` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| -\| `transactionId` \| `String` \| Your ID for the transaction \| \| +\|参数 \|数据类型 \|描述 \| \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| \| `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 \| \| ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -48,25 +44,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - - + ```dart AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken) ``` - + -Create an `AdjustPlayStoreSubscription` object with the following properties: +创建一个 `AdjustPlayStoreSubscription` 对象，属性如下： -| Parameter | Data type | Description | -| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `String` | The price of the subscription | -| `currency` | `String` | The currency of the subscription | -| `sku` | `String` | The ID of the product | -| `orderId` | `String` | Your ID for the transaction | -| `signature` | `String` | The signature of the purchase data | -| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation]() for more information | +| 参数 | 数据类型 | 描述 | +|-----------------|----------|------------------------------------------------------------------------------------------------------------------------------------| +| `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( @@ -78,27 +73,23 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} - -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. + - - +### 记录购买日期\{\#record\-the\-purchase\-date\} -Add the `transactionDate` property in the `AdjustAppStoreSubscription` class. +您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。 + - +在`AdjustAppStoreSubscription`类中添加`transactionDate`属性。 + ```dart String? transactionDate ``` - + -Set a timestamp to the `transactionDate` property of your `subscription` instance to record the date on which the user purchased a subscription. +为`subscription`实例的`transactionDate`属性设置时间戳，记录用户购买订阅的日期。 ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -109,20 +100,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.transactionDate = 'transactionDate'; ``` - - + -Add the `purchaseTime` property in the `AdjustPlayStoreSubscription` class. - - +在`AdjustPlayStoreSubscription`类中添加`purchaseTime`属性。 + ```dart String? purchaseTime; ``` - + -Set a timestamp to the `purchaseTime` property of your `subscription` instance to record the date on which the user purchased a subscription. +为`subscription`实例的`purchaseTime`属性设置时间戳，记录用户购买订阅的日期。 ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -135,20 +124,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.purchaseTime = 'purchase-time'; ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### 记录购买地区 \(仅限 iOS\)\{\#record\-the\-purchase\-region\-ios\-only\} - + ```dart String? salesRegion ``` - + -You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `String`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. +您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `String` 传递。此信息格式需为 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) 对象的 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront)。 ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -159,18 +147,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.salesRegion = 'sales-region'; ``` -### Add callback parameters {#add-callback-parameters} - -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. +### 添加回传参数\{\#add\-callback\-parameters\} - - +您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -182,14 +168,13 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -204,21 +189,18 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - - -### Add partner parameters {#add-partner-parameters} + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. +### 添加合作伙伴参数\{\#add\-partner\-parameters\} - - +您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -230,14 +212,13 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -252,23 +233,21 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + -## 2\. Record subscription information \{\#record\-subscription\-information\} +2\. 记录订阅信息\{\#record\-subscription\-information\} +------------------------------------------------------- -Once you have set up your subscription object, you can record it using the Adjust SDK. - - - +设置好订阅对象后，您就可以通过 Adjust SDK 对其进行记录了。 + ```dart static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription) ``` - + -Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. +将订阅对象传送至 `trackAppStoreSubscription` 方法，以记录用户订阅购买。 ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -285,16 +264,15 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + -Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. +将订阅对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -313,5 +291,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 8083c68d0e1b544e4e9b12d81ed21c7cee4978f4 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 08:58:56 +0000 Subject: [PATCH 59/75] File src/content/docs/en/sdk/flutter/v5/features/subscriptions.mdx was translated to ja-JP locale --- .../sdk/flutter/v5/features/subscriptions.mdx | 183 ++++++++---------- 1 file changed, 82 insertions(+), 101 deletions(-) diff --git a/src/content/docs/ja/sdk/flutter/v5/features/subscriptions.mdx b/src/content/docs/ja/sdk/flutter/v5/features/subscriptions.mdx index d7ac0c88f2..00e5e57daa 100644 --- a/src/content/docs/ja/sdk/flutter/v5/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/flutter/v5/features/subscriptions.mdx @@ -1,45 +1,44 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: ja/sdk/flutter/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ja/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/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 +App StoreおよびPlay Storeのサブスクリプションを計測し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`AdjustAppStoreSubscription`または`AdjustPlayStoreSubscription`を作成してください。 - +1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} +------------------------------------------------------------------------------- -You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - -To get started, you need to create a subscription object containing details of the subscription purchase. - - - +開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。 + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId) ``` - + -Create an `AdjustAppStoreSubscription` object with the following properties: +以下のプロパティを含む`AdjustAppStoreSubscription`オブジェクトを作成します： -\| Parameter \| Data type \| Description \| -\| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| -\| `price` \| `String` \| The price of the subscription \| -\| `currency` \| `String` \| The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object \| -\| `transactionId` \| `String` \| Your ID for the transaction \| \| +\|パラメーター \|データタイプ \|説明 \| +\| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| +\| `price` \| `String` \|サブスクリプションの価格 \| +\| `currency` \| `String` \|サブスクリプションの通貨。 [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc)オブジェクトの[`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc)としてフォーマット\| +\| `transactionId` \| `String` \| トランザクションのためのID\| \| ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -48,25 +47,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - - + ```dart AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken) ``` - + -Create an `AdjustPlayStoreSubscription` object with the following properties: +以下のプロパティを含む`AdjustPlayStoreSubscription`オブジェクトを作成します： -| Parameter | Data type | Description | -| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `String` | The price of the subscription | -| `currency` | `String` | The currency of the subscription | -| `sku` | `String` | The ID of the product | -| `orderId` | `String` | Your ID for the transaction | -| `signature` | `String` | The signature of the purchase data | -| `purchaseToken` | `String` | The unique token of the transaction. See [Google's documentation]() for more information | +| パラメーター | データタイプ | 説明 | +|-----------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------| +| `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( @@ -78,27 +76,23 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} - -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. + - - +### 購入データを記録する \{\#record\-the\-purchase\-date\} -Add the `transactionDate` property in the `AdjustAppStoreSubscription` class. +ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。 + - +`AdjustAppStoreSubscription`クラスに`transactionDate`プロパティを追加します。 + ```dart String? transactionDate ``` - + -Set a timestamp to the `transactionDate` property of your `subscription` instance to record the date on which the user purchased a subscription. +`subscription`インスタンスの`transactionDate`プロパティにタイムスタンプを設定し、ユーザーがサブスクリプションを購入した日を記録します。 ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -109,20 +103,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.transactionDate = 'transactionDate'; ``` - - + -Add the `purchaseTime` property in the `AdjustPlayStoreSubscription` class. - - +`AdjustPlayStoreSubscription`クラスに`purchaseTime`プロパティを追加します。 + ```dart String? purchaseTime; ``` - + -Set a timestamp to the `purchaseTime` property of your `subscription` instance to record the date on which the user purchased a subscription. +`subscription`インスタンスの`purchaseTime`プロパティにタイムスタンプを設定し、ユーザーがサブスクリプションを購入した日を記録します。 ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -135,20 +127,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.purchaseTime = 'purchase-time'; ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### 購入地域を記録する（iOSのみ） \{\#record\-the\-purchase\-region\-ios\-only\} - + ```dart String? salesRegion ``` - + -You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `String`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. +ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトの`setSalesRegion`メソッドを呼び、国コードを`String`としてパスします。これは、[`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/storekit/storefront)としてフォーマットされる必要があります。 ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -159,18 +150,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.salesRegion = 'sales-region'; ``` -### Add callback parameters {#add-callback-parameters} - -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. +### コールバックパラメーターを追加する \{\#add\-callback\-parameters\} - - +コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -182,14 +171,13 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -204,21 +192,18 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - - -### Add partner parameters {#add-partner-parameters} + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. +### パートナーパラメーターを追加する \{\#add\-partner\-parameters\} - - +パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -230,14 +215,13 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -252,23 +236,21 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + -## 2\. Record subscription information \{\#record\-subscription\-information\} +2\. サブスクリプション情報を記録する \{\#record\-subscription\-information\} +------------------------------------------------------------------ -Once you have set up your subscription object, you can record it using the Adjust SDK. - - - +サブスクリプションオブジェクトを設定したら、Adjust SDKを使用して記録することが可能です。 + ```dart static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription) ``` - + -Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. +完了したオブジェクトを `trackAppStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -285,16 +267,15 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + -Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. +完了したオブジェクトを `trackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -313,5 +294,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From b7dfbfe0eea608f47be975aa4d4f455d1f5782be 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 08:58:59 +0000 Subject: [PATCH 60/75] File src/content/docs/en/sdk/ios/v4/features/subscriptions.mdx was translated to ko-KR locale --- .../ko/sdk/ios/v4/features/subscriptions.mdx | 156 ++++++++---------- 1 file changed, 68 insertions(+), 88 deletions(-) diff --git a/src/content/docs/ko/sdk/ios/v4/features/subscriptions.mdx b/src/content/docs/ko/sdk/ios/v4/features/subscriptions.mdx index 177f7f2394..a35ab961cf 100644 --- a/src/content/docs/ko/sdk/ios/v4/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/ios/v4/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: ko/sdk/ios/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/ios/features/subscriptions +title: "구독 정보 전송" +description: "이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다." +slug: "en/sdk/ios/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/ios/features/subscriptions" --- + - +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. +앱 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `ADJSubscription` 인스턴스를 생성하시기 바랍니다. - +1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} +----------------------------------------------------------------- -You can record App Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `ADJSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -31,19 +32,18 @@ You can record App Store subscriptions and verify their validity with the Adjust ``` - + -To get started, you need to create a subscription object containing details of the subscription purchase. To do this, initialize an `ADJSubscription` object using the `initWithPrice` method. Pass the following arguments: +시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. 이 작업을 위해서는 `initWithPrice` 메서드를 사용해 `ADJSubscription` 객체를 초기화합니다. 다음 인수를 전달합니다. -| Parameter | Data type | Description | -| --------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `NSDecimalNumber` | The price of the subscription | -| `currency` | `NSString` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | -| `transactionId` | `NSString` | Your ID for the transaction | -| `receipt` | `NSString` | The receipt information | +| 파라미터 | 데이터 유형 | 설명 | +|-----------------|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `NSDecimalNumber` | 구독료 | +| `currency` | `NSString` | 구독 통화. [`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` | `NSString` | 거래 ID | +| `receipt` | `NSString` | 영수증 정보 | - - + ```swift let subscription = ADJSubscription( @@ -52,8 +52,7 @@ let subscription = ADJSubscription( transactionId: transactionId) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -61,23 +60,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price transactionId:transactionId]; ``` - - + -### Record the purchase date {#record-the-purchase-date} +### 구매일 기록 \{\#record\-the\-purchase\-date\} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setTransactionDate` method with a timestamp to record this information. - - - +사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. 이 정보를 기록할 타임스탬프와 함께 `setTransactionDate` 메서드를 호출합니다. + ```swift let subscription = ADJSubscription( @@ -88,8 +84,7 @@ let subscription = ADJSubscription( subscription.setTransactionDate(transactionDate) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -99,23 +94,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setTransactionDate:transactionDate]; ``` - - + -### Record the purchase region {#record-the-purchase-region} +### 구매 지역 기록 \{\#record\-the\-purchase\-region\} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - - -You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as an `NSString`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. + - - +사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `NSString`로 전달합니다. 이는 [`priceLocale`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift)로 포맷되어야 합니다. + ```swift let subscription = ADJSubscription( @@ -126,8 +118,7 @@ let subscription = ADJSubscription( subscription.setSalesRegion(salesRegion) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -137,23 +128,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setSalesRegion:salesRegion]; ``` - - + -### Add callback parameters {#add-callback-parameters} +### 콜백 파라미터 추가 \{\#add\-callback\-parameters\} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - - - +콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. + ```swift let subscription = ADJSubscription( @@ -165,8 +153,7 @@ subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -177,23 +164,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - - + -### Add partner parameters {#add-partner-parameters} +### 파트너 파라미터 추가 \{\#add\-partner\-parameters\} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - - -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + - - +Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. + ```swift let subscription = ADJSubscription( @@ -205,8 +189,7 @@ subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -217,23 +200,21 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - - + -## 2\. Send subscription information \{\#send\-subscription\-information\} +2\. 구독 정보 전송 \{\#send\-subscription\-information\} +-------------------------------------------------------- - + ```objc + (void)trackSubscription:(nonnull ADJSubscription *)subscription; ``` - + -Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackSubscription` method to record the user's subscription purchase. - - - +구독 객체를 설정하고 나면 Adjust SDK를 사용하여 Adjust에 전송할 수 있습니다. 완료된 객체를 `trackSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. + ```swift let subscription = ADJSubscription( @@ -257,8 +238,7 @@ subscription.addCallbackParameter("key2", value: "value2") Adjust.trackSubscription(subscription) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -278,5 +258,5 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [Adjust trackSubscription:subscription]; ``` - - + + From fcbc9465fc3c20365cf5b60aacf5be201496abad 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 08:59:01 +0000 Subject: [PATCH 61/75] File src/content/docs/en/sdk/ios/v4/features/subscriptions.mdx was translated to zh-CN locale --- .../zh/sdk/ios/v4/features/subscriptions.mdx | 156 ++++++++---------- 1 file changed, 68 insertions(+), 88 deletions(-) diff --git a/src/content/docs/zh/sdk/ios/v4/features/subscriptions.mdx b/src/content/docs/zh/sdk/ios/v4/features/subscriptions.mdx index f6c1b71903..36281d98c3 100644 --- a/src/content/docs/zh/sdk/ios/v4/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/ios/v4/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: zh/sdk/ios/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/ios/features/subscriptions +title: "发送订阅信息" +description: "使用这些方法向 Adjust 发送订阅信息。" +slug: "en/sdk/ios/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/ios/features/subscriptions" --- + - +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 + -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 +您可以用 Adjust SDK 记录 App Store 的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `ADJSubscription` 实例。 - +1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} +------------------------------------------------------------ -You can record App Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `ADJSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -31,19 +32,18 @@ You can record App Store subscriptions and verify their validity with the Adjust ``` - + -To get started, you need to create a subscription object containing details of the subscription purchase. To do this, initialize an `ADJSubscription` object using the `initWithPrice` method. Pass the following arguments: +要开始设置，先创建一个包含订阅购买细节的订阅对象。为此，请使用 `initWithPrice` 方法初始化一个 `ADJSubscription` 对象。传递以下参数： -| Parameter | Data type | Description | -| --------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `NSDecimalNumber` | The price of the subscription | -| `currency` | `NSString` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | -| `transactionId` | `NSString` | Your ID for the transaction | -| `receipt` | `NSString` | The receipt information | +| 参数 | 数据类型 | 描述 | +|-----------------|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `NSDecimalNumber` | 订阅价格 | +| `currency` | `NSString` | 订阅使用的币种。此信息格式为 [`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` | `NSString` | 您的交易 ID | +| `receipt` | `NSString` | 收据信息 | - - + ```swift let subscription = ADJSubscription( @@ -52,8 +52,7 @@ let subscription = ADJSubscription( transactionId: transactionId) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -61,23 +60,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price transactionId:transactionId]; ``` - - + -### Record the purchase date {#record-the-purchase-date} +### 记录购买日期\{\#record\-the\-purchase\-date\} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setTransactionDate` method with a timestamp to record this information. - - - +您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。请使用时间戳调用 `setTransactionDate` 方法，记录该信息。 + ```swift let subscription = ADJSubscription( @@ -88,8 +84,7 @@ let subscription = ADJSubscription( subscription.setTransactionDate(transactionDate) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -99,23 +94,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setTransactionDate:transactionDate]; ``` - - + -### Record the purchase region {#record-the-purchase-region} +### 记录购买地区\{\#record\-the\-purchase\-region\} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - - -You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as an `NSString`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. + - - +您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `NSString` 传递。此信息格式需为 [`priceLocale`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) 对象的 [`countryCode`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift)。 + ```swift let subscription = ADJSubscription( @@ -126,8 +118,7 @@ let subscription = ADJSubscription( subscription.setSalesRegion(salesRegion) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -137,23 +128,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setSalesRegion:salesRegion]; ``` - - + -### Add callback parameters {#add-callback-parameters} +### 添加回传参数\{\#add\-callback\-parameters\} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - - - +您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 + ```swift let subscription = ADJSubscription( @@ -165,8 +153,7 @@ subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -177,23 +164,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - - + -### Add partner parameters {#add-partner-parameters} +### 添加合作伙伴参数\{\#add\-partner\-parameters\} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - - -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + - - +您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 + ```swift let subscription = ADJSubscription( @@ -205,8 +189,7 @@ subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -217,23 +200,21 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - - + -## 2\. Send subscription information \{\#send\-subscription\-information\} +2\. 发送订阅信息 \{\#send\-subscription\-information\} +------------------------------------------------------ - + ```objc + (void)trackSubscription:(nonnull ADJSubscription *)subscription; ``` - + -Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackSubscription` method to record the user's subscription purchase. - - - +设置好订阅对象后，您就可以使用 Adjust SDK 将其发送给 Adjust 了。将已完成对象传送至 `trackSubscription` 方法，以记录用户订阅购买。 + ```swift let subscription = ADJSubscription( @@ -257,8 +238,7 @@ subscription.addCallbackParameter("key2", value: "value2") Adjust.trackSubscription(subscription) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -278,5 +258,5 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [Adjust trackSubscription:subscription]; ``` - - + + From ce719753cf5476cb6ae2b3c453faf563db18b400 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 08:59:04 +0000 Subject: [PATCH 62/75] File src/content/docs/en/sdk/ios/v4/features/subscriptions.mdx was translated to ja-JP locale --- .../ja/sdk/ios/v4/features/subscriptions.mdx | 156 ++++++++---------- 1 file changed, 68 insertions(+), 88 deletions(-) diff --git a/src/content/docs/ja/sdk/ios/v4/features/subscriptions.mdx b/src/content/docs/ja/sdk/ios/v4/features/subscriptions.mdx index b638f26e09..1e79ff9c36 100644 --- a/src/content/docs/ja/sdk/ios/v4/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/ios/v4/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: ja/sdk/ios/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/ios/features/subscriptions +title: "サブスクリプション情報を送信する" +description: "Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。" +slug: "en/sdk/ios/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/ios/features/subscriptions" --- + - +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 +App Storeのサブスクリプションを記録し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`ADJSubscription`インスタンスを作成します。 - +1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} +------------------------------------------------------------------------------- -You can record App Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `ADJSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -31,19 +32,18 @@ You can record App Store subscriptions and verify their validity with the Adjust ``` - + -To get started, you need to create a subscription object containing details of the subscription purchase. To do this, initialize an `ADJSubscription` object using the `initWithPrice` method. Pass the following arguments: +開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。これを行うには、`initWithPrice`メソッドを使用して`ADJSubscription`オブジェクトを初期化します。さらに、以下の引数をパスします。 -| Parameter | Data type | Description | -| --------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `NSDecimalNumber` | The price of the subscription | -| `currency` | `NSString` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | -| `transactionId` | `NSString` | Your ID for the transaction | -| `receipt` | `NSString` | The receipt information | +| パラメーター | データタイプ | 説明 | +|-----------------|-------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `NSDecimalNumber` | サブスクリプションの価格 | +| `currency` | `NSString` | サブスクリプションの通貨。[`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` | `NSString` | トランザクションID | +| `receipt` | `NSString` | レシート情報 | - - + ```swift let subscription = ADJSubscription( @@ -52,8 +52,7 @@ let subscription = ADJSubscription( transactionId: transactionId) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -61,23 +60,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price transactionId:transactionId]; ``` - - + -### Record the purchase date {#record-the-purchase-date} +### 購入データを記録する \{\#record\-the\-purchase\-date\} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setTransactionDate` method with a timestamp to record this information. - - - +ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。タイムスタンプを使用して`setTransactionDate`メソッドを呼び出し、この情報を記録します。 + ```swift let subscription = ADJSubscription( @@ -88,8 +84,7 @@ let subscription = ADJSubscription( subscription.setTransactionDate(transactionDate) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -99,23 +94,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setTransactionDate:transactionDate]; ``` - - + -### Record the purchase region {#record-the-purchase-region} +### 購入地域を記録する \{\#record\-the\-purchase\-region\} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - - -You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as an `NSString`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. + - - +ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトの`setSalesRegion`メソッドを呼び、国コードを`NSString`としてパスします。これは、[`priceLocale`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift)としてフォーマットされる必要があります。 + ```swift let subscription = ADJSubscription( @@ -126,8 +118,7 @@ let subscription = ADJSubscription( subscription.setSalesRegion(salesRegion) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -137,23 +128,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setSalesRegion:salesRegion]; ``` - - + -### Add callback parameters {#add-callback-parameters} +### コールバックパラメーターを追加する \{\#add\-callback\-parameters\} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - - - +コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + ```swift let subscription = ADJSubscription( @@ -165,8 +153,7 @@ subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -177,23 +164,20 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - - + -### Add partner parameters {#add-partner-parameters} +### パートナーパラメーターを追加する \{\#add\-partner\-parameters\} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - - -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + - - +パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + ```swift let subscription = ADJSubscription( @@ -205,8 +189,7 @@ subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -217,23 +200,21 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - - + -## 2\. Send subscription information \{\#send\-subscription\-information\} +2\. サブスクリプション情報を送信する \{\#send\-subscription\-information\} +---------------------------------------------------------------- - + ```objc + (void)trackSubscription:(nonnull ADJSubscription *)subscription; ``` - + -Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackSubscription` method to record the user's subscription purchase. - - - +サブスクリプションオブジェクトを設定したら、Adjust SDKを使用してそれをAdjustに送信できます。完了したオブジェクトを `trackSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 + ```swift let subscription = ADJSubscription( @@ -257,8 +238,7 @@ subscription.addCallbackParameter("key2", value: "value2") Adjust.trackSubscription(subscription) ``` - - + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -278,5 +258,5 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [Adjust trackSubscription:subscription]; ``` - - + + From 4384c6a9e886cc3fca67c55012581a6f7fd5bfbc 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 08:59:06 +0000 Subject: [PATCH 63/75] File src/content/docs/en/sdk/ios/v5/features/subscriptions.mdx was translated to ko-KR locale --- .../ko/sdk/ios/v5/features/subscriptions.mdx | 154 ++++++++---------- 1 file changed, 67 insertions(+), 87 deletions(-) diff --git a/src/content/docs/ko/sdk/ios/v5/features/subscriptions.mdx b/src/content/docs/ko/sdk/ios/v5/features/subscriptions.mdx index 2c6be8b326..4255422464 100644 --- a/src/content/docs/ko/sdk/ios/v5/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/ios/v5/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: ko/sdk/ios/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/sdk/ios/v4/features/subscriptions +title: "구독 정보 전송" +description: "이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다." +slug: "en/sdk/ios/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/ko/sdk/ios/v4/features/subscriptions" --- + - +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. +앱 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `ADJAppStoreSubscription` 인스턴스를 생성하시기 바랍니다. - +1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} +----------------------------------------------------------------- -You can record App Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `ADJAppStoreSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -30,18 +31,17 @@ You can record App Store subscriptions and verify their validity with the Adjust transactionId:(nonnull NSString *)transactionId; ``` - + -To get started, you need to create a subscription object containing details of the subscription purchase. To do this, initialize an `ADJAppStoreSubscription` object using the `initWithPrice` method. Pass the following arguments: +시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. 이 작업을 위해서는 `initWithPrice` 메서드를 사용해 `ADJAppStoreSubscription` 객체를 초기화합니다. 다음 인수를 전달합니다. -| Parameter | Data type | Description | -| --------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `NSDecimalNumber` | The price of the subscription | -| `currency` | `NSString` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | -| `transactionId` | `NSString` | Your ID for the transaction | +| 파라미터 | 데이터 유형 | 설명 | +|-----------------|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `NSDecimalNumber` | 구독료 | +| `currency` | `NSString` | 구독 통화. [`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` | `NSString` | 거래 ID | - - + ```swift let subscription = ADJAppStoreSubscription( @@ -50,8 +50,7 @@ let subscription = ADJAppStoreSubscription( transactionId: transactionId ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -59,23 +58,20 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit transactionId:transactionId]; ``` - - + -### Record the purchase date {#record-the-purchase-date} +### 구매일 기록 \{\#record\-the\-purchase\-date\} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setTransactionDate` method with a timestamp to record this information. - - - +사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. 이 정보를 기록할 타임스탬프와 함께 `setTransactionDate` 메서드를 호출합니다. + ```swift guard let subscription = ADJAppStoreSubscription( @@ -86,8 +82,7 @@ guard let subscription = ADJAppStoreSubscription( subscription.setTransactionDate(transactionDate) ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -97,23 +92,20 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setTransactionDate:transactionDate]; ``` - - + -### Record the purchase region {#record-the-purchase-region} +### 구매 지역 기록 \{\#record\-the\-purchase\-region\} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - - -You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as an `NSString`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. + - - +사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `NSString`로 전달합니다. 이는 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront)로 포맷되어야 합니다. + ```swift guard let subscription = ADJAppStoreSubscription( @@ -124,8 +116,7 @@ guard let subscription = ADJAppStoreSubscription( subscription.setSalesRegion(salesRegion) ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -135,23 +126,20 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setSalesRegion:salesRegion]; ``` - - + -### Add callback parameters {#add-callback-parameters} +### 콜백 파라미터 추가 \{\#add\-callback\-parameters\} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - - - +콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. + ```swift guard let subscription = ADJAppStoreSubscription( @@ -163,8 +151,7 @@ subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -175,23 +162,20 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - - + -### Add partner parameters {#add-partner-parameters} +### 파트너 파라미터 추가 \{\#add\-partner\-parameters\} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - - -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + - - +Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. + ```swift guard let subscription = ADJAppStoreSubscription( @@ -203,8 +187,7 @@ subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -215,23 +198,21 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - - + -## 2\. Send subscription information \{\#send\-subscription\-information\} +2\. 구독 정보 전송 \{\#send\-subscription\-information\} +-------------------------------------------------------- - + ```objc + (void)trackAppStoreSubscription:(nonnull ADJAppStoreSubscription *)subscription; ``` - + -Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackAppStoreSubscription` method to record the user's subscription purchase. - - - +구독 객체를 설정하고 나면 Adjust SDK를 사용하여 Adjust에 전송할 수 있습니다. 완료된 객체를 `trackAppStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. + ```swift guard let subscription = ADJAppStoreSubscription( @@ -253,8 +234,7 @@ subscription.addCallbackParameter("key2", value: "value2") Adjust.trackAppStoreSubscription(subscription) ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -274,5 +254,5 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [Adjust trackAppStoreSubscription:subscription]; ``` - - + + From f49f9aa163f55787f01aa5e55f7bf78fa141bbee 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 08:59:08 +0000 Subject: [PATCH 64/75] File src/content/docs/en/sdk/ios/v5/features/subscriptions.mdx was translated to zh-CN locale --- .../zh/sdk/ios/v5/features/subscriptions.mdx | 154 ++++++++---------- 1 file changed, 67 insertions(+), 87 deletions(-) diff --git a/src/content/docs/zh/sdk/ios/v5/features/subscriptions.mdx b/src/content/docs/zh/sdk/ios/v5/features/subscriptions.mdx index 1d80bbf0e5..415ad78bac 100644 --- a/src/content/docs/zh/sdk/ios/v5/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/ios/v5/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: zh/sdk/ios/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /zh/sdk/ios/v4/features/subscriptions +title: "发送订阅信息" +description: "使用这些方法向 Adjust 发送订阅信息。" +slug: "en/sdk/ios/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/ios/v4/features/subscriptions" --- + - +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 + -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 +您可以用 Adjust SDK 记录 App Store 的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `ADJAppStoreSubscription` 实例。 - +1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} +------------------------------------------------------------ -You can record App Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `ADJAppStoreSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -30,18 +31,17 @@ You can record App Store subscriptions and verify their validity with the Adjust transactionId:(nonnull NSString *)transactionId; ``` - + -To get started, you need to create a subscription object containing details of the subscription purchase. To do this, initialize an `ADJAppStoreSubscription` object using the `initWithPrice` method. Pass the following arguments: +要开始设置，先创建一个包含订阅购买细节的订阅对象。为此，请使用 `initWithPrice` 方法初始化一个 `ADJAppStoreSubscription` 对象。传递以下参数： -| Parameter | Data type | Description | -| --------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `NSDecimalNumber` | The price of the subscription | -| `currency` | `NSString` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | -| `transactionId` | `NSString` | Your ID for the transaction | +| 参数 | 数据类型 | 描述 | +|-----------------|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `NSDecimalNumber` | 订阅价格 | +| `currency` | `NSString` | 订阅使用的币种。此信息格式为 [`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` | `NSString` | 您的交易 ID | - - + ```swift let subscription = ADJAppStoreSubscription( @@ -50,8 +50,7 @@ let subscription = ADJAppStoreSubscription( transactionId: transactionId ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -59,23 +58,20 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit transactionId:transactionId]; ``` - - + -### Record the purchase date {#record-the-purchase-date} +### 记录购买日期\{\#record\-the\-purchase\-date\} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setTransactionDate` method with a timestamp to record this information. - - - +您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。请使用时间戳调用 `setTransactionDate` 方法，记录该信息。 + ```swift guard let subscription = ADJAppStoreSubscription( @@ -86,8 +82,7 @@ guard let subscription = ADJAppStoreSubscription( subscription.setTransactionDate(transactionDate) ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -97,23 +92,20 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setTransactionDate:transactionDate]; ``` - - + -### Record the purchase region {#record-the-purchase-region} +### 记录购买地区\{\#record\-the\-purchase\-region\} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - - -You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as an `NSString`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. + - - +您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `NSString` 传递。此信息格式需为 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) 对象的 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront)。 + ```swift guard let subscription = ADJAppStoreSubscription( @@ -124,8 +116,7 @@ guard let subscription = ADJAppStoreSubscription( subscription.setSalesRegion(salesRegion) ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -135,23 +126,20 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setSalesRegion:salesRegion]; ``` - - + -### Add callback parameters {#add-callback-parameters} +### 添加回传参数\{\#add\-callback\-parameters\} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - - - +您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 + ```swift guard let subscription = ADJAppStoreSubscription( @@ -163,8 +151,7 @@ subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -175,23 +162,20 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - - + -### Add partner parameters {#add-partner-parameters} +### 添加合作伙伴参数\{\#add\-partner\-parameters\} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - - -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + - - +您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 + ```swift guard let subscription = ADJAppStoreSubscription( @@ -203,8 +187,7 @@ subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -215,23 +198,21 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - - + -## 2\. Send subscription information \{\#send\-subscription\-information\} +2\. 发送订阅信息 \{\#send\-subscription\-information\} +------------------------------------------------------ - + ```objc + (void)trackAppStoreSubscription:(nonnull ADJAppStoreSubscription *)subscription; ``` - + -Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackAppStoreSubscription` method to record the user's subscription purchase. - - - +设置好订阅对象后，您就可以使用 Adjust SDK 将其发送给 Adjust 了。将已完成对象传送至 `trackAppStoreSubscription` 方法，以记录用户订阅购买。 + ```swift guard let subscription = ADJAppStoreSubscription( @@ -253,8 +234,7 @@ subscription.addCallbackParameter("key2", value: "value2") Adjust.trackAppStoreSubscription(subscription) ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -274,5 +254,5 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [Adjust trackAppStoreSubscription:subscription]; ``` - - + + From 091d52bcb45062ea32e677c189fb20596b59ad2b 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 08:59:10 +0000 Subject: [PATCH 65/75] File src/content/docs/en/sdk/ios/v5/features/subscriptions.mdx was translated to ja-JP locale --- .../ja/sdk/ios/v5/features/subscriptions.mdx | 154 ++++++++---------- 1 file changed, 67 insertions(+), 87 deletions(-) diff --git a/src/content/docs/ja/sdk/ios/v5/features/subscriptions.mdx b/src/content/docs/ja/sdk/ios/v5/features/subscriptions.mdx index 2534aaa25a..06110a6c5d 100644 --- a/src/content/docs/ja/sdk/ios/v5/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/ios/v5/features/subscriptions.mdx @@ -1,28 +1,29 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: ja/sdk/ios/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ja/sdk/ios/v4/features/subscriptions +title: "サブスクリプション情報を送信する" +description: "Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。" +slug: "en/sdk/ios/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/ios/v4/features/subscriptions" --- + - +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 +App Storeのサブスクリプションを記録し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`ADJAppStoreSubscription`インスタンスを作成します。 - +1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} +------------------------------------------------------------------------------- -You can record App Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `ADJAppStoreSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -30,18 +31,17 @@ You can record App Store subscriptions and verify their validity with the Adjust transactionId:(nonnull NSString *)transactionId; ``` - + -To get started, you need to create a subscription object containing details of the subscription purchase. To do this, initialize an `ADJAppStoreSubscription` object using the `initWithPrice` method. Pass the following arguments: +開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。これを行うには、`initWithPrice`メソッドを使用して`ADJAppStoreSubscription`オブジェクトを初期化します。さらに、以下の引数をパスします。 -| Parameter | Data type | Description | -| --------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `NSDecimalNumber` | The price of the subscription | -| `currency` | `NSString` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | -| `transactionId` | `NSString` | Your ID for the transaction | +| パラメーター | データタイプ | 説明 | +|-----------------|-------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `NSDecimalNumber` | サブスクリプションの価格 | +| `currency` | `NSString` | サブスクリプションの通貨。[`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` | `NSString` | トランザクションID | - - + ```swift let subscription = ADJAppStoreSubscription( @@ -50,8 +50,7 @@ let subscription = ADJAppStoreSubscription( transactionId: transactionId ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -59,23 +58,20 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit transactionId:transactionId]; ``` - - + -### Record the purchase date {#record-the-purchase-date} +### 購入データを記録する \{\#record\-the\-purchase\-date\} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. Call the `setTransactionDate` method with a timestamp to record this information. - - - +ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。タイムスタンプを使用して`setTransactionDate`メソッドを呼び出し、この情報を記録します。 + ```swift guard let subscription = ADJAppStoreSubscription( @@ -86,8 +82,7 @@ guard let subscription = ADJAppStoreSubscription( subscription.setTransactionDate(transactionDate) ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -97,23 +92,20 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setTransactionDate:transactionDate]; ``` - - + -### Record the purchase region {#record-the-purchase-region} +### 購入地域を記録する \{\#record\-the\-purchase\-region\} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - - -You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as an `NSString`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. + - - +ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトの`setSalesRegion`メソッドを呼び、国コードを`NSString`としてパスします。これは、[`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/storekit/storefront)としてフォーマットされる必要があります。 + ```swift guard let subscription = ADJAppStoreSubscription( @@ -124,8 +116,7 @@ guard let subscription = ADJAppStoreSubscription( subscription.setSalesRegion(salesRegion) ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -135,23 +126,20 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setSalesRegion:salesRegion]; ``` - - + -### Add callback parameters {#add-callback-parameters} +### コールバックパラメーターを追加する \{\#add\-callback\-parameters\} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - - - +コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + ```swift guard let subscription = ADJAppStoreSubscription( @@ -163,8 +151,7 @@ subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -175,23 +162,20 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - - + -### Add partner parameters {#add-partner-parameters} +### パートナーパラメーターを追加する \{\#add\-partner\-parameters\} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - - -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. + - - +パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + ```swift guard let subscription = ADJAppStoreSubscription( @@ -203,8 +187,7 @@ subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -215,23 +198,21 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - - + -## 2\. Send subscription information \{\#send\-subscription\-information\} +2\. サブスクリプション情報を送信する \{\#send\-subscription\-information\} +---------------------------------------------------------------- - + ```objc + (void)trackAppStoreSubscription:(nonnull ADJAppStoreSubscription *)subscription; ``` - + -Once you have set up your subscription object, you can send it to Adjust using the Adjust SDK. Pass your completed object to the `trackAppStoreSubscription` method to record the user's subscription purchase. - - - +サブスクリプションオブジェクトを設定したら、Adjust SDKを使用してそれをAdjustに送信できます。完了したオブジェクトを `trackAppStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 + ```swift guard let subscription = ADJAppStoreSubscription( @@ -253,8 +234,7 @@ subscription.addCallbackParameter("key2", value: "value2") Adjust.trackAppStoreSubscription(subscription) ``` - - + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -274,5 +254,5 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [Adjust trackAppStoreSubscription:subscription]; ``` - - + + From 3fb1878aa56e2b9bf21241474a60158bd7d5d7d5 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 08:59:12 +0000 Subject: [PATCH 66/75] File src/content/docs/en/sdk/testing/subscription-recording.mdx was translated to ko-KR locale --- .../ko/sdk/testing/subscription-recording.mdx | 63 +++++++++---------- 1 file changed, 30 insertions(+), 33 deletions(-) diff --git a/src/content/docs/ko/sdk/testing/subscription-recording.mdx b/src/content/docs/ko/sdk/testing/subscription-recording.mdx index 49757ae393..8c0fa3d61a 100644 --- a/src/content/docs/ko/sdk/testing/subscription-recording.mdx +++ b/src/content/docs/ko/sdk/testing/subscription-recording.mdx @@ -1,46 +1,43 @@ --- -title: Test subscription recording -description: Test that the Adjust SDK is sending subscription information to Adjust -slug: ko/sdk/testing/subscription-recording -sidebar-label: Subscription recording +title: "구독 기록 테스트" +description: "Adjust SDK가 Adjust로 구독 정보를 전송하는지 테스트" +slug: "en/sdk/testing/subscription-recording" +sidebar-label: "구독 기록" sidebar-position: 3 --- +Adjust SDK를 사용하면 유료 구독 정보를 기록할 수 있습니다. + -You can use the Adjust SDK to record information about subscription purchases in your app. +테스트가 완료되면 SDK 환경을 반드시 **Production** 으로 변경하여, 앱이 프로덕션 모드에서 작동하도록 하시기 바랍니다. + - +SDK는 다음의 툴을 통해 테스트할 수 있습니다. -Make sure to set your SDK environment to **Production** after you finish testing. This ensures your app works in production mode. +* Adjust 테스팅 콘솔은 [AppView](https://help.adjust.com/en/article/testing-console)에서 사용 가능합니다. +* [Adjust 디바이스 API](/en/api/device-api/inspect). +* IDE의 로그 아웃풋. - +테스트 방법: -Use these tools to test the SDK: +1. 플랫폼별 Adjust SDK 연동 가이드를 참조하여 연동을 완료합니다. +2. **샌드박스** 모드로 환경을 설정하여, 앱이 테스트용 콘솔로만 정보를 전송하도록 합니다. +3. 로그 레벨을 **verbose** 로 설정하여 앱으로부터의 모든 로깅 정보를 포착합니다. +4. 테스트용 기기 또는 에뮬레이션 기기를 설정한 뒤 기기의 광고 ID를 찾습니다. 광고 ID는 [Adjust Insights 앱](https://apps.apple.com/us/app/adjust-insights/id1125517808)을 설치하여 찾을 수 있습니다. +5. 이전에 테스트 목적으로 해당 기기를 사용한 적이 있다면 다음을 수행하시기 바랍니다. + 1. 테스트용 기기에서 앱을 삭제합니다. + 2. 테스팅 콘솔에서 기기의 광고 ID를 삭제합니다. [AppView의 테스팅 콘솔 페이지](https://help.adjust.com/en/article/testing-console#forget-device)의 지침을 참고하시기 바랍니다. + 3. 대안으로, [forget device 엔드포인트](/en/api/device-api/forget/)를 호출하여 기기의 기존 정보를 삭제할 수도 있습니다. -- The Adjust testing console, available in [AppView](https://help.adjust.com/ko/article/testing-console). -- The [Adjust Device API](/ko/api/device-api/inspect). -- Your IDE's log output. +6. Adjust SDK가 포함된 앱의 테스트 버전을 다운로드하고, 실행합니다. +7. 테스트용 구매를 트리거합니다. +8. 테스팅 콘솔을 실행한 후, 기기의 광고 ID 상태를 확인합니다. -To test that this is working: +구독이 성공적으로 기록되었다면, 콘솔 아웃풋의 다음 영역에 정보가 입력됩니다. -1. Follow the integration guide for your platform to integrate the Adjust SDK. -2. Set the environment to **sandbox** . This ensures that your app only sends information to the testing console. -3. Set your log level to **verbose** to capture all logging information from your app. -4. Set up a test device or an emulated device and find the device's advertising ID. You can install the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808) to find this information. -5. If you've previously used the device for testing: +* **LastSubscriptionEventType** +* [**마지막 구독 이벤트 하위 유형**](https://help.adjust.com/en/article/manage-subscription-data#subscription-event-subtypes) +* **LastSubscriptionEventTimestamp** +* **제품 ID** - 1. Delete your app from the test device. - 2. Clear the device's advertising ID from the testing console. Follow the instructions for the [Testing console in AppView](https://help.adjust.com/ko/article/testing-console#forget-device). - 3. Alternatively, call the [forget device endpoint](/ko/api/device-api/forget/) to remove existing information about the device. +![Adjust 테스팅 콘솔](@images/sdk-testing/subscription/testing-console.png) -6. Download and open the test version of your app that contains the Adjust SDK. -7. Trigger a test purchase. -8. Open the testing console and check the device's advertising ID status. - -If the subscription is recorded successfully, the following fields are populated in the console output: - -- **Last Subscription Event Type** -- [**Last Subscription Event Subtype**](https://help.adjust.com/ko/article/manage-subscription-data#subscription-event-subtypes) -- **Last Subscription Event Timestamp** -- **Product ID** - -![The Adjust testing console](@images/sdk-testing/subscription/testing-console.png) From 57f38cdf38c981dd9484f02a1033c507d0ea4e4a 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 08:59:14 +0000 Subject: [PATCH 67/75] File src/content/docs/en/sdk/testing/subscription-recording.mdx was translated to zh-CN locale --- .../zh/sdk/testing/subscription-recording.mdx | 63 +++++++++---------- 1 file changed, 30 insertions(+), 33 deletions(-) diff --git a/src/content/docs/zh/sdk/testing/subscription-recording.mdx b/src/content/docs/zh/sdk/testing/subscription-recording.mdx index dd65cb32a5..940e24d2ab 100644 --- a/src/content/docs/zh/sdk/testing/subscription-recording.mdx +++ b/src/content/docs/zh/sdk/testing/subscription-recording.mdx @@ -1,46 +1,43 @@ --- -title: Test subscription recording -description: Test that the Adjust SDK is sending subscription information to Adjust -slug: zh/sdk/testing/subscription-recording -sidebar-label: Subscription recording +title: "测试订阅记录" +description: "测试 Adjust SDK 是否正在向 Adjust 发送订阅信息" +slug: "en/sdk/testing/subscription-recording" +sidebar-label: "订阅记录" sidebar-position: 3 --- +您可以通过 Adjust SDK 来记录应用内订阅购买的相关信息。 + -You can use the Adjust SDK to record information about subscription purchases in your app. +完成测试后请确保将 SDK 环境设置为 **Production** 。这请确保应用在生产环境中正常运行。 + - +使用这些工具测试 SDK： -Make sure to set your SDK environment to **Production** after you finish testing. This ensures your app works in production mode. +* 位于[AppView](https://help.adjust.com/en/article/testing-console)中的测试控制台。 +* [Adjust 设备 API](/en/api/device-api/inspect)。 +* 您的 IDE 日志输出。 - +要测试此功能是否正常运转： -Use these tools to test the SDK: +1. 按照对应平台的集成指南来集成 Adjust SDK。 +2. 将环境设为 **Sandbox** 。这能保证您的应用只向测试控制台发送信息。 +3. 将日志级别设为 **verbose** 来抓取来自应用的全部记录信息。 +4. 设置一台测试设备或模拟设备，找到设备的广告 ID。您可以安装 [Adjust Insights 应用](https://apps.apple.com/us/app/adjust-insights/id1125517808)来找到此信息。 +5. 如果您此前曾使用此设备进行测试： + 1. 从测试设备中删除您的应用。 + 2. 在测试控制台中清除设备的广告 ID。请按照[AppView 中的测试控制台](https://help.adjust.com/en/article/testing-console#forget-device)中的说明进行操作。 + 3. 另外，还可以调用[遗忘设备终端](/en/api/device-api/forget/)来移除已有设备信息。 -- The Adjust testing console, available in [AppView](https://help.adjust.com/zh/article/testing-console). -- The [Adjust Device API](/zh/api/device-api/inspect). -- Your IDE's log output. +6. 下载并打开包含 Adjust SDK 的测试版本应用。 +7. 触发一次购买作为测试。 +8. 打开测试控制台，查看设备的广告 ID 状态。 -To test that this is working: +如果订阅已被成功记录，那么控制台输出中以下字段会被填充： -1. Follow the integration guide for your platform to integrate the Adjust SDK. -2. Set the environment to **sandbox** . This ensures that your app only sends information to the testing console. -3. Set your log level to **verbose** to capture all logging information from your app. -4. Set up a test device or an emulated device and find the device's advertising ID. You can install the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808) to find this information. -5. If you've previously used the device for testing: +* **最后订阅事件类型** +* [**最后订阅事件子类型**](https://help.adjust.com/en/article/manage-subscription-data#subscription-event-subtypes) +* **LastSubscriptionEventTimestamp** +* **产品 ID** - 1. Delete your app from the test device. - 2. Clear the device's advertising ID from the testing console. Follow the instructions for the [Testing console in AppView](https://help.adjust.com/zh/article/testing-console#forget-device). - 3. Alternatively, call the [forget device endpoint](/zh/api/device-api/forget/) to remove existing information about the device. +![Adjust 测试控制台](@images/sdk-testing/subscription/testing-console.png) -6. Download and open the test version of your app that contains the Adjust SDK. -7. Trigger a test purchase. -8. Open the testing console and check the device's advertising ID status. - -If the subscription is recorded successfully, the following fields are populated in the console output: - -- **Last Subscription Event Type** -- [**Last Subscription Event Subtype**](https://help.adjust.com/zh/article/manage-subscription-data#subscription-event-subtypes) -- **Last Subscription Event Timestamp** -- **Product ID** - -![The Adjust testing console](@images/sdk-testing/subscription/testing-console.png) From 85fc1639e663a4bf09af622d1e90aa72cd0ede1e 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 08:59:16 +0000 Subject: [PATCH 68/75] File src/content/docs/en/sdk/testing/subscription-recording.mdx was translated to ja-JP locale --- .../ja/sdk/testing/subscription-recording.mdx | 63 +++++++++---------- 1 file changed, 30 insertions(+), 33 deletions(-) diff --git a/src/content/docs/ja/sdk/testing/subscription-recording.mdx b/src/content/docs/ja/sdk/testing/subscription-recording.mdx index 121e550c89..e54c2542d1 100644 --- a/src/content/docs/ja/sdk/testing/subscription-recording.mdx +++ b/src/content/docs/ja/sdk/testing/subscription-recording.mdx @@ -1,46 +1,43 @@ --- -title: Test subscription recording -description: Test that the Adjust SDK is sending subscription information to Adjust -slug: ja/sdk/testing/subscription-recording -sidebar-label: Subscription recording +title: "サブスクリプション記録のテスト" +description: "Adjust SDKがAdjustにサブスクリプション情報を送信していることをテストする" +slug: "en/sdk/testing/subscription-recording" +sidebar-label: "サブスクリプション計測" sidebar-position: 3 --- +Adjust SDKを使用して、アプリ内でのサブスクリプション購入に関する情報を記録できます。 + -You can use the Adjust SDK to record information about subscription purchases in your app. +テストが終了したら、SDK環境を **本番用** に設定してください。これにより、アプリが本番用モードで動作します。 + - +SDKのテストには以下のツールを使用できます。 -Make sure to set your SDK environment to **Production** after you finish testing. This ensures your app works in production mode. +* Adjustテストコンソール（[AppView](https://help.adjust.com/en/article/testing-console)でご利用可能）。 +* [AdjustデバイスAPI](/en/api/device-api/inspect) +* IDEのログアウトプット - +これが機能していることをテストするには、以下の手順に従ってください。 -Use these tools to test the SDK: +1. お使いのプラットフォーム向けの連携ガイドに従って、Adjust SDKを連携します。 +2. 環境を **サンドボックス** に設定します。これにより、アプリからはテストコンソールにのみ情報が送信されるようになります。 +3. アプリから全てのログ情報を取得するために、ログレベルを **verbose** に設定します。 +4. テストデバイスまたはエミュレートされたデバイスを設定し、デバイスの広告IDを確認します。[Adjust Insightsアプリ](https://apps.apple.com/us/app/adjust-insights/id1125517808)をインストールして、この情報を見つけることができます。 +5. 以前にこのデバイスをテストに使用したことがある場合は、以下の手順に従ってください。 + 1. テスト用デバイスからアプリを削除します。 + 2. テストコンソールからデバイスの広告IDを消去します。[AppViewのテストコンソール](https://help.adjust.com/en/article/testing-console#forget-device)向けの手順に従ってください。 + 3. または、[Forget deviceのエンドポイント](/en/api/device-api/forget/)を呼び出して、デバイスに関する既存の情報を削除することができます。 -- The Adjust testing console, available in [AppView](https://help.adjust.com/ja/article/testing-console). -- The [Adjust Device API](/ja/api/device-api/inspect). -- Your IDE's log output. +6. Adjust SDKを含むアプリのテストバージョンをダウンロードして開きます。 +7. テスト購入をトリガーします。 +8. テストコンソールを開き、デバイスの広告IDのステータスを確認します。 -To test that this is working: +サブスクリプションが正常に記録されている場合、コンソール出力で次のフィールドの値が入力されます。 -1. Follow the integration guide for your platform to integrate the Adjust SDK. -2. Set the environment to **sandbox** . This ensures that your app only sends information to the testing console. -3. Set your log level to **verbose** to capture all logging information from your app. -4. Set up a test device or an emulated device and find the device's advertising ID. You can install the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808) to find this information. -5. If you've previously used the device for testing: +* **LastSubscriptionEventType** +* [**Last Subscription Event Subtype**](https://help.adjust.com/en/article/manage-subscription-data#subscription-event-subtypes) +* **LastSubscriptionEventTimestamp** +* **製品ID** - 1. Delete your app from the test device. - 2. Clear the device's advertising ID from the testing console. Follow the instructions for the [Testing console in AppView](https://help.adjust.com/ja/article/testing-console#forget-device). - 3. Alternatively, call the [forget device endpoint](/ja/api/device-api/forget/) to remove existing information about the device. +![Adjustテストコンソール](@images/sdk-testing/subscription/testing-console.png) -6. Download and open the test version of your app that contains the Adjust SDK. -7. Trigger a test purchase. -8. Open the testing console and check the device's advertising ID status. - -If the subscription is recorded successfully, the following fields are populated in the console output: - -- **Last Subscription Event Type** -- [**Last Subscription Event Subtype**](https://help.adjust.com/ja/article/manage-subscription-data#subscription-event-subtypes) -- **Last Subscription Event Timestamp** -- **Product ID** - -![The Adjust testing console](@images/sdk-testing/subscription/testing-console.png) From c5845bd81dab27e6d91ba6740bc41dedf386184d 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 08:59:18 +0000 Subject: [PATCH 69/75] File src/content/docs/en/sdk/unity/v4/features/subscriptions.mdx was translated to ko-KR locale --- .../sdk/unity/v4/features/subscriptions.mdx | 175 ++++++++---------- 1 file changed, 79 insertions(+), 96 deletions(-) diff --git a/src/content/docs/ko/sdk/unity/v4/features/subscriptions.mdx b/src/content/docs/ko/sdk/unity/v4/features/subscriptions.mdx index a02d7dc8c1..568bf5c869 100644 --- a/src/content/docs/ko/sdk/unity/v4/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/unity/v4/features/subscriptions.mdx @@ -1,46 +1,45 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: ko/sdk/unity/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/unity/features/subscriptions +title: "구독 정보 전송" +description: "이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다." +slug: "en/sdk/unity/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/unity/features/subscriptions" --- + - +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. +앱 스토어 및 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustAppStoreSubscription` 또는 `AdjustPlayStoreSubscription` 인스턴스를 생성하시기 바랍니다. - +1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} +----------------------------------------------------------------- -You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - -To get started, you need to create a subscription object containing details of the subscription purchase. - - - +시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. + ```cs public AdjustAppStoreSubscription(string price, string currency, string transactionId, string receipt) ``` - + -Create an `AdjustAppStoreSubscription` object with the following properties: +다음 속성을 포함하는 `AdjustAppStoreSubscription` 객체를 생성합니다. -| Parameter | Data type | Description | -| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | -| `transactionId` | `string` | Your ID for the transaction | -| `receipt` | `string` | The receipt information | +| 파라미터 | 데이터 유형 | 설명 | +|-----------------|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `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 | +| `receipt` | `string` | 영수증 정보 | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -50,25 +49,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - - + ```cs public AdjustPlayStoreSubscription(string price, string currency, string sku, string orderId, string signature, string purchaseToken) ``` - + -Create an `AdjustPlayStoreSubscription` object with the following properties: +다음 속성을 포함하는 `AdjustPlayStoreSubscription` 객체를 생성합니다. -| Parameter | Data type | Description | -| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription | -| `sku` | `string` | The ID of the product | -| `orderId` | `string` | Your ID for the transaction | -| `signature` | `string` | The signature of the purchase data | -| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation]() for more information | +| 파라미터 | 데이터 유형 | 설명 | +|-----------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------| +| `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())를 참조하시기 바랍니다. | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -80,23 +78,20 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. +### 구매일 기록 \{\#record\-the\-purchase\-date\} - - +사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. + ```cs public void setTransactionDate(string transactionDate); ``` - + -Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. +구독 객체의 `setTransactionDate` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -108,16 +103,15 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - - + ```cs public void setPurchaseTime(string purchaseTime); ``` - + -Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. +구독 객체의 `setPurchaseTime` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -130,20 +124,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### 구매 지역 기록\(iOS만 해당\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```cs public void setSalesRegion(string salesRegion); ``` - + -You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. +사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `string`로 전달합니다. 이는 [`priceLocale`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift)로 포맷되어야 합니다. ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -155,18 +148,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters {#add-callback-parameters} +### 콜백 파라미터 추가 \{\#add\-callback\-parameters\} -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - - - +콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -179,14 +170,13 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -201,21 +191,18 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - - -### Add partner parameters {#add-partner-parameters} + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. +### 파트너 파라미터 추가 \{\#add\-partner\-parameters\} - - +Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -228,14 +215,13 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -250,23 +236,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - + -## 2\. Record subscription information \{\#record\-subscription\-information\} +2\. 구독 정보 기록 \{\#record\-subscription\-information\} +---------------------------------------------------------- -Once you have set up your subscription object, you can record it using the Adjust SDK. - - - +구독 객체를 설정하고 나면 Adjust SDK를 사용하여 기록을 시작할 수 있습니다. + ```cs public static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + -Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. +구독 객체를 `trackAppStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -284,16 +268,15 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```cs public static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + -Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. +구독 객체를 `trackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -312,5 +295,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 9abdde2b5996079fb43976cdec4672d36d3ddfe1 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 08:59:20 +0000 Subject: [PATCH 70/75] File src/content/docs/en/sdk/unity/v4/features/subscriptions.mdx was translated to zh-CN locale --- .../sdk/unity/v4/features/subscriptions.mdx | 175 ++++++++---------- 1 file changed, 79 insertions(+), 96 deletions(-) diff --git a/src/content/docs/zh/sdk/unity/v4/features/subscriptions.mdx b/src/content/docs/zh/sdk/unity/v4/features/subscriptions.mdx index 38b0982cf5..460cfd874b 100644 --- a/src/content/docs/zh/sdk/unity/v4/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/unity/v4/features/subscriptions.mdx @@ -1,46 +1,45 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: zh/sdk/unity/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/unity/features/subscriptions +title: "发送订阅信息" +description: "使用这些方法向 Adjust 发送订阅信息。" +slug: "en/sdk/unity/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/unity/features/subscriptions" --- + - +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 + -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 +您可以用 Adjust SDK 记录 App Store 和 Play 应用商店的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `AdjustAppStoreSubscription` 或 `AdjustPlayStoreSubscription` 实例。 - +1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} +------------------------------------------------------------ -You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - -To get started, you need to create a subscription object containing details of the subscription purchase. - - - +要开始设置，先创建一个包含订阅购买细节的订阅对象。 + ```cs public AdjustAppStoreSubscription(string price, string currency, string transactionId, string receipt) ``` - + -Create an `AdjustAppStoreSubscription` object with the following properties: +创建一个 `AdjustAppStoreSubscription` 对象，属性如下： -| Parameter | Data type | Description | -| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | -| `transactionId` | `string` | Your ID for the transaction | -| `receipt` | `string` | The receipt information | +| 参数 | 数据类型 | 描述 | +|-----------------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `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 | +| `receipt` | `string` | 收据信息 | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -50,25 +49,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - - + ```cs public AdjustPlayStoreSubscription(string price, string currency, string sku, string orderId, string signature, string purchaseToken) ``` - + -Create an `AdjustPlayStoreSubscription` object with the following properties: +创建一个 `AdjustPlayStoreSubscription` 对象，属性如下： -| Parameter | Data type | Description | -| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription | -| `sku` | `string` | The ID of the product | -| `orderId` | `string` | Your ID for the transaction | -| `signature` | `string` | The signature of the purchase data | -| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation]() for more information | +| 参数 | 数据类型 | 描述 | +|-----------------|----------|------------------------------------------------------------------------------------------------------------------------------------| +| `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())，了解更多信息。 | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -80,23 +78,20 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. +### 记录购买日期\{\#record\-the\-purchase\-date\} - - +您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。 + ```cs public void setTransactionDate(string transactionDate); ``` - + -Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. +在您的订阅对象上调用 `setTransactionDate` 方法来记录订阅的时间戳。 ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -108,16 +103,15 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - - + ```cs public void setPurchaseTime(string purchaseTime); ``` - + -Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. +在您的订阅对象上调用 `setPurchaseTime` 方法来记录订阅的时间戳。 ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -130,20 +124,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### 记录购买地区 \(仅限 iOS\)\{\#record\-the\-purchase\-region\-ios\-only\} - + ```cs public void setSalesRegion(string salesRegion); ``` - + -You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. +您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `string` 传递。此信息格式需为 [`priceLocale`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) 对象的 [`countryCode`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift)。 ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -155,18 +148,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters {#add-callback-parameters} +### 添加回传参数\{\#add\-callback\-parameters\} -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - - - +您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -179,14 +170,13 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -201,21 +191,18 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - - -### Add partner parameters {#add-partner-parameters} + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. +### 添加合作伙伴参数\{\#add\-partner\-parameters\} - - +您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -228,14 +215,13 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -250,23 +236,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - + -## 2\. Record subscription information \{\#record\-subscription\-information\} +2\. 记录订阅信息\{\#record\-subscription\-information\} +------------------------------------------------------- -Once you have set up your subscription object, you can record it using the Adjust SDK. - - - +设置好订阅对象后，您就可以通过 Adjust SDK 对其进行记录了。 + ```cs public static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + -Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. +将订阅对象传送至 `trackAppStoreSubscription` 方法，以记录用户订阅购买。 ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -284,16 +268,15 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```cs public static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + -Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. +将订阅对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -312,5 +295,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From b96bc3e8b64a5d1d64296d5687ee67fb6a482ee1 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 08:59:22 +0000 Subject: [PATCH 71/75] File src/content/docs/en/sdk/unity/v4/features/subscriptions.mdx was translated to ja-JP locale --- .../sdk/unity/v4/features/subscriptions.mdx | 175 ++++++++---------- 1 file changed, 79 insertions(+), 96 deletions(-) diff --git a/src/content/docs/ja/sdk/unity/v4/features/subscriptions.mdx b/src/content/docs/ja/sdk/unity/v4/features/subscriptions.mdx index 7de755d983..c06ba31f18 100644 --- a/src/content/docs/ja/sdk/unity/v4/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/unity/v4/features/subscriptions.mdx @@ -1,46 +1,45 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: ja/sdk/unity/v4/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/unity/features/subscriptions +title: "サブスクリプション情報を送信する" +description: "Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。" +slug: "en/sdk/unity/v4/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/unity/features/subscriptions" --- + - +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 +App StoreおよびPlay Storeのサブスクリプションを計測し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`AdjustAppStoreSubscription`または`AdjustPlayStoreSubscription`を作成してください。 - +1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} +------------------------------------------------------------------------------- -You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - -To get started, you need to create a subscription object containing details of the subscription purchase. - - - +開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。 + ```cs public AdjustAppStoreSubscription(string price, string currency, string transactionId, string receipt) ``` - + -Create an `AdjustAppStoreSubscription` object with the following properties: +以下のプロパティを含む`AdjustAppStoreSubscription`オブジェクトを作成します： -| Parameter | Data type | Description | -| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | -| `transactionId` | `string` | Your ID for the transaction | -| `receipt` | `string` | The receipt information | +| パラメーター | データタイプ | 説明 | +|-----------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `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 | +| `receipt` | `string` | レシート情報 | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -50,25 +49,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - - + ```cs public AdjustPlayStoreSubscription(string price, string currency, string sku, string orderId, string signature, string purchaseToken) ``` - + -Create an `AdjustPlayStoreSubscription` object with the following properties: +以下のプロパティを含む`AdjustPlayStoreSubscription`オブジェクトを作成します： -| Parameter | Data type | Description | -| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription | -| `sku` | `string` | The ID of the product | -| `orderId` | `string` | Your ID for the transaction | -| `signature` | `string` | The signature of the purchase data | -| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation]() for more information | +| パラメーター | データタイプ | 説明 | +|-----------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------| +| `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())を参照してください | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -80,23 +78,20 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. +### 購入データを記録する \{\#record\-the\-purchase\-date\} - - +ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。 + ```cs public void setTransactionDate(string transactionDate); ``` - + -Call the `setTransactionDate` method on your subscription object to record the timestamp of the subscription. +サブスクリプションオブジェクトで`setTransactionDate`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -108,16 +103,15 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - - + ```cs public void setPurchaseTime(string purchaseTime); ``` - + -Call the `setPurchaseTime` method on your subscription object to record the timestamp of the subscription. +サブスクリプションオブジェクトで`setPurchaseTime`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -130,20 +124,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### 購入地域を記録する（iOSのみ） \{\#record\-the\-purchase\-region\-ios\-only\} - + ```cs public void setSalesRegion(string salesRegion); ``` - + -You can record the region in which the user purchased a subscription. To do this, call the `setSalesRegion` method on your subscription object and pass the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift) object. +ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトの`setSalesRegion`メソッドを呼び、国コードを`string`としてパスします。これは、[`priceLocale`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift)としてフォーマットされる必要があります。 ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -155,18 +148,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### Add callback parameters {#add-callback-parameters} +### コールバックパラメーターを追加する \{\#add\-callback\-parameters\} -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `addCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - - - +コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -179,14 +170,13 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -201,21 +191,18 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - - - -### Add partner parameters {#add-partner-parameters} + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `addPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. +### パートナーパラメーターを追加する \{\#add\-partner\-parameters\} - - +パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -228,14 +215,13 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -250,23 +236,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - - + -## 2\. Record subscription information \{\#record\-subscription\-information\} +2\. サブスクリプション情報を記録する \{\#record\-subscription\-information\} +------------------------------------------------------------------ -Once you have set up your subscription object, you can record it using the Adjust SDK. - - - +サブスクリプションオブジェクトを設定したら、Adjust SDKを使用して記録することが可能です。 + ```cs public static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + -Pass your subscription object to the `trackAppStoreSubscription` method to record the user's subscription purchase. +完了したオブジェクトを `trackAppStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -284,16 +268,15 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```cs public static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + -Pass your subscription object to the `trackPlayStoreSubscription` method to record the user's subscription purchase. +完了したオブジェクトを `trackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -312,5 +295,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + From 2b7bdff6c83a721990afd4a300948763bc86bfeb 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 08:59:24 +0000 Subject: [PATCH 72/75] File src/content/docs/en/sdk/unity/v5/features/subscriptions.mdx was translated to ko-KR locale --- .../sdk/unity/v5/features/subscriptions.mdx | 173 ++++++++---------- 1 file changed, 78 insertions(+), 95 deletions(-) diff --git a/src/content/docs/ko/sdk/unity/v5/features/subscriptions.mdx b/src/content/docs/ko/sdk/unity/v5/features/subscriptions.mdx index dd04eeaf20..89b64bcbdf 100644 --- a/src/content/docs/ko/sdk/unity/v5/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/unity/v5/features/subscriptions.mdx @@ -1,45 +1,44 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: ko/sdk/unity/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/sdk/unity/v4/features/subscriptions +title: "구독 정보 전송" +description: "이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다." +slug: "en/sdk/unity/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/unity/v4/features/subscriptions" --- + - +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. +앱 스토어 및 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustAppStoreSubscription` 또는 `AdjustPlayStoreSubscription` 인스턴스를 생성하시기 바랍니다. - +1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} +----------------------------------------------------------------- -You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - -To get started, you need to create a subscription object containing details of the subscription purchase. - - - +시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. + ```cs public AdjustAppStoreSubscription(string price, string currency, string transactionId); ``` - + -Create an `AdjustAppStoreSubscription` object with the following properties: +다음 속성을 포함하는 `AdjustAppStoreSubscription` 객체를 생성합니다. -| Parameter | Data type | Description | -| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | -| `transactionId` | `string` | Your ID for the transaction | +| 파라미터 | 데이터 유형 | 설명 | +|-----------------|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `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 | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -48,25 +47,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - - + ```cs public AdjustPlayStoreSubscription(string price, string currency, string sku, string orderId, string signature, string purchaseToken) ``` - + -Create an `AdjustPlayStoreSubscription` object with the following properties: +다음 속성을 포함하는 `AdjustPlayStoreSubscription` 객체를 생성합니다. -| Parameter | Data type | Description | -| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription | -| `sku` | `string` | The ID of the product | -| `orderId` | `string` | Your ID for the transaction | -| `signature` | `string` | The signature of the purchase data | -| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation]() for more information | +| 파라미터 | 데이터 유형 | 설명 | +|-----------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------| +| `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())를 참조하시기 바랍니다. | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -78,23 +76,20 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. +### 구매일 기록 \{\#record\-the\-purchase\-date\} - - +사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. + ```cs public string TransactionDate { get; set; } ``` - + -Set the `setTransactionDate` property of your `AdjustAppStoreSubscription` instance to record the timestamp of the subscription. +`AdjustAppStoreSubscription` 인스턴스의 `setTransactionDate` 속성을 설정하면 구독의 타임스탬프를 기록할 수 있습니다. ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -105,16 +100,15 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.TransactionDate = transactionDate; ``` - - + ```cs public string PurchaseTime { get; set; } ``` - + -Set the `PurchaseTime` property of your `AdjustPlayStoreSubscription` instance to record the timestamp of the subscription. +`AdjustPlayStoreSubscription` 인스턴스의 `PurchaseTime` 속성을 설정하면 구독의 타임스탬프를 기록할 수 있습니다. ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -127,20 +121,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.PurchaseTime = purchaseTime; ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### 구매 지역 기록\(iOS만 해당\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```cs public string SalesRegion { get; set; } ``` - + -You can record the region in which the user purchased a subscription. To do this, set the `SalesRegion` property of your `AdjustPlayStoreSubscription` instance to the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. +사용자가 구독을 결제한 지역을 기록할 수 있습니다. `AdjustPlayStoreSubscription` 인스턴스의 `SalesRegion` 속성에서 국가 코드를 `string`로 설정합니다. 이는 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)로써 형식화 되어야 합니다. ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -151,18 +144,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.SalesRegiom = salesRegion; ``` -### Add callback parameters {#add-callback-parameters} +### 콜백 파라미터 추가 \{\#add\-callback\-parameters\} -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `AddCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - - - +콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `AddCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -174,14 +165,13 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - - + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -196,21 +186,18 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - - - -### Add partner parameters {#add-partner-parameters} + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `AddPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. +### 파트너 파라미터 추가 \{\#add\-partner\-parameters\} - - +Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `AddPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -222,14 +209,13 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - - + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -244,23 +230,21 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - - + -## 2\. Record subscription information \{\#record\-subscription\-information\} +2\. 구독 정보 기록 \{\#record\-subscription\-information\} +---------------------------------------------------------- -Once you have set up your subscription object, you can record it using the Adjust SDK. - - - +구독 객체를 설정하고 나면 Adjust SDK를 사용하여 기록을 시작할 수 있습니다. + ```cs public static void TrackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + -Pass your subscription object to the `Adjust.TrackAppStoreSubscription` method to record the user's subscription purchase. +구독 객체를 `Adjust.TrackAppStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -277,16 +261,15 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackAppStoreSubscription(subscription); ``` - - + ```cs public static void TrackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + -Pass your subscription object to the `Adjust.TrackPlayStoreSubscription` method to record the user's subscription purchase. +구독 객체를 `Adjust.TrackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -305,5 +288,5 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackPlayStoreSubscription(subscription); ``` - - + + From 04c329f9a32541bfd034688f27b53a4715be79e5 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 08:59:26 +0000 Subject: [PATCH 73/75] File src/content/docs/en/sdk/unity/v5/features/subscriptions.mdx was translated to zh-CN locale --- .../sdk/unity/v5/features/subscriptions.mdx | 173 ++++++++---------- 1 file changed, 78 insertions(+), 95 deletions(-) diff --git a/src/content/docs/zh/sdk/unity/v5/features/subscriptions.mdx b/src/content/docs/zh/sdk/unity/v5/features/subscriptions.mdx index 62d7774187..eac5e23404 100644 --- a/src/content/docs/zh/sdk/unity/v5/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/unity/v5/features/subscriptions.mdx @@ -1,45 +1,44 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: zh/sdk/unity/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /zh/sdk/unity/v4/features/subscriptions +title: "发送订阅信息" +description: "使用这些方法向 Adjust 发送订阅信息。" +slug: "en/sdk/unity/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/unity/v4/features/subscriptions" --- + - +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 + -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 +您可以用 Adjust SDK 记录 App Store 和 Play 应用商店的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `AdjustAppStoreSubscription` 或 `AdjustPlayStoreSubscription` 实例。 - +1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} +------------------------------------------------------------ -You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - -To get started, you need to create a subscription object containing details of the subscription purchase. - - - +要开始设置，先创建一个包含订阅购买细节的订阅对象。 + ```cs public AdjustAppStoreSubscription(string price, string currency, string transactionId); ``` - + -Create an `AdjustAppStoreSubscription` object with the following properties: +创建一个 `AdjustAppStoreSubscription` 对象，属性如下： -| Parameter | Data type | Description | -| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | -| `transactionId` | `string` | Your ID for the transaction | +| 参数 | 数据类型 | 描述 | +|-----------------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `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 | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -48,25 +47,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - - + ```cs public AdjustPlayStoreSubscription(string price, string currency, string sku, string orderId, string signature, string purchaseToken) ``` - + -Create an `AdjustPlayStoreSubscription` object with the following properties: +创建一个 `AdjustPlayStoreSubscription` 对象，属性如下： -| Parameter | Data type | Description | -| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription | -| `sku` | `string` | The ID of the product | -| `orderId` | `string` | Your ID for the transaction | -| `signature` | `string` | The signature of the purchase data | -| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation]() for more information | +| 参数 | 数据类型 | 描述 | +|-----------------|----------|------------------------------------------------------------------------------------------------------------------------------------| +| `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())，了解更多信息。 | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -78,23 +76,20 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. +### 记录购买日期\{\#record\-the\-purchase\-date\} - - +您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。 + ```cs public string TransactionDate { get; set; } ``` - + -Set the `setTransactionDate` property of your `AdjustAppStoreSubscription` instance to record the timestamp of the subscription. +设置`AdjustAppStoreSubscription`实例的`setTransactionDate`属性来记录订阅的时间戳。 ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -105,16 +100,15 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.TransactionDate = transactionDate; ``` - - + ```cs public string PurchaseTime { get; set; } ``` - + -Set the `PurchaseTime` property of your `AdjustPlayStoreSubscription` instance to record the timestamp of the subscription. +设置`AdjustPlayStoreSubscription`实例的`PurchaseTime`属性来记录订阅的时间戳。 ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -127,20 +121,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.PurchaseTime = purchaseTime; ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### 记录购买地区 \(仅限 iOS\)\{\#record\-the\-purchase\-region\-ios\-only\} - + ```cs public string SalesRegion { get; set; } ``` - + -You can record the region in which the user purchased a subscription. To do this, set the `SalesRegion` property of your `AdjustPlayStoreSubscription` instance to the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. +您可以记录用户购买订阅的地区。为此，请将`AdjustPlayStoreSubscription`实例的`SalesRegion`属性设置为`string`形式的国家代码。此信息需为[`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)对象的[`countryCode`](https://developer.apple.com/documentation/storekit/storefront)。 ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -151,18 +144,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.SalesRegiom = salesRegion; ``` -### Add callback parameters {#add-callback-parameters} +### 添加回传参数\{\#add\-callback\-parameters\} -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `AddCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - - - +您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `AddCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -174,14 +165,13 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - - + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -196,21 +186,18 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - - - -### Add partner parameters {#add-partner-parameters} + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `AddPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. +### 添加合作伙伴参数\{\#add\-partner\-parameters\} - - +您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`AddPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -222,14 +209,13 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - - + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -244,23 +230,21 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - - + -## 2\. Record subscription information \{\#record\-subscription\-information\} +2\. 记录订阅信息\{\#record\-subscription\-information\} +------------------------------------------------------- -Once you have set up your subscription object, you can record it using the Adjust SDK. - - - +设置好订阅对象后，您就可以通过 Adjust SDK 对其进行记录了。 + ```cs public static void TrackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + -Pass your subscription object to the `Adjust.TrackAppStoreSubscription` method to record the user's subscription purchase. +将订阅对象传送至 `Adjust.TrackAppStoreSubscription` 方法，以记录用户订阅购买。 ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -277,16 +261,15 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackAppStoreSubscription(subscription); ``` - - + ```cs public static void TrackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + -Pass your subscription object to the `Adjust.TrackPlayStoreSubscription` method to record the user's subscription purchase. +将订阅对象传送至 `Adjust.TrackPlayStoreSubscription` 方法，以记录用户订阅购买。 ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -305,5 +288,5 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackPlayStoreSubscription(subscription); ``` - - + + From 1fc219211e10badf601348b25ab3e3150b9d9e88 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 08:59:28 +0000 Subject: [PATCH 74/75] File src/content/docs/en/sdk/unity/v5/features/subscriptions.mdx was translated to ja-JP locale --- .../sdk/unity/v5/features/subscriptions.mdx | 173 ++++++++---------- 1 file changed, 78 insertions(+), 95 deletions(-) diff --git a/src/content/docs/ja/sdk/unity/v5/features/subscriptions.mdx b/src/content/docs/ja/sdk/unity/v5/features/subscriptions.mdx index 0747b96abe..4fe72ffbaf 100644 --- a/src/content/docs/ja/sdk/unity/v5/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/unity/v5/features/subscriptions.mdx @@ -1,45 +1,44 @@ --- -title: Send subscription information -description: Use these methods send subscription information to Adjust. -slug: ja/sdk/unity/features/subscriptions -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ja/sdk/unity/v4/features/subscriptions +title: "サブスクリプション情報を送信する" +description: "Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。" +slug: "en/sdk/unity/features/subscriptions" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/unity/v4/features/subscriptions" --- + - +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 +App StoreおよびPlay Storeのサブスクリプションを計測し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`AdjustAppStoreSubscription`または`AdjustPlayStoreSubscription`を作成してください。 - +1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} +------------------------------------------------------------------------------- -You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an `AdjustAppStoreSubscription` or `AdjustPlayStoreSubscription` instance containing the details. - -## 1\. Instantiate a subscription object \{\#instantiate\-a\-subscription\-object\} - -To get started, you need to create a subscription object containing details of the subscription purchase. - - - +開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。 + ```cs public AdjustAppStoreSubscription(string price, string currency, string transactionId); ``` - + -Create an `AdjustAppStoreSubscription` object with the following properties: +以下のプロパティを含む`AdjustAppStoreSubscription`オブジェクトを作成します： -| Parameter | Data type | Description | -| --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription. Formatted as the [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) of the [`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc) object | -| `transactionId` | `string` | Your ID for the transaction | +| パラメーター | データタイプ | 説明 | +|-----------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `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 | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -48,25 +47,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - - + ```cs public AdjustPlayStoreSubscription(string price, string currency, string sku, string orderId, string signature, string purchaseToken) ``` - + -Create an `AdjustPlayStoreSubscription` object with the following properties: +以下のプロパティを含む`AdjustPlayStoreSubscription`オブジェクトを作成します： -| Parameter | Data type | Description | -| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `string` | The price of the subscription | -| `currency` | `string` | The currency of the subscription | -| `sku` | `string` | The ID of the product | -| `orderId` | `string` | Your ID for the transaction | -| `signature` | `string` | The signature of the purchase data | -| `purchaseToken` | `string` | The unique token of the transaction. See [Google's documentation]() for more information | +| パラメーター | データタイプ | 説明 | +|-----------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------| +| `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())を参照してください | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -78,23 +76,20 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - - - -### Record the purchase date {#record-the-purchase-date} + -You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on. +### 購入データを記録する \{\#record\-the\-purchase\-date\} - - +ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。 + ```cs public string TransactionDate { get; set; } ``` - + -Set the `setTransactionDate` property of your `AdjustAppStoreSubscription` instance to record the timestamp of the subscription. +`AdjustAppStoreSubscription`インスタンスの`setTransactionDate`プロパティを設定し、サブスクリプションのタイムスタンプを記録します。 ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -105,16 +100,15 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.TransactionDate = transactionDate; ``` - - + ```cs public string PurchaseTime { get; set; } ``` - + -Set the `PurchaseTime` property of your `AdjustPlayStoreSubscription` instance to record the timestamp of the subscription. +`AdjustPlayStoreSubscription`インスタンスの`PurchaseTime`プロパティを設定し、サブスクリプションのタイムスタンプを記録します。 ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -127,20 +121,19 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.PurchaseTime = purchaseTime; ``` - - + -### Record the purchase region \(iOS only\) {#record-the-purchase-region-ios-only} +### 購入地域を記録する（iOSのみ） \{\#record\-the\-purchase\-region\-ios\-only\} - + ```cs public string SalesRegion { get; set; } ``` - + -You can record the region in which the user purchased a subscription. To do this, set the `SalesRegion` property of your `AdjustPlayStoreSubscription` instance to the country code as a `string`. This needs to be formatted as the [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) of the [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) object. +ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、 `AdjustPlayStoreSubscription`インスタンスの`SalesRegion`プロパティを`string`として国コードに設定します。これは、[`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/storekit/storefront)としてフォーマットされる必要があります。 ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -151,18 +144,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.SalesRegiom = salesRegion; ``` -### Add callback parameters {#add-callback-parameters} +### コールバックパラメーターを追加する \{\#add\-callback\-parameters\} -You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the `AddCallbackParameter` method on your subscription object. You can add multiple callback parameters by calling this method multiple times. - - - +コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`AddCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -174,14 +165,13 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - - + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -196,21 +186,18 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - - - -### Add partner parameters {#add-partner-parameters} + -You can add partner parameters to your subscription object. The SDK sends these to Adjust's servers when the user purchases a subscription. Adjust's servers forward the information on to your network partner. To add partner parameters, call the `AddPartnerParameter` method on your subscription object. You can add multiple partner parameters by calling this method multiple times. +### パートナーパラメーターを追加する \{\#add\-partner\-parameters\} - - +パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`AddPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -222,14 +209,13 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - - + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -244,23 +230,21 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - - + -## 2\. Record subscription information \{\#record\-subscription\-information\} +2\. サブスクリプション情報を記録する \{\#record\-subscription\-information\} +------------------------------------------------------------------ -Once you have set up your subscription object, you can record it using the Adjust SDK. - - - +サブスクリプションオブジェクトを設定したら、Adjust SDKを使用して記録することが可能です。 + ```cs public static void TrackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + -Pass your subscription object to the `Adjust.TrackAppStoreSubscription` method to record the user's subscription purchase. +完了したオブジェクトを `Adjust.TrackAppStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -277,16 +261,15 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackAppStoreSubscription(subscription); ``` - - + ```cs public static void TrackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + -Pass your subscription object to the `Adjust.TrackPlayStoreSubscription` method to record the user's subscription purchase. +完了したオブジェクトを `Adjust.TrackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -305,5 +288,5 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackPlayStoreSubscription(subscription); ``` - - + + From 5cc3858f7fc83fa04e2648962b61521eaee4c2bd Mon Sep 17 00:00:00 2001 From: github-actions <41898282+github-actions[bot]@users.noreply.github.com> Date: Tue, 14 Jan 2025 09:00:11 +0000 Subject: [PATCH 75/75] Fix translated and formatted files --- .../sdk/android/v4/features/subscriptions.mdx | 130 ++++++++------- .../sdk/android/v5/features/subscriptions.mdx | 130 ++++++++------- .../sdk/cordova/v4/features/subscriptions.mdx | 149 ++++++++++-------- .../sdk/cordova/v5/features/subscriptions.mdx | 139 +++++++++------- .../sdk/flutter/v4/features/subscriptions.mdx | 149 ++++++++++-------- .../sdk/flutter/v5/features/subscriptions.mdx | 145 +++++++++-------- .../ja/sdk/ios/v4/features/subscriptions.mdx | 140 +++++++++------- .../ja/sdk/ios/v5/features/subscriptions.mdx | 138 +++++++++------- .../ja/sdk/testing/subscription-recording.mdx | 37 +++-- .../sdk/unity/v4/features/subscriptions.mdx | 149 ++++++++++-------- .../sdk/unity/v5/features/subscriptions.mdx | 147 +++++++++-------- .../sdk/android/v4/features/subscriptions.mdx | 130 ++++++++------- .../sdk/android/v5/features/subscriptions.mdx | 130 ++++++++------- .../sdk/cordova/v4/features/subscriptions.mdx | 149 ++++++++++-------- .../sdk/cordova/v5/features/subscriptions.mdx | 141 +++++++++-------- .../sdk/flutter/v4/features/subscriptions.mdx | 149 ++++++++++-------- .../sdk/flutter/v5/features/subscriptions.mdx | 147 +++++++++-------- .../ko/sdk/ios/v4/features/subscriptions.mdx | 140 +++++++++------- .../ko/sdk/ios/v5/features/subscriptions.mdx | 138 +++++++++------- .../ko/sdk/testing/subscription-recording.mdx | 39 ++--- .../sdk/unity/v4/features/subscriptions.mdx | 149 ++++++++++-------- .../sdk/unity/v5/features/subscriptions.mdx | 147 +++++++++-------- .../sdk/android/v4/features/subscriptions.mdx | 128 ++++++++------- .../sdk/android/v5/features/subscriptions.mdx | 128 ++++++++------- .../sdk/cordova/v4/features/subscriptions.mdx | 149 ++++++++++-------- .../sdk/cordova/v5/features/subscriptions.mdx | 139 +++++++++------- .../sdk/flutter/v4/features/subscriptions.mdx | 147 +++++++++-------- .../sdk/flutter/v5/features/subscriptions.mdx | 145 +++++++++-------- .../zh/sdk/ios/v4/features/subscriptions.mdx | 140 +++++++++------- .../zh/sdk/ios/v5/features/subscriptions.mdx | 138 +++++++++------- .../zh/sdk/testing/subscription-recording.mdx | 37 +++-- .../sdk/unity/v4/features/subscriptions.mdx | 147 +++++++++-------- .../sdk/unity/v5/features/subscriptions.mdx | 145 +++++++++-------- 33 files changed, 2446 insertions(+), 1909 deletions(-) diff --git a/src/content/docs/ja/sdk/android/v4/features/subscriptions.mdx b/src/content/docs/ja/sdk/android/v4/features/subscriptions.mdx index 4ecbd79408..d690a60708 100644 --- a/src/content/docs/ja/sdk/android/v4/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/android/v4/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "サブスクリプション情報を送信する" -description: "Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。" -slug: "en/sdk/android/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/android/features/subscriptions" +title: サブスクリプション情報を送信する +description: Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。 +slug: ja/sdk/android/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ja/sdk/android/features/subscriptions --- - -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 - + + +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + + Playストアのサブスクリプションを記録し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションを購入したら、詳細を含む `AdjustPlayStoreSubscription`オブジェクトをインスタンス化します。 -1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} -------------------------------------------------------------------------------- +## 1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} - + ```java public AdjustPlayStoreSubscription(final long price, @@ -35,20 +34,21 @@ public AdjustPlayStoreSubscription(final long price, ``` - + 開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトをインスタンス化する必要があります。これを行うには、新しい`AdjustPlayStoreSubscription`を作成して次の引数をパスします： -| パラメーター | データタイプ | 説明 | -|-----------------|----------|------------------------------------------------------------------------------------------------------------------------------| -| `price` | `long` | サブスクリプションの価格 | -| `currency` | `String` | サブスクリプション通貨 | -| `sku` | `String` | プロダクトID | -| `orderId` | `String` | トランザクションID | -| `signature` | `String` | 購入データのシグネチャー | -| `purchaseToken` | `String` | トランザクションの一意のトークン。詳細は[Googleのドキュメント](https://developer.android.com/reference/com/android/billingclient/api/Purchase)を参照してください | +| パラメーター | データタイプ | 説明 | +| --------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `long` | サブスクリプションの価格 | +| `currency` | `String` | サブスクリプション通貨 | +| `sku` | `String` | プロダクトID | +| `orderId` | `String` | トランザクションID | +| `signature` | `String` | 購入データのシグネチャー | +| `purchaseToken` | `String` | トランザクションの一意のトークン。詳細は[Googleのドキュメント](https://developer.android.com/reference/com/android/billingclient/api/Purchase)を参照してください | - + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,7 +62,8 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -76,20 +77,23 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### 購入データを記録する \{\#record\-the\-purchase\-date\} +### 購入データを記録する {#record-the-purchase-date} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。タイムスタンプを使用して`setPurchaseTime`メソッドを呼び出し、この情報を記録します。 - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -104,7 +108,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -119,75 +124,85 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +### コールバックパラメーターを追加する {#add-callback-parameters} - + ```java public void addCallbackParameter(String key, String value) ``` - + コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - + + + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - + + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - + + -### パートナーパラメーターを追加する \{\#add\-partner\-parameters\} +### パートナーパラメーターを追加する {#add-partner-parameters} - + ```java public void addPartnerParameter(String key, String value) ``` - + パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - + + + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - + + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - + + -2\. サブスクリプション情報を送信する \{\#send\-subscription\-information\} ----------------------------------------------------------------- +## 2\. サブスクリプション情報を送信する \{\#send\-subscription\-information\} - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - + サブスクリプションオブジェクトを設定したら、Adjust SDKを使用してそれをAdjustに送信できます。完了したオブジェクトを `trackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -202,7 +217,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -217,5 +233,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ja/sdk/android/v5/features/subscriptions.mdx b/src/content/docs/ja/sdk/android/v5/features/subscriptions.mdx index 1e4e4f9519..74e8fb9c47 100644 --- a/src/content/docs/ja/sdk/android/v5/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/android/v5/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "サブスクリプション情報を送信する" -description: "Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。" -slug: "en/sdk/android/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/android/v4/features/subscriptions" +title: サブスクリプション情報を送信する +description: Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。 +slug: ja/sdk/android/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ja/sdk/android/v4/features/subscriptions --- - -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 - + + +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + + Playストアのサブスクリプションを記録し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションを購入したら、詳細を含む `AdjustPlayStoreSubscription`オブジェクトをインスタンス化します。 -1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} -------------------------------------------------------------------------------- +## 1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} - + ```java public AdjustPlayStoreSubscription(final long price, @@ -35,20 +34,21 @@ public AdjustPlayStoreSubscription(final long price, ``` - + 開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトをインスタンス化する必要があります。これを行うには、新しい`AdjustPlayStoreSubscription`を作成して次の引数をパスします： -| パラメーター | データタイプ | 説明 | -|-----------------|----------|------------------------------------------------------------------------------------------------------------------------------| -| `price` | `long` | サブスクリプションの価格 | -| `currency` | `String` | サブスクリプション通貨 | -| `sku` | `String` | プロダクトID | -| `orderId` | `String` | トランザクションID | -| `signature` | `String` | 購入データのシグネチャー | -| `purchaseToken` | `String` | トランザクションの一意のトークン。詳細は[Googleのドキュメント](https://developer.android.com/reference/com/android/billingclient/api/Purchase)を参照してください | +| パラメーター | データタイプ | 説明 | +| --------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `long` | サブスクリプションの価格 | +| `currency` | `String` | サブスクリプション通貨 | +| `sku` | `String` | プロダクトID | +| `orderId` | `String` | トランザクションID | +| `signature` | `String` | 購入データのシグネチャー | +| `purchaseToken` | `String` | トランザクションの一意のトークン。詳細は[Googleのドキュメント](https://developer.android.com/reference/com/android/billingclient/api/Purchase)を参照してください | - + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,7 +62,8 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -76,20 +77,23 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### 購入データを記録する \{\#record\-the\-purchase\-date\} +### 購入データを記録する {#record-the-purchase-date} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。タイムスタンプを使用して`setPurchaseTime`メソッドを呼び出し、この情報を記録します。 - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -104,7 +108,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -119,75 +124,85 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +### コールバックパラメーターを追加する {#add-callback-parameters} - + ```java public void addCallbackParameter(String key, String value) ``` - + コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - + + + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - + + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - + + -### パートナーパラメーターを追加する \{\#add\-partner\-parameters\} +### パートナーパラメーターを追加する {#add-partner-parameters} - + ```java public void addPartnerParameter(String key, String value) ``` - + パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - + + + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - + + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - + + -2\. サブスクリプション情報を送信する \{\#send\-subscription\-information\} ----------------------------------------------------------------- +## 2\. サブスクリプション情報を送信する \{\#send\-subscription\-information\} - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - + サブスクリプションオブジェクトを設定したら、Adjust SDKを使用してそれをAdjustに送信できます。完了したオブジェクトを `trackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -202,7 +217,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -217,5 +233,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ja/sdk/cordova/v4/features/subscriptions.mdx b/src/content/docs/ja/sdk/cordova/v4/features/subscriptions.mdx index daef30c22d..9733423ba6 100644 --- a/src/content/docs/ja/sdk/cordova/v4/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/cordova/v4/features/subscriptions.mdx @@ -1,45 +1,46 @@ --- -title: "サブスクリプション情報を送信する" -description: "Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。" -slug: "en/sdk/cordova/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/cordova/features/subscriptions" +title: サブスクリプション情報を送信する +description: Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。 +slug: ja/sdk/cordova/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ja/sdk/cordova/features/subscriptions --- - -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 - + + +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + + App StoreおよびPlay Storeのサブスクリプションを計測し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`AdjustAppStoreSubscription`または`AdjustPlayStoreSubscription`を作成してください。 -1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} -------------------------------------------------------------------------------- +## 1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} 開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。 - + + + ```js constructor(price: string, currency: string, transactionId: string, receipt: string) ``` - + 以下のプロパティを含む`AdjustAppStoreSubscription`オブジェクトを作成します： -| パラメーター | データタイプ | 説明 | -|-----------------|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | 数値 | サブスクリプションの価格 | -| `currency` | 文字列 | サブスクリプションの通貨。[`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` | 文字列 | トランザクションID | -| `receipt` | 文字列 | レシート情報 | +| パラメーター | データタイプ | 説明 | +| --------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | 数値 | サブスクリプションの価格 | +| `currency` | 文字列 | サブスクリプションの通貨。[`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` | 文字列 | トランザクションID | +| `receipt` | 文字列 | レシート情報 | ```js var subscription = new AdjustAppStoreSubscription( @@ -50,24 +51,25 @@ var subscription = new AdjustAppStoreSubscription( ); ``` - + + ```js constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + 以下のプロパティを含む`AdjustPlayStoreSubscription`オブジェクトを作成します： -| パラメーター | データタイプ | 説明 | -|-----------------|--------|-------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | 数値 | サブスクリプションの価格 | -| `currency` | 文字列 | サブスクリプション通貨 | -| `sku` | 文字列 | プロダクトID | -| `orderId` | 文字列 | トランザクションID | -| `signature` | 文字列 | 購入データのシグネチャー | -| `purchaseToken` | 文字列 | トランザクションの一意のトークン。詳細は[Googleのドキュメント](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken())を参照してください | +| パラメーター | データタイプ | 説明 | +| --------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | 数値 | サブスクリプションの価格 | +| `currency` | 文字列 | サブスクリプション通貨 | +| `sku` | 文字列 | プロダクトID | +| `orderId` | 文字列 | トランザクションID | +| `signature` | 文字列 | 購入データのシグネチャー | +| `purchaseToken` | 文字列 | トランザクションの一意のトークン。詳細は[Googleのドキュメント]()を参照してください | ```js var subscription = new AdjustPlayStoreSubscription( @@ -80,18 +82,21 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - + + -### 購入データを記録する \{\#record\-the\-purchase\-date\} +### 購入データを記録する {#record-the-purchase-date} ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。 - + + + ```js setTransactionDate(transactionDate: string): void ``` - + サブスクリプションオブジェクトで`setTransactionDate`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 @@ -106,13 +111,14 @@ var subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - + + ```js setPurchaseTime(purchaseTime: string): void ``` - + サブスクリプションオブジェクトで`setPurchaseTime`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 @@ -128,17 +134,18 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### 購入地域を記録する（iOSのみ） \{\#record\-the\-purchase\-region\-ios\-only\} +### 購入地域を記録する（iOSのみ） {#record-the-purchase-region-ios-only} - + ```js setSalesRegion(salesRegion: string): void ``` - + ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトの`setSalesRegion`メソッドを呼び、国コードを`string`としてパスします。これは、[`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/storekit/storefront)としてフォーマットされる必要があります。 @@ -153,16 +160,18 @@ var subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +### コールバックパラメーターを追加する {#add-callback-parameters} コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - + + + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -176,13 +185,14 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -198,18 +208,21 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + -### パートナーパラメーターを追加する \{\#add\-partner\-parameters\} +### パートナーパラメーターを追加する {#add-partner-parameters} パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - + + + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -223,13 +236,14 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -245,19 +259,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + -2\. サブスクリプション情報を記録する \{\#record\-subscription\-information\} ------------------------------------------------------------------- +## 2\. サブスクリプション情報を記録する \{\#record\-subscription\-information\} サブスクリプションオブジェクトを設定したら、Adjust SDKを使用して記録することが可能です。 - + + + ```js trackAppStoreSubscription(subscription: AdjustAppStoreSubscription): void ``` - + 完了したオブジェクトを `trackAppStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 @@ -278,13 +294,14 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```js trackPlayStoreSubscription(subscription: AdjustPlayStoreSubscription): void ``` - + 完了したオブジェクトを `trackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 @@ -306,5 +323,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ja/sdk/cordova/v5/features/subscriptions.mdx b/src/content/docs/ja/sdk/cordova/v5/features/subscriptions.mdx index 657469cae8..3e4695cf4c 100644 --- a/src/content/docs/ja/sdk/cordova/v5/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/cordova/v5/features/subscriptions.mdx @@ -1,36 +1,37 @@ --- -title: "サブスクリプション情報を送信する" -description: "Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。" -slug: "en/sdk/cordova/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/cordova/v4/features/subscriptions" +title: サブスクリプション情報を送信する +description: Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。 +slug: ja/sdk/cordova/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ja/sdk/cordova/v4/features/subscriptions --- - -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 - + + +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + + App StoreおよびPlay Storeのサブスクリプションを計測し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`AdjustAppStoreSubscription`または`AdjustPlayStoreSubscription`を作成してください。 -1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} -------------------------------------------------------------------------------- +## 1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} 開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。 - + + + ```ts constructor(price: string, currency: string, transactionId: string) ``` - + 以下のプロパティを含む`AdjustAppStoreSubscription`オブジェクトを作成します。 @@ -38,7 +39,7 @@ constructor(price: string, currency: string, transactionId: string) \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| \| `price` \| `string` \|サブスクリプションの価格 \| \| `currency` \| `string` \|サブスクリプションの通貨。 [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc)オブジェクトの[`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc)としてフォーマット\| -\| `transactionId` \| `string` \| トランザクションのためのID\| \| +\| `transactionId` \| `string` \| トランザクションのためのID\| \| ```js var subscription = new AdjustAppStoreSubscription( @@ -49,24 +50,25 @@ var subscription = new AdjustAppStoreSubscription( Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + 以下のプロパティを含む`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のドキュメント]()を参照してください | ```js var subscription = new AdjustPlayStoreSubscription( @@ -79,18 +81,21 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - + + -### 購入データを記録する \{\#record\-the\-purchase\-date\} +### 購入データを記録する {#record-the-purchase-date} ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。 - + + + ```ts setTransactionDate(transactionDate: string): void ``` - + サブスクリプションオブジェクトで`setTransactionDate`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 @@ -105,13 +110,14 @@ subscription.setTransactionDate(transactionDate); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts setPurchaseTime(purchaseTime: string): void ``` - + サブスクリプションオブジェクトで`setPurchaseTime`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 @@ -127,17 +133,18 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### 購入地域を記録する（iOSのみ） \{\#record\-the\-purchase\-region\-ios\-only\} +### 購入地域を記録する（iOSのみ） {#record-the-purchase-region-ios-only} - + ```ts setSalesRegion(salesRegion: string): void ``` - + ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトの`setSalesRegion`メソッドを呼び、国コードを`string`としてパスします。これは、[`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/storekit/storefront)としてフォーマットされる必要があります。 @@ -152,16 +159,18 @@ subscription.setSalesRegion(salesRegion); Adjust.trackPlayStoreSubscription(subscription); ``` -### コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +### コールバックパラメーターを追加する {#add-callback-parameters} コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - + + + ```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -178,13 +187,14 @@ subscription.addCallbackParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -200,18 +210,21 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + -### パートナーパラメーターを追加する \{\#add\-partner\-parameters\} +### パートナーパラメーターを追加する {#add-partner-parameters} パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - + + + ```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -228,13 +241,14 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -250,19 +264,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + -2\. サブスクリプション情報を記録する \{\#record\-subscription\-information\} ------------------------------------------------------------------- +## 2\. サブスクリプション情報を記録する \{\#record\-subscription\-information\} サブスクリプションオブジェクトを設定したら、Adjust SDKを使用して記録することが可能です。 - + + + ```ts trackAppStoreSubscription(adjustAppStoreSubscription: AdjustAppStoreSubscription): void ``` - + 完了したオブジェクトを `trackAppStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 @@ -278,13 +294,14 @@ subscription.setSalesRegion(salesRegion); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts trackPlayStoreSubscription(adjustPlayStoreSubscription: AdjustPlayStoreSubscription): void ``` - + 完了したオブジェクトを `trackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 @@ -302,5 +319,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ja/sdk/flutter/v4/features/subscriptions.mdx b/src/content/docs/ja/sdk/flutter/v4/features/subscriptions.mdx index e83447821e..ec45f5f087 100644 --- a/src/content/docs/ja/sdk/flutter/v4/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/flutter/v4/features/subscriptions.mdx @@ -1,45 +1,46 @@ --- -title: "サブスクリプション情報を送信する" -description: "Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。" -slug: "en/sdk/flutter/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/flutter/features/subscriptions" +title: サブスクリプション情報を送信する +description: Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。 +slug: ja/sdk/flutter/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ja/sdk/flutter/features/subscriptions --- - -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 - + + +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + + App StoreおよびPlay Storeのサブスクリプションを計測し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`AdjustAppStoreSubscription`または`AdjustPlayStoreSubscription`を作成してください。 -1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} -------------------------------------------------------------------------------- +## 1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} 開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。 - + + + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId, String _receipt) ``` - + 以下のプロパティを含む`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 | -| `receipt` | `String` | レシート情報 | +| パラメーター | データタイプ | 説明 | +| --------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `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 | +| `receipt` | `String` | レシート情報 | ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -49,24 +50,25 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - + + ```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のドキュメント](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のドキュメント]()を参照してください | ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -78,18 +80,21 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - + + -### 購入データを記録する \{\#record\-the\-purchase\-date\} +### 購入データを記録する {#record-the-purchase-date} ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。 - + + + ```dart void setTransactionDate(String _transactionDate) ``` - + サブスクリプションオブジェクトで`setTransactionDate`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 @@ -103,13 +108,14 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - + + ```dart void setPurchaseTime(String purchaseTime) ``` - + サブスクリプションオブジェクトで`setPurchaseTime`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 @@ -124,17 +130,18 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### 購入地域を記録する（iOSのみ） \{\#record\-the\-purchase\-region\-ios\-only\} +### 購入地域を記録する（iOSのみ） {#record-the-purchase-region-ios-only} - + ```dart void setSalesRegion(String _salesRegion) ``` - + ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトの`setSalesRegion`メソッドを呼び、国コードを`String`としてパスします。これは、[`priceLocale`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift)としてフォーマットされる必要があります。 @@ -148,16 +155,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +### コールバックパラメーターを追加する {#add-callback-parameters} コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - + + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -170,13 +179,14 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -191,18 +201,21 @@ 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( @@ -215,13 +228,14 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - + + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -236,19 +250,21 @@ 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`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 @@ -268,13 +284,14 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + 完了したオブジェクトを `trackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 @@ -295,5 +312,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ja/sdk/flutter/v5/features/subscriptions.mdx b/src/content/docs/ja/sdk/flutter/v5/features/subscriptions.mdx index 00e5e57daa..ca6fe31518 100644 --- a/src/content/docs/ja/sdk/flutter/v5/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/flutter/v5/features/subscriptions.mdx @@ -1,36 +1,37 @@ --- -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" +title: サブスクリプション情報を送信する +description: Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。 +slug: ja/sdk/flutter/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ja/sdk/flutter/v4/features/subscriptions --- - -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 - + + +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + + App StoreおよびPlay Storeのサブスクリプションを計測し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`AdjustAppStoreSubscription`または`AdjustPlayStoreSubscription`を作成してください。 -1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} -------------------------------------------------------------------------------- +## 1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} 開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。 - + + + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId) ``` - + 以下のプロパティを含む`AdjustAppStoreSubscription`オブジェクトを作成します： @@ -38,7 +39,7 @@ AdjustAppStoreSubscription(String _price, String _currency, String _transactionI \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| \| `price` \| `String` \|サブスクリプションの価格 \| \| `currency` \| `String` \|サブスクリプションの通貨。 [`currencyCode`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc)オブジェクトの[`priceLocale`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc)としてフォーマット\| -\| `transactionId` \| `String` \| トランザクションのためのID\| \| +\| `transactionId` \| `String` \| トランザクションのためのID\| \| ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -47,24 +48,25 @@ 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のドキュメント](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のドキュメント]()を参照してください | ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -76,21 +78,25 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - + + -### 購入データを記録する \{\#record\-the\-purchase\-date\} +### 購入データを記録する {#record-the-purchase-date} ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。 - + + + `AdjustAppStoreSubscription`クラスに`transactionDate`プロパティを追加します。 - + + ```dart String? transactionDate ``` - + `subscription`インスタンスの`transactionDate`プロパティにタイムスタンプを設定し、ユーザーがサブスクリプションを購入した日を記録します。 @@ -103,16 +109,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.transactionDate = 'transactionDate'; ``` - + + `AdjustPlayStoreSubscription`クラスに`purchaseTime`プロパティを追加します。 - + + ```dart String? purchaseTime; ``` - + `subscription`インスタンスの`purchaseTime`プロパティにタイムスタンプを設定し、ユーザーがサブスクリプションを購入した日を記録します。 @@ -127,17 +135,18 @@ 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 ``` - + ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトの`setSalesRegion`メソッドを呼び、国コードを`String`としてパスします。これは、[`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/storekit/storefront)としてフォーマットされる必要があります。 @@ -150,16 +159,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.salesRegion = 'sales-region'; ``` -### コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +### コールバックパラメーターを追加する {#add-callback-parameters} コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - + + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -171,13 +182,14 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -192,18 +204,21 @@ 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( @@ -215,13 +230,14 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - + + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -236,19 +252,21 @@ 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`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 @@ -267,13 +285,14 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + 完了したオブジェクトを `trackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 @@ -294,5 +313,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ja/sdk/ios/v4/features/subscriptions.mdx b/src/content/docs/ja/sdk/ios/v4/features/subscriptions.mdx index 1e79ff9c36..6974980005 100644 --- a/src/content/docs/ja/sdk/ios/v4/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/ios/v4/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "サブスクリプション情報を送信する" -description: "Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。" -slug: "en/sdk/ios/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/ios/features/subscriptions" +title: サブスクリプション情報を送信する +description: Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。 +slug: ja/sdk/ios/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ja/sdk/ios/features/subscriptions --- - -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 - + + +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + + App Storeのサブスクリプションを記録し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`ADJSubscription`インスタンスを作成します。 -1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} -------------------------------------------------------------------------------- +## 1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -32,18 +31,19 @@ App Storeのサブスクリプションを記録し、それぞれの有効性 ``` - + 開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。これを行うには、`initWithPrice`メソッドを使用して`ADJSubscription`オブジェクトを初期化します。さらに、以下の引数をパスします。 -| パラメーター | データタイプ | 説明 | -|-----------------|-------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `NSDecimalNumber` | サブスクリプションの価格 | +| パラメーター | データタイプ | 説明 | +| --------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `NSDecimalNumber` | サブスクリプションの価格 | | `currency` | `NSString` | サブスクリプションの通貨。[`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` | `NSString` | トランザクションID | -| `receipt` | `NSString` | レシート情報 | +| `transactionId` | `NSString` | トランザクションID | +| `receipt` | `NSString` | レシート情報 | - + + ```swift let subscription = ADJSubscription( @@ -52,7 +52,8 @@ let subscription = ADJSubscription( transactionId: transactionId) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -60,20 +61,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price transactionId:transactionId]; ``` - + + -### 購入データを記録する \{\#record\-the\-purchase\-date\} +### 購入データを記録する {#record-the-purchase-date} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - + ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。タイムスタンプを使用して`setTransactionDate`メソッドを呼び出し、この情報を記録します。 - + + + ```swift let subscription = ADJSubscription( @@ -84,7 +88,8 @@ let subscription = ADJSubscription( subscription.setTransactionDate(transactionDate) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -94,20 +99,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setTransactionDate:transactionDate]; ``` - + + -### 購入地域を記録する \{\#record\-the\-purchase\-region\} +### 購入地域を記録する {#record-the-purchase-region} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - + ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトの`setSalesRegion`メソッドを呼び、国コードを`NSString`としてパスします。これは、[`priceLocale`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift)としてフォーマットされる必要があります。 - + + + ```swift let subscription = ADJSubscription( @@ -118,7 +126,8 @@ let subscription = ADJSubscription( subscription.setSalesRegion(salesRegion) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -128,20 +137,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setSalesRegion:salesRegion]; ``` - + + -### コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +### コールバックパラメーターを追加する {#add-callback-parameters} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - + + + ```swift let subscription = ADJSubscription( @@ -153,7 +165,8 @@ subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -164,20 +177,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - + + -### パートナーパラメーターを追加する \{\#add\-partner\-parameters\} +### パートナーパラメーターを追加する {#add-partner-parameters} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - + + + ```swift let subscription = ADJSubscription( @@ -189,7 +205,8 @@ subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -200,21 +217,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - + + -2\. サブスクリプション情報を送信する \{\#send\-subscription\-information\} ----------------------------------------------------------------- +## 2\. サブスクリプション情報を送信する \{\#send\-subscription\-information\} - + ```objc + (void)trackSubscription:(nonnull ADJSubscription *)subscription; ``` - + サブスクリプションオブジェクトを設定したら、Adjust SDKを使用してそれをAdjustに送信できます。完了したオブジェクトを `trackSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 - + + + ```swift let subscription = ADJSubscription( @@ -238,7 +257,8 @@ subscription.addCallbackParameter("key2", value: "value2") Adjust.trackSubscription(subscription) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -258,5 +278,5 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [Adjust trackSubscription:subscription]; ``` - - + + diff --git a/src/content/docs/ja/sdk/ios/v5/features/subscriptions.mdx b/src/content/docs/ja/sdk/ios/v5/features/subscriptions.mdx index 06110a6c5d..bc863d1932 100644 --- a/src/content/docs/ja/sdk/ios/v5/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/ios/v5/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "サブスクリプション情報を送信する" -description: "Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。" -slug: "en/sdk/ios/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/ios/v4/features/subscriptions" +title: サブスクリプション情報を送信する +description: Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。 +slug: ja/sdk/ios/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ja/sdk/ios/v4/features/subscriptions --- - -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 - + + +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + + App Storeのサブスクリプションを記録し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`ADJAppStoreSubscription`インスタンスを作成します。 -1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} -------------------------------------------------------------------------------- +## 1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -31,17 +30,18 @@ App Storeのサブスクリプションを記録し、それぞれの有効性 transactionId:(nonnull NSString *)transactionId; ``` - + 開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。これを行うには、`initWithPrice`メソッドを使用して`ADJAppStoreSubscription`オブジェクトを初期化します。さらに、以下の引数をパスします。 -| パラメーター | データタイプ | 説明 | -|-----------------|-------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `NSDecimalNumber` | サブスクリプションの価格 | +| パラメーター | データタイプ | 説明 | +| --------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `NSDecimalNumber` | サブスクリプションの価格 | | `currency` | `NSString` | サブスクリプションの通貨。[`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` | `NSString` | トランザクションID | +| `transactionId` | `NSString` | トランザクションID | - + + ```swift let subscription = ADJAppStoreSubscription( @@ -50,7 +50,8 @@ let subscription = ADJAppStoreSubscription( transactionId: transactionId ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -58,20 +59,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit transactionId:transactionId]; ``` - + + -### 購入データを記録する \{\#record\-the\-purchase\-date\} +### 購入データを記録する {#record-the-purchase-date} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - + ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。タイムスタンプを使用して`setTransactionDate`メソッドを呼び出し、この情報を記録します。 - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -82,7 +86,8 @@ guard let subscription = ADJAppStoreSubscription( subscription.setTransactionDate(transactionDate) ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -92,20 +97,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setTransactionDate:transactionDate]; ``` - + + -### 購入地域を記録する \{\#record\-the\-purchase\-region\} +### 購入地域を記録する {#record-the-purchase-region} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - + ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトの`setSalesRegion`メソッドを呼び、国コードを`NSString`としてパスします。これは、[`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/storekit/storefront)としてフォーマットされる必要があります。 - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -116,7 +124,8 @@ guard let subscription = ADJAppStoreSubscription( subscription.setSalesRegion(salesRegion) ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -126,20 +135,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setSalesRegion:salesRegion]; ``` - + + -### コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +### コールバックパラメーターを追加する {#add-callback-parameters} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -151,7 +163,8 @@ subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -162,20 +175,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - + + -### パートナーパラメーターを追加する \{\#add\-partner\-parameters\} +### パートナーパラメーターを追加する {#add-partner-parameters} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -187,7 +203,8 @@ subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -198,21 +215,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - + + -2\. サブスクリプション情報を送信する \{\#send\-subscription\-information\} ----------------------------------------------------------------- +## 2\. サブスクリプション情報を送信する \{\#send\-subscription\-information\} - + ```objc + (void)trackAppStoreSubscription:(nonnull ADJAppStoreSubscription *)subscription; ``` - + サブスクリプションオブジェクトを設定したら、Adjust SDKを使用してそれをAdjustに送信できます。完了したオブジェクトを `trackAppStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -234,7 +253,8 @@ subscription.addCallbackParameter("key2", value: "value2") Adjust.trackAppStoreSubscription(subscription) ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -254,5 +274,5 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [Adjust trackAppStoreSubscription:subscription]; ``` - - + + diff --git a/src/content/docs/ja/sdk/testing/subscription-recording.mdx b/src/content/docs/ja/sdk/testing/subscription-recording.mdx index e54c2542d1..ab6e9fc9b2 100644 --- a/src/content/docs/ja/sdk/testing/subscription-recording.mdx +++ b/src/content/docs/ja/sdk/testing/subscription-recording.mdx @@ -1,21 +1,24 @@ --- -title: "サブスクリプション記録のテスト" -description: "Adjust SDKがAdjustにサブスクリプション情報を送信していることをテストする" -slug: "en/sdk/testing/subscription-recording" -sidebar-label: "サブスクリプション計測" +title: サブスクリプション記録のテスト +description: Adjust SDKがAdjustにサブスクリプション情報を送信していることをテストする +slug: ja/sdk/testing/subscription-recording +sidebar-label: サブスクリプション計測 sidebar-position: 3 --- + Adjust SDKを使用して、アプリ内でのサブスクリプション購入に関する情報を記録できます。 - + + テストが終了したら、SDK環境を **本番用** に設定してください。これにより、アプリが本番用モードで動作します。 - + + SDKのテストには以下のツールを使用できます。 -* Adjustテストコンソール（[AppView](https://help.adjust.com/en/article/testing-console)でご利用可能）。 -* [AdjustデバイスAPI](/en/api/device-api/inspect) -* IDEのログアウトプット +- Adjustテストコンソール（[AppView](https://help.adjust.com/ja/article/testing-console)でご利用可能）。 +- [AdjustデバイスAPI](/ja/api/device-api/inspect) +- IDEのログアウトプット これが機能していることをテストするには、以下の手順に従ってください。 @@ -23,10 +26,11 @@ SDKのテストには以下のツールを使用できます。 2. 環境を **サンドボックス** に設定します。これにより、アプリからはテストコンソールにのみ情報が送信されるようになります。 3. アプリから全てのログ情報を取得するために、ログレベルを **verbose** に設定します。 4. テストデバイスまたはエミュレートされたデバイスを設定し、デバイスの広告IDを確認します。[Adjust Insightsアプリ](https://apps.apple.com/us/app/adjust-insights/id1125517808)をインストールして、この情報を見つけることができます。 -5. 以前にこのデバイスをテストに使用したことがある場合は、以下の手順に従ってください。 +5. 以前にこのデバイスをテストに使用したことがある場合は、以下の手順に従ってください。 + 1. テスト用デバイスからアプリを削除します。 - 2. テストコンソールからデバイスの広告IDを消去します。[AppViewのテストコンソール](https://help.adjust.com/en/article/testing-console#forget-device)向けの手順に従ってください。 - 3. または、[Forget deviceのエンドポイント](/en/api/device-api/forget/)を呼び出して、デバイスに関する既存の情報を削除することができます。 + 2. テストコンソールからデバイスの広告IDを消去します。[AppViewのテストコンソール](https://help.adjust.com/ja/article/testing-console#forget-device)向けの手順に従ってください。 + 3. または、[Forget deviceのエンドポイント](/ja/api/device-api/forget/)を呼び出して、デバイスに関する既存の情報を削除することができます。 6. Adjust SDKを含むアプリのテストバージョンをダウンロードして開きます。 7. テスト購入をトリガーします。 @@ -34,10 +38,9 @@ SDKのテストには以下のツールを使用できます。 サブスクリプションが正常に記録されている場合、コンソール出力で次のフィールドの値が入力されます。 -* **LastSubscriptionEventType** -* [**Last Subscription Event Subtype**](https://help.adjust.com/en/article/manage-subscription-data#subscription-event-subtypes) -* **LastSubscriptionEventTimestamp** -* **製品ID** +- **LastSubscriptionEventType** +- [**Last Subscription Event Subtype**](https://help.adjust.com/ja/article/manage-subscription-data#subscription-event-subtypes) +- **LastSubscriptionEventTimestamp** +- **製品ID** ![Adjustテストコンソール](@images/sdk-testing/subscription/testing-console.png) - diff --git a/src/content/docs/ja/sdk/unity/v4/features/subscriptions.mdx b/src/content/docs/ja/sdk/unity/v4/features/subscriptions.mdx index c06ba31f18..ce11a3dee5 100644 --- a/src/content/docs/ja/sdk/unity/v4/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/unity/v4/features/subscriptions.mdx @@ -1,45 +1,46 @@ --- -title: "サブスクリプション情報を送信する" -description: "Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。" -slug: "en/sdk/unity/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/unity/features/subscriptions" +title: サブスクリプション情報を送信する +description: Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。 +slug: ja/sdk/unity/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ja/sdk/unity/features/subscriptions --- - -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 - + + +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + + App StoreおよびPlay Storeのサブスクリプションを計測し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`AdjustAppStoreSubscription`または`AdjustPlayStoreSubscription`を作成してください。 -1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} -------------------------------------------------------------------------------- +## 1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} 開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。 - + + + ```cs public AdjustAppStoreSubscription(string price, string currency, string transactionId, string receipt) ``` - + 以下のプロパティを含む`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 | -| `receipt` | `string` | レシート情報 | +| パラメーター | データタイプ | 説明 | +| --------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `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 | +| `receipt` | `string` | レシート情報 | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -49,24 +50,25 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - + + ```cs public 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のドキュメント](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のドキュメント]()を参照してください | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -78,18 +80,21 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - + + -### 購入データを記録する \{\#record\-the\-purchase\-date\} +### 購入データを記録する {#record-the-purchase-date} ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。 - + + + ```cs public void setTransactionDate(string transactionDate); ``` - + サブスクリプションオブジェクトで`setTransactionDate`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 @@ -103,13 +108,14 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - + + ```cs public void setPurchaseTime(string purchaseTime); ``` - + サブスクリプションオブジェクトで`setPurchaseTime`メソッドを呼び出し、サブスクリプションのタイムスタンプを記録します。 @@ -124,17 +130,18 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### 購入地域を記録する（iOSのみ） \{\#record\-the\-purchase\-region\-ios\-only\} +### 購入地域を記録する（iOSのみ） {#record-the-purchase-region-ios-only} - + ```cs public void setSalesRegion(string salesRegion); ``` - + ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、subscriptionオブジェクトの`setSalesRegion`メソッドを呼び、国コードを`string`としてパスします。これは、[`priceLocale`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift)としてフォーマットされる必要があります。 @@ -148,16 +155,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +### コールバックパラメーターを追加する {#add-callback-parameters} コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`addCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - + + + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -170,13 +179,14 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -191,18 +201,21 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + -### パートナーパラメーターを追加する \{\#add\-partner\-parameters\} +### パートナーパラメーターを追加する {#add-partner-parameters} パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`addPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - + + + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -215,13 +228,14 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -236,19 +250,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + -2\. サブスクリプション情報を記録する \{\#record\-subscription\-information\} ------------------------------------------------------------------- +## 2\. サブスクリプション情報を記録する \{\#record\-subscription\-information\} サブスクリプションオブジェクトを設定したら、Adjust SDKを使用して記録することが可能です。 - + + + ```cs public static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + 完了したオブジェクトを `trackAppStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 @@ -268,13 +284,14 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```cs public static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + 完了したオブジェクトを `trackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 @@ -295,5 +312,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ja/sdk/unity/v5/features/subscriptions.mdx b/src/content/docs/ja/sdk/unity/v5/features/subscriptions.mdx index 4fe72ffbaf..746c3a58c1 100644 --- a/src/content/docs/ja/sdk/unity/v5/features/subscriptions.mdx +++ b/src/content/docs/ja/sdk/unity/v5/features/subscriptions.mdx @@ -1,44 +1,45 @@ --- -title: "サブスクリプション情報を送信する" -description: "Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。" -slug: "en/sdk/unity/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/unity/v4/features/subscriptions" +title: サブスクリプション情報を送信する +description: Adjustにサブスクリプション情報を送信するには、これらのメソッドを使用してください。 +slug: ja/sdk/unity/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ja/sdk/unity/v4/features/subscriptions --- - -以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)の手順に従ってください。 - + + +以下の手順は、Adjust SDK内でサブスクリプション計測を行う場合にのみ有効です。この機能を有効化するには、[アプリにサブスクリプションを設定](https://help.adjust.com/ja/article/set-up-subscriptions-for-your-app)の手順に従ってください。 + + App StoreおよびPlay Storeのサブスクリプションを計測し、それぞれの有効性をAdjust SDKで確認できます。ユーザーがサブスクリプションの購入を完了したら、その詳細を含む`AdjustAppStoreSubscription`または`AdjustPlayStoreSubscription`を作成してください。 -1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} -------------------------------------------------------------------------------- +## 1\. サブスクリプションオブジェクトをインスタンス化する \{\#instantiate\-a\-subscription\-object\} 開始するには、サブスクリプション購入の詳細を含むサブスクリプションオブジェクトを作成する必要があります。 - + + + ```cs public 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 | +| パラメーター | データタイプ | 説明 | +| --------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `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 | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -47,24 +48,25 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - + + ```cs public 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のドキュメント](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のドキュメント]()を参照してください | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -76,18 +78,21 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - + + -### 購入データを記録する \{\#record\-the\-purchase\-date\} +### 購入データを記録する {#record-the-purchase-date} ユーザーがサブスクリプションを購入した日を記録することができます。SDKはこのデータを返して、レポートします。 - + + + ```cs public string TransactionDate { get; set; } ``` - + `AdjustAppStoreSubscription`インスタンスの`setTransactionDate`プロパティを設定し、サブスクリプションのタイムスタンプを記録します。 @@ -100,13 +105,14 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.TransactionDate = transactionDate; ``` - + + ```cs public string PurchaseTime { get; set; } ``` - + `AdjustPlayStoreSubscription`インスタンスの`PurchaseTime`プロパティを設定し、サブスクリプションのタイムスタンプを記録します。 @@ -121,17 +127,18 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.PurchaseTime = purchaseTime; ``` - + + -### 購入地域を記録する（iOSのみ） \{\#record\-the\-purchase\-region\-ios\-only\} +### 購入地域を記録する（iOSのみ） {#record-the-purchase-region-ios-only} - + ```cs public string SalesRegion { get; set; } ``` - + ユーザーがサブスクリプションを購入した地域を記録することができます。これを行うには、 `AdjustPlayStoreSubscription`インスタンスの`SalesRegion`プロパティを`string`として国コードに設定します。これは、[`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)オブジェクトの[`countryCode`](https://developer.apple.com/documentation/storekit/storefront)としてフォーマットされる必要があります。 @@ -144,16 +151,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.SalesRegiom = salesRegion; ``` -### コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +### コールバックパラメーターを追加する {#add-callback-parameters} コールバックパラメーターをサブスクリプションオブジェクトに追加することができます。Adjustは、これらのパラメーターをコールバックURLに追加します。コールバックパラメーターを追加するには、サブスクリプションオブジェクトの`AddCallbackParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - + + + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -165,13 +174,14 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - + + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -186,18 +196,21 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - + + -### パートナーパラメーターを追加する \{\#add\-partner\-parameters\} +### パートナーパラメーターを追加する {#add-partner-parameters} パートナーパラメーターをサブスクリプションオブジェクトに追加することができます。SDKは、ユーザーがサブスクリプションを購入した時に、Adjustサーバーへこれらを送信します。Adjustサーバーは、その情報をネットワークパートナーに転送します。パラメーターパラメーターを追加するには、サブスクリプションオブジェクトの`AddPartnerParameter`メソッドを呼び出してください。このメソッドを複数回呼び出すことで、複数のコールバックパラメーターを追加できます。 - + + + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -209,13 +222,14 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - + + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -230,19 +244,21 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - + + -2\. サブスクリプション情報を記録する \{\#record\-subscription\-information\} ------------------------------------------------------------------- +## 2\. サブスクリプション情報を記録する \{\#record\-subscription\-information\} サブスクリプションオブジェクトを設定したら、Adjust SDKを使用して記録することが可能です。 - + + + ```cs public static void TrackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + 完了したオブジェクトを `Adjust.TrackAppStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 @@ -261,13 +277,14 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackAppStoreSubscription(subscription); ``` - + + ```cs public static void TrackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + 完了したオブジェクトを `Adjust.TrackPlayStoreSubscription`メソッドにパスして、ユーザーのサブスクリプション購入を記録します。 @@ -288,5 +305,5 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ko/sdk/android/v4/features/subscriptions.mdx b/src/content/docs/ko/sdk/android/v4/features/subscriptions.mdx index 326c5847a5..81dc6febf2 100644 --- a/src/content/docs/ko/sdk/android/v4/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/android/v4/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "구독 정보 전송" -description: "이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다." -slug: "en/sdk/android/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/android/features/subscriptions" +title: 구독 정보 전송 +description: 이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다. +slug: ko/sdk/android/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ko/sdk/android/features/subscriptions --- - -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. - + + +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + + 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustPlayStoreSubscription` 객체를 생성하시기 바랍니다. -1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} ------------------------------------------------------------------ +## 1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} - + ```java public AdjustPlayStoreSubscription(final long price, @@ -35,20 +34,21 @@ public AdjustPlayStoreSubscription(final long price, ``` - + 시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 인스턴스화해야 합니다. 이를 위해 새로운 `AdjustPlayStoreSubscription` 객체를 생성하고 다음 인수를 전달합니다. -| 파라미터 | 데이터 유형 | 설명 | -|-----------------|----------|-----------------------------------------------------------------------------------------------------------------------------| -| `price` | `long` | 구독료 | -| `currency` | `String` | 구독 통화 | -| `sku` | `String` | 제품 ID | -| `orderId` | `String` | 거래 ID | -| `signature` | `String` | 구매 데이터의 서명 | -| `purchaseToken` | `String` | 거래의 고유 토큰. 자세한 정보는 [Google 문서](https://developer.android.com/reference/com/android/billingclient/api/Purchase)를 참조하시기 바랍니다. | +| 파라미터 | 데이터 유형 | 설명 | +| --------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `long` | 구독료 | +| `currency` | `String` | 구독 통화 | +| `sku` | `String` | 제품 ID | +| `orderId` | `String` | 거래 ID | +| `signature` | `String` | 구매 데이터의 서명 | +| `purchaseToken` | `String` | 거래의 고유 토큰. 자세한 정보는 [Google 문서](https://developer.android.com/reference/com/android/billingclient/api/Purchase)를 참조하시기 바랍니다. | - + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,7 +62,8 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -76,20 +77,23 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### 구매일 기록 \{\#record\-the\-purchase\-date\} +### 구매일 기록 {#record-the-purchase-date} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + 사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. 이 정보를 기록할 타임스탬프와 함께 `setPurchaseTime` 메서드를 호출합니다. - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -104,7 +108,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -119,75 +124,85 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### 콜백 파라미터 추가 \{\#add\-callback\-parameters\} +### 콜백 파라미터 추가 {#add-callback-parameters} - + ```java public void addCallbackParameter(String key, String value) ``` - + 콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. - + + + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - + + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - + + -### 파트너 파라미터 추가 \{\#add\-partner\-parameters\} +### 파트너 파라미터 추가 {#add-partner-parameters} - + ```java public void addPartnerParameter(String key, String value) ``` - + Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. - + + + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - + + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - + + -2\. 구독 정보 전송 \{\#send\-subscription\-information\} --------------------------------------------------------- +## 2\. 구독 정보 전송 \{\#send\-subscription\-information\} - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - + 구독 객체를 설정하고 나면 Adjust SDK를 사용하여 Adjust에 전송할 수 있습니다. 완료된 객체를 `trackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -202,7 +217,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -217,5 +233,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ko/sdk/android/v5/features/subscriptions.mdx b/src/content/docs/ko/sdk/android/v5/features/subscriptions.mdx index 402910de81..0e07d3c8b5 100644 --- a/src/content/docs/ko/sdk/android/v5/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/android/v5/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "구독 정보 전송" -description: "이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다." -slug: "en/sdk/android/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/android/v4/features/subscriptions" +title: 구독 정보 전송 +description: 이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다. +slug: ko/sdk/android/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ko/sdk/android/v4/features/subscriptions --- - -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. - + + +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + + 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustPlayStoreSubscription` 객체를 생성하시기 바랍니다. -1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} ------------------------------------------------------------------ +## 1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} - + ```java public AdjustPlayStoreSubscription(final long price, @@ -35,20 +34,21 @@ public AdjustPlayStoreSubscription(final long price, ``` - + 시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 인스턴스화해야 합니다. 이를 위해 새로운 `AdjustPlayStoreSubscription` 객체를 생성하고 다음 인수를 전달합니다. -| 파라미터 | 데이터 유형 | 설명 | -|-----------------|----------|-----------------------------------------------------------------------------------------------------------------------------| -| `price` | `long` | 구독료 | -| `currency` | `String` | 구독 통화 | -| `sku` | `String` | 제품 ID | -| `orderId` | `String` | 거래 ID | -| `signature` | `String` | 구매 데이터의 서명 | -| `purchaseToken` | `String` | 거래의 고유 토큰. 자세한 정보는 [Google 문서](https://developer.android.com/reference/com/android/billingclient/api/Purchase)를 참조하시기 바랍니다. | +| 파라미터 | 데이터 유형 | 설명 | +| --------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `long` | 구독료 | +| `currency` | `String` | 구독 통화 | +| `sku` | `String` | 제품 ID | +| `orderId` | `String` | 거래 ID | +| `signature` | `String` | 구매 데이터의 서명 | +| `purchaseToken` | `String` | 거래의 고유 토큰. 자세한 정보는 [Google 문서](https://developer.android.com/reference/com/android/billingclient/api/Purchase)를 참조하시기 바랍니다. | - + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,7 +62,8 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -76,20 +77,23 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### 구매일 기록 \{\#record\-the\-purchase\-date\} +### 구매일 기록 {#record-the-purchase-date} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + 사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. 이 정보를 기록할 타임스탬프와 함께 `setPurchaseTime` 메서드를 호출합니다. - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -104,7 +108,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -119,75 +124,85 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### 콜백 파라미터 추가 \{\#add\-callback\-parameters\} +### 콜백 파라미터 추가 {#add-callback-parameters} - + ```java public void addCallbackParameter(String key, String value) ``` - + 콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. - + + + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - + + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - + + -### 파트너 파라미터 추가 \{\#add\-partner\-parameters\} +### 파트너 파라미터 추가 {#add-partner-parameters} - + ```java public void addPartnerParameter(String key, String value) ``` - + Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. - + + + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - + + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - + + -2\. 구독 정보 전송 \{\#send\-subscription\-information\} --------------------------------------------------------- +## 2\. 구독 정보 전송 \{\#send\-subscription\-information\} - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - + 구독 객체를 설정하고 나면 Adjust SDK를 사용하여 Adjust에 전송할 수 있습니다. 완료된 객체를 `trackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -202,7 +217,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -217,5 +233,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ko/sdk/cordova/v4/features/subscriptions.mdx b/src/content/docs/ko/sdk/cordova/v4/features/subscriptions.mdx index 2eb64ac42f..bc62d9337b 100644 --- a/src/content/docs/ko/sdk/cordova/v4/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/cordova/v4/features/subscriptions.mdx @@ -1,45 +1,46 @@ --- -title: "구독 정보 전송" -description: "이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다." -slug: "en/sdk/cordova/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/cordova/features/subscriptions" +title: 구독 정보 전송 +description: 이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다. +slug: ko/sdk/cordova/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ko/sdk/cordova/features/subscriptions --- - -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. - + + +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + + 앱 스토어 및 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustAppStoreSubscription` 또는 `AdjustPlayStoreSubscription` 인스턴스를 생성하시기 바랍니다. -1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} ------------------------------------------------------------------ +## 1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} 시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. - + + + ```js constructor(price: string, currency: string, transactionId: string, receipt: string) ``` - + 다음 속성을 포함하는 `AdjustAppStoreSubscription` 객체를 생성합니다. -| 파라미터 | 데이터 유형 | 설명 | -|-----------------|--------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | Number | 구독료 | -| `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 | -| `receipt` | String | 영수증 정보 | +| 파라미터 | 데이터 유형 | 설명 | +| --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | Number | 구독료 | +| `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 | +| `receipt` | String | 영수증 정보 | ```js var subscription = new AdjustAppStoreSubscription( @@ -50,24 +51,25 @@ var subscription = new AdjustAppStoreSubscription( ); ``` - + + ```js constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + 다음 속성을 포함하는 `AdjustPlayStoreSubscription` 객체를 생성합니다. -| 파라미터 | 데이터 유형 | 설명 | -|-----------------|--------|------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | Number | 구독료 | -| `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` | Number | 구독료 | +| `currency` | String | 구독 통화 | +| `sku` | String | 제품 ID | +| `orderId` | String | 거래 ID | +| `signature` | String | 구매 데이터의 서명 | +| `purchaseToken` | String | 거래의 고유 토큰. 자세한 정보는 [Google 문서]()를 참조하시기 바랍니다. | ```js var subscription = new AdjustPlayStoreSubscription( @@ -80,18 +82,21 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - + + -### 구매일 기록 \{\#record\-the\-purchase\-date\} +### 구매일 기록 {#record-the-purchase-date} 사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. - + + + ```js setTransactionDate(transactionDate: string): void ``` - + 구독 객체의 `setTransactionDate` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. @@ -106,13 +111,14 @@ var subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - + + ```js setPurchaseTime(purchaseTime: string): void ``` - + 구독 객체의 `setPurchaseTime` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. @@ -128,17 +134,18 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### 구매 지역 기록\(iOS만 해당\) \{\#record\-the\-purchase\-region\-ios\-only\} +### 구매 지역 기록\(iOS만 해당\) {#record-the-purchase-region-ios-only} - + ```js setSalesRegion(salesRegion: string): void ``` - + 사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `string`로 전달합니다. 이는 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront)로 포맷되어야 합니다. @@ -153,16 +160,18 @@ var subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### 콜백 파라미터 추가 \{\#add\-callback\-parameters\} +### 콜백 파라미터 추가 {#add-callback-parameters} 콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. - + + + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -176,13 +185,14 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -198,18 +208,21 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + -### 파트너 파라미터 추가 \{\#add\-partner\-parameters\} +### 파트너 파라미터 추가 {#add-partner-parameters} Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. - + + + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -223,13 +236,14 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -245,19 +259,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + -2\. 구독 정보 기록 \{\#record\-subscription\-information\} ----------------------------------------------------------- +## 2\. 구독 정보 기록 \{\#record\-subscription\-information\} 구독 객체를 설정하고 나면 Adjust SDK를 사용하여 기록을 시작할 수 있습니다. - + + + ```js trackAppStoreSubscription(subscription: AdjustAppStoreSubscription): void ``` - + 구독 객체를 `trackAppStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. @@ -278,13 +294,14 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```js trackPlayStoreSubscription(subscription: AdjustPlayStoreSubscription): void ``` - + 구독 객체를 `trackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. @@ -306,5 +323,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ko/sdk/cordova/v5/features/subscriptions.mdx b/src/content/docs/ko/sdk/cordova/v5/features/subscriptions.mdx index 94b304413e..05ff6e7057 100644 --- a/src/content/docs/ko/sdk/cordova/v5/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/cordova/v5/features/subscriptions.mdx @@ -1,41 +1,42 @@ --- -title: "구독 정보 전송" -description: "이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다." -slug: "en/sdk/cordova/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/cordova/v4/features/subscriptions" +title: 구독 정보 전송 +description: 이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다. +slug: ko/sdk/cordova/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ko/sdk/cordova/v4/features/subscriptions --- - -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. - + + +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + + 앱 스토어 및 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustAppStoreSubscription` 또는 `AdjustPlayStoreSubscription` 인스턴스를 생성하시기 바랍니다. -1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} ------------------------------------------------------------------ +## 1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} 시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. - + + + ```ts constructor(price: string, currency: string, transactionId: string) ``` - + 다음 속성들을 포함하는 `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 \| \| +\| 파라미터 \| 데이터 유형 \| 설명 \| \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| \| `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 \| \| ```js var subscription = new AdjustAppStoreSubscription( @@ -46,24 +47,25 @@ var subscription = new AdjustAppStoreSubscription( Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + 다음 속성들을 포함하는 `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 문서]()를 참조하시기 바랍니다. | ```js var subscription = new AdjustPlayStoreSubscription( @@ -76,18 +78,21 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - + + -### 구매일 기록 \{\#record\-the\-purchase\-date\} +### 구매일 기록 {#record-the-purchase-date} 사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. - + + + ```ts setTransactionDate(transactionDate: string): void ``` - + 구독 객체의 `setTransactionDate` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. @@ -102,13 +107,14 @@ subscription.setTransactionDate(transactionDate); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts setPurchaseTime(purchaseTime: string): void ``` - + 구독 객체의 `setPurchaseTime` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. @@ -124,17 +130,18 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### 구매 지역 기록\(iOS만 해당\) \{\#record\-the\-purchase\-region\-ios\-only\} +### 구매 지역 기록\(iOS만 해당\) {#record-the-purchase-region-ios-only} - + ```ts setSalesRegion(salesRegion: string): void ``` - + 사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `string`로 전달합니다. 이는 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront)로 포맷되어야 합니다. @@ -149,16 +156,18 @@ subscription.setSalesRegion(salesRegion); Adjust.trackPlayStoreSubscription(subscription); ``` -### 콜백 파라미터 추가 \{\#add\-callback\-parameters\} +### 콜백 파라미터 추가 {#add-callback-parameters} 콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. - + + + ```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -175,13 +184,14 @@ subscription.addCallbackParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -197,18 +207,21 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + -### 파트너 파라미터 추가 \{\#add\-partner\-parameters\} +### 파트너 파라미터 추가 {#add-partner-parameters} Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. - + + + ```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -225,13 +238,14 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -247,19 +261,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + -2\. 구독 정보 기록 \{\#record\-subscription\-information\} ----------------------------------------------------------- +## 2\. 구독 정보 기록 \{\#record\-subscription\-information\} 구독 객체를 설정하고 나면 Adjust SDK를 사용하여 기록을 시작할 수 있습니다. - + + + ```ts trackAppStoreSubscription(adjustAppStoreSubscription: AdjustAppStoreSubscription): void ``` - + 구독 객체를 `trackAppStoreSubscription` 메서드 메서드로 전달하여 사용자의 구독 구매를 기록합니다. @@ -275,13 +291,14 @@ subscription.setSalesRegion(salesRegion); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts trackPlayStoreSubscription(adjustPlayStoreSubscription: AdjustPlayStoreSubscription): void ``` - + 구독 객체를 `trackPlayStoreSubscription` 메서드 메서드로 전달하여 사용자의 구독 구매를 기록합니다. @@ -299,5 +316,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ko/sdk/flutter/v4/features/subscriptions.mdx b/src/content/docs/ko/sdk/flutter/v4/features/subscriptions.mdx index de79ef7c19..24302c652f 100644 --- a/src/content/docs/ko/sdk/flutter/v4/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/flutter/v4/features/subscriptions.mdx @@ -1,45 +1,46 @@ --- -title: "구독 정보 전송" -description: "이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다." -slug: "en/sdk/flutter/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/flutter/features/subscriptions" +title: 구독 정보 전송 +description: 이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다. +slug: ko/sdk/flutter/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ko/sdk/flutter/features/subscriptions --- - -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. - + + +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + + 앱 스토어 및 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustAppStoreSubscription` 또는 `AdjustPlayStoreSubscription` 인스턴스를 생성하시기 바랍니다. -1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} ------------------------------------------------------------------ +## 1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} 시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. - + + + ```dart AdjustAppStoreSubscription(String _price, String _currency, String _transactionId, String _receipt) ``` - + 다음 속성을 포함하는 `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 | -| `receipt` | `String` | 영수증 정보 | +| 파라미터 | 데이터 유형 | 설명 | +| --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `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 | +| `receipt` | `String` | 영수증 정보 | ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -49,24 +50,25 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - + + ```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 문서](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 문서]()를 참조하시기 바랍니다. | ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -78,18 +80,21 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - + + -### 구매일 기록 \{\#record\-the\-purchase\-date\} +### 구매일 기록 {#record-the-purchase-date} 사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. - + + + ```dart void setTransactionDate(String _transactionDate) ``` - + 구독 객체의 `setTransactionDate` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. @@ -103,13 +108,14 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - + + ```dart void setPurchaseTime(String purchaseTime) ``` - + 구독 객체의 `setPurchaseTime` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. @@ -124,17 +130,18 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### 구매 지역 기록\(iOS만 해당\) \{\#record\-the\-purchase\-region\-ios\-only\} +### 구매 지역 기록\(iOS만 해당\) {#record-the-purchase-region-ios-only} - + ```dart void setSalesRegion(String _salesRegion) ``` - + 사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `String`로 전달합니다. 이는 [`priceLocale`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift)로 포맷되어야 합니다. @@ -148,16 +155,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### 콜백 파라미터 추가 \{\#add\-callback\-parameters\} +### 콜백 파라미터 추가 {#add-callback-parameters} 콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. - + + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -170,13 +179,14 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -191,18 +201,21 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - + + -### 파트너 파라미터 추가 \{\#add\-partner\-parameters\} +### 파트너 파라미터 추가 {#add-partner-parameters} Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. - + + + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -215,13 +228,14 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - + + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -236,19 +250,21 @@ 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` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. @@ -268,13 +284,14 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + 구독 객체를 `trackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. @@ -295,5 +312,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ko/sdk/flutter/v5/features/subscriptions.mdx b/src/content/docs/ko/sdk/flutter/v5/features/subscriptions.mdx index c6b1efe1c0..710272e48d 100644 --- a/src/content/docs/ko/sdk/flutter/v5/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/flutter/v5/features/subscriptions.mdx @@ -1,41 +1,42 @@ --- -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" +title: 구독 정보 전송 +description: 이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다. +slug: ko/sdk/flutter/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ko/sdk/flutter/v4/features/subscriptions --- - -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. - + + +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + + 앱 스토어 및 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `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 \| \| +\| 파라미터 \| 데이터 유형 \| 설명 \| \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| \| `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 \| \| ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -44,24 +45,25 @@ 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 문서](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 문서]()를 참조하시기 바랍니다. | ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -73,21 +75,25 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - + + -### 구매일 기록 \{\#record\-the\-purchase\-date\} +### 구매일 기록 {#record-the-purchase-date} 사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. - + + + `AdjustAppStoreSubscription` 클래스에`transactionDate` 속성을 추가합니다. - + + ```dart String? transactionDate ``` - + `subscription` 인스턴스의 `transactionDate` 속성에 타임스탬프를 설정하면 사용자가 구독을 결제한 날을 기록할 수 있습니다. @@ -100,16 +106,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.transactionDate = 'transactionDate'; ``` - + + `AdjustPlayStoreSubscription` 클래스에`purchaseTime` 속성을 추가합니다. - + + ```dart String? purchaseTime; ``` - + `subscription` 인스턴스의 `purchaseTime` 속성에 타임스탬프를 설정하면 사용자가 구독을 결제한 날을 기록할 수 있습니다. @@ -124,17 +132,18 @@ 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)로 포맷되어야 합니다. @@ -147,16 +156,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.salesRegion = 'sales-region'; ``` -### 콜백 파라미터 추가 \{\#add\-callback\-parameters\} +### 콜백 파라미터 추가 {#add-callback-parameters} 콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. - + + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -168,13 +179,14 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -189,18 +201,21 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - + + -### 파트너 파라미터 추가 \{\#add\-partner\-parameters\} +### 파트너 파라미터 추가 {#add-partner-parameters} Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. - + + + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -212,13 +227,14 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - + + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -233,19 +249,21 @@ 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` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. @@ -264,13 +282,14 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + 구독 객체를 `trackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. @@ -291,5 +310,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ko/sdk/ios/v4/features/subscriptions.mdx b/src/content/docs/ko/sdk/ios/v4/features/subscriptions.mdx index a35ab961cf..68c1d8d087 100644 --- a/src/content/docs/ko/sdk/ios/v4/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/ios/v4/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "구독 정보 전송" -description: "이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다." -slug: "en/sdk/ios/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/ios/features/subscriptions" +title: 구독 정보 전송 +description: 이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다. +slug: ko/sdk/ios/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ko/sdk/ios/features/subscriptions --- - -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. - + + +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + + 앱 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `ADJSubscription` 인스턴스를 생성하시기 바랍니다. -1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} ------------------------------------------------------------------ +## 1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -32,18 +31,19 @@ redirects: ``` - + 시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. 이 작업을 위해서는 `initWithPrice` 메서드를 사용해 `ADJSubscription` 객체를 초기화합니다. 다음 인수를 전달합니다. -| 파라미터 | 데이터 유형 | 설명 | -|-----------------|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `NSDecimalNumber` | 구독료 | +| 파라미터 | 데이터 유형 | 설명 | +| --------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `NSDecimalNumber` | 구독료 | | `currency` | `NSString` | 구독 통화. [`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` | `NSString` | 거래 ID | -| `receipt` | `NSString` | 영수증 정보 | +| `transactionId` | `NSString` | 거래 ID | +| `receipt` | `NSString` | 영수증 정보 | - + + ```swift let subscription = ADJSubscription( @@ -52,7 +52,8 @@ let subscription = ADJSubscription( transactionId: transactionId) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -60,20 +61,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price transactionId:transactionId]; ``` - + + -### 구매일 기록 \{\#record\-the\-purchase\-date\} +### 구매일 기록 {#record-the-purchase-date} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - + 사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. 이 정보를 기록할 타임스탬프와 함께 `setTransactionDate` 메서드를 호출합니다. - + + + ```swift let subscription = ADJSubscription( @@ -84,7 +88,8 @@ let subscription = ADJSubscription( subscription.setTransactionDate(transactionDate) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -94,20 +99,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setTransactionDate:transactionDate]; ``` - + + -### 구매 지역 기록 \{\#record\-the\-purchase\-region\} +### 구매 지역 기록 {#record-the-purchase-region} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - + 사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `NSString`로 전달합니다. 이는 [`priceLocale`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift)로 포맷되어야 합니다. - + + + ```swift let subscription = ADJSubscription( @@ -118,7 +126,8 @@ let subscription = ADJSubscription( subscription.setSalesRegion(salesRegion) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -128,20 +137,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setSalesRegion:salesRegion]; ``` - + + -### 콜백 파라미터 추가 \{\#add\-callback\-parameters\} +### 콜백 파라미터 추가 {#add-callback-parameters} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + 콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. - + + + ```swift let subscription = ADJSubscription( @@ -153,7 +165,8 @@ subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -164,20 +177,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - + + -### 파트너 파라미터 추가 \{\#add\-partner\-parameters\} +### 파트너 파라미터 추가 {#add-partner-parameters} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. - + + + ```swift let subscription = ADJSubscription( @@ -189,7 +205,8 @@ subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -200,21 +217,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - + + -2\. 구독 정보 전송 \{\#send\-subscription\-information\} --------------------------------------------------------- +## 2\. 구독 정보 전송 \{\#send\-subscription\-information\} - + ```objc + (void)trackSubscription:(nonnull ADJSubscription *)subscription; ``` - + 구독 객체를 설정하고 나면 Adjust SDK를 사용하여 Adjust에 전송할 수 있습니다. 완료된 객체를 `trackSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. - + + + ```swift let subscription = ADJSubscription( @@ -238,7 +257,8 @@ subscription.addCallbackParameter("key2", value: "value2") Adjust.trackSubscription(subscription) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -258,5 +278,5 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [Adjust trackSubscription:subscription]; ``` - - + + diff --git a/src/content/docs/ko/sdk/ios/v5/features/subscriptions.mdx b/src/content/docs/ko/sdk/ios/v5/features/subscriptions.mdx index 4255422464..b1a0052934 100644 --- a/src/content/docs/ko/sdk/ios/v5/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/ios/v5/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "구독 정보 전송" -description: "이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다." -slug: "en/sdk/ios/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/ko/sdk/ios/v4/features/subscriptions" +title: 구독 정보 전송 +description: 이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다. +slug: ko/sdk/ios/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ko/sdk/ios/v4/features/subscriptions --- - -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. - + + +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + + 앱 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `ADJAppStoreSubscription` 인스턴스를 생성하시기 바랍니다. -1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} ------------------------------------------------------------------ +## 1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -31,17 +30,18 @@ redirects: transactionId:(nonnull NSString *)transactionId; ``` - + 시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. 이 작업을 위해서는 `initWithPrice` 메서드를 사용해 `ADJAppStoreSubscription` 객체를 초기화합니다. 다음 인수를 전달합니다. -| 파라미터 | 데이터 유형 | 설명 | -|-----------------|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `NSDecimalNumber` | 구독료 | +| 파라미터 | 데이터 유형 | 설명 | +| --------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `NSDecimalNumber` | 구독료 | | `currency` | `NSString` | 구독 통화. [`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` | `NSString` | 거래 ID | +| `transactionId` | `NSString` | 거래 ID | - + + ```swift let subscription = ADJAppStoreSubscription( @@ -50,7 +50,8 @@ let subscription = ADJAppStoreSubscription( transactionId: transactionId ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -58,20 +59,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit transactionId:transactionId]; ``` - + + -### 구매일 기록 \{\#record\-the\-purchase\-date\} +### 구매일 기록 {#record-the-purchase-date} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - + 사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. 이 정보를 기록할 타임스탬프와 함께 `setTransactionDate` 메서드를 호출합니다. - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -82,7 +86,8 @@ guard let subscription = ADJAppStoreSubscription( subscription.setTransactionDate(transactionDate) ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -92,20 +97,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setTransactionDate:transactionDate]; ``` - + + -### 구매 지역 기록 \{\#record\-the\-purchase\-region\} +### 구매 지역 기록 {#record-the-purchase-region} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - + 사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `NSString`로 전달합니다. 이는 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront)로 포맷되어야 합니다. - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -116,7 +124,8 @@ guard let subscription = ADJAppStoreSubscription( subscription.setSalesRegion(salesRegion) ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -126,20 +135,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setSalesRegion:salesRegion]; ``` - + + -### 콜백 파라미터 추가 \{\#add\-callback\-parameters\} +### 콜백 파라미터 추가 {#add-callback-parameters} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + 콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -151,7 +163,8 @@ subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -162,20 +175,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - + + -### 파트너 파라미터 추가 \{\#add\-partner\-parameters\} +### 파트너 파라미터 추가 {#add-partner-parameters} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -187,7 +203,8 @@ subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -198,21 +215,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - + + -2\. 구독 정보 전송 \{\#send\-subscription\-information\} --------------------------------------------------------- +## 2\. 구독 정보 전송 \{\#send\-subscription\-information\} - + ```objc + (void)trackAppStoreSubscription:(nonnull ADJAppStoreSubscription *)subscription; ``` - + 구독 객체를 설정하고 나면 Adjust SDK를 사용하여 Adjust에 전송할 수 있습니다. 완료된 객체를 `trackAppStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -234,7 +253,8 @@ subscription.addCallbackParameter("key2", value: "value2") Adjust.trackAppStoreSubscription(subscription) ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -254,5 +274,5 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [Adjust trackAppStoreSubscription:subscription]; ``` - - + + diff --git a/src/content/docs/ko/sdk/testing/subscription-recording.mdx b/src/content/docs/ko/sdk/testing/subscription-recording.mdx index 8c0fa3d61a..8c94dc3278 100644 --- a/src/content/docs/ko/sdk/testing/subscription-recording.mdx +++ b/src/content/docs/ko/sdk/testing/subscription-recording.mdx @@ -1,32 +1,36 @@ --- -title: "구독 기록 테스트" -description: "Adjust SDK가 Adjust로 구독 정보를 전송하는지 테스트" -slug: "en/sdk/testing/subscription-recording" -sidebar-label: "구독 기록" +title: 구독 기록 테스트 +description: Adjust SDK가 Adjust로 구독 정보를 전송하는지 테스트 +slug: ko/sdk/testing/subscription-recording +sidebar-label: 구독 기록 sidebar-position: 3 --- + Adjust SDK를 사용하면 유료 구독 정보를 기록할 수 있습니다. - + + 테스트가 완료되면 SDK 환경을 반드시 **Production** 으로 변경하여, 앱이 프로덕션 모드에서 작동하도록 하시기 바랍니다. - + + SDK는 다음의 툴을 통해 테스트할 수 있습니다. -* Adjust 테스팅 콘솔은 [AppView](https://help.adjust.com/en/article/testing-console)에서 사용 가능합니다. -* [Adjust 디바이스 API](/en/api/device-api/inspect). -* IDE의 로그 아웃풋. +- Adjust 테스팅 콘솔은 [AppView](https://help.adjust.com/ko/article/testing-console)에서 사용 가능합니다. +- [Adjust 디바이스 API](/ko/api/device-api/inspect). +- IDE의 로그 아웃풋. -테스트 방법: +테스트 방법: 1. 플랫폼별 Adjust SDK 연동 가이드를 참조하여 연동을 완료합니다. 2. **샌드박스** 모드로 환경을 설정하여, 앱이 테스트용 콘솔로만 정보를 전송하도록 합니다. 3. 로그 레벨을 **verbose** 로 설정하여 앱으로부터의 모든 로깅 정보를 포착합니다. 4. 테스트용 기기 또는 에뮬레이션 기기를 설정한 뒤 기기의 광고 ID를 찾습니다. 광고 ID는 [Adjust Insights 앱](https://apps.apple.com/us/app/adjust-insights/id1125517808)을 설치하여 찾을 수 있습니다. -5. 이전에 테스트 목적으로 해당 기기를 사용한 적이 있다면 다음을 수행하시기 바랍니다. +5. 이전에 테스트 목적으로 해당 기기를 사용한 적이 있다면 다음을 수행하시기 바랍니다. + 1. 테스트용 기기에서 앱을 삭제합니다. - 2. 테스팅 콘솔에서 기기의 광고 ID를 삭제합니다. [AppView의 테스팅 콘솔 페이지](https://help.adjust.com/en/article/testing-console#forget-device)의 지침을 참고하시기 바랍니다. - 3. 대안으로, [forget device 엔드포인트](/en/api/device-api/forget/)를 호출하여 기기의 기존 정보를 삭제할 수도 있습니다. + 2. 테스팅 콘솔에서 기기의 광고 ID를 삭제합니다. [AppView의 테스팅 콘솔 페이지](https://help.adjust.com/ko/article/testing-console#forget-device)의 지침을 참고하시기 바랍니다. + 3. 대안으로, [forget device 엔드포인트](/ko/api/device-api/forget/)를 호출하여 기기의 기존 정보를 삭제할 수도 있습니다. 6. Adjust SDK가 포함된 앱의 테스트 버전을 다운로드하고, 실행합니다. 7. 테스트용 구매를 트리거합니다. @@ -34,10 +38,9 @@ SDK는 다음의 툴을 통해 테스트할 수 있습니다. 구독이 성공적으로 기록되었다면, 콘솔 아웃풋의 다음 영역에 정보가 입력됩니다. -* **LastSubscriptionEventType** -* [**마지막 구독 이벤트 하위 유형**](https://help.adjust.com/en/article/manage-subscription-data#subscription-event-subtypes) -* **LastSubscriptionEventTimestamp** -* **제품 ID** +- **LastSubscriptionEventType** +- [**마지막 구독 이벤트 하위 유형**](https://help.adjust.com/ko/article/manage-subscription-data#subscription-event-subtypes) +- **LastSubscriptionEventTimestamp** +- **제품 ID** ![Adjust 테스팅 콘솔](@images/sdk-testing/subscription/testing-console.png) - diff --git a/src/content/docs/ko/sdk/unity/v4/features/subscriptions.mdx b/src/content/docs/ko/sdk/unity/v4/features/subscriptions.mdx index 568bf5c869..70c0db6e4c 100644 --- a/src/content/docs/ko/sdk/unity/v4/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/unity/v4/features/subscriptions.mdx @@ -1,45 +1,46 @@ --- -title: "구독 정보 전송" -description: "이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다." -slug: "en/sdk/unity/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/unity/features/subscriptions" +title: 구독 정보 전송 +description: 이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다. +slug: ko/sdk/unity/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ko/sdk/unity/features/subscriptions --- - -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. - + + +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + + 앱 스토어 및 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustAppStoreSubscription` 또는 `AdjustPlayStoreSubscription` 인스턴스를 생성하시기 바랍니다. -1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} ------------------------------------------------------------------ +## 1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} 시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. - + + + ```cs public AdjustAppStoreSubscription(string price, string currency, string transactionId, string receipt) ``` - + 다음 속성을 포함하는 `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 | -| `receipt` | `string` | 영수증 정보 | +| 파라미터 | 데이터 유형 | 설명 | +| --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `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 | +| `receipt` | `string` | 영수증 정보 | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -49,24 +50,25 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - + + ```cs public 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 문서](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 문서]()를 참조하시기 바랍니다. | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -78,18 +80,21 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - + + -### 구매일 기록 \{\#record\-the\-purchase\-date\} +### 구매일 기록 {#record-the-purchase-date} 사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. - + + + ```cs public void setTransactionDate(string transactionDate); ``` - + 구독 객체의 `setTransactionDate` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. @@ -103,13 +108,14 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - + + ```cs public void setPurchaseTime(string purchaseTime); ``` - + 구독 객체의 `setPurchaseTime` 메서드를 호출하여 구독의 타임스탬프를 기록합니다. @@ -124,17 +130,18 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### 구매 지역 기록\(iOS만 해당\) \{\#record\-the\-purchase\-region\-ios\-only\} +### 구매 지역 기록\(iOS만 해당\) {#record-the-purchase-region-ios-only} - + ```cs public void setSalesRegion(string salesRegion); ``` - + 사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `string`로 전달합니다. 이는 [`priceLocale`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift)로 포맷되어야 합니다. @@ -148,16 +155,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### 콜백 파라미터 추가 \{\#add\-callback\-parameters\} +### 콜백 파라미터 추가 {#add-callback-parameters} 콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. - + + + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -170,13 +179,14 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -191,18 +201,21 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + -### 파트너 파라미터 추가 \{\#add\-partner\-parameters\} +### 파트너 파라미터 추가 {#add-partner-parameters} Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. - + + + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -215,13 +228,14 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -236,19 +250,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + -2\. 구독 정보 기록 \{\#record\-subscription\-information\} ----------------------------------------------------------- +## 2\. 구독 정보 기록 \{\#record\-subscription\-information\} 구독 객체를 설정하고 나면 Adjust SDK를 사용하여 기록을 시작할 수 있습니다. - + + + ```cs public static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + 구독 객체를 `trackAppStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. @@ -268,13 +284,14 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```cs public static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + 구독 객체를 `trackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. @@ -295,5 +312,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/ko/sdk/unity/v5/features/subscriptions.mdx b/src/content/docs/ko/sdk/unity/v5/features/subscriptions.mdx index 89b64bcbdf..a0bff35273 100644 --- a/src/content/docs/ko/sdk/unity/v5/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/unity/v5/features/subscriptions.mdx @@ -1,44 +1,45 @@ --- -title: "구독 정보 전송" -description: "이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다." -slug: "en/sdk/unity/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/unity/v4/features/subscriptions" +title: 구독 정보 전송 +description: 이 메서드를 사용하여 구독 정보를 Adjust로 전송합니다. +slug: ko/sdk/unity/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ko/sdk/unity/v4/features/subscriptions --- - -다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. - + + +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. + + 앱 스토어 및 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustAppStoreSubscription` 또는 `AdjustPlayStoreSubscription` 인스턴스를 생성하시기 바랍니다. -1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} ------------------------------------------------------------------ +## 1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\} 시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. - + + + ```cs public 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 | +| 파라미터 | 데이터 유형 | 설명 | +| --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `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 | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -47,24 +48,25 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - + + ```cs public 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 문서](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 문서]()를 참조하시기 바랍니다. | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -76,18 +78,21 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - + + -### 구매일 기록 \{\#record\-the\-purchase\-date\} +### 구매일 기록 {#record-the-purchase-date} 사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. - + + + ```cs public string TransactionDate { get; set; } ``` - + `AdjustAppStoreSubscription` 인스턴스의 `setTransactionDate` 속성을 설정하면 구독의 타임스탬프를 기록할 수 있습니다. @@ -100,13 +105,14 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.TransactionDate = transactionDate; ``` - + + ```cs public string PurchaseTime { get; set; } ``` - + `AdjustPlayStoreSubscription` 인스턴스의 `PurchaseTime` 속성을 설정하면 구독의 타임스탬프를 기록할 수 있습니다. @@ -121,17 +127,18 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.PurchaseTime = purchaseTime; ``` - + + -### 구매 지역 기록\(iOS만 해당\) \{\#record\-the\-purchase\-region\-ios\-only\} +### 구매 지역 기록\(iOS만 해당\) {#record-the-purchase-region-ios-only} - + ```cs public string SalesRegion { get; set; } ``` - + 사용자가 구독을 결제한 지역을 기록할 수 있습니다. `AdjustPlayStoreSubscription` 인스턴스의 `SalesRegion` 속성에서 국가 코드를 `string`로 설정합니다. 이는 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)로써 형식화 되어야 합니다. @@ -144,16 +151,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.SalesRegiom = salesRegion; ``` -### 콜백 파라미터 추가 \{\#add\-callback\-parameters\} +### 콜백 파라미터 추가 {#add-callback-parameters} 콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `AddCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. - + + + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -165,13 +174,14 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - + + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -186,18 +196,21 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - + + -### 파트너 파라미터 추가 \{\#add\-partner\-parameters\} +### 파트너 파라미터 추가 {#add-partner-parameters} Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `AddPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. - + + + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -209,13 +222,14 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - + + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -230,19 +244,21 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - + + -2\. 구독 정보 기록 \{\#record\-subscription\-information\} ----------------------------------------------------------- +## 2\. 구독 정보 기록 \{\#record\-subscription\-information\} 구독 객체를 설정하고 나면 Adjust SDK를 사용하여 기록을 시작할 수 있습니다. - + + + ```cs public static void TrackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + 구독 객체를 `Adjust.TrackAppStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. @@ -261,13 +277,14 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackAppStoreSubscription(subscription); ``` - + + ```cs public static void TrackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + 구독 객체를 `Adjust.TrackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. @@ -288,5 +305,5 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/zh/sdk/android/v4/features/subscriptions.mdx b/src/content/docs/zh/sdk/android/v4/features/subscriptions.mdx index b842676829..fb3b4eb21c 100644 --- a/src/content/docs/zh/sdk/android/v4/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/android/v4/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "发送订阅信息" -description: "使用这些方法向 Adjust 发送订阅信息。" -slug: "en/sdk/android/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/android/features/subscriptions" +title: 发送订阅信息 +description: 使用这些方法向 Adjust 发送订阅信息。 +slug: zh/sdk/android/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /zh/sdk/android/features/subscriptions --- - -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 - + + +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 + + 您可以用 Adjust SDK 记录 Play 商店的订阅，并验证这些订阅是否有效。用户购买订阅后，实例化一个包含细节的 `AdjustPlayStoreSubscription` 对象。 -1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} ------------------------------------------------------------- +## 1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} - + ```java public AdjustPlayStoreSubscription(final long price, @@ -35,20 +34,21 @@ public AdjustPlayStoreSubscription(final long price, ``` - + 要开始设置，先实例化一个包含订阅购买细节的订阅对象。为此，请创建一个新的 `AdjustPlayStoreSubscription` 对象，并传送下列参数： -| 参数 | 数据类型 | 描述 | -|-----------------|----------|-----------------------------------------------------------------------------------------------------------------| -| `price` | `long` | 订阅价格 | -| `currency` | `String` | 订阅使用的币种 | -| `sku` | `String` | 产品 ID | -| `orderId` | `String` | 您的交易 ID | -| `signature` | `String` | 购买数据的签名 | +| 参数 | 数据类型 | 描述 | +| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `long` | 订阅价格 | +| `currency` | `String` | 订阅使用的币种 | +| `sku` | `String` | 产品 ID | +| `orderId` | `String` | 您的交易 ID | +| `signature` | `String` | 购买数据的签名 | | `purchaseToken` | `String` | 交易唯一识别码。请参考[Google 的文档](https://developer.android.com/reference/com/android/billingclient/api/Purchase)，了解更多信息。 | - + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,7 +62,8 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -76,20 +77,23 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### 记录购买日期\{\#record\-the\-purchase\-date\} +### 记录购买日期{#record-the-purchase-date} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + 您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。请使用时间戳调用 `setPurchaseTime` 方法，记录该信息。 - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -104,7 +108,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -119,75 +124,85 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### 添加回传参数\{\#add\-callback\-parameters\} +### 添加回传参数{#add-callback-parameters} - + ```java public void addCallbackParameter(String key, String value) ``` - + 您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 - + + + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - + + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - + + -### 添加合作伙伴参数\{\#add\-partner\-parameters\} +### 添加合作伙伴参数{#add-partner-parameters} - + ```java public void addPartnerParameter(String key, String value) ``` - + 您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 - + + + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - + + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - + + -2\. 发送订阅信息 \{\#send\-subscription\-information\} ------------------------------------------------------- +## 2\. 发送订阅信息 \{\#send\-subscription\-information\} - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - + 设置好订阅对象后，您就可以使用 Adjust SDK 将其发送给 Adjust 了。将已完成对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -202,7 +217,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -217,5 +233,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/zh/sdk/android/v5/features/subscriptions.mdx b/src/content/docs/zh/sdk/android/v5/features/subscriptions.mdx index 742e03fc86..cafa2a6675 100644 --- a/src/content/docs/zh/sdk/android/v5/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/android/v5/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "发送订阅信息" -description: "使用这些方法向 Adjust 发送订阅信息。" -slug: "en/sdk/android/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/android/v4/features/subscriptions" +title: 发送订阅信息 +description: 使用这些方法向 Adjust 发送订阅信息。 +slug: zh/sdk/android/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /zh/sdk/android/v4/features/subscriptions --- - -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 - + + +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 + + 您可以用 Adjust SDK 记录 Play 商店的订阅，并验证这些订阅是否有效。用户购买订阅后，实例化一个包含细节的 `AdjustPlayStoreSubscription` 对象。 -1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} ------------------------------------------------------------- +## 1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} - + ```java public AdjustPlayStoreSubscription(final long price, @@ -35,20 +34,21 @@ public AdjustPlayStoreSubscription(final long price, ``` - + 要开始设置，先实例化一个包含订阅购买细节的订阅对象。为此，请创建一个新的 `AdjustPlayStoreSubscription` 对象，并传送下列参数： -| 参数 | 数据类型 | 描述 | -|-----------------|----------|-----------------------------------------------------------------------------------------------------------------| -| `price` | `long` | 订阅价格 | -| `currency` | `String` | 订阅使用的币种 | -| `sku` | `String` | 产品 ID | -| `orderId` | `String` | 您的交易 ID | -| `signature` | `String` | 购买数据的签名 | +| 参数 | 数据类型 | 描述 | +| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | `long` | 订阅价格 | +| `currency` | `String` | 订阅使用的币种 | +| `sku` | `String` | 产品 ID | +| `orderId` | `String` | 您的交易 ID | +| `signature` | `String` | 购买数据的签名 | | `purchaseToken` | `String` | 交易唯一识别码。请参考[Google 的文档](https://developer.android.com/reference/com/android/billingclient/api/Purchase)，了解更多信息。 | - + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -62,7 +62,8 @@ val subscription = AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -76,20 +77,23 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### 记录购买日期\{\#record\-the\-purchase\-date\} +### 记录购买日期{#record-the-purchase-date} - + ```java public void setPurchaseTime(final long purchaseTime) ``` - + 您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。请使用时间戳调用 `setPurchaseTime` 方法，记录该信息。 - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -104,7 +108,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -119,75 +124,85 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - + + -### 添加回传参数\{\#add\-callback\-parameters\} +### 添加回传参数{#add-callback-parameters} - + ```java public void addCallbackParameter(String key, String value) ``` - + 您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 - + + + ```kotlin subscription.addCallbackParameter("key", "value") subscription.addCallbackParameter("foo", "bar") ``` - + + ```java subscription.addCallbackParameter("key", "value"); subscription.addCallbackParameter("foo", "bar"); ``` - + + -### 添加合作伙伴参数\{\#add\-partner\-parameters\} +### 添加合作伙伴参数{#add-partner-parameters} - + ```java public void addPartnerParameter(String key, String value) ``` - + 您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 - + + + ```kotlin subscription.addPartnerParameter("key", "value") subscription.addPartnerParameter("foo", "bar") ``` - + + ```java subscription.addPartnerParameter("key", "value"); subscription.addPartnerParameter("foo", "bar"); ``` - + + -2\. 发送订阅信息 \{\#send\-subscription\-information\} ------------------------------------------------------- +## 2\. 发送订阅信息 \{\#send\-subscription\-information\} - + ```java public static void trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription) ``` - + 设置好订阅对象后，您就可以使用 Adjust SDK 将其发送给 Adjust 了。将已完成对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 - + + + ```kotlin val subscription = AdjustPlayStoreSubscription( @@ -202,7 +217,8 @@ subscription.setPurchaseTime(purchaseTime) Adjust.trackPlayStoreSubscription(subscription) ``` - + + ```java AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -217,5 +233,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/zh/sdk/cordova/v4/features/subscriptions.mdx b/src/content/docs/zh/sdk/cordova/v4/features/subscriptions.mdx index 162c9dd156..2316b9843f 100644 --- a/src/content/docs/zh/sdk/cordova/v4/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/cordova/v4/features/subscriptions.mdx @@ -1,45 +1,46 @@ --- -title: "发送订阅信息" -description: "使用这些方法向 Adjust 发送订阅信息。" -slug: "en/sdk/cordova/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/cordova/features/subscriptions" +title: 发送订阅信息 +description: 使用这些方法向 Adjust 发送订阅信息。 +slug: zh/sdk/cordova/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /zh/sdk/cordova/features/subscriptions --- - -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 - + + +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 + + 您可以用 Adjust SDK 记录 App Store 和 Play 应用商店的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `AdjustAppStoreSubscription` 或 `AdjustPlayStoreSubscription` 实例。 -1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} ------------------------------------------------------------- +## 1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} 要开始设置，先创建一个包含订阅购买细节的订阅对象。 - + + + ```js constructor(price: string, currency: string, transactionId: string, receipt: string) ``` - + 创建一个 `AdjustAppStoreSubscription` 对象，属性如下： -| 参数 | 数据类型 | 描述 | -|-----------------|------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | 数字 | 订阅价格 | -| `currency` | 字符串 | 订阅使用的币种。此信息格式为 [`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` | 字符串 | 您的交易 ID | -| `receipt` | 字符串 | 收据信息 | +| 参数 | 数据类型 | 描述 | +| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `price` | 数字 | 订阅价格 | +| `currency` | 字符串 | 订阅使用的币种。此信息格式为 [`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` | 字符串 | 您的交易 ID | +| `receipt` | 字符串 | 收据信息 | ```js var subscription = new AdjustAppStoreSubscription( @@ -50,24 +51,25 @@ var subscription = new AdjustAppStoreSubscription( ); ``` - + + ```js constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + 创建一个 `AdjustPlayStoreSubscription` 对象，属性如下： -| 参数 | 数据类型 | 描述 | -|-----------------|------|------------------------------------------------------------------------------------------------------------------------------------| -| `price` | 数字 | 订阅价格 | -| `currency` | 字符串 | 订阅使用的币种 | -| `sku` | 字符串 | 产品 ID | -| `orderId` | 字符串 | 您的交易 ID | -| `signature` | 字符串 | 购买数据的签名 | -| `purchaseToken` | 字符串 | 交易唯一识别码。请参考[Google 的文档](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken())，了解更多信息。 | +| 参数 | 数据类型 | 描述 | +| --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `price` | 数字 | 订阅价格 | +| `currency` | 字符串 | 订阅使用的币种 | +| `sku` | 字符串 | 产品 ID | +| `orderId` | 字符串 | 您的交易 ID | +| `signature` | 字符串 | 购买数据的签名 | +| `purchaseToken` | 字符串 | 交易唯一识别码。请参考[Google 的文档]()，了解更多信息。 | ```js var subscription = new AdjustPlayStoreSubscription( @@ -80,18 +82,21 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - + + -### 记录购买日期\{\#record\-the\-purchase\-date\} +### 记录购买日期{#record-the-purchase-date} 您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。 - + + + ```js setTransactionDate(transactionDate: string): void ``` - + 在您的订阅对象上调用 `setTransactionDate` 方法来记录订阅的时间戳。 @@ -106,13 +111,14 @@ var subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - + + ```js setPurchaseTime(purchaseTime: string): void ``` - + 在您的订阅对象上调用 `setPurchaseTime` 方法来记录订阅的时间戳。 @@ -128,17 +134,18 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### 记录购买地区 \(仅限 iOS\)\{\#record\-the\-purchase\-region\-ios\-only\} +### 记录购买地区 \(仅限 iOS\){#record-the-purchase-region-ios-only} - + ```js setSalesRegion(salesRegion: string): void ``` - + 您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `string` 传递。此信息格式需为 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) 对象的 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront)。 @@ -153,16 +160,18 @@ var subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### 添加回传参数\{\#add\-callback\-parameters\} +### 添加回传参数{#add-callback-parameters} 您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 - + + + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -176,13 +185,14 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + ```js addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -198,18 +208,21 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + -### 添加合作伙伴参数\{\#add\-partner\-parameters\} +### 添加合作伙伴参数{#add-partner-parameters} 您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 - + + + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -223,13 +236,14 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + ```js addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -245,19 +259,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + -2\. 记录订阅信息\{\#record\-subscription\-information\} -------------------------------------------------------- +## 2\. 记录订阅信息\{\#record\-subscription\-information\} 设置好订阅对象后，您就可以通过 Adjust SDK 对其进行记录了。 - + + + ```js trackAppStoreSubscription(subscription: AdjustAppStoreSubscription): void ``` - + 将订阅对象传送至 `trackAppStoreSubscription` 方法，以记录用户订阅购买。 @@ -278,13 +294,14 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```js trackPlayStoreSubscription(subscription: AdjustPlayStoreSubscription): void ``` - + 将订阅对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 @@ -306,5 +323,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/zh/sdk/cordova/v5/features/subscriptions.mdx b/src/content/docs/zh/sdk/cordova/v5/features/subscriptions.mdx index 36d349b04a..46d03223f0 100644 --- a/src/content/docs/zh/sdk/cordova/v5/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/cordova/v5/features/subscriptions.mdx @@ -1,41 +1,42 @@ --- -title: "发送订阅信息" -description: "使用这些方法向 Adjust 发送订阅信息。" -slug: "en/sdk/cordova/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/cordova/v4/features/subscriptions" +title: 发送订阅信息 +description: 使用这些方法向 Adjust 发送订阅信息。 +slug: zh/sdk/cordova/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /zh/sdk/cordova/v4/features/subscriptions --- - -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 - + + +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 + + 您可以用 Adjust SDK 记录 App Store 和 Play 应用商店的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `AdjustAppStoreSubscription` 或 `AdjustPlayStoreSubscription` 实例。 -1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} ------------------------------------------------------------- +## 1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} 要开始设置，先创建一个包含订阅购买细节的订阅对象。 - + + + ```ts constructor(price: string, currency: string, transactionId: string) ``` - + 创建一个 `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 \| \| ```js var subscription = new AdjustAppStoreSubscription( @@ -46,24 +47,25 @@ var subscription = new AdjustAppStoreSubscription( Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string) ``` - + 创建一个 `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 的文档]()，了解更多信息。 | ```js var subscription = new AdjustPlayStoreSubscription( @@ -76,18 +78,21 @@ var subscription = new AdjustPlayStoreSubscription( ); ``` - + + -### 记录购买日期\{\#record\-the\-purchase\-date\} +### 记录购买日期{#record-the-purchase-date} 您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。 - + + + ```ts setTransactionDate(transactionDate: string): void ``` - + 在您的订阅对象上调用 `setTransactionDate` 方法来记录订阅的时间戳。 @@ -102,13 +107,14 @@ subscription.setTransactionDate(transactionDate); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts setPurchaseTime(purchaseTime: string): void ``` - + 在您的订阅对象上调用 `setPurchaseTime` 方法来记录订阅的时间戳。 @@ -124,17 +130,18 @@ var subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### 记录购买地区 \(仅限 iOS\)\{\#record\-the\-purchase\-region\-ios\-only\} +### 记录购买地区 \(仅限 iOS\){#record-the-purchase-region-ios-only} - + ```ts setSalesRegion(salesRegion: string): void ``` - + 您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `string` 传递。此信息格式需为 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) 对象的 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront)。 @@ -149,16 +156,18 @@ subscription.setSalesRegion(salesRegion); Adjust.trackPlayStoreSubscription(subscription); ``` -### 添加回传参数\{\#add\-callback\-parameters\} +### 添加回传参数{#add-callback-parameters} 您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 - + + + ```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -175,13 +184,14 @@ subscription.addCallbackParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts addCallbackParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -197,18 +207,21 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + -### 添加合作伙伴参数\{\#add\-partner\-parameters\} +### 添加合作伙伴参数{#add-partner-parameters} 您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 - + + + ```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustAppStoreSubscription( @@ -225,13 +238,14 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts addPartnerParameter(key: string, value: string): void ``` - + ```js var subscription = new AdjustPlayStoreSubscription( @@ -247,19 +261,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + -2\. 记录订阅信息\{\#record\-subscription\-information\} -------------------------------------------------------- +## 2\. 记录订阅信息\{\#record\-subscription\-information\} 设置好订阅对象后，您就可以通过 Adjust SDK 对其进行记录了。 - + + + ```ts trackAppStoreSubscription(adjustAppStoreSubscription: AdjustAppStoreSubscription): void ``` - + 将订阅对象传送至 `trackAppStoreSubscription` 方法，以记录用户订阅购买。 @@ -275,13 +291,14 @@ subscription.setSalesRegion(salesRegion); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```ts trackPlayStoreSubscription(adjustPlayStoreSubscription: AdjustPlayStoreSubscription): void ``` - + 将订阅对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 @@ -299,5 +316,5 @@ subscription.setPurchaseTime(purchaseTime); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/zh/sdk/flutter/v4/features/subscriptions.mdx b/src/content/docs/zh/sdk/flutter/v4/features/subscriptions.mdx index a1ab049dc8..eb89f05387 100644 --- a/src/content/docs/zh/sdk/flutter/v4/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/flutter/v4/features/subscriptions.mdx @@ -1,45 +1,46 @@ --- -title: "发送订阅信息" -description: "使用这些方法向 Adjust 发送订阅信息。" -slug: "en/sdk/flutter/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/flutter/features/subscriptions" +title: 发送订阅信息 +description: 使用这些方法向 Adjust 发送订阅信息。 +slug: zh/sdk/flutter/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /zh/sdk/flutter/features/subscriptions --- - -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 - + + +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/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, String _receipt) ``` - + 创建一个 `AdjustAppStoreSubscription` 对象，属性如下： -| 参数 | 数据类型 | 描述 | -|-----------------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `String` | 订阅价格 | +| 参数 | 数据类型 | 描述 | +| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `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 | -| `receipt` | `String` | 收据信息 | +| `transactionId` | `String` | 您的交易 ID | +| `receipt` | `String` | 收据信息 | ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -49,24 +50,25 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - + + ```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 的文档](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 的文档]()，了解更多信息。 | ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -78,18 +80,21 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - + + -### 记录购买日期\{\#record\-the\-purchase\-date\} +### 记录购买日期{#record-the-purchase-date} 您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。 - + + + ```dart void setTransactionDate(String _transactionDate) ``` - + 在您的订阅对象上调用 `setTransactionDate` 方法来记录订阅的时间戳。 @@ -103,13 +108,14 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - + + ```dart void setPurchaseTime(String purchaseTime) ``` - + 在您的订阅对象上调用 `setPurchaseTime` 方法来记录订阅的时间戳。 @@ -124,17 +130,18 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### 记录购买地区 \(仅限 iOS\)\{\#record\-the\-purchase\-region\-ios\-only\} +### 记录购买地区 \(仅限 iOS\){#record-the-purchase-region-ios-only} - + ```dart void setSalesRegion(String _salesRegion) ``` - + 您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `String` 传递。此信息格式需为 [`priceLocale`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) 对象的 [`countryCode`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift)。 @@ -148,16 +155,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### 添加回传参数\{\#add\-callback\-parameters\} +### 添加回传参数{#add-callback-parameters} 您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 - + + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -170,13 +179,14 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -191,18 +201,21 @@ 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( @@ -215,13 +228,14 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - + + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -236,19 +250,21 @@ 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` 方法，以记录用户订阅购买。 @@ -268,13 +284,14 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + 将订阅对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 @@ -295,5 +312,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + 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 abc6018485..ce9c1809ea 100644 --- a/src/content/docs/zh/sdk/flutter/v5/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/flutter/v5/features/subscriptions.mdx @@ -1,41 +1,42 @@ --- -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" +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 --- - -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 - + + +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/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( @@ -44,24 +45,25 @@ 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 的文档](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 的文档]()，了解更多信息。 | ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -73,21 +75,25 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - + + -### 记录购买日期\{\#record\-the\-purchase\-date\} +### 记录购买日期{#record-the-purchase-date} 您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。 - + + + 在`AdjustAppStoreSubscription`类中添加`transactionDate`属性。 - + + ```dart String? transactionDate ``` - + 为`subscription`实例的`transactionDate`属性设置时间戳，记录用户购买订阅的日期。 @@ -100,16 +106,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.transactionDate = 'transactionDate'; ``` - + + 在`AdjustPlayStoreSubscription`类中添加`purchaseTime`属性。 - + + ```dart String? purchaseTime; ``` - + 为`subscription`实例的`purchaseTime`属性设置时间戳，记录用户购买订阅的日期。 @@ -124,17 +132,18 @@ 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)。 @@ -147,16 +156,18 @@ 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( @@ -168,13 +179,14 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - + + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -189,18 +201,21 @@ 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( @@ -212,13 +227,14 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - + + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -233,19 +249,21 @@ 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` 方法，以记录用户订阅购买。 @@ -264,13 +282,14 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + 将订阅对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 @@ -291,5 +310,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/zh/sdk/ios/v4/features/subscriptions.mdx b/src/content/docs/zh/sdk/ios/v4/features/subscriptions.mdx index 36281d98c3..c7fa9416fb 100644 --- a/src/content/docs/zh/sdk/ios/v4/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/ios/v4/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "发送订阅信息" -description: "使用这些方法向 Adjust 发送订阅信息。" -slug: "en/sdk/ios/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/ios/features/subscriptions" +title: 发送订阅信息 +description: 使用这些方法向 Adjust 发送订阅信息。 +slug: zh/sdk/ios/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /zh/sdk/ios/features/subscriptions --- - -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 - + + +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 + + 您可以用 Adjust SDK 记录 App Store 的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `ADJSubscription` 实例。 -1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} ------------------------------------------------------------- +## 1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -32,18 +31,19 @@ redirects: ``` - + 要开始设置，先创建一个包含订阅购买细节的订阅对象。为此，请使用 `initWithPrice` 方法初始化一个 `ADJSubscription` 对象。传递以下参数： -| 参数 | 数据类型 | 描述 | -|-----------------|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `NSDecimalNumber` | 订阅价格 | +| 参数 | 数据类型 | 描述 | +| --------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `price` | `NSDecimalNumber` | 订阅价格 | | `currency` | `NSString` | 订阅使用的币种。此信息格式为 [`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` | `NSString` | 您的交易 ID | -| `receipt` | `NSString` | 收据信息 | +| `transactionId` | `NSString` | 您的交易 ID | +| `receipt` | `NSString` | 收据信息 | - + + ```swift let subscription = ADJSubscription( @@ -52,7 +52,8 @@ let subscription = ADJSubscription( transactionId: transactionId) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -60,20 +61,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price transactionId:transactionId]; ``` - + + -### 记录购买日期\{\#record\-the\-purchase\-date\} +### 记录购买日期{#record-the-purchase-date} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - + 您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。请使用时间戳调用 `setTransactionDate` 方法，记录该信息。 - + + + ```swift let subscription = ADJSubscription( @@ -84,7 +88,8 @@ let subscription = ADJSubscription( subscription.setTransactionDate(transactionDate) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -94,20 +99,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setTransactionDate:transactionDate]; ``` - + + -### 记录购买地区\{\#record\-the\-purchase\-region\} +### 记录购买地区{#record-the-purchase-region} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - + 您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `NSString` 传递。此信息格式需为 [`priceLocale`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) 对象的 [`countryCode`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift)。 - + + + ```swift let subscription = ADJSubscription( @@ -118,7 +126,8 @@ let subscription = ADJSubscription( subscription.setSalesRegion(salesRegion) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -128,20 +137,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription setSalesRegion:salesRegion]; ``` - + + -### 添加回传参数\{\#add\-callback\-parameters\} +### 添加回传参数{#add-callback-parameters} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + 您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 - + + + ```swift let subscription = ADJSubscription( @@ -153,7 +165,8 @@ subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -164,20 +177,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - + + -### 添加合作伙伴参数\{\#add\-partner\-parameters\} +### 添加合作伙伴参数{#add-partner-parameters} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + 您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 - + + + ```swift let subscription = ADJSubscription( @@ -189,7 +205,8 @@ subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -200,21 +217,23 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - + + -2\. 发送订阅信息 \{\#send\-subscription\-information\} ------------------------------------------------------- +## 2\. 发送订阅信息 \{\#send\-subscription\-information\} - + ```objc + (void)trackSubscription:(nonnull ADJSubscription *)subscription; ``` - + 设置好订阅对象后，您就可以使用 Adjust SDK 将其发送给 Adjust 了。将已完成对象传送至 `trackSubscription` 方法，以记录用户订阅购买。 - + + + ```swift let subscription = ADJSubscription( @@ -238,7 +257,8 @@ subscription.addCallbackParameter("key2", value: "value2") Adjust.trackSubscription(subscription) ``` - + + ```objc ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price @@ -258,5 +278,5 @@ ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price [Adjust trackSubscription:subscription]; ``` - - + + diff --git a/src/content/docs/zh/sdk/ios/v5/features/subscriptions.mdx b/src/content/docs/zh/sdk/ios/v5/features/subscriptions.mdx index 415ad78bac..9efa5e748e 100644 --- a/src/content/docs/zh/sdk/ios/v5/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/ios/v5/features/subscriptions.mdx @@ -1,29 +1,28 @@ --- -title: "发送订阅信息" -description: "使用这些方法向 Adjust 发送订阅信息。" -slug: "en/sdk/ios/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/ios/v4/features/subscriptions" +title: 发送订阅信息 +description: 使用这些方法向 Adjust 发送订阅信息。 +slug: zh/sdk/ios/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /zh/sdk/ios/v4/features/subscriptions --- - -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 - + + +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 + + 您可以用 Adjust SDK 记录 App Store 的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `ADJAppStoreSubscription` 实例。 -1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} ------------------------------------------------------------- +## 1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} - + ```objc - (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price @@ -31,17 +30,18 @@ redirects: transactionId:(nonnull NSString *)transactionId; ``` - + 要开始设置，先创建一个包含订阅购买细节的订阅对象。为此，请使用 `initWithPrice` 方法初始化一个 `ADJAppStoreSubscription` 对象。传递以下参数： -| 参数 | 数据类型 | 描述 | -|-----------------|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `NSDecimalNumber` | 订阅价格 | +| 参数 | 数据类型 | 描述 | +| --------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `price` | `NSDecimalNumber` | 订阅价格 | | `currency` | `NSString` | 订阅使用的币种。此信息格式为 [`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` | `NSString` | 您的交易 ID | +| `transactionId` | `NSString` | 您的交易 ID | - + + ```swift let subscription = ADJAppStoreSubscription( @@ -50,7 +50,8 @@ let subscription = ADJAppStoreSubscription( transactionId: transactionId ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -58,20 +59,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit transactionId:transactionId]; ``` - + + -### 记录购买日期\{\#record\-the\-purchase\-date\} +### 记录购买日期{#record-the-purchase-date} - + ```objc - (void)setTransactionDate:(nonnull NSDate *)transactionDate; ``` - + 您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。请使用时间戳调用 `setTransactionDate` 方法，记录该信息。 - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -82,7 +86,8 @@ guard let subscription = ADJAppStoreSubscription( subscription.setTransactionDate(transactionDate) ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -92,20 +97,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setTransactionDate:transactionDate]; ``` - + + -### 记录购买地区\{\#record\-the\-purchase\-region\} +### 记录购买地区{#record-the-purchase-region} - + ```objc - (void)setSalesRegion:(nonnull NSString *)salesRegion; ``` - + 您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `NSString` 传递。此信息格式需为 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) 对象的 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront)。 - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -116,7 +124,8 @@ guard let subscription = ADJAppStoreSubscription( subscription.setSalesRegion(salesRegion) ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -126,20 +135,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription setSalesRegion:salesRegion]; ``` - + + -### 添加回传参数\{\#add\-callback\-parameters\} +### 添加回传参数{#add-callback-parameters} - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + 您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -151,7 +163,8 @@ subscription.addCallbackParameter("key1", value: "value1") subscription.addCallbackParameter("key2", value: "value2") ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -162,20 +175,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addCallbackParameter:@"key2" value:@"value2"]; ``` - + + -### 添加合作伙伴参数\{\#add\-partner\-parameters\} +### 添加合作伙伴参数{#add-partner-parameters} - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + 您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -187,7 +203,8 @@ subscription.addParameterParameter("key1", value: "value1") subscription.addParameterParameter("key2", value: "value2") ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -198,21 +215,23 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [subscription addParameterParameter:@"key2" value:@"value2"]; ``` - + + -2\. 发送订阅信息 \{\#send\-subscription\-information\} ------------------------------------------------------- +## 2\. 发送订阅信息 \{\#send\-subscription\-information\} - + ```objc + (void)trackAppStoreSubscription:(nonnull ADJAppStoreSubscription *)subscription; ``` - + 设置好订阅对象后，您就可以使用 Adjust SDK 将其发送给 Adjust 了。将已完成对象传送至 `trackAppStoreSubscription` 方法，以记录用户订阅购买。 - + + + ```swift guard let subscription = ADJAppStoreSubscription( @@ -234,7 +253,8 @@ subscription.addCallbackParameter("key2", value: "value2") Adjust.trackAppStoreSubscription(subscription) ``` - + + ```objc ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price @@ -254,5 +274,5 @@ ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWit [Adjust trackAppStoreSubscription:subscription]; ``` - - + + diff --git a/src/content/docs/zh/sdk/testing/subscription-recording.mdx b/src/content/docs/zh/sdk/testing/subscription-recording.mdx index 940e24d2ab..ecb6b07c63 100644 --- a/src/content/docs/zh/sdk/testing/subscription-recording.mdx +++ b/src/content/docs/zh/sdk/testing/subscription-recording.mdx @@ -1,21 +1,24 @@ --- -title: "测试订阅记录" -description: "测试 Adjust SDK 是否正在向 Adjust 发送订阅信息" -slug: "en/sdk/testing/subscription-recording" -sidebar-label: "订阅记录" +title: 测试订阅记录 +description: 测试 Adjust SDK 是否正在向 Adjust 发送订阅信息 +slug: zh/sdk/testing/subscription-recording +sidebar-label: 订阅记录 sidebar-position: 3 --- + 您可以通过 Adjust SDK 来记录应用内订阅购买的相关信息。 - + + 完成测试后请确保将 SDK 环境设置为 **Production** 。这请确保应用在生产环境中正常运行。 - + + 使用这些工具测试 SDK： -* 位于[AppView](https://help.adjust.com/en/article/testing-console)中的测试控制台。 -* [Adjust 设备 API](/en/api/device-api/inspect)。 -* 您的 IDE 日志输出。 +- 位于[AppView](https://help.adjust.com/zh/article/testing-console)中的测试控制台。 +- [Adjust 设备 API](/zh/api/device-api/inspect)。 +- 您的 IDE 日志输出。 要测试此功能是否正常运转： @@ -23,10 +26,11 @@ sidebar-position: 3 2. 将环境设为 **Sandbox** 。这能保证您的应用只向测试控制台发送信息。 3. 将日志级别设为 **verbose** 来抓取来自应用的全部记录信息。 4. 设置一台测试设备或模拟设备，找到设备的广告 ID。您可以安装 [Adjust Insights 应用](https://apps.apple.com/us/app/adjust-insights/id1125517808)来找到此信息。 -5. 如果您此前曾使用此设备进行测试： +5. 如果您此前曾使用此设备进行测试： + 1. 从测试设备中删除您的应用。 - 2. 在测试控制台中清除设备的广告 ID。请按照[AppView 中的测试控制台](https://help.adjust.com/en/article/testing-console#forget-device)中的说明进行操作。 - 3. 另外，还可以调用[遗忘设备终端](/en/api/device-api/forget/)来移除已有设备信息。 + 2. 在测试控制台中清除设备的广告 ID。请按照[AppView 中的测试控制台](https://help.adjust.com/zh/article/testing-console#forget-device)中的说明进行操作。 + 3. 另外，还可以调用[遗忘设备终端](/zh/api/device-api/forget/)来移除已有设备信息。 6. 下载并打开包含 Adjust SDK 的测试版本应用。 7. 触发一次购买作为测试。 @@ -34,10 +38,9 @@ sidebar-position: 3 如果订阅已被成功记录，那么控制台输出中以下字段会被填充： -* **最后订阅事件类型** -* [**最后订阅事件子类型**](https://help.adjust.com/en/article/manage-subscription-data#subscription-event-subtypes) -* **LastSubscriptionEventTimestamp** -* **产品 ID** +- **最后订阅事件类型** +- [**最后订阅事件子类型**](https://help.adjust.com/zh/article/manage-subscription-data#subscription-event-subtypes) +- **LastSubscriptionEventTimestamp** +- **产品 ID** ![Adjust 测试控制台](@images/sdk-testing/subscription/testing-console.png) - diff --git a/src/content/docs/zh/sdk/unity/v4/features/subscriptions.mdx b/src/content/docs/zh/sdk/unity/v4/features/subscriptions.mdx index 460cfd874b..dd647386f8 100644 --- a/src/content/docs/zh/sdk/unity/v4/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/unity/v4/features/subscriptions.mdx @@ -1,45 +1,46 @@ --- -title: "发送订阅信息" -description: "使用这些方法向 Adjust 发送订阅信息。" -slug: "en/sdk/unity/v4/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/unity/features/subscriptions" +title: 发送订阅信息 +description: 使用这些方法向 Adjust 发送订阅信息。 +slug: zh/sdk/unity/v4/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /zh/sdk/unity/features/subscriptions --- - -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 - + + +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 + + 您可以用 Adjust SDK 记录 App Store 和 Play 应用商店的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `AdjustAppStoreSubscription` 或 `AdjustPlayStoreSubscription` 实例。 -1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} ------------------------------------------------------------- +## 1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} 要开始设置，先创建一个包含订阅购买细节的订阅对象。 - + + + ```cs public AdjustAppStoreSubscription(string price, string currency, string transactionId, string receipt) ``` - + 创建一个 `AdjustAppStoreSubscription` 对象，属性如下： -| 参数 | 数据类型 | 描述 | -|-----------------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `string` | 订阅价格 | +| 参数 | 数据类型 | 描述 | +| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `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 | -| `receipt` | `string` | 收据信息 | +| `transactionId` | `string` | 您的交易 ID | +| `receipt` | `string` | 收据信息 | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -49,24 +50,25 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( receipt); ``` - + + ```cs public 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 的文档](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 的文档]()，了解更多信息。 | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -78,18 +80,21 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - + + -### 记录购买日期\{\#record\-the\-purchase\-date\} +### 记录购买日期{#record-the-purchase-date} 您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。 - + + + ```cs public void setTransactionDate(string transactionDate); ``` - + 在您的订阅对象上调用 `setTransactionDate` 方法来记录订阅的时间戳。 @@ -103,13 +108,14 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setTransactionDate(transactionDate); ``` - + + ```cs public void setPurchaseTime(string purchaseTime); ``` - + 在您的订阅对象上调用 `setPurchaseTime` 方法来记录订阅的时间戳。 @@ -124,17 +130,18 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.setPurchaseTime(purchaseTime); ``` - + + -### 记录购买地区 \(仅限 iOS\)\{\#record\-the\-purchase\-region\-ios\-only\} +### 记录购买地区 \(仅限 iOS\){#record-the-purchase-region-ios-only} - + ```cs public void setSalesRegion(string salesRegion); ``` - + 您可以记录用户购买订阅的地区。为此，请在订阅对象上调用 `setSalesRegion` 方法并将国家代码作为 `string` 传递。此信息格式需为 [`priceLocale`](https://developer.apple.com/documentation/foundation/nslocale/1643060-countrycode?language=swift) 对象的 [`countryCode`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=swift)。 @@ -148,16 +155,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.setSalesRegion(salesRegion); ``` -### 添加回传参数\{\#add\-callback\-parameters\} +### 添加回传参数{#add-callback-parameters} 您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `addCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 - + + + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -170,13 +179,14 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + ```cs public void addCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -191,18 +201,21 @@ subscription.addCallbackParameter("key1", "value1"); subscription.addCallbackParameter("key2", "value2"); ``` - + + -### 添加合作伙伴参数\{\#add\-partner\-parameters\} +### 添加合作伙伴参数{#add-partner-parameters} 您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`addPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 - + + + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -215,13 +228,14 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + ```cs public void addPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -236,19 +250,21 @@ subscription.addPartnerParameter("key1", "value1"); subscription.addPartnerParameter("key2", "value2"); ``` - + + -2\. 记录订阅信息\{\#record\-subscription\-information\} -------------------------------------------------------- +## 2\. 记录订阅信息\{\#record\-subscription\-information\} 设置好订阅对象后，您就可以通过 Adjust SDK 对其进行记录了。 - + + + ```cs public static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + 将订阅对象传送至 `trackAppStoreSubscription` 方法，以记录用户订阅购买。 @@ -268,13 +284,14 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackAppStoreSubscription(subscription); ``` - + + ```cs public static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + 将订阅对象传送至 `trackPlayStoreSubscription` 方法，以记录用户订阅购买。 @@ -295,5 +312,5 @@ subscription.addPartnerParameter("key2", "value2"); Adjust.trackPlayStoreSubscription(subscription); ``` - - + + diff --git a/src/content/docs/zh/sdk/unity/v5/features/subscriptions.mdx b/src/content/docs/zh/sdk/unity/v5/features/subscriptions.mdx index eac5e23404..f8d7023c69 100644 --- a/src/content/docs/zh/sdk/unity/v5/features/subscriptions.mdx +++ b/src/content/docs/zh/sdk/unity/v5/features/subscriptions.mdx @@ -1,44 +1,45 @@ --- -title: "发送订阅信息" -description: "使用这些方法向 Adjust 发送订阅信息。" -slug: "en/sdk/unity/features/subscriptions" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/unity/v4/features/subscriptions" +title: 发送订阅信息 +description: 使用这些方法向 Adjust 发送订阅信息。 +slug: zh/sdk/unity/features/subscriptions +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /zh/sdk/unity/v4/features/subscriptions --- - -下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)中的步骤操作。 - + + +下列步骤仅会在 Adjust SDK 中设置订阅监测。要启用该功能，请按照[为应用设置订阅监测](https://help.adjust.com/zh/article/set-up-subscriptions-for-your-app)中的步骤操作。 + + 您可以用 Adjust SDK 记录 App Store 和 Play 应用商店的订阅，并验证这些订阅是否有效。用户购买订阅后，创建一个包含细节的 `AdjustAppStoreSubscription` 或 `AdjustPlayStoreSubscription` 实例。 -1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} ------------------------------------------------------------- +## 1\. 实例化订阅对象\{\#instantiate\-a\-subscription\-object\} 要开始设置，先创建一个包含订阅购买细节的订阅对象。 - + + + ```cs public AdjustAppStoreSubscription(string price, string currency, string transactionId); ``` - + 创建一个 `AdjustAppStoreSubscription` 对象，属性如下： -| 参数 | 数据类型 | 描述 | -|-----------------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `price` | `string` | 订阅价格 | +| 参数 | 数据类型 | 描述 | +| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `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 | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -47,24 +48,25 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - + + ```cs public 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 的文档](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 的文档]()，了解更多信息。 | ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -76,18 +78,21 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( purchaseToken); ``` - + + -### 记录购买日期\{\#record\-the\-purchase\-date\} +### 记录购买日期{#record-the-purchase-date} 您可以记录用户购买订阅的日期。SDK 会返回该数据用于报告。 - + + + ```cs public string TransactionDate { get; set; } ``` - + 设置`AdjustAppStoreSubscription`实例的`setTransactionDate`属性来记录订阅的时间戳。 @@ -100,13 +105,14 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.TransactionDate = transactionDate; ``` - + + ```cs public string PurchaseTime { get; set; } ``` - + 设置`AdjustPlayStoreSubscription`实例的`PurchaseTime`属性来记录订阅的时间戳。 @@ -121,17 +127,18 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.PurchaseTime = purchaseTime; ``` - + + -### 记录购买地区 \(仅限 iOS\)\{\#record\-the\-purchase\-region\-ios\-only\} +### 记录购买地区 \(仅限 iOS\){#record-the-purchase-region-ios-only} - + ```cs public string SalesRegion { get; set; } ``` - + 您可以记录用户购买订阅的地区。为此，请将`AdjustPlayStoreSubscription`实例的`SalesRegion`属性设置为`string`形式的国家代码。此信息需为[`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode)对象的[`countryCode`](https://developer.apple.com/documentation/storekit/storefront)。 @@ -144,16 +151,18 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.SalesRegiom = salesRegion; ``` -### 添加回传参数\{\#add\-callback\-parameters\} +### 添加回传参数{#add-callback-parameters} 您可以向订阅对象附加回传参数。SDK 会将这些参数附加至您的回传 URL。要添加回传参数，请在订阅对象上调用 `AddCallbackParameter` 方法。多次调用该方法可添加多个回传参数。 - + + + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -165,13 +174,14 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - + + ```cs public void AddCallbackParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -186,18 +196,21 @@ subscription.AddCallbackParameter("key1", "value1"); subscription.AddCallbackParameter("key2", "value2"); ``` - + + -### 添加合作伙伴参数\{\#add\-partner\-parameters\} +### 添加合作伙伴参数{#add-partner-parameters} 您可以向订阅对象附加合作伙伴参数。用户购买订阅时，SDK 会将这些参数发送至 Adjust 服务器。Adjust 服务器会将此信息转发至您的合作伙伴。要添加合作伙伴参数，请在您的订阅对象上调用`AddPartnerParameter`方法。多次调用该方法可添加多个合作伙伴参数。 - + + + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -209,13 +222,14 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - + + ```cs public void AddPartnerParameter(string key, string value); ``` - + ```cs AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -230,19 +244,21 @@ subscription.AddPartnerParameter("key1", "value1"); subscription.AddPartnerParameter("key2", "value2"); ``` - + + -2\. 记录订阅信息\{\#record\-subscription\-information\} -------------------------------------------------------- +## 2\. 记录订阅信息\{\#record\-subscription\-information\} 设置好订阅对象后，您就可以通过 Adjust SDK 对其进行记录了。 - + + + ```cs public static void TrackAppStoreSubscription(AdjustAppStoreSubscription subscription); ``` - + 将订阅对象传送至 `Adjust.TrackAppStoreSubscription` 方法，以记录用户订阅购买。 @@ -261,13 +277,14 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackAppStoreSubscription(subscription); ``` - + + ```cs public static void TrackPlayStoreSubscription(AdjustPlayStoreSubscription subscription); ``` - + 将订阅对象传送至 `Adjust.TrackPlayStoreSubscription` 方法，以记录用户订阅购买。 @@ -288,5 +305,5 @@ subscription.AddPartnerParameter("key2", "value2"); Adjust.TrackPlayStoreSubscription(subscription); ``` - - + +