마케터를 위한 안드로이드 SDK 연동 가이드

어떤 인앱 이벤트로도 수익 값을 보낼 수 있습니다. 수익을 포함하려면 af_revenue 파라미터를 사용해야 합니다. 앱스플라이어가 대시보드와 로데이터에서 실제 수익으로 계산하는 유일한 이벤트 파라미터입니다. 자세한 사항은 여기를 확인하세요.

개발사 지침은 수익 기록을 참조하십시오.

앱스플라이어의 SDK는 인앱 구매에 대해서 서버 확인 기능을 제공합니다. 구매 검증을 통과하면 앱스플라이어로 인앱 구매 이벤트가 자동 전송됩니다. 그러므로 이 이벤트를 따로 직접 전송하면 인앱 구매 내역이 중복되어 기록됩니다.

앱이 여행, 게임 또는 이커머스와 같은 수직 구조에 속하는 경우 수직 구조별로 권장되는 인앱 이벤트 목록을 참조하십시오.

앱을 설치하지 않은 사용자의 경우 원링크는 장치 유형을 검색하여 올바른 대상(예를 들어, Google Play, Apple App Store, 타사 앱 스토어 또는 웹 페이지)으로 리디렉션합니다. 이것은 원링크 템플릿 설정에 기반합니다. 더 알아보기

앱을 설치한 사용자에 대해 원링크는 앱을 열어줍니다. 앱을 열 뿐만 아니라 앱 내의 특정 활동이나 페이지로 사용자를 딥링킹할 수도 있습니다. 이렇게 하려면 개발사가 통합 딥링킹(UDL)을 구현해야 합니다.

일러두기:

• UDL은 SDK V6.1 이상을 요구합니다.
• 딥링킹에 원링크를 이미 사용하고 있는 고객은 UDL 대신 레거시 방법을 사용하고 있을 수 있습니다.

원링크로 딥링킹 설정하기 가이드에서 상세 설명을 확인하십시오.

앱을 설치하지 않은 사용자의 경우 원링크는 장치 유형을 검색하여 올바른 대상인 Google Play, Apple App Store, 타사 앱 스토어 또는 웹 페이지로 리디렉션합니다. 사용자가 앱을 실행하면 디퍼드 딥링킹을 사용하여 앱 내의 특정 활동 또는 페이지로 리디렉션할 수 있습니다.

이렇게 하려면 개발사가 통합 딥링킹(UDL)을 구현해야 합니다.

일러두기:

• UDL은 SDK V6.1 이상을 요구합니다.
• 디퍼드 딥링킹에 원링크를 이미 사용하고 있는 고객은 UDL 대신 레거시 방법을 사용하고 있을 수 있습니다.

자세한 내용은 디퍼드 딥링킹에 대한 가이드를 참고하십시오.

앱스플라이어는 모든 벤더의 푸시 알림 캠페인 측정을 지원하며 Google 클라우드 메시징 또는 Apple 푸시 알림 서비스를 직접 사용하는 개발사도 지원할 수 있습니다. 앱으로 정의된 전환은 푸시 알림 메시지에서 시작하여 리타게팅 대시보드에 표시됩니다.

원링크를 사용하여 푸시 알림을 통해 사용자 리인게이지먼트를 측정할 수 있습니다. 푸시 알림 리인게이지먼트 캠페인 측정에 대한 안내서를 참조하십시오.

앱스플라이어를 사용하면, 구글 플레이 외 앱 마켓을 통한 인스톨까지 성과 측정 할 수 있습니다. 이를 통해 구글 플레이를 사용할 수 없는 시장에서도 앱을 홍보하고 더 많은 잠재 고객에게 도달 할 수 있습니다.

구글플레이 외 앱 마켓의 앱 설치를 어떻게 어트리뷰트하는지에 대한 더 상세한 내용은 여기를 참고하세요 .

사전 설치 캠페인은, 앱 개발사가 모바일 기기 제조사와 계약하여 기기 생산 시에 앱이 미리 설치되어 있도록 하는 경우입니다.

앱스플라이어를 사용하면, 이렇게 사전 설치된 앱의 인스톨을 쉽게 어트리뷰트 할 수 있습니다. 사용자가 앱을 최초 실행할 때, 앱스플라이어는 해당 인스톨을 기기 제조사 이름 미디어 소스로 어트리뷰트 합니다.

