AppsFlyer SDK 연동 가이드 - Android

다음 방법 중 한 가지 사용하여 SDK를 앱에 추가하기

• [모범 활용 사례] Gradle 이용
• 수동으로 SDK 추가

The Android Install Referrer improves attribution accuracy, protects from install fraud, and more. It is supported from AppsFlyer Android SDK version 4.8.6.

앱에 인스톨 리퍼러를 추가하는 방법은 두 가지가 있습니다.

• Gradle 사용 (권장)
• 수동으로 인스톨 리퍼러 추가

권한을 추가하면 확률적 모델링 어트리뷰션의 매칭 확률을 더욱 높일 수 있습니다. 또한 SDK에서 Wifi나 통신사 네트워크 데이터와 같은 더 많은 데이터를 전송할 수 있습니다. 이런 데이터를 로데이터 보고서 에서 확인하고 캠페인 분석 및 최적화에 사용할 수 있습니다.

필요한 권한 추가하기

1. AndroidManifest.xml에 다음 권한을 추가하십시오:
   

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

BroadcastReceiver는 구글플레이에서 앱스플라이어가 어트리뷰션에 사용하는 정보를 가져옵니다. BroadcastReceiver를 사용하면 어트리뷰션 확률이 높아집니다.

인스톨 리퍼러 BroadcastReceiver는 다음 두가지 방법으로 구현할 수 있습니다:

<application>
	<receiver android:name="com.appsflyer.SingleInstallBroadcastReceiver" android:exported="true">
		<intent-filter>
			 <action android:name="com.android.vending.INSTALL_REFERRER" />
		 </intent-filter>
	</receiver>
</application>

<application>
	<receiver android:name="com.appsflyer.MultipleInstallBroadcastReceiver" android:exported="true">
		<intent-filter>
			<action android:name="com.android.vending.INSTALL_REFERRER" />
		</intent-filter>
	</receiver>
</application>

앱스플라이어는 dev key를 사용하여 계정을 고유하게 식별합니다. Dev key는 SDK가 앱스플라이어 계정에 속한 데이터를 안전하게 송수신 하도록 만드는 필수 값입니다.

주의! 잘못되거나 문제있는 dev key를 사용하면 SDK에서 전송하는 모든 트래픽에 영향을 주거나 어트리뷰션과 리포팅이 중단됩니다.

Dev key를 확인하려면:

1. 앱의 대시보드에 접속합니다.
2. 대시보드의 설정 아래에 있는 앱 설정을 클릭합니다.
3. Dev key를 복사하십시오.
   

   

글로벌 앱 클래스 등록

AndroidManifest.xml 파일에서 application 태그 안에 다음 행을 추가합니다.

android:name="<APP.PACKAGE.NAME>.<AFApplication>"

• <APP.PACKAGE.NAME> - 이 부분을 앱 패키지 이름으로 변경합니다.
• <AFApplication> - 이 부분을 글로벌 앱 클래스에서 설정한 이름으로 변경합니다.

Manifest.xml의 이 행은 앱에서 global application이 무엇을 말하는지 알려줍니다. 이렇게 함으로써, 앱스플라이어 SDK는 앱에 전체적으로 액세스 할 수 있습니다.

SDK 초기화

앱의 global application class 내에서 SDK를 초기화 하는 것을 추천합니다. 이를 통해 SDK는 딥링크를 포함한 모든 시나리오에서 초기화 할 수 있습니다.

아래의 단계들은 앱의 global application class 내부에서 이루어집니다.

1. 앱의 global application class 내에서 다음 라이브러리를 가져옵니다.
   

   import com.appsflyer.AppsFlyerLib;
   import com.appsflyer.AppsFlyerConversionListener;

2. Inside the global class, assign your dev key to a variable, preferably named AF_DEV_KEY.
   
   Java Kotlin

   public class AFApplication extends Application {
       private static final String AF_DEV_KEY = "qrdZGj123456789";
       
       //...
       
   }
   

   class AFApplication : Application() {
       private val devKey = "qrdZGj123456789";
   
       //...
       
   }
   

