Android SDK 시작 가이드

팁:

Adjust가 Android SDK의 새로운 버전을 출시했습니다. 사전 체험판을 통해 새로운 기능을 사용해보고 싶으신가요? 현재 사용 가능한 새로운 기능과 특징은 다음과 같습니다.

슈퍼 앱 또는 자체 BI 시스템을 보유한 고객사에 대한 지원 개선
adid 정보 조회에 대한 유연성 추가, 이벤트 중복 제거 제한 상한, SDK 정보의 캐싱 및 재생 개선
자세한 어트리뷰션 콜백 정보, 디버깅 간소화, 직관적인 메서드 이름

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

1단계: 환경 설정

Adjust SDK를 시작하려면 프로젝트에 Adjust SDK를 dependency로 추가해야 합니다.

중요:

Adjust SDK 연동에 필요한 Android API의 최소 지원 레벨은 9 (Gingerbread)입니다. 웹뷰 확장에 필요한 Android API의 최소 지원 레벨은 17(Jelly Bean)입니다.

Maven

다음을 build.gradle 파일에 추가합니다:

dependencies {
   implementation 'com.adjust.sdk:adjust-android:4\.38\.3'
   implementation 'com.android.installreferrer:installreferrer:2.2'
   // 앱의 웹 뷰 내에서 Adjust SDK를 사용하는 경우 다음을 추가하세요.
   implementation 'com.adjust.sdk:adjust-android-webbridge:4\.38\.3'
}

아카이브로 추가

Google Play Store의 앱은 기기 식별을 위해 Google 광고 ID 를 사용해야 합니다. Adjust SDK에 Google 광고 ID를 활성화하려면 Google Play Services 를 연동해야 합니다. 이를 위해 Google Play Services 라이브러리를 프로젝트에 추가하시기 바랍니다. build.gradle 파일의 dependencies 섹션에 다음의 디펜던시를 추가합니다.

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

참고:

Adjust SDK는 play-services-analytics 디펜던시의 버전과 연결되어 있지 않습니다. 따라서 Google Play Services 라이브러리의 모든 버전을 사용할 수 있습니다.

앱 세트 ID 수집

참고:

앱 세트 ID는 Adjust SDK v4.33.5 및 이상 버전에서 이용 가능합니다.

앱 세트 ID 는 사용자가 기기에 설치한 앱 정보를 측정할 수 있도록 해주는 고유한 ID입니다. 동일한 개발자의 모든 앱은 앱 세트 ID를 공유하기 때문에, 모든 앱 사용자로부터 유의미한 인사이트를 수집할 수 있습니다. 디바이스의 앱 세트 ID를 기록하려면 다음의 권한을 build.gradle 파일에 추가해야 합니다.

dependencies {
   implementation 'com.google.android.gms:play-services-appset:16.0.2'
 }

3단계: 권한 추가

참고:

앱이 어린이를 타겟하는 경우, Adjust SDK가 읽는 것을 방지하기 위해 AD_ID 권한을 삭제해야 합니다. 자세한 내용은 은 어린이용 앱 설정 을 참조하시기 바랍니다.

Adjust SDK는 다음의 권한을 필요로 합니다. 다음의 권한을 AndroidManifest.xml 파일에 추가하시기 바랍니다.

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

Google Play Store를 타겟팅하지 않는 경우 다음의 권한을 추가해야 합니다:

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

4단계: 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.** { *; }

Google Play Store에서 앱을 퍼블리시하지 않는 경우 다음의 com.adjust.sdk 규칙을 추가합니다.

-keep public class com.adjust.sdk.** { *; }

5단계: 설치 리퍼러 설정

설치 리퍼러는 앱 설치를 소스에 어트리뷰션하는 데 사용할 수 있는 고유한 식별자입니다. Adjust SDK는 어트리뷰션을 위해 이 정보가 필요합니다. 이 정보를 수집하는 방법에는 4가지가 있습니다.