더 자세한 내용을 보려면 여기를 클릭하세요.

앱 삭제 측정을 셋팅하는 방법에 대해서는 여기를 읽어보십시오.

앱스플라이어 서버가 요청을 성공적으로 수신했다는 확인 신호를 받길 원하시면, AppsFlyerTrackingRequestListener 리스너를 구현하십시오.

onRequestSuccess() 콜백 메서드는 SDK에서 만든 어트리뷰션 요청에 대해 매 200회 응답마다 호출됩니다.

onRequestFailure(String error) 콜백 메서드가 다른 응답에 대해 호출되고 오류 메시지를 반환합니다.

구현 예

AppsFlyerLib.getInstance().start(getApplicationContext(), "devKey", new AppsFlyerRequestListener() {
            @Override
            public void onSuccess() {
                Log.d(LOG_TAG, "Launch sent successfully, got 200 response code from server");
            }
            @Override
            public void onError(int i, @NonNull String s) {
                Log.d(LOG_TAG, "Launch failed to be sent:\n" +
                                "Error code: " + i + "\n"
                                + "Error description: " + s);
            }
        });

AppsFlyerLib.getInstance().start(this, "devKey", object : AppsFlyerRequestListener {
            override fun onSuccess() {
                Log.d(LOG_TAG, "Launch sent successfully")
            }
            override fun onError(errorCode: Int, errorDesc: String) {
                Log.d(LOG_TAG, "Launch failed to be sent:\n" +
                        "Error code: " + errorCode + "\n"
                        + "Error description: " + errorDesc)
            }
        })

Request Listner에서 에러가 발생하면, 다음과 같은 에러 코드와 설명이 제공됩니다.

setAdditionalData API를 사용하면 SDK에서 보낸 이벤트에 사용자정의 데이터를 추가할 수 있습니다. 일반적으로 SDK 수준에서 Segment, Adobe 및 Airship을 비롯한 여러 외부 파트너 플랫폼과 통합하는 데 사용됩니다.

setAdditionalData 코드 예시:

HashMap<String,Object> CustomDataMap = new HashMap<>();
CustomDataMap.put("custom_param_1","value_of_param_1");
AppsFlyerLib.getInstance().setAdditionalData(CustomDataMap);

val customDataMap = HashMap<String, Any>()
customDataMap.put("custom_param_1","value_of_param_1")
AppsFlyerLib.getInstance().setAdditionalData(customDataMap)

앱 소유주가 원링크 없이 사용하고 앱과 연과된 도메인이 있으면, appendParametersToDeepLinkingURL 메서드를 사용하여 앱 세션을 어트리뷰션 할 수 있습니다.

예를 들어 엔드유저가 구글 검색을 통해 광고주의 도메인, www.example.com을 클릭합니다.

• 이 때, 엔드유저의 기기에 앱이 설치되지 않았으면 웹사이트(www.example.com)으로 리디렉션 됩니다.
• 앱이 설치되어 있으면, www.example.com와 연관된 앱으로 딥링킹됩니다. 이 앱 세션(앱 오픈)은 appendParametersToDeepLinkingURL에 정의된 미디어 소스(pid 파라미터)에 어트리뷰션 됩니다.

상세 내용은 안드로이드 SDK 참고를 확인하세요.

일러두기: 스마트 배너는 앱 소유주가 웹사이트 방문객을 앱 사용자로 전환시키도록 지원합니다.

기본 설정으로는, 앱을 실행할 때의 간격이 적어도 5초 이상이 되어야 두 개의 별도 세션으로 집계합니다(세션 집계에 대해 알아보기).

다음 API를 사용하여 세션 사이의 최소 필요시간을 설정합니다:

AppsFlyerLib.setMinTimeBetweenSessions(int seconds);

너무 높은 값을 세션 간격 시간으로 설정하면 딥링킹과 같이 세션 데이터를 사용하는 API에 문제가 생길 수 있습니다.

새로운 사용자 세션을 이 SDK 메서드를 통해 기록할 수 있습니다. 이 방법은 예를 들어, 백그라운드에서 동작하는 유틸리티 앱에 유용할 수 있습니다.

이 API를 액티비티 onCreate(): 에 사용하십시오

public void logSession(Context context);

사용 예:

AppsFlyerLib.getInstance().logSession(context);