3. Global class 내부에서 super.onCreate () 을 호출한 후, AppsFlyerConversionListener 를 구현하십시오. 코드는 아래 4번 설명을 참고하십시오.
4. ConversionListener이후 글로벌 클래스 내에서, init()메서드를 사용하여 SDK를 구동합니다. 
   
   Java Kotlin

   public class AFApplication extends Application {
       private static final String AF_DEV_KEY = "qrdZGj123456789";
       
       @Override
       public void onCreate() {
           super.onCreate();
           AppsFlyerConversionListener conversionListener = new AppsFlyerConversionListener() {
               @Override
               public void onConversionDataSuccess(Map<String, Object> conversionData) {
               
                       for (String attrName : conversionData.keySet()) {
                       Log.d("LOG_TAG", "attribute: " + attrName + " = " + conversionData.get(attrName));
                   }
               }
   
               @Override
               public void onConversionDataFail(String errorMessage) {
   		   Log.d("LOG_TAG", "error getting conversion data: " + errorMessage);
               }
   
               @Override
               public void onAppOpenAttribution(Map<String, String> attributionData) {
                   for (String attrName : attributionData.keySet()) {
                       Log.d("LOG_TAG", "attribute: " + attrName + " = " + attributionData.get(attrName));
                   }
               }
   
               @Override
               public void onAttributionFailure(String errorMessage) {
                   Log.d("LOG_TAG", "error onAttributionFailure : " + errorMessage);
               }
           };
           
           AppsFlyerLib.getInstance().init(AF_DEV_KEY, conversionListener, this);
   
       }
   }
                 

   class AFApplication : Application() {
       private val devKey = "qrdZGj123456789";
   
       override fun onCreate() {
           super.onCreate()
           val conversionDataListener  = object : AppsFlyerConversionListener{
               override fun onConversionDataSuccess(data: MutableMap<String, Any>?) {
                   data?.let { cvData ->
                       cvData.map {
                           Log.i(LOG_TAG, "conversion_attribute:  ${it.key} = ${it.value}")
                       }
                   }
               }
   
               override fun onConversionDataFail(error: String?) {
                   Log.e(LOG_TAG, "error onAttributionFailure :  $error")
               }
   
               override fun onAppOpenAttribution(data: MutableMap<String, String>?) {
                   data?.map {
                       Log.d(LOG_TAG, "onAppOpen_attribute: ${it.key} = ${it.value}")
                   }
               }
   
               override fun onAttributionFailure(error: String?) {
                   Log.e(LOG_TAG, "error onAttributionFailure :  $error")
               }
           }
   
           AppsFlyerLib.getInstance().init(devKey, conversionDataListener, this)
       }
   }
   

5. 앱의 글로벌 클래스에서, start()을 호출합니다.
   
   Java Kotlin

   AppsFlyerLib.getInstance().start(this);
   

   AppsFlyerLib.getInstance().start(this)

SDK 실행을 지연하기 위해 Activity 클래스에서 start를 호출할 수 있습니다.

이 옵션은 가령, GDPR이나 CCPA 요건에 따라 사용자 개인정보 사용 동의를 얻을 때까지 시작을 지연해야할 때 사용할 수 있습니다.

Activity 클래스에서 호출을 시작할 때

• Activity 인스턴스를 애플리캐이션이 아니라 인수(argument)로 전달하도록 하십시오.
•  립링킹 기능 사용을 계획한다면 start() API를 start 없이 딥링킹을 할 수 있는 다른 Activity에 추가하십시오.

인스톨 테스트를 시작하기 전에 테스트 기기를 등록해주십시오.

오가닉 설치는 보통 앱스토어에서 직접 다운로드 받는 인스톨로 어트리뷰트 되지 않는 앱 설치입니다.

오가닉 인스톨을 시뮬레이션하려면:

1. 컴퓨터에 모바일 기기가 잘 연결되어 있는지 확인하십시오.
2. 안드로이드 스튜디오에서 Logcat을 엽니다.
3. 안드로이드 스튜디오에서 앱을 기기 또는 에뮬레이터에 설치하십시오.
4. 앱이 시작될 때까지 기다립니다.
5. Logcat에서 앱의 패키지 이름을 찾으십시오.