Google Play Referrer API 사용.
브로드캐스트 리시버로 INSTALL_REFERRER 인텐트 수신
Huawei Referrer API 사용(Huawei 기기에만 해당).
Facebook 리퍼러 연동을 사용합니다.
기기 별 값에 액세스하기 위해 플러그인을 사용하시기 바랍니다.

중요:

Google은 Google Play Services의 리퍼러 정보를 전달하는 데 사용되는 INSTALL_REFERRER 인텐트 메서드 를 지원하지 않습니다. 현재 이 메서드를 사용한다면 Google Play Referrer API로 전환하시기 바랍니다.

Google Play Referrer API

참고:

이 기능은 Adjut SDK v4.12.0 이상 버전에서 지원됩니다.

Google Play Referrer API를 지원하려면 다음이 build.gradle 파일에 있어야 합니다.

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

Proguard를 사용하는 경우, Proguard 파일에 다음의 세팅을 추가합니다:

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

INSTALL_REFERRER 인텐트

INSTALL_REFERRER 인텐트를 지원하는 스토어의 경우, 브로드캐스트 리시버로 이를 포착할 수 있습니다. AndroidManifest.xml 의 application 태그에 다음의 receiver 를 추가합니다.

<receiver     android:name="com.adjust.sdk.AdjustReferrerReceiver"     android:permission="android.permission.INSTALL_PACKAGES"     android:exported="true" >
    <intent-filter>
        <action android:name="com.android.vending.INSTALL_REFERRER" />
    </intent-filter>
</receiver>

이 수신기는 설치 리퍼러를 조회하고 Adjust 백엔드로 전달합니다.

다른 수신기를 사용하는 경우 Adjust와의 커뮤니케이션을 설정해야 합니다. Adjust 브로드캐스트 리시버와의 커뮤니케이션 활성화는 이 설명을 참조하시기 바랍니다.

Huawei 리퍼러 API

메타 리퍼러 연동

Adjust SDK는 v4.36.0 이상 버전에서 메타 설치 리퍼러 를 지원합니다. 본 기능을 활성화하려면 다음을 수행하시기 바랍니다.

Meta 앱 ID는 App Dashboard 에서 찾을 수 있습니다. 자세한 내용은 Meta의 App Dashboard 문서 를 참조하시기 바랍니다.
앱 ID를 문자열 인수로 AdjustConfig.setFbAppId 메서드에 전달합니다.

Java

adjustConfig.setFbAppId(<fb_app_id_string>);

삼성 리퍼러 플러그인

Xiaomi 리퍼러 플러그인

6단계: SDK를 앱에 연동

Adjust SDK를 표준 앱에 연동하는 경우, 표준 SDK 연동 단계를 수행하시기 바랍니다. 웹뷰에 대해 SDK를 연동하는 경우, 웹뷰 SDK 연동 단계를 수행합니다.

표준 SDK

Adjust는 SDK 초기화를 위해 글로벌 Android Application 클래스를 사용하는 것을 추천합니다. 이 설정이 없는 경우 다음을 수행합니다:

Application 를 확장하는 클래스를 생성합니다.
AndroidManifest.xml 파일을 열고, <application> 요소를 찾습니다.
android:name 속성을 추가하고 어플리케이션 클래스의 이름으로 설정합니다. 예를 들어, Application 클래스의 이름이 GlobalApplication 인 경우:

 <application
   android:name=".GlobalApplication"
   <!-- ... -->
 </application>

애플리케이션 클래스에서 onCreate 메서드를 찾거나 추가합니다. 다음의 코드를 추가하여 Adjust SDK를 초기화합니다.

import com.adjust.sdk.Adjust;
import com.adjust.sdk.AdjustConfig;

public class GlobalApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        String appToken = "{YourAppToken}";
        String environment = AdjustConfig.ENVIRONMENT_SANDBOX;
        AdjustConfig config = new AdjustConfig(this, appToken, environment);
        Adjust.onCreate(config);
    }
}

