Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Smartling translations are completed for commit e27a4b6d44607d0b26525d2b429bf62669f9745d from main #1241

Draft
wants to merge 8 commits into
base: main
Choose a base branch
from
Draft
10 changes: 5 additions & 5 deletions src/content/docs/ko/sdk/react-native/v4/plugins/index.mdoc
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,11 @@ category-title: 플러그인
type: category
sidebar-position: 3
versions:
- label: v5
value: v5
default: true
- label: v4
value: v4
- label: v5
value: v5
default: true
- label: v4
value: v4
redirects:
v5: /ko/sdk/react-native/plugins
---
Expand Down
52 changes: 33 additions & 19 deletions src/content/docs/ko/sdk/react-native/v5/index.mdoc
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,11 @@ category-title: React Native SDK
slug: ko/sdk/react-native
sidebar-position: 4
versions:
- label: v5
value: v5
default: true
- label: v4
value: v4
- label: v5
value: v5
default: true
- label: v4
value: v4
redirects:
v4: /ko/sdk/react-native/v4
---
Expand All @@ -20,7 +20,9 @@ Adjust React Native SDK를 통해 React Native 앱의 어트리뷰션, 이벤트
Adjust SDK는 iOS 12 이상 버전과 Android API level 21 (Lollipop) 이상을 지원합니다.
{% /callout %}

