Skip to content

Commit

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

<Callout type="important">

다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/ko/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다.

</Callout>
다음 단계는 Adjust SDK 내의 구독 측정만을 설정합니다. 이 기능을 활성화하려면 [앱에 대한 구독 설정](https://help.adjust.com/en/article/set-up-subscriptions-for-your-app)에 나온 단계를 수행하시기 바랍니다.
</Callout>

앱 스토어 및 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 `AdjustAppStoreSubscription` 또는 `AdjustPlayStoreSubscription` 인스턴스를 생성하시기 바랍니다.

## 1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\}
1\. 구독 객체 인스턴스화 \{\#instantiate\-a\-subscription\-object\}
-----------------------------------------------------------------

시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다.

<Tabs>
<Tab title="App Store" sync="appstore" icon="PlatformIos"> <CodeBlock title="메서드 서명">
<tabs> <tab title="App Store" sync="appstore" icon="PlatformIos"> <codeblock title="메서드 서명">

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

</CodeBlock>
</CodeBlock>

다음 속성을 포함하는 `AdjustAppStoreSubscription` 객체를 생성합니다.

\| 파라미터 \| 데이터 유형 \| 설명 \| \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| \| `price` \| `String` \| 구독 요금 \| \| `currency` \| `String` \| 구독 통화. [`priceLocale`](https://developer.apple.com/documentation/foundation/nslocale/1642836-currencycode?language=objc) 객체의 [`currencyCode`](https://developer.apple.com/documentation/storekit/skproduct/1506145-pricelocale?language=objc)로 형식화됨 \|
\|`transactionId` \| `String` \| \| 트랜잭션 ID \| \|
\| 파라미터 \| 데이터 유형 \| 설명 \| \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\- \| \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \| \-\-\- \| \| `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(
Expand All @@ -45,25 +44,24 @@ AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
transactionId);
```

</Tab>
<Tab title="Play Store" sync="playstore" icon="PlatformGooglePlay"> <CodeBlock title="메서드 서명">
</Tab> <tab title="Play Store" sync="playstore" icon="PlatformGooglePlay"> <codeblock title="메서드 서명">

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

</CodeBlock>
</CodeBlock>

다음 속성을 포함하는 `AdjustPlayStoreSubscription` 객체를 생성합니다.

| 파라미터 | 데이터 유형 | 설명 |
| --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `price` | `String` | 구독료 |
| `currency` | `String` | 구독 통화 |
| `sku` | `String` | 제품 ID |
| `orderId` | `String` | 거래 ID |
| `signature` | `String` | 구매 데이터의 서명 |
| `purchaseToken` | `String` | 거래의 고유 토큰. 자세한 정보는 [Google 문서](<https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken()>)를 참조하시기 바랍니다. |
| 파라미터 | 데이터 유형 | 설명 |
|-----------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------|
| `price` | `String` | 구독료 |
| `currency` | `String` | 구독 통화 |
| `sku` | `String` | 제품 ID |
| `orderId` | `String` | 거래 ID |
| `signature` | `String` | 구매 데이터의 서명 |
| `purchaseToken` | `String` | 거래의 고유 토큰. 자세한 정보는 [Google 문서](https://developer.android.com/reference/com/android/billingclient/api/Purchase#getPurchaseToken())를 참조하시기 바랍니다. |

```dart
AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
Expand All @@ -75,25 +73,21 @@ AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
purchaseToken);
```

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

### 구매일 기록 {#record-the-purchase-date}
### 구매일 기록 \{\#record\-the\-purchase\-date\}

사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다.

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

`AdjustAppStoreSubscription` 클래스에`transactionDate` 속성을 추가합니다.

<CodeBlock title="속성 선언">
<codeblock title="속성 선언">

```dart
String? transactionDate
```

</CodeBlock>
</CodeBlock>

`subscription` 인스턴스의 `transactionDate` 속성에 타임스탬프를 설정하면 사용자가 구독을 결제한 날을 기록할 수 있습니다.

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

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

`AdjustPlayStoreSubscription` 클래스에`purchaseTime` 속성을 추가합니다.

<CodeBlock title="속성 선언">
<codeblock title="속성 선언">

```dart
String? purchaseTime;
```

</CodeBlock>
</CodeBlock>

`subscription` 인스턴스의 `purchaseTime` 속성에 타임스탬프를 설정하면 사용자가 구독을 결제한 날을 기록할 수 있습니다.

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

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

### 구매 지역 기록\(iOS만 해당\) {#record-the-purchase-region-ios-only}
### 구매 지역 기록\(iOS만 해당\) \{\#record\-the\-purchase\-region\-ios\-only\}

<CodeBlock title="메서드 서명">
<codeblock title="메서드 서명">

```dart
String? salesRegion
```

</CodeBlock>
</CodeBlock>

사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 `setSalesRegion` 메서드를 호출하고 국가 코드를 `String`로 전달합니다. 이는 [`Storefront`](https://developer.apple.com/documentation/storekit/storefront/3792000-countrycode) 객체의 [`countryCode`](https://developer.apple.com/documentation/storekit/storefront)로 포맷되어야 합니다.

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

### 콜백 파라미터 추가 {#add-callback-parameters}
### 콜백 파라미터 추가 \{\#add\-callback\-parameters\}

콜백 파라미터를 구독 객체에 추가할 수 있습니다. Adjust는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 `addCallbackParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 매개 변수를 추가할 수 있습니다.

<Tabs>
<Tab title="App Store" sync="appstore" icon="PlatformIos"> <CodeBlock title="메서드 서명">
<tabs> <tab title="App Store" sync="appstore" icon="PlatformIos"> <codeblock title="메서드 서명">

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

</CodeBlock>
</CodeBlock>

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

</Tab>
<Tab title="Play Store" sync="playstore" icon="PlatformGooglePlay"> <CodeBlock title="메서드 서명">
</Tab> <tab title="Play Store" sync="playstore" icon="PlatformGooglePlay"> <codeblock title="메서드 서명">

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

</CodeBlock>
</CodeBlock>

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

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

### 파트너 파라미터 추가 {#add-partner-parameters}
### 파트너 파라미터 추가 \{\#add\-partner\-parameters\}

Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 `addPartnerParameter` 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다.

<Tabs>
<Tab title="App Store" sync="appstore" icon="PlatformIos"> <CodeBlock title="메서드 서명">
<tabs> <tab title="App Store" sync="appstore" icon="PlatformIos"> <codeblock title="메서드 서명">

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

</CodeBlock>
</CodeBlock>

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

</Tab>
<Tab title="Play Store" sync="playstore" icon="PlatformGooglePlay"> <CodeBlock title="메서드 서명">
</Tab> <tab title="Play Store" sync="playstore" icon="PlatformGooglePlay"> <codeblock title="메서드 서명">

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

</CodeBlock>
</CodeBlock>

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

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

## 2\. 구독 정보 기록 \{\#record\-subscription\-information\}
2\. 구독 정보 기록 \{\#record\-subscription\-information\}
----------------------------------------------------------

구독 객체를 설정하고 나면 Adjust SDK를 사용하여 기록을 시작할 수 있습니다.

<Tabs>
<Tab title="App Store" sync="appstore" icon="PlatformIos"> <CodeBlock title="메서드 서명">
<tabs> <tab title="App Store" sync="appstore" icon="PlatformIos"> <codeblock title="메서드 서명">

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

</CodeBlock>
</CodeBlock>

구독 객체를 `trackAppStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다.

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

</Tab>
<Tab title="Play Store" sync="playstore" icon="PlatformGooglePlay"> <CodeBlock title="메서드 서명">
</Tab> <tab title="Play Store" sync="playstore" icon="PlatformGooglePlay"> <codeblock title="메서드 서명">

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

</CodeBlock>
</CodeBlock>

구독 객체를 `trackPlayStoreSubscription` 메서드로 전달하여 사용자의 구독 구매를 기록합니다.

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

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

0 comments on commit 20cb5e2

Please sign in to comment.