이메일 서비스 제공 업체들 과 같은 몇몇 외부 업체 서비스 사는 이메일 내의 링크를 자체 클릭 기록 도메인으로 래핑(wrapping)합니다. 어떤 업체는 자신의 클릭 기록 도메인을 직접 설정하도록 허용하기도 합니다. 만약 원링크가 이런 도메인들에서 래핑된다면, 원링크의 기능이 제한될 수 있습니다.

이 문제를 해결하기 위해 setResolveDeepLinkURLs API를 사용할 수 있습니다. 이 API를 사용하여 앱을 시작하는 클릭 도메인에서 원링크를 가져 오십시오. 반드시 SDK 초기화 전에 이 API를 호출해야합니다.

예를 들어, 당신의 원링크(https://mysubdomain.onelink.me/abCD)로 리다이렉션되는 세 개의 클릭 도메인이 있습니다. 이 API를 사용하여 클릭 도메인이 리다이렉션하는 원링크를 가져오십시오. 이 API 메서드는 SDK가 분석하는 도메인 목록을 수신합니다. SDK 초기화 전에 다음 코드를 추가하십시오.

AppsFlyerLib.getInstance().setResolveDeepLinkURLs("clickdomain.com", "myclickdomain.com", "anotherclickdomain.com");

위의 코드를 사용하면 원링크 기능을 유지하면서 자체 클릭 도메인을 사용할 수 있습니다. 여기에서 클릭 도메인은 앱 실행을 담당합니다. 대신 API가 이 클릭 도메인에서 원링크를 가져오고, 이 원링크에서 데이터를 확보하여 맞춤식 콘텐츠로 딥링크 하는데 사용할 수 있습니다.

앱스플라이어를 사용하여, 리타겟팅 캠페인 중 일부인 푸시 알림 성과를 측정할 수 있습니다.

이 기능을 사용하려면, 푸시 알림 클릭 이후 실행되는 모든 액티비티의 onCreate 메서드에서, sendPushNotificationData 메서드를 호출하십시오:

AppsFlyerLib.getInstance().sendPushNotificationData(this);

푸쉬 알림 측정에 대한 더 자세한 내용은 여기에서 확인하실 수 있습니다.

기존 사용자가 친구나 아는 사람을 앱의 신규 사용자로 초대하도록 하는 것은 앱 사용자를 늘리는데 크게 기여할 수 있습니다. 앱스플라이어를 사용하면 앱 내 사용자 초대에서 발생한 설치를 어트리뷰트하고 기록할 수 있습니다.

더 자세한 내용은 사용자 초대 어트리뷰션 안내를 참조하십시오.

AppsFlyer ID는 앱의 모든 신규 설치가 일어날 때마다 발급됩니다. 다양한 목적으로 AppsFlyer ID를 활용할 수 있습니다:

• 서버 간 인앱 이벤트(server-to-server in-app events) 보내기.
• 백엔드 시스템의 사용자 기록을 AppsFlyer ID와 맞추기.
• 풀(pull) 또는 푸시(push) API로 수신한 데이터를 병합할 때 엔트리를 매핑합니다.

AppsFlyer ID를 확보하기 위해서 다음 API를 사용하세요:

public String getAppsFlyerUID(Context context);

사용 예:

String appsFlyerId = AppsFlyerLib.getInstance().getAppsFlyerUID(this);

고객 사용자 ID를 설정하려면 다음 코드를 사용하세요.

public void setCustomerUserId(String id);

사용 예:

AppsFlyerLib.getInstance().setCustomerUserId("myId");

고객 ID를 설정한 이후에만 인앱 이벤트 기록이 연결되어 보고되므로, 가능한 앱 활동 흐름 초기에 고객 사용자 ID 셋팅하는 것을 추천드립니다.

• 만약, setCustomerUserId 가 startTracking을 호출하기 이전에 호출된다면, 인스톨 및 이벤트 로데이터 리포트에 CUID(Customer User ID) 정보가 포함되어 표시됩니다.
• CUID(Customer User ID)를 나중에 설정하면, CUID는 CUID를 설정한 이후에 기록된 이벤트만 연결됩니다.

첫 번째 앱 실행 후 고객 사용자 ID 값이 다시 설정되지 않도록 하기 위하고, 고객 사용자 ID를 얻기 위한 서버 호출을 줄이기 위해서, 다음 구문을 사용하여 값이 비어 있는지 여부를 확인할 수 있습니다:

AppsFlyerProperties.getInstance().getString(AppsFlyerProperties.APP_USER_ID)

고객 사용자 ID에 대해 더 자세히 알아보려면 여기를 클릭하세요.

customerUserID가 설정될 때까지 SDK 초기화를 지연시킬 수 있습니다.

고객 사용자 ID 호출할 때까지 SDK 초기화를 지연시키기 위해서는 다음을 수행하십시오:

AppsFlyerLib.getInstance().waitForCustomerUserId(true);

메서드를 init() 메서드 바로 앞에서 호출합니다. SDK 초기화의 나머지 부분은 변경되지 않아야 합니다.

일단 customerUserID가 부여되고 나면,

AppsFlyerLib.getInstance().setCustomerIdAndLogSession("customer_id", this);

SDK에 관련 고객 사용자 ID를 제공하고 SDK가 시작되도록 합니다.

코드는 다음과 같이 작성되어야 합니다.

public class AFApplication extends Application {
  private static final String AF_DEV_KEY = "qrdZGj123456789";
  @Override
  public void onCreate() {
    super.onCreate();
    AppsFlyerConversionListener conversionDataListener = 
    new AppsFlyerConversionListener() {
      ...
    };
    AppsFlyerLib.getInstance().waitForCustomerUserId(true);
    //WARNING! Removing above line doesn't cancel its effect.
    // Replace with this to stop waiting for CUID:
    // AppsFlyerLib.getInstance().waitForCustomerUserId(false);
    AppsFlyerLib.getInstance().init(AF_DEV_KEY, getConversionListener(), getApplicationContext());
    AppsFlyerLib.getInstance().start(this);
    // Do your magic to get the customerUserID
    // ...
    // any AppsFlyer SDK code invoked here will be discarded
   //Call the following API once the customerUserID is available:
 AppsFlyerLib.getInstance().setCustomerIdAndLogSession("customer_id", this);
  }
}

class AFApplication: Application() {
 private val afDevKey = ""

 override fun onCreate() {
  super.onCreate()
  val conversionDataListener = object: AppsFlyerConversionListener {
   ...
  }
  AppsFlyerLib.getInstance().waitForCustomerUserId(true);
  //WARNING! Removing above line doesn't cancel its effect.
  // Replace with this to stop waiting for CUID:
  // AppsFlyerLib.getInstance().waitForCustomerUserId(false);
  AppsFlyerLib.getInstance().init(afDevKey, conversionDataListener, this)
  AppsFlyerLib.getInstance().start(this)
  // Do your magic to get the customerUserID
  // ...
  // any AppsFlyer SDK code invoked here will be discarded
  // Call the following API once the customerUserID is available:
  AppsFlyerLib.getInstance().setCustomerIdAndLogSession("customer_id", this)
 }
}

고객 사용자 ID가 가능할 때까지 SDK 초기화를 지연시키는 것에 대해 더 자세한 내용을 보시려면 여기로 이동하십시오.

SDK 4.8.0 버전부터 AppsFlyer는 google_advertising_id를 자동으로 수집합니다.

Google Advertising ID 수집에 관한 요구 사항은 SDK 4.7.x 이하 버전에서만 적용됩니다.

SDK는 IMEI 또는 안드로이드 ID를 자동으로 수집하지 않습니다. 그러나 이러한 식별자를 수집해야 할 경우 개발사가 다음 API 중 하나를 구현할 수 있습니다.

• 수동 수집: 앱은 ( setIMEI 또는 setAndroidID API를 사용하여) IMEI 또는 안드로이드 ID를 SDK로 전달합니다. SDK는 데이터를 앱스플라이어 서버로 전송합니다. 

  식별자 ID를 앱스플라이어로 전송하기 위해서는:

  1. 앱이 열릴 때 기기 IMEI 또는 안드로이드 ID를 수집합니다.
  2. start 메서드를 호출하기 전에 다음 API를 호출합니다.
     

     AppsFlyerLib.getInstance().setImeiData("IMEI_HERE");
     AppsFlyerLib.getInstance().setAndroidIdData("ANDROID_ID_HERE");

• 기기 ID 수집에 대한 옵트인: SDK가 IMEI 또는 안드로이드 ID를 수집하도록 강제합니다. 코드를 다음과 같이 수정합니다.

  AppsFlyerLib.getInstance().setCollectIMEI(true);
  AppsFlyerLib.getInstance().setCollectAndroidID(true);

앱스플라이어 SDK를 사용하여 안드로이드 OAID를 수집하여 타사 안드로이드 앱 스토어의 인스톨 성과를 측정합니다. 자세한 내용은 OAID 구현 가이드를 참조하십시오.

간혹, 법률 및 개인 정보 보호 준수를 위해서 모든 SDK 데이터 기록(logging)을 중단해야 하는 경우가 있을 수 있습니다. stop API로 이를 실행할 수 있습니다. 이 API가 호출되고 나면, 앱스플라이어 SDK의 작동이 중지되고 더 이상 앱스플라이어 서버와 통신하지 않습니다.

AppsFlyerLib.getInstance().stop(true, getApplicationContext());

AppsFlyerLib.getInstance().stop(true, applicationContext);

서로 다른 몇 가지 사용자 옵트아웃 시나리오가 있습니다. 앱과 관련된 각 시나리오에 맞는 정확한 지침을 따르는 것을 권장합니다.

다음 호출을 통하여 SDK를 재활성화할 수 있습니다.

AppsFlyerLib.getInstance().stop(false, getApplicationContext());
AppsFlyerLib.getInstance().start(getApplicationContext(), <AF_DEV_KEY>);

AppsFlyerLib.getInstance().stop(false, applicationContext);
AppsFlyerLib.getInstance().start(applicationContext, <AF_DEV_KEY>);

stop이 true로 설정되어 있는 경우, start를 설정하지 마십시오. 다음을 호출하여 SDK 현재 상태를 확인할 수 있습니다.

AppsFlyerLib.getInstance().isStopped() // returns true if SDK is stopped, false otherwise

AppsFlyerLib.getInstance().isStopped // returns true if SDK is stopped, false otherwise

SDK를 초기화하는 동안 다음 API를 사용하면, 사용자의 설치, 이벤트, 세션을 명시적으로 익명처리 할 수 있습니다:

public void anonymizeUser(boolean isDisabled);

사용 예:

AppsFlyerLib.getInstance().anonymizeUser(true);

false로 설정된 anonymizeUser를 호출하면 로그를 재시작할 수 있습니다.

광고주는 특정 사용자들의 사용자 레벨 데이터를 애드 네트워크/파트너사와 공유하지 않을 경우가 있습니다. 사용자 정보를 공유하지 않는 이유는 다음과 같습니다. 

• CCPA나 GDPR과 같은 개인정보 보호 정책 준수
• 사용자 옵트아웃(개인정보 제 3자와의 공유 거부)
• 파트너사(애드 네트워크, 제 3자 기업)가 경쟁사이기도 한 경우

앱스플라이어는 일부 또는 모든 파트너와 데이터 공유를 중단하는 API 메서드를 다음과 같이 두 가지 제공합니다.

• setSharingFilter: 광고주가 이 메서드를 이용하여 일부(하나 혹은 복수) 애드 네트워크/연동 파트너를 데이터 공유 대상에서제외할 수 있습니다.
• setSharingFilterForAllPartners: 광고주가 모든 네트워크/연동 파트너와 데이터 공유를 중단할 때 사용합니다.

이 필터링 메서드는 SDK V5.4.1.에서 지원됩니다.

이 필터링 메서드는 SDK가 구동을 시작할 때마다 호출되어야 하고 전체 세션에 영향을 미칩니다. 파트너와의 데이터 공유 필터를 설정해야할지 판단하는데 시간이 걸리면, SDK 구동 시작을 지연시키십시오. 

첫  start를 호출하기 전에 메서드가 활성화된 경우

• SRN에서 유입된 사용자들이 오가닉으로 기록되고 사용자 정보는 연동 파트너와 공유되지 않습니다.
• 애드 네트워크(SRN 제외) 클릭으로 유입된 사용자 는 논오가닉으로 기록되지만 사용자 정보는 포스트백, API, 로데이터 리포트 혹은 다른 어떤 방법으로도 애드 네트워크와 공유되지 않습니다.

그런데 앱 삭제 데이터는 이 메서드를 이용하여 필터링할 수 없습니다. 대신, 앱스플라이어 대시보드 설정 화면에서 앱 삭제 이벤트를 파트너사에 전송하는 것을 중단할 수 있습니다.