## 1. 프로젝트에 SDK 추가 {% #add-the-sdk-to-your-project %}
1. 프로젝트에 SDK 추가 {% #add-the-sdk-to-your-project %}

---

React Native 앱에서 Adjust SDK를 시작하려면 우선 프로젝트에 Adjust SDK를 추가해야 합니다. Adjust SDK를 추가를 위해 다음 단계를 따르시기 바랍니다.

Expand All @@ -36,7 +38,9 @@ React Native 앱에서 Adjust SDK를 시작하려면 우선 프로젝트에 Adju
$ cd ios && pod install
```

## 2. SDK 연동 {% #integrate-the-sdk %}
1. SDK 연동 {% #integrate-the-sdk %}

---

SDK를 프로젝트에 연동하려면 Adjust의 SDK 구성을 메인 앱 Javascript 파일로 가져와야 합니다.

Expand All @@ -46,7 +50,9 @@ SDK를 프로젝트에 연동하려면 Adjust의 SDK 구성을 메인 앱 Javasc
import { Adjust, AdjustConfig } from "react-native-adjust";
```

## 3. Adjust SDK 초기화 {% #initialize-the-adjust-sdk %}
3. Adjust SDK 초기화 {% #initialize-the-adjust-sdk %}

---

React Native 앱에서 최대한 빨리 Adjust SDK를 초기화하시기 바랍니다. 이를 위해 앱 토큰 및 앱을 실행하고자 하는 환경과 함께 config 객체를 초기화하시기 바랍니다. 앱의 `.js` 파일 시작 부분에 다음 코드 라인을 추가합니다.

Expand All @@ -73,27 +79,29 @@ componentWillUnmount() {
테스트 시에는 환경이 `AdjustEnvironment.sandbox`로 설정되어야 합니다. 앱을 앱스토어에 제출하기 전에 이를 `AdjustEnvironment.production`로 변경합니다.
{% /callout %}

## 4. Android 기기 설정 {% #set-up-android-devices %}
4. Android 기기 설정 {% #set-up-android-devices %}

---

### 권한 추가 {% #add-permissions %}

Adjust SDK는 정보 액세스를 위한 특정 권한이 필요합니다.

* `INTERNET`: Adjust Android SDK에 자동으로 추가됨. 수동으로 추가할 필요는 없습니다.
* `INTERNET`: Adjust Android SDK에 자동으로 추가됩니다. 수동으로 추가하지 않아도 됩니다.

추가적인 정보에 대한 액세스를 허용하는 선택적 권한을 추가할 수도 있습니다.
추가 정보에 액세스할 수 있는 선택적 권한도 추가할 있습니다.

* `ACCESS_NETWORK_STATE` (선택 사항): 이를 `AndroidManifest.xml` 파일에 추가하여 유용한 특정 파라미터를 읽을 수 있습니다.
* `ACCESS_NETWORK_STATE` (선택 사항): 이를 `AndroidManifest.xml` 파일에 추가하면 도움이 될 수 있는 특정 파라미터를 읽을 수 있습니다.

```xml
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.INTERNET" id="sl-md0000000"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" id="sl-md0000000"/>
```

Adjust SDK 4.32.0 및 이상 버전에는 `com.google.android.gms.AD_ID` 권한이 기본값으로 포함됩니다. 앱이 COPPA 준수 대상이거나 Google 플레이 스토어를 타겟으로 하지 않는 경우, `remove`를 추가하여 이 권한을 제거할 수 있습니다.

```xml
<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
<uses-permission android:name="com.google.android.gms.permission.AD_ID" id="sl-md0000000"/>
```

{% callout type="seealso" %}
Expand All @@ -119,7 +127,7 @@ Adjust SDK는 `play-services-ads-identifier` 디펜던시의 버전과 연결되
* [x] 개발자가 앱에서 추천 콘텐츠를 검색할 수 있도록 하는 앱 스토어의 API 집합체입니다.
* [x] Google Play 및 Huawei App Gallery와 같은 앱 스토어가 스토어 웹사이트의 앱 페이지 URL에서 허용하는 `referrer` 파라미터입니다. 리퍼러 파라미터가 생성되는 방법은 다음과 같습니다.
* 사용자가 Adjust 링크를 클릭하면 Adjust 서버는 `reftag`라는 고유 식별자를 전달합니다. 이 식별자는 클릭과 리퍼러 파라미터에 할당됩니다. reftag에 관한 자세한 정보는 [Reftag](https://help.adjust.com/ko/article/reftag)를 참고하시기 바랍니다.
* [Google 애드](https://support.google.com/google-ads/answer/6357635?hl=en) 캠페인을 실행할 때 Google은 `gclid`라는 고유 식별자를 리퍼러 파라미터에 전달합니다. Google Ads 계정에서 **Auto-tagging** 이 활성화되어 있어야 합니다.
* [Google Ads](https://support.google.com/google-ads/answer/6357635?hl=en) 캠페인을 실행할 때 Google은 `gclid`로 불리는 고유 식별자를 리퍼러 파라미터에 전달합니다. Google Ads 계정에서 **Auto-tagging** 이 활성화되어 있어야 합니다.

{% callout type="note" %}
설치 리퍼러가 필수는 아니지만 어트리뷰션 정확도 향상을 위해 적극 권장됩니다.
Expand Down Expand Up @@ -153,7 +161,9 @@ Adjust SDK는 `play-services-ads-identifier` 디펜던시의 버전과 연결되

Adjust SDK는 Adjust Meta 설치 리퍼러 플러그인을 사용하는 [Meta 설치 리퍼러](https://developers.facebook.com/docs/app-ads/meta-install-referrer)를 지원합니다. [연동에 대한 자세한 내용은 React Native Meta 설치 리퍼러 플러그인을 참조하시기 바랍니다](/ko/sdk/react-native/plugins/meta-referrer-plugin).

## 5. iOS 프레임워크 추가 {% #add-ios-frameworks %}
5. iOS 프레임워크 추가 {% #add-ios-frameworks %}

---

Adjust SDK는 특정 iOS 프레임워크가 앱에 포함된 경우 추가적인 정보를 얻을 수 있습니다. 이러한 프레임워크는 특정 SDK 기능을 활성화하지만, SDK가 일반적으로 작동하기 위해 반드시 필요한 것은 아닙니다. **Project Settings --> Build Phases --> Link Binary With Libraries** 에서 프레임워크를 추가한 뒤 이를 **Optional** 로 지정할 수 있습니다.

Expand All @@ -164,11 +174,15 @@ Adjust SDK는 특정 iOS 프레임워크가 앱에 포함된 경우 추가적인
| **StoreKit.framework** | SKAdNetwork 프레임워크에 액세스하고, Adjust SDK가 iOS 14 및 이후 버전에서 통신을 자동으로 처리하기 위해 필요. | |
| **AppTrackingTransparency.framework** | iOS 14 및 이후 버전에서 SDK가 사용자의 ATT 동의를 래핑하고 사용자의 동의 응답에 액세스하기 위해 필요. | 앱이 "아동" 카테고리를 타겟팅하는 경우에는 이 프레임워크를 실행할 필요 없음. |

## 6. SDK 서명 설정 {% #set-up-sdk-signature %}
6. SDK 서명 설정 {% #set-up-sdk-signature %}

---

Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 SDK 서명 라이브러리를 사용하려면 [Adjust 헬프 센터에 있는 SDK 서명 가이드](https://help.adjust.com/ko/article/sdk-signature)의 지침을 따르시기 바랍니다.

## 7. 연동 테스트 {% #test-your-integration %}
7. 연동 테스트 {% #test-your-integration %}

---

Adjust SDK는 연동 테스트와 문제 해결 툴을 제공합니다. 다음과 같이 설정을 테스트하시기 바랍니다.

Expand Down
10 changes: 5 additions & 5 deletions src/content/docs/ko/sdk/react-native/v5/plugins/index.mdoc
Original file line number Diff line number Diff line change
Expand Up @@ -6,11 +6,11 @@ slug: ko/sdk/react-native/plugins
type: category
sidebar-position: 3
versions:
- label: v5
value: v5
default: true
- label: v4
value: v4
- label: v5
value: v5
default: true
- label: v4
value: v4
redirects:
v4: /ko/sdk/react-native/v4/plugins
---
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,17 +3,17 @@ title: Meta 설치 리퍼러
description: Meta 설치 리퍼러 플러그인을 사용하여 Meta 설치 리퍼러 정보를 Adjust에 전송합니다.
slug: ko/sdk/react-native/plugins/meta-referrer-plugin
versions:
- label: v5
value: v5
default: true
- label: v4
value: v4
- label: v5
value: v5
default: true
- label: v4
value: v4
redirects:
v4: /ko/sdk/react-native/v4#meta-referrer-integration
---

{% callout type="note" %}
Adjust SDK는 [Meta가 요구](https://developers.facebook.com/docs/app-ads/meta-install-referrer#step-1--add-the-meta-apps)하는 `<queries>` 요소를 번들로 제공합니다. 이를 `AndroidManifest.xml`에 추가할 필요는 없습니다.
Adjust SDK는 [Meta가 요구](https://developers.facebook.com/docs/app-ads/meta-install-referrer#step-1--add-the-meta-apps)하는 `<queries id="sl-md0000000">` 요소를 번들로 제공합니다. 이를 `AndroidManifest.xml`에 추가할 필요는 없습니다.
{% /callout %}

Meta 설치 리퍼러 플러그인은 Adjust SDK가 기기에서 Meta 설치 리퍼러 값을 읽을 수 있도록 해줍니다. 이후 SDK는 해당 정보를 설치 페이로드의 일부로서 Adjust 서버에 전송합니다.
Expand Down
Loading