다음이 표시되어야 합니다:

스크린샷에서 강조 표시된 부분은 SDK가 오가닉 인스톨을 확인하였음을 나타냅니다. 이 데이터는 AFApplication 클래스의 onConversionDataSuccess 메서드에서 가져옵니다. 전환 데이터를 가져오는 것은 이 가이드에 후반부에 설명되어 있습니다.

참고: SDK 버전 5 부터, onConversionDataSuccess 는 전환 데이터를 가져 오는 메소드의 이름입니다. SDK 버전 5.0.0 보다 낮은 버전을 사용하는 경우 메소드 이름은 onInstallConversionDataLoaded 입니다. SDK 5.0.0으로 업그레이드 하는 것을 추천드립니다. 더 자세한 내용은 여기를 클릭하여 볼 수 있습니다.

이제 오가닉 인스톨이 앱 대시보드의 개요 페이지에 나타납니다.

앱의 대시보드에서 오가닉 인스톨 숫자를 확인할 수 없으면 SDK 문제 해결 안내서 를 참조하십시오.

논오가닉 인스톨은 보통 마케팅 캠페인에 참여하고 일어나는 앱 설치로, 어트리뷰트 성과로 기록되는 인스톨입니다. 어트리뷰션 링크를 사용하여 논오가닉 인스톨을 시뮬레이션 할 수 있습니다.

논오가닉 인스톨을 시뮬레이션하려면:

1. Manifest에서 앱의 패키지 이름이 무엇인지 확인하십시오. 예, com.company.app .
   • In the URL below, replace <app_package_name> with your app's package name:
     

     https://app.appsflyer.com/<app_package_name>?pid=Test&c=Test

     예시:

     https://app.appsflyer.com/com.company.app?pid=Test&c=Test

   •  c 파라미터는 캠페인의 이름을 나타냅니다.
   • pid 파라미터는 인스톨이 어트리뷰션되는 미디어 소스의 이름을 나타냅니다.
   • 컴퓨터로 클릭 테스트시, 광고 ID(GAID)를 추가해야 합니다. (1 단계의 링크 끝에 &advertising_id=<GAID>를 추가하십시오.)
2. 이 url을 기기로 전송합니다. 이메일이나 메신저 앱을 통해 url 링크를 보내면 됩니다.
3. 기기에서 url을 클릭하십시오.
   • 만약 앱이 이미 앱 마켓에 등록되어 있다면 앱 마켓으로 리디렉트됩니다. 연결된 앱 마켓에서 앱을 다운로드 받지 마시고 5번 단계를 진행하십시오.
   • 아직 앱이 앱 마켓에 등록되지 않았고 개발단계라면, 링크를 클릭했을 때 앱스토어에서 해당 앱을 찾을 수 없다는 메시지가 보여질 것입니다. 무시하고 5번 단계를 진행하십시오.
4. 안드로이드 스튜디오에서 Logcat을 엽니다.
5. USB 케이블을 통해 기기를 컴퓨터에 연결하십시오.
6. 안드로이드 스튜디오에서 기기에 앱을 설치하십시오.
7. Logcat에서 앱의 패키지 이름을 찾으십시오.

다음이 표시되어야 합니다:

이제 논오가닉 인스톨이 앱 대시보드 개요 페이지에 나타납니다.

SDK에는 인앱 이벤트 관련 두 가지 인터페이스가 있습니다:

• AFInAppEventType - 인앱 이벤트 이름에 대한 상수.
• AFInAppEventParameterName - 인앱 이벤트 파라미터 이름에 대한 상수.

아래의 이유로, 이 두 가지 인터페이스를 사용하시는 것을 강력하게 추천드립니다:

• 표준 방식의 이름 지정을 통해 앱스플라이어는 자동으로 페이스북, 구글, 트위터, 스냅챗과 같은 Self-reporting networks(SRNs)의 이벤트와 매핑할 수 있습니다.
• 이전 버전과의 호환성 - 앱스플라이어가 특정 이벤트의 이름이나 이벤트 파라미터를 변경하더라도, 기존의 구현 내용이 이전 버전과 호환됩니다.

