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 710272e48..c6b1efe1c 100644 --- a/src/content/docs/ko/sdk/flutter/v5/features/subscriptions.mdx +++ b/src/content/docs/ko/sdk/flutter/v5/features/subscriptions.mdx @@ -1,42 +1,41 @@ --- -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: "구독 정보 전송" +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/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다. - - +다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/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( @@ -45,25 +44,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( transactionId); ``` - - + ```dart AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken) ``` - + 다음 속성을 포함하는 `AdjustPlayStoreSubscription` 객체를 생성합니다. -| 파라미터 | 데이터 유형 | 설명 | -| --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `price` | `String` | 구독료 | -| `currency` | `String` | 구독 통화 | -| `sku` | `String` | 제품 ID | -| `orderId` | `String` | 거래 ID | -| `signature` | `String` | 구매 데이터의 서명 | -| `purchaseToken` | `String` | 거래의 고유 토큰. 자세한 정보는 [Google 문서]()를 참조하시기 바랍니다. | +| 파라미터 | 데이터 유형 | 설명 | +|-----------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------| +| `price` | `String` | 구독료 | +| `currency` | `String` | 구독 통화 | +| `sku` | `String` | 제품 ID | +| `orderId` | `String` | 거래 ID | +| `signature` | `String` | 구매 데이터의 서명 | +| `purchaseToken` | `String` | 거래의 고유 토큰. 자세한 정보는 [Google 문서](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken())를 참조하시기 바랍니다. | ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -75,25 +73,21 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( purchaseToken); ``` - - + -### 구매일 기록 {#record-the-purchase-date} +### 구매일 기록 \{\#record\-the\-purchase\-date\} 사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. - - - + `AdjustAppStoreSubscription` 클래스에`transactionDate` 속성을 추가합니다. - - + ```dart String? transactionDate ``` - + `subscription` 인스턴스의 `transactionDate` 속성에 타임스탬프를 설정하면 사용자가 구독을 결제한 날을 기록할 수 있습니다. @@ -106,18 +100,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.transactionDate = 'transactionDate'; ``` - - + `AdjustPlayStoreSubscription` 클래스에`purchaseTime` 속성을 추가합니다. - - + ```dart String? purchaseTime; ``` - + `subscription` 인스턴스의 `purchaseTime` 속성에 타임스탬프를 설정하면 사용자가 구독을 결제한 날을 기록할 수 있습니다. @@ -132,18 +124,17 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( subscription.purchaseTime = 'purchase-time'; ``` - - + -### 구매 지역 기록\(iOS만 해당\) {#record-the-purchase-region-ios-only} +### 구매 지역 기록\(iOS만 해당\) \{\#record\-the\-purchase\-region\-ios\-only\} - + ```dart String? salesRegion ``` - + 사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `String`로 전달합니다. 이는 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront)로 포맷되어야 합니다. @@ -156,18 +147,16 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( subscription.salesRegion = 'sales-region'; ``` -### 콜백 파라미터 추가 {#add-callback-parameters} +### 콜백 파라미터 추가 \{\#add\-callback\-parameters\} 콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다. - - - + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -179,14 +168,13 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - + ```dart void addCallbackParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -201,21 +189,18 @@ subscription.addCallbackParameter('key1', 'value1'); subscription.addCallbackParameter('key2', 'value2'); ``` - - + -### 파트너 파라미터 추가 {#add-partner-parameters} +### 파트너 파라미터 추가 \{\#add\-partner\-parameters\} Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다. - - - + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription( @@ -227,14 +212,13 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + ```dart void addPartnerParameter(String key, String value) ``` - + ```dart AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription( @@ -249,21 +233,19 @@ subscription.addPartnerParameter('key1', 'value1'); subscription.addPartnerParameter('key2', 'value2'); ``` - - + -## 2\. 구독 정보 기록 \{\#record\-subscription\-information\} +2\. 구독 정보 기록 \{\#record\-subscription\-information\} +---------------------------------------------------------- 구독 객체를 설정하고 나면 Adjust SDK를 사용하여 기록을 시작할 수 있습니다. - - - + ```dart static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription) ``` - + 구독 객체를 `trackAppStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. @@ -282,14 +264,13 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackAppStoreSubscription(subscription); ``` - - + ```dart static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription) ``` - + 구독 객체를 `trackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다. @@ -310,5 +291,5 @@ subscription.addPartnerParameter('key2', 'value2'); Adjust.trackPlayStoreSubscription(subscription); ``` - - + +