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

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 15 additions & 13 deletions src/content/docs/ko/sdk/react-native/v4/plugins/index.mdoc
Original file line number Diff line number Diff line change
@@ -1,17 +1,19 @@
---
title: 서드파티 플러그인
description: 타사 플러그인을 사용하여 타사 SDK의 정보를 Adjust로 전달합니다.
category-title: 플러그인
type: category
title: "서드파티 플러그인"
description: "타사 플러그인을 사용하여 타사 SDK의 정보를 Adjust로 전달합니다."
category-title: "플러그인"
type: "category"
sidebar-position: 3
versions:
- label: v5
value: v5
default: true
- label: v4
value: v4
redirects:
v5: /ko/sdk/react-native/plugins
versions:
-
label: "v5"
value: "v5"
default: true
-
label: "v4"
value: "v4"
redirects:
v5: "/ko/sdk/react-native/plugins"
---

플러그인을 사용하여 정보를 타사 플러그인으로 전달합니다.

129 changes: 69 additions & 60 deletions src/content/docs/ko/sdk/react-native/v5/index.mdoc
Original file line number Diff line number Diff line change
@@ -1,26 +1,28 @@
---
title: React Native SDK 연동 가이드
description: React Native SDK를 사용해 React Native 앱의 Adjust 기능에 액세스
category-title: React Native SDK
slug: ko/sdk/react-native
title: "React Native SDK 연동 가이드"
description: "React Native SDK를 사용해 React Native 앱의 Adjust 기능에 액세스"
category-title: "React Native SDK"
slug: "en/sdk/react-native"
sidebar-position: 4
versions:
- label: v5
value: v5
default: true
- label: v4
value: v4
redirects:
v4: /ko/sdk/react-native/v4
versions:
-
label: "v5"
value: "v5"
default: true
-
label: "v4"
value: "v4"
redirects:
v4: "/ko/sdk/react-native/v4"
---