이 두 인터페이스를 사용하려면, 아래처럼 임포트 하십시오:

import com.appsflyer.AFInAppEventParameterName;
import com.appsflyer.AFInAppEventType;

여기에서 추천하는 이벤트 이름과 구조의 리스트를 확인하십시오.

어떤 인앱 이벤트로도 수익 값을 보낼 수 있습니다. af_revenue (AFInAppEventParameterName.REVENUE)이벤트 파라미터를 사용하여 수익을 인앱 이벤트의 일부로서 계산할 수 있습니다. 양수 또는 음수의 모든 숫자를 입력할 수 있습니다.

앱스플라이어가 대시보드와 로데이터에서 실제 수익으로 계산하는 유일한 이벤트 파라미터는 af_revenue 입니다. 더 자세한 내용은 여기를 클릭하십시오.

수익 값이 있는 이벤트를 보낼 때 다음을 명심하십시오:

• 통화 코드를 설정하려면 (아래 예시 참고), 반드시 3 글자 ISO 4217 코드 이어야 합니다. (기본은 USD).
• 다음 메서드를 호출하여 모든 이벤트에 대한 통화 코드를 설정할 수 있습니다: AppsFlyer.setCurrencyCode ( " ZZZ " ) 통화 설정, 표시 및 통화 변환에 대한 자세한 내용은 수익 통화에 대한 안내서 를 참조하십시오.
• 수익 값에는 쉼표 구분 기호, 통화 기호 또는 텍스트가 절대로 포함되면 안됩니다. 예를 들어, 수익 값은 1234.56과 같은 형태가 되어야 합니다.

예 : 수익 값이 있는 인앱 구매 이벤트

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.REVENUE,1234.56);
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"Shirt");
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"1234567");
eventValue.put(AFInAppEventParameterName.CURRENCY,"USD");
AppsFlyerLib.getInstance().logEvent(getApplicationContext() , AFInAppEventType.PURCHASE , eventValue);

val eventValue = HashMap<String, Any>() 
eventValue.put(AFInAppEventParameterName.REVENUE,1234.56)
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"Shirt")
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"1234567")
eventValue.put(AFInAppEventParameterName.CURRENCY,"USD")
AppsFlyerLib.getInstance().logEvent(getApplicationContext() , AFInAppEventType.PURCHASE , eventValue)

위의 구매 이벤트에서는 이와 관련된 수익이 $1,234.56 있으며, 이는 대시보드에서 수익으로 나타납니다.

마이너스 수익 기록하기

마이너스 수익을 기록해야하는 상황이 있을 수 있습니다.

예를 들어, 사용자가 앱에서 구매한 신발에 대해 환불을 받는 경우.

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.REVENUE,-200);
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"shoes");
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"4875");
eventValue.put(AFInAppEventParameterName.CURRENCY,"USD");
AppsFlyerLib.getInstance().logEvent(getApplicationContext() , "cancel_purchase" , eventValue);

val eventValue = HashMap<String, Any>()
eventValue.put(AFInAppEventParameterName.REVENUE, -200)
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE, "category_a")
eventValue.put(AFInAppEventParameterName.CONTENT_ID, "1234567")
eventValue.put(AFInAppEventParameterName.CURRENCY, "USD")
AppsFlyerLib.getInstance().logEvent(applicationContext,  "cancel_purchase", eventValue)

앱스플라이어의 SDK는 인앱 구매에 대해서 서버 구매 영수증 검증 기능을 제공합니다. 구매 내역을 검증하려면 validateAndLogInAppPurchase를 호출하십시오.

구매가 확인되면 이 호출은 자동으로 af_purchase 인앱 이벤트를 생성합니다.

public static void validateAndLogInAppPurchase(Context context, 
String publicKey, String signature, String purchaseData, 
String price, String currency, HashMap<String, String> additionalParameters);

메서드 파라미터

