React Native SDK 시작하기

Adjust React Native SDK를 통해 React Native 앱의 어트리뷰션, 이벤트 등을 트래킹 할 수 있습니다. 본 페이지의 단계에 따라 Adjust SDK 설정을 완료하시기 바랍니다. 이에 대한 예시는 GitHub에서 확인하실 수 있습니다.

1. 프로젝트에 SDK 추가

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

1. 다음 방법 중 한 가지를 사용하여 React Native 라이브러리를 다운로드합니다.

$ npm install react-native-adjust --save

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

$ cd ios && pod install

2. SDK 연동

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

앱의 .js 파일의 시작 부분에 다음의 라인을 추가합니다:

import { Adjust, AdjustEvent, AdjustConfig } from 'react-native-adjust';

3. Adjust SDK 초기화

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

constructor(props) {
    super(props);
    const adjustConfig = new AdjustConfig("{YourAppToken}", AdjustConfig.EnvironmentSandbox);
    Adjust.create(adjustConfig);
}

componentWillUnmount() {
  Adjust.componentWillUnmount();
}

AdjustConfig 인수 전달:

• {YourAppToken} 를 사용 중인 토큰으로 교체합니다. 토큰 확인 방법은 앱 설정 을 참조하시기 바랍니다.
• 앱 환경 을 선택합니다.
  • 앱을 테스트하며 테스트 데이터를 전송하려는 경우 AdjustConfig.EnvironmentSandbox 를 사용합니다. 테스트 데이터를 보려면 Datascape에서 샌드박스 모드를 활성화 해야 합니다.
  • 테스트를 완료하고 앱 출시 준비가 된 경우 AdjustConfig.EnvironmentProduction 를 사용하시기 바랍니다.

4. Android 기기 설정

권한 추가

Adjust SDK는 다음의 권한을 필요로합니다. AndroidManifest.xml 파일이 아직 존재하지 않는다면 추가하시기 바랍니다.

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

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

<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

자세한 내용은 Google의 AdvertisingIdClient.info 문서를 참조하시기 바랍니다.

Google Play Services 추가

Google Play Store를 타겟팅하는 앱은 기기를 식별하기 위해 반드시 Google Advertising ID (gps_adid)를 사용해야 합니다. 이를 위해 build.gradle 파일의 dependencies 섹션에 다음의 디펜던시를 추가합니다.

implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'

Proguard 설정

Proguard를 사용하는 경우, 다음의 규칙을 Proguard 파일에 추가하시기 바랍니다.

-keep class com.adjust.sdk.** { *; }
-keep class com.google.android.gms.common.ConnectionResult {
    int SUCCESS;
}
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient {
    com.google.android.gms.ads.identifier.AdvertisingIdClient$Info getAdvertisingIdInfo(android.content.Context);
}
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient$Info {
    java.lang.String getId();
    boolean isLimitAdTrackingEnabled();
}
-keep public class com.android.installreferrer.** { *; }

설치 리퍼러 설정

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

•  개발자가 앱에서 추천 콘텐츠를 검색할 수 있도록 하는 앱 스토어의 API 집합체입니다.
•  Google Play 및 Huawei App Gallery와 같은 앱 스토어가 스토어 웹사이트의 앱 페이지 URL에서 허용하는 referrer 파라미터입니다. 리퍼러 파라미터가 생성되는 방법은 다음과 같습니다.
  • 사용자가 Adjust 트래커를 클릭하면 Adjust 서버는 reftag라는 고유 식별자를 전달합니다. 이 식별자는 클릭과 리퍼러 파라미터에 할당됩니다. reftag에 관한 자세한 정보는 Reftag를 참고하시기 바랍니다.
  • Google Ads 캠페인을 실행할 때 Google은 gclid라는 고유 식별자를 리퍼러 파라미터에 전달합니다. Google Ads 계정에서 auto-tagging 이 활성화되어 있어야 합니다.

dependencies {
//...
implementation 'com.android.installreferrer:installreferrer:2.2'
//...
}

allprojects {
    repositories {
        maven {
            url "https://maven.google.com"
        }
    }
}

-keep public class com.android.installreferrer.** { *; }

5. iOS 프레임워크 추가

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

6. Adjust SDK 서명 추가

Adjust SDK 서명을 사용해 Adjust SDK가 전송한 모든 커뮤니케이션에 서명을 추가할 수 있습니다. Adjust 서버는 이를 기반으로 유효하지 않은 설치 활동을 감지 및 차단할 수 있습니다.

Adjust SDK 서명을 사용하려면 담당 테크니컬 어카운트 매니저 또는 support@adjust.com에 문의하시기 바랍니다.

7. 연동 테스트

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

• 샌드박스 모드로 환경을 설정합니다.
• Datascape에서 샌드박스 필터 추가
• 로그 수준을 verbose 로 설정합니다.