팁:

앱 토큰은 Adjust 대시보드에서 찾을 수 있습니다.

environment 변수를 샌드박스 또는 프로덕션 모드로 설정합니다.

중요:

테스트 시에는 반드시 환경이 AdjustConfig.ENVIRONMENT_SANDBOX 로 설정되어야 합니다. 앱을 앱스토어에 제출하기 전에 이를 AdjustConfig.ENVIRONMENT_PRODUCTION 로 변경합니다.

String environment = AdjustConfig.ENVIRONMENT_SANDBOX;
String environment = AdjustConfig.ENVIRONMENT_PRODUCTION;

Web View SDK

이 과정을 시작하기 전에, WebView 객체에 대한 레퍼런스를 얻어야 합니다. 완료되면 다음을 따르시기 바랍니다.

webView.getSettings().setJavaScriptEnabled(true) 를 호출하여 웹뷰에서 자바스크립트를 활성화합니다.
AdjustBridge.registerAndGetInstance(getApplication(), webview) 를 호출하여 AdjustBridgeInstance 의 디폴트 인스턴스를 시작합니다. 이는 Adjust 브릿지를 웹뷰에서 자바스크립트 인터페이스로 등록할 것입니다.
필요한 경우 AdjustBridge.setWebView() 를 호출하여 새로운 WebView 를 설정합니다.
AdjustBridge.unregister() 를 호출하여 AdjustBridgeInstance 와 WebView 의 등록을 취소합니다.

위 단계를 모두 완료하면 액티비티는 다음과 같아야 합니다:

public class MainActivity extends Activity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        WebView webView = (WebView) findViewById(R.id.webView);
        webView.getSettings().setJavaScriptEnabled(true);
        webView.setWebChromeClient(new WebChromeClient());
        webView.setWebViewClient(new WebViewClient());

        AdjustBridge.registerAndGetInstance(getApplication(), webview);
        try {
            webView.loadUrl("file:///android_asset/AdjustExample-WebView.html");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
    
    @Override
    protected void onDestroy() {
        AdjustBridge.unregister();

        super.onDestroy();
    }
}

축하합니다! Adjust 브릿지가 앱에 추가되었습니다! 자바스크립트 브릿지가 페이지와 Adjust SDK 간에 소통할 수 있습니다.

HTML 파일로 SDK에서 Adjust Javascript 파일을 가져옵니다.

<script type="text/javascript" src="adjust.js"></script>null<script type="text/javascript" src="adjust_event.js"></script>
<script type="text/javascript" src="adjust_third_party_sharing.js"></script>
<script type="text/javascript" src="adjust_config.js"></script>

자바스크립트 파일에 레퍼런스를 추가합니다. Adjust SDK를 초기화하기 위해 HTML 파일에서 다음을 사용합니다:

let yourAppToken = '{YourAppToken}';
let environment = AdjustConfig.EnvironmentSandbox;
let adjustConfig = new AdjustConfig(yourAppToken, environment);

Adjust.onCreate(adjustConfig);

팁:

앱 토큰은 Adjust 대시보드에서 찾을 수 있습니다.

중요:

테스트 시에는 반드시 환경이 AdjustConfig.EnvironmentSandbox 로 설정되어야 합니다. 앱을 앱스토어에 제출하기 전에 이를 AdjustConfig.EnvironmentProduction 로 변경합니다.

let environment = AdjustConfig.EnvironmentSandbox;
let environment = AdjustConfig.EnvironmentProduction;

7단계: 세션 트래킹 설정

SDK가 세션 정보를 Adjust 백엔드로 전달할 수 있도록 세션 트래킹을 설정해야 합니다. 다음의 설명에 따라 앱에서 이를 설정하시기 바랍니다.

API level 14 이상