• String publicKey – 구글 개발자 콘솔의 퍼블릭 키 .
• String signature – 거래 서명 (구매가 완료되었을 때 구글 API에서 리턴된).
• String purchaseData – JSON 형식으로 구매한 제품 (구매가 완료되었을 때 구글 API에서 리턴된).
• String price – 앱스플라이어에 전송될 인앱 이벤트 수익 값.
• String currency – 앱스플라이어에 전송될 인앱 이벤트 통화 설정.
• HashMap<String, String> additionalParameters – 인앱 이벤트 내역의 추가 파라미터로 인앱 이벤트 로데이터 event_value 필드에 표시됩니다.

구매 검증이 성공했을 때와 실패했을 때의 콜백

구매 검증 시도가 성공했는지 여부를 확인하려면 애플리케이션 클래스에서 registerValidatorListener를 구현하십시오. 이 리스너는 '성공'한 경우와 '실패'한 경우(검증 실패나 다른 원인때문에) 두 개의 콜백 블록을 가집니다.

AppsFlyerLib.getInstance().registerValidatorListener(this,new
   AppsFlyerInAppPurchaseValidatorListener() {
     public void onValidateInApp() {
       Log.d(TAG, "Purchase validated successfully");
     }
     public void onValidateInAppFailure(String error) {
       Log.d(TAG, "onValidateInAppFailure called: " + error);
     }
});

AppsFlyerLib.getInstance().registerValidatorListener(this, object : AppsFlyerInAppPurchaseValidatorListener {
    override fun onValidateInApp() {
       	Log.d(LOG_TAG, "Purchase validated successfully")
    }

    override fun onValidateInAppFailure(error: String) {
        Log.d(LOG_TAG, "onValidateInAppFailure called: $error")
   }
})

구매 검증 사용 예시:

// Purchase object is returned by Google API in onPurchasesUpdated() callback
private void handlePurchase(Purchase purchase) {
    Log.d(LOG_TAG, "Purchase successful!");
    Map<String, String> additional_event_values = new HashMap<>();
    additional_event_values.put("some_parameter", "some_value");
    String price= "10";
    String currency = "USD";
    AppsFlyerLib.getInstance().validateAndLogInAppPurchase(getApplicationContext(), PUBLIC_KEY, purchase.getSignature(), purchase.getOriginalJson(), revenue, currency, additional_event_values);
}

// Purchase object is returned by Google API in onPurchasesUpdated() callback
private fun handlePurchase(Purchase purchase) {
   Log.d(LOG_TAG, "Purchase successful!");
   val additional_event_values = HashMap<String, String>()
   additional_event_values.put("some_parameter", "some_value");
   val price= "10";
   val currency = "USD";
   AppsFlyerLib.getInstance().validateAndLogInAppPurchase(this, PUBLIC_KEY, purchase.getSignature(), purchase.getOriginalJson(), revenue, currency, additional_event_values);
}

구매 검증을 통과하면 앱스플라이어로 인앱 구매 이벤트가 자동 전송됩니다. 아래에서 event_value 파라미터에 전송된 샘플 데이터를 참고하십시오:

{
   "some_parameter":"some_value", // from additional_event_values
   "af_currency":"USD", // from currency
   "af_content_id":"test_id", // from purchase
   "af_revenue":"10", // from revenue
   "af_quantity":"1", // from purchase
   "af_validated":true // flag that AF verified the purchase
}

• 이벤트 이름: 45자 까지만 가능
• 이벤트 밸류: 1000자를 넘지 않아야 합니다. 더 긴 경우, 잘려서 보여집니다.
• 가격 및 수익: 숫자 또는 소수만 사용하십시오. (예: 5 또는 5.2)
• 가격 및 수익 값은 마침표 뒤로 최대 5 자리까지 가능합니다. 예, 5.12345
• 안드로이드 SDK 버전 4.8.1부터 인앱 이벤트나 다른 SDK API에서 영어가 아닌 문자도 사용할 수 있도록 지원합니다.

logEvent를 호출하여 이벤트 이름과 이벤트 값 파라미터로 인앱 이벤트를 기록할 수 있습니다. 더 자세한 내용은 인앱 이벤트 문서를 참조하십시오.