Adjust React Native SDK를 통해 React Native 앱의 어트리뷰션, 이벤트 등을 측정할 수 있습니다. 본 가이드의 단계를 수행하여 Adjust SDK와 연동되도록 앱을 설정하시기 바랍니다. 이에 대한 예시는 [GitHub](https://github.com/adjust/react_native_sdk/tree/master/example)에서 확인하실 수 있습니다.

{% callout type="important" %}
Adjust SDK는 iOS 12 이상 버전과 Android API level 21 (Lollipop) 이상을 지원합니다.
{% /callout %}
\{% callout type="important" %\}
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 @@ -30,13 +32,14 @@ React Native 앱에서 Adjust SDK를 시작하려면 우선 프로젝트에 Adju
$ npm install react-native-adjust@{% $versions.react_native.v5 %} --save
```

1. 터미널에서 다음 명령어를 실행하여 iOS 앱용 CocoaPods 디펜던시를 설치합니다.
2. 터미널에서 다음 명령어를 실행하여 iOS 앱용 CocoaPods 디펜던시를 설치합니다.

```console
$ cd ios && pod install
```

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

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

Expand All @@ -46,7 +49,8 @@ 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 @@ -64,66 +68,67 @@ componentWillUnmount() {

다음 `AdjustConfig` 인수를 전달합니다.

* `{YourAppToken}`을 귀하의 토큰으로 교체합니다. 앱 토큰 확인 방법은 [앱 설정](https://help.adjust.com/ko/article/app-settings#view-your-app-token) 페이지를 참조하시기 바랍니다.
* **앱 환경** 을 선택합니다.
* 앱을 테스트하며 테스트 데이터를 전송하려는 경우 `AdjustConfig.EnvironmentSandbox`를 사용합니다. 테스트 데이터를 보려면 대시보드에서 [샌드박스 모드를 활성화](https://help.adjust.com/ko/article/filter-data#sandbox)해야 합니다.
* `{YourAppToken}`을 귀하의 토큰으로 교체합니다. 앱 토큰 확인 방법은 [앱 설정](https://help.adjust.com/en/article/app-settings#view-your-app-token) 페이지를 참조하시기 바랍니다.
* **앱 환경** 을 선택합니다.
* 앱을 테스트하며 테스트 데이터를 전송하려는 경우 `AdjustConfig.EnvironmentSandbox`를 사용합니다. 테스트 데이터를 보려면 대시보드에서 [샌드박스 모드를 활성화](https://help.adjust.com/en/article/filter-data#sandbox)해야 합니다.
* 테스트를 끝내고 앱 출시가 준비되면 `AdjustConfig.EnvironmentProduction`을 사용하십시오.

{% callout type="important" %}
\{% callout type="important" %\}
테스트 시에는 환경이 `AdjustEnvironment.sandbox`로 설정되어야 합니다. 앱을 앱스토어에 제출하기 전에 이를 `AdjustEnvironment.production`로 변경합니다.
{% /callout %}
\{% /callout %\}

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

### 권한 추가 {% #add-permissions %}
### 권한 추가 \{% \#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`를 추가하여 이 권한을 제거할 수 있습니다.
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" %}
\{% callout type="seealso" %\}
이 권한에 대한 자세한 내용은 Google의 [`AdvertisingIdClient.Info`](https://developers.google.com/android/reference/com/google/android/gms/ads/identifier/AdvertisingIdClient.Info#public-string-getid) 문서를 참조하시기 바랍니다.
{% /callout %}
\{% /callout %\}

### Google Play Services 추가 {% #add-google-play-services %}
### Google Play Services 추가 \{% \#add\-google\-play\-services %\}

Google Play Store를 타겟팅하는 앱은 기기를 식별하기 위해 반드시 [Google Advertising ID](https://support.google.com/googleplay/android-developer/answer/6048248?hl=en) (`gps_adid`)를 사용해야 합니다. 이를 위해 `build.gradle` 파일의 `dependencies` 섹션에 다음의 디펜던시를 추가합니다.
Google Play Store를 타겟팅하는 앱은 기기를 식별하기 위해 반드시 [Google Advertising ID](https://support.google.com/googleplay/android-developer/answer/6048248?hl=en) \(`gps_adid`\)를 사용해야 합니다. 이를 위해 `build.gradle` 파일의 `dependencies` 섹션에 다음의 디펜던시를 추가합니다.

```groovy
implementation 'com.google.android.gms:play-services-ads-identifier:18.1.0'
```

{% callout type="note" %}
\{% callout type="note" %\}
Adjust SDK는 `play-services-ads-identifier` 디펜던시의 버전과 연결되어 있지 않습니다. 따라서 Google 플레이 서비스 라이브러리의 모든 버전을 사용할 수 있습니다.
{% /callout %}
\{% /callout %\}

### 설치 리퍼러 설정 {% #set-up-install-referrer %}
### 설치 리퍼러 설정 \{% \#set\-up\-install\-referrer %\}

설치 리퍼러는 앱 설치를 소스에 어트리뷰션하는 데 사용할 수 있는 어트리뷰션 메커니즘입니다. 이는 두 개의 부분으로 구성됩니다.

* [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** 이 활성화되어 있어야 합니다.
* [x] Google Play 및 Huawei App Gallery와 같은 앱 스토어가 스토어 웹사이트의 앱 페이지 URL에서 허용하는 `referrer` 파라미터입니다. 리퍼러 파라미터가 생성되는 방법은 다음과 같습니다.
* 사용자가 Adjust 링크를 클릭하면 Adjust 서버는 `reftag`라는 고유 식별자를 전달합니다. 이 식별자는 클릭과 리퍼러 파라미터에 할당됩니다. reftag에 관한 자세한 정보는 [Reftag](https://help.adjust.com/en/article/reftag)를 참고하시기 바랍니다.
* [Google Ads](https://support.google.com/google-ads/answer/6357635?hl=en) 캠페인을 실행할 때 Google은 `gclid`로 불리는 고유 식별자를 리퍼러 파라미터에 전달합니다. Google Ads 계정에서 **Auto\-tagging** 이 활성화되어 있어야 합니다.

{% callout type="note" %}
\{% callout type="note" %\}
설치 리퍼러가 필수는 아니지만 어트리뷰션 정확도 향상을 위해 적극 권장됩니다.
{% /callout %}
\{% /callout %\}

#### Google Play Referrer API

Expand All @@ -137,7 +142,7 @@ Adjust SDK는 `play-services-ads-identifier` 디펜던시의 버전과 연결되
}
```

1. `installreferrer` 라이브러리는 **Google Maven** 리포지토리의 일부입니다. 앱을 빌드하려면 앱의 최상위 `build.gradle` 파일에 Google Maven 리포지토리를 추가해야 합니다.
2. `installreferrer` 라이브러리는 **Google Maven** 리포지토리의 일부입니다. 앱을 빌드하려면 앱의 최상위 `build.gradle` 파일에 Google Maven 리포지토리를 추가해야 합니다.

```groovy
allprojects {
Expand All @@ -151,37 +156,41 @@ Adjust SDK는 `play-services-ads-identifier` 디펜던시의 버전과 연결되

#### Meta 리퍼러 연동

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).
Adjust SDK는 Adjust Meta 설치 리퍼러 플러그인을 사용하는 [Meta 설치 리퍼러](https://developers.facebook.com/docs/app-ads/meta-install-referrer)를 지원합니다. [연동에 대한 자세한 내용은 React Native Meta 설치 리퍼러 플러그인을 참조하시기 바랍니다](/en/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** 로 지정할 수 있습니다.
Adjust SDK는 특정 iOS 프레임워크가 앱에 포함된 경우 추가적인 정보를 얻을 수 있습니다. 이러한 프레임워크는 특정 SDK 기능을 활성화하지만, SDK가 일반적으로 작동하기 위해 반드시 필요한 것은 아닙니다. **Project Settings \-\-> Build Phases \-\-> Link Binary With Libraries** 에서 프레임워크를 추가한 뒤 이를 **Optional** 로 지정할 수 있습니다.

| 프레임워크 | 설명 | 참고 사항 |
| ------------------------------------- | --------------------------------------------------------------------------- | -------------------------------------------- |
| **AdSupport.framework** | SDK가 IDFA 값과 (iOS 14 이전의 경우) AT 정보에 액세스하기 위해 필요. | 앱이 "아동" 카테고리를 타겟팅하는 경우에는 이 프레임워크를 실행할 필요 없음. |
| 프레임워크 | 설명 | 참고 사항 |
|---------------------------------------|-----------------------------------------------------------------------------|----------------------------------------------|
| **AdSupport.framework** | SDK가 IDFA 값과 \(iOS 14 이전의 경우\) AT 정보에 액세스하기 위해 필요. | 앱이 "아동" 카테고리를 타겟팅하는 경우에는 이 프레임워크를 실행할 필요 없음. |
| **AdServices.framework** | 본 프레임워크는 Apple Search Ads 어트리뷰션을 위해 필요합니다. | |
| **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)의 지침을 따르시기 바랍니다.
Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 SDK 서명 라이브러리를 사용하려면 [Adjust 헬프 센터에 있는 SDK 서명 가이드](https://help.adjust.com/en/article/sdk-signature)의 지침을 따르시기 바랍니다.

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

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

* 환경을 `AdjustConfig.EnvironmentSandbox`로 설정합니다.
* Adjust 대시보드 결과에 [샌드박스 필터](https://help.adjust.com/ko/article/filter-data#sandbox)를 추가합니다.
* Adjust 대시보드 결과에 [샌드박스 필터](https://help.adjust.com/en/article/filter-data#sandbox)를 추가합니다.
* 로그 수준을 `AdjustConfig.LogLevelVerbose`로 설정합니다.

{% callout type="tip" %}
\{% callout type="tip" %\}
문제 발생 시, 모든 상세 내용과 로그를 [[email protected]](mailto:[email protected])로 전송하시기 바랍니다.
{% /callout %}
\{% /callout %\}

### Google Play Services 연동 테스트 {% #test-google-play-services-integration %}
### Google Play Services 연동 테스트 \{% \#test\-google\-play\-services\-integration %\}

Adjust SDK가 기기의 Google 광고 ID를 수신할 수 있는지 테스트하려면 로그 수준을 `AdjustConfig.LogLevelVerbose`로 설정하고, 환경을 `AdjustConfig.EnvironmentSandbox`로 설정합니다. 앱을 시작하고 세션이나 이벤트를 기록합니다. SDK가 광고 ID를 읽으면 `gps_adid` 파라미터를 로그합니다.

Google광고 ID를 읽을 수 없다면 SDK [Github repository](https://github.com/adjust/react_native_sdk)에 이슈를 제기하거나 [[email protected]](mailto:[email protected])으로 메일로 문의해 주시기 바랍니다.

30 changes: 16 additions & 14 deletions src/content/docs/ko/sdk/react-native/v5/plugins/index.mdoc
Original file line number Diff line number Diff line change
@@ -1,18 +1,20 @@
---
title: 서드파티 플러그인
description: 타사 플러그인을 사용하여 타사 SDK의 정보를 Adjust로 전달합니다.
category-title: 플러그인
slug: ko/sdk/react-native/plugins
type: category
title: "서드파티 플러그인"
description: "타사 플러그인을 사용하여 타사 SDK의 정보를 Adjust로 전달합니다."
category-title: "플러그인"
slug: "en/sdk/react-native/plugins"
type: "category"
sidebar-position: 3
versions:
- label: v5
value: v5
default: true
- label: v4
value: v4
redirects:
v4: /ko/sdk/react-native/v4/plugins
versions:
-
label: "v5"
value: "v5"
default: true
-
label: "v4"
value: "v4"
redirects:
v4: "/ko/sdk/react-native/v4/plugins"
---

플러그인을 사용하여 정보를 타사 플러그인으로 전달합니다.

Loading
Loading