ActivityLifecycleCallbacks 인터페이스를 도입한 비공개 클래스를 추가합니다. 본 인터페이스에 액세스할 수 없다면 앱이 타겟팅하는 Android API 레벨이 14 이하인 것입니다. 이 경우 아래의 지침 에 따라 각 활동을 업데이트해야 합니다. 앱의 액티비티에 Adjust.onResume 와 Adjust.onPause 호출이 있다면, 이를 삭제합니다.
onActivityResumed(Activity activity) 메서드를 수정하고, Adjust.onResume() 에 콜을 추가합니다. onActivityPaused(Activity activity) 메서드를 수정하고, Adjust.onPause() 에 콜을 추가합니다.
Adjust SDK 구성 단계에 onCreate() 메서드를 추가합니다. 생성된 ActivityLifecycleCallbacks 클래스의 인스턴스와 함께 registerActivityLifecycleCallbacks 을 호출합니다.

import com.adjust.sdk.Adjust;
import com.adjust.sdk.AdjustConfig;

public class GlobalApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        String appToken = "{YourAppToken}";
        String environment = AdjustConfig.ENVIRONMENT_SANDBOX;
        AdjustConfig config = new AdjustConfig(this, appToken, environment);
        Adjust.onCreate(config);

        registerActivityLifecycleCallbacks(new AdjustLifecycleCallbacks());
    }

     private static final class AdjustLifecycleCallbacks implements ActivityLifecycleCallbacks {
         @Override
         public void onActivityResumed(Activity activity) {
             Adjust.onResume();
         }

         @Override
         public void onActivityPaused(Activity activity) {
             Adjust.onPause();
         }

         //...
     }
  }

API level 9~13

gradle 파일의 minSdkVersion 값이 9~13이라면 14 이상으로 업데이트하시기 바랍니다. 이를 통해 연동 과정을 간소화할 수 있습니다. 주요 버전별 시장 점유율에 관한 정보는 Android 대시보드 에서 확인하시기 바랍니다.

액티비티를 중지 또는 재개하려면 특정 메서드를 호출해야 합니다. 이를 통해 Adjust SDK가 세션의 시작이나 종료를 놓치지 않을 수 있습니다. 앱에서 각 액티비티에 대해 다음의 단계를 수행하시기 바랍니다:

Activity의 onResume 메서드에서 Adjust.onResume() 을 호출합니다. 필요한 경우 본 메서드를 생성합니다.
Activity의 onPause 메서드에서 Adjust.onPause() 을 호출합니다. 필요한 경우 본 메서드를 생성합니다.

위 단계를 모두 완료하면 액티비티는 다음과 같아야 합니다.

import com.adjust.sdk.Adjust;

public class YourActivity extends Activity {
    protected void onResume() {
        super.onResume();
        Adjust.onResume();
    }
    protected void onPause() {
        super.onPause();
        Adjust.onPause();
    }
}

앱에서 각 액티비티에 대해 위 단계를 반복합니다. 코딩 스타일에 따라, 모든 액티비티에 대해 공통 슈퍼클래스에서 본 단계를 추가할 수도 있습니다.

8단계: 로깅 설정

로깅의 verbosity를 설정하려면 config 인스턴스에서 setLogLevel 메서드 를 호출합니다.

Java

Javascript

adjustConfig.setLogLevel(LogLevel.WARN);

모든 로깅을 비활성화하려면 로그 수준을 suppress 으로 설정합니다.

Java

Javascript

AdjustConfig config = new AdjustConfig(this, appToken, environment, true);
config.setLogLevel(LogLevel.SUPRESS);
Adjust.onCreate(config);

9단계: 앱 빌드

잘하셨습니다! 이제 앱을 빌드하고 실행할 수 있습니다. 로깅을 활성화하여 문제가 있는지 확인하고 Adjust SDK를 통해 사용자 어트리뷰션을 시작하시기 바랍니다.