아래는 구매 이벤트를 기록한 간단한 예입니다. 업종에 따라 이미 정리해둔 코드 스니펫 리스트를 확인하시려면, 업종 별 리치 인앱 이벤트 가이드 항목을 참고하십시오.

예시: 인앱 구매 이벤트

Map<String,Object> eventValues = new HashMap<>();
eventValues.put(AFInAppEventParameterName.REVENUE, 1200);
eventValues.put(AFInAppEventParameterName.CURRENCY, "JPY");
eventValues.put(AFInAppEventParameterName.CONTENT_TYPE, "Shoes");
AppsFlyerLib.getInstance().logEvent(this, AFInAppEventType.PURCHASE, eventValues);

val eventValues = HashMap<String, Any>();
eventValues.put(AFInAppEventParameterName.REVENUE, 1200)
eventValues.put(AFInAppEventParameterName.CURRENCY, "JPY")
eventValues.put(AFInAppEventParameterName.CONTENT_TYPE, "Shoes")
AppsFlyerLib.getInstance().logEvent(this, AFInAppEventType.PURCHASE, eventValues)

사용자가 인터넷에 연결되지 않았을 때 이벤트가 발생한 경우라도 앱스플라이어는 여전히 이벤트를 기록할 수 있습니다. 작동원리는 이렇습니다:

1. SDK가 앱스플라이어 서버에 이벤트를 보내고 응답을 기다립니다.
2. SDK에서 200 응답을 받지 못하는 경우는 이벤트가 캐시에 저장됩니다.
3. 저장된 이벤트는 다음 200 응답을 받을 때 서버로 다시 전송됩니다.
4. 캐시에 다수의 이벤트가 있는 경우에는 순서대로 하나씩 빠르게 서버로 전송됩니다.

인앱 이벤트를 기록할 때 리스너를 설정할 수 있습니다. 이 리스너를 사용하여 두 가지 시나리오에 대한 논리를 정의할 수 있습니다.

• 인앱 이벤트가 성공적으로 기록되었습니다.
• 인앱 이벤트를 기록하는 동안 에러가 발생했습니다.

AppsFlyerLib.getInstance().logEvent(getApplicationContext(), AFInAppEventType.PURCHASE, eventValue, new AppsFlyerRequestListener() {
                    @Override
                    public void onSuccess() {
                        Log.d(LOG_TAG, "Event sent successfully");
                    }
                    @Override
                    public void onError(int i, @NonNull String s) {
                        Log.d(LOG_TAG, "Event failed to be sent:\n" +
                                "Error code: " + i + "\n"
                                + "Error description: " + s);
                    }
                });

AppsFlyerLib.getInstance().logEvent(getApplicationContext(), AFInAppEventType.PURCHASE, eventValue, object : AppsFlyerRequestListener {
            override fun onSuccess() {
                Log.d(LOG_TAG, "Event sent successfully")
            }
            override fun onError(errorCode: Int, errorDesc: String) {
                Log.d(LOG_TAG, "Event failed to be sent:\n" +
                        "Error code: " + errorCode + "\n"
                        + "Error description: " + errorDesc)
            }
        })

인앱 이벤트를 기록할 때 에러가 발생하면, 아래와 같이 에러 코드와 설명이 제공됩니다.

For users without your app installed, OneLink detects the device type and redirects them to the correct destination: Google Play, Apple App Store, third-party app store, or web page. This is based on your OneLink template settings. Learn more

Note: Device detection and redirection do not require the AppsFlyer SDK. However, the SDK is required for deep linking.

For users with your app installed, OneLink opens the app. In addition to opening the app, you can also deep link users to a specific activity or page within the app. This requires your developer to implement Unified Deep Linking (UDL).

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

일러두기:

• UDL requires SDK V6.1+
• Customers already using OneLink for deep linking may be using the legacy method, instead of UDL

For users without your app installed, OneLink detects the device type and redirects them to the correct destination: Google Play, Apple App Store, third-party app store, or web page. Once the user launches the app, you can use deferred deep linking to redirect them to a specific activity or page within the app.

This requires your developer to implement Unified Deep Linking (UDL).

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

일러두기:

• UDL requires SDK V6.1+
• Customers already using OneLink for deferred deep linking might be using the legacy method, instead of UDL

The SDK provides you with conversion and engagement data following every install or deep linking event. You can use this data to customize content and the app's behavior programmatically.

디렉트 딥링크가 사용되어 앱이 열렸을 때의 딥링킹 데이터를 얻으려면 onAppOpenAttribution 메서드를 구현하십시오.

언제든지 수작업으로 딥링킹 리인게이지먼트 데이터를 얻으려면, performOnAppAttribution 메서드를 구현하십시오.이 메서드로 새로운 리인게이지먼트를 기록하지 않고 리인게이지먼트 데이터에 액세스할 수 있습니다.

자세한 내용은 딥링크 데이터에 대한 가이드를 참고하십시오.

You can use OneLink to measure user re-engagement via push notifications. See our guide on measuring push notification re-engagement campaigns.

새 인스톨이 일어날 때마다, SDK 내에서 사용자 어트리뷰션 데이터에 실시간으로 액세스 할 수 있습니다.

이렇게 함으로써, 사용자에게 맞춤형 콘텐츠를 제공하거나, 사용자를 앱 내부의 특정 액티비티로 연결(이 문서의 디퍼드 딥링킹 항목 참고) 할 수 있습니다. 이는 앱에 대한 사용자 인게이지먼트를 향상할 수 있습니다.

앱스플라이어의 전환 데이터를 안드로이드 SDK에서 확보하기 위해서는 AppsFlyerConversionListener를 구현하십시오.

import android.app.Application;
import com.appsflyer.AppsFlyerLib;
import com.appsflyer.AppsFlyerConversionListener;
import java.util.Map;
import android.util.Log;

public class AFApplication extends Application {
    private static final String AF_DEV_KEY = "qrdZGj123456789";

    @Override
    public void onCreate() {
        super.onCreate();
        AppsFlyerConversionListener conversionListener = new AppsFlyerConversionListener() {


            @Override
            public void onConversionDataSuccess(Map<String, Object> conversionData) {
            
                    for (String attrName : conversionData.keySet()) {
                    Log.d("LOG_TAG", "attribute: " + attrName + " = " + conversionData.get(attrName));
                }
            }

            @Override
            public void onConversionDataFail(String errorMessage) {
		   Log.d("LOG_TAG", "error getting conversion data: " + errorMessage);
            }

            @Override
            public void onAppOpenAttribution(Map<String, String> conversionData) {
            
                for (String attrName : conversionData.keySet()) {
                    Log.d("LOG_TAG", "attribute: " + attrName + " = " + conversionData.get(attrName));
                }

            }

            @Override
            public void onAttributionFailure(String errorMessage) {
                Log.d("LOG_TAG", "error onAttributionFailure : " + errorMessage);
            }
        };

        AppsFlyerLib.getInstance().init(AF_DEV_KEY, conversionListener, getApplicationContext());
        AppsFlyerLib.getInstance().start(this);
    }
}

import com.appsflyer.AppsFlyerConversionListener
import com.appsflyer.AppsFlyerLib
import com.appsflyer.AppsFlyerLibCore.LOG_TAG

class AFApplication : Application() {
    private val devKey = "qrdZGj123456789";

    override fun onCreate() {
        super.onCreate()
        val conversionDataListener  = object : AppsFlyerConversionListener{
            override fun onConversionDataSuccess(data: MutableMap<String, Any>?) {
                data?.let { cvData ->
                    cvData.map {
                        Log.i(LOG_TAG, "conversion_attribute:  ${it.key} = ${it.value}")
                    }
                }
            }

            override fun onConversionDataFail(error: String?) {
                Log.e(LOG_TAG, "error onAttributionFailure :  $error")
            }

            override fun onAppOpenAttribution(data: MutableMap<String, String>?) {
                data?.map {
                    Log.d(LOG_TAG, "onAppOpen_attribute: ${it.key} = ${it.value}")
                }
            }

            override fun onAttributionFailure(error: String?) {
                Log.e(LOG_TAG, "error onAttributionFailure :  $error")
            }
        }

        AppsFlyerLib.getInstance().init(devKey, conversionDataListener, applicationContext)
        AppsFlyerLib.getInstance().start(this)
    }
}

AppsFlyerConversionListener 인터페이스에서 가장 중요한 API는 다음과 같습니다:

• onInstallConversionData - 신규 앱 설치에 대한 전환 데이터를 제공합니다.
  참고: SDK 버전 V5 부터, onConversionDataSuccess는 전환 데이터를 가져 오는 메소드의 이름입니다. SDK 버전 5.0.0 보다 낮은 버전을 사용하는 경우, 메소드 이름은 onInstallConversionDataLoaded 입니다. SDK 5.0.0으로 업그레이드 하십시오. 더 자세한 내용은 여기를 클릭하십시오.
• onAppOpenAttribution - 이미 설치되어 있는 앱이 수동이나 딥링킹을 통해 실행되었을 때, 리타겟팅 전환 데이터를 제공합니다.

전환 데이터에 대해 자세히 알아보시려면 전환 데이터 시나리오에 대한 가이드를 참고하십시오.

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

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

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

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

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

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

앱스플라이어 서버가 요청을 성공적으로 수신했다는 확인 신호를 받길 원하시면, 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 수준에서 Segment, Adobe및 Urban Airship과 같은 몇몇 외부 파트너 플랫폼과 연동할 때 필요합니다.
이 API는 해당 플랫폼의 연동 안내 문서에서 setAdditionalData API가 필요하다고 특별히 명시된 경우에만 사용하십시오.

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");

The code above allows you to use your click domain while preserving OneLink functionality. The click domains are responsible for launching the app. The API, in turn, gets the OneLink from these click domains, then you can use the data from this OneLink to deep-link and customize user content.

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

이 기능을 사용하려면, 푸시 알림 클릭 이후 실행되는 모든 액티비티의 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 값이 다시 설정되지 않도록 하기 위하고, 고객 사용자 ID를 얻기 위한 서버 호출을 줄이기 위해서, 다음 구문을 사용하여 값이 비어 있는지 여부를 확인할 수 있습니다:

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

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

고객 사용자 ID (customerUserID)를 위해 SDK 초기화 지연시키기

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 이하 버전에서만 적용됩니다.

어트리뷰션을 하기 위해서는, 적어도 하나의 기기 식별자가 수집되어야만 합니다. 다음 ID들이 가능합니다: 구글 광고 ID, 안드로이드 ID, IMEI, OAID

GAID - Google Advertising ID (구글 광고 ID)

구글 플레이 서비스가 포함된 앱이라면 자동으로 수집됩니다. 구글 광고 ID를 사용 가능한 경우라면, 구글 플레이 정책 위반을 피하기 위해, IMEI와 안드로이드 ID를 수집해서는 안됩니다.

IMEI 및 안드로이드 ID

기본 설정으로는 비활성화 되어 있습니다. 구글 플레이 서비스를 포함하지 않은 앱에서만 수집될 수 있습니다.
참고 2019년 말에 출시된  안드로이드 10 (API 레벨 29) 부터, IMEI 에 대한 접근이 제한됩니다.

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

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

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

OAID - Open Advertiser Identifier

OAID 구현 안내

디바이스 ID 수집 옵트 아웃

다음 API를 사용하여 IMEI와 안드로이드 ID, OAID 수집을 옵트아웃할 수 있습니다: 

AppsFlyerLib.getInstance().setCollectIMEI(false);
AppsFlyerLib.getInstance().setCollectAndroidID(false);
AppsFlyerLib.getInstance().setCollectOaid(false);

간혹, 법률 및 개인 정보 보호 준수를 위해서 모든 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

Use this API during the SDK Initialization to explicitly anonymize a user's install, events, and sessions:

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, 로데이터 리포트 혹은 다른 어떤 방법으로도 애드 네트워크와 공유되지 않습니다.

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