AppsFlyer SDK 연동 - 안드로이드

앱의 모든 신규 설치에 대해서 AppsFlyer의 고유 기기 ID가 생성됩니다. 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 값이 다시 설정되지 않도록 하기 위해 다음의 구문을 사용하여 값이 비어 있는지 여부를 확인할 수 있습니다. 

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

고객 사용자 ID에 대한 더 자세한 정보는 여기를 클릭하세요.

SHA1, MD5, SHA256, 그리고 평문의 암호화 방식을 지원합니다.

예:

public void setUserEmails(String... emails);

사용 예:

AppsFlyerLib.getInstance().setUserEmails(AppsFlyerProperties.EmailsCryptType.MD5, "email1@domain.com","email2@domain.com", ….);

SDK 4.8.0 버전부터 AppsFlyer는 google_advertising_id를 자동으로 수집합니다. Google 광고 ID 수집에 관한 요구 사항은 SDK 4.7.x 버전 및 그 이하에만 적용됩니다.

OS 버전이 안드로이드 4.4 KitKat 이상이고 기기가 Google Play Services를 포함하고 있으면(SDK 버전 4.8.8 및 GPS가 필요한 특정 앱에서), 기본적으로 SDK가 IMEI 및 안드로이드 ID를 수집하지 않습니다. 

AppsFlyer에 해당 ID를 명시적으로 보내고자 하는 경우 개발자는 다음 API를 startTracking 코드 앞에 넣어 사용할 수 있습니다.

AppsFlyerLib.getInstance().setImeiData("IMEI_DATA_HERE");
AppsFlyerLib.getInstance().setAndroidIdData("ANDROID_ID_DATA_HERE");

앱이 Google Play Services를 포함하지 않는 경우 SDK가 IMEI 및 안드로이드 ID를 수집합니다. 하지만, Google Play Services가 포함된 앱은 IMEI를 수집하면 안됩니다. 이는 Google Play 정책 위반입니다.

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

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

이 프로세스를 모두 정확하게 완료하기 위해서는 여기를 읽으세요.

AppsFlyer는 리타게팅 캠페인의 하나로 푸쉬 알림을 측정할 수 있습니다.

이 기능을 사용하기 위해서는 알림을 클릭하면 실행되는 각 액티비티의 onCreate 메서드 안에서 다음 메서드를 호출하세요.

AppsFlyerLib.getInstance().sendPushNotificationData(this);

데이터 페이로드는 관련 키-값 스트링과 함께 오브젝트 af를 포함해야 합니다.

예:

{  
   "data":{  
      "score":"5x1",
      "time":"15:10",
      "af":{  
         "c":"test_campaign",
         "is_retargeting":"true",
         "pid":"push_provider_int"
      }
   }
}
{

{  
   "data":{  
      "score":"5x1",
      "time":"15:10",
      "click_action":"com.example.someAction",
      "af":{  
         "c":"test_campaign",
         "is_retargeting":"true",
         "pid":"push_provider_int"
      }
   }
}

AFInAppEventParameterName.CURRENCY

국제 통화 코드가 사용됩니다.

기본값은 USD입니다. 사용 가능한 ISO 통화 코드는 여기에서 확인할 수 있습니다.

통화 코드를 설정하려면 다음 API를 사용하세요.

public void setCurrencyCode(String currencyCode);

사용 예:

AppsFlyerLib.getInstance().setCurrencyCode("GBP");

AppsFlyer SDK는 인앱 구매에 대해서 서버 확인 기능을 제공합니다. 구매 검증 트래킹을 설정하려면 onActivityResult function에서 validateAndTrackInAppPurchase 메서드를 호출합니다.

이 호출은 자동으로 af_purchase 인앱이벤트를 생성합니다.

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

이 호출은 '성공'한 경우와 검증 실패 등의 원인으로 '실패'한 경우에 대한 두 개의 콜백 블록을 가집니다.

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

사용 예:

protected void onActivityResult(int requestCode, int resultCode, Intent data) {
   if (requestCode == 1001) {
       String purchaseData = data.getStringExtra("INAPP_PURCHASE_DATA");
       String dataSignature = data.getStringExtra("INAPP_DATA_SIGNATURE");
       if (resultCode == RESULT_OK) {
           HashMap<String,String> event = new HashMap<>();
           event.put(AFInAppEventParameterName.PRICE,"9");
           AppsFlyerLib.getInstance().validateAndTrackInAppPurchase(getApplicationContext(),publicKey, dataSignature, purchaseData, "3.00", "ILS", event);
       }
   }
} 

사용자의 설치, 이벤트, 세션의 익명 처리를 확실하게 하기 위해서는 SDK를 초기화할 때 다음 API를 사용하세요.

public void setDeviceTrackingDisabled(boolean isDisabled);

사용 예:

AppsFlyerLib.getInstance().setDeviceTrackingDisabled(true);

deviceTrackingDisabled를 false로 설정하고 다시 호출하면, 트래킹을 다시 시작할 수 있습니다.

AppsFlyerLib.setMinTimeBetweenSessions(int seconds);

백그라운드에서 작동하는 유틸리티 앱인 경우에는 액티비티의 onCreate() 안에서 다음 API를 사용할 수 있습니다.

public void reportTrackSession(Context context);

사용 예:

AppsFlyerLib.getInstance().reportTrackSession(context);

Google Play가 아닌 곳에서의 설치를 트래킹하기 위해서는 앱의 AndroidManifest.xml 파일에서 고유의 채널 또는 스토어 이름을 각 APK별로 설정합니다. 채널 값은 대소문자를 구분합니다.

예:

<meta-data android:name="CHANNEL" android:value="Amazon" />
<meta-data android:name="CHANNEL" android:value="Standalone"/>
<meta-data android:name="CHANNEL" android:value="Verizon" />

meta-data 태그를 </application> 태그 앞에 놓습니다.

스토어를 통하지 않는 앱의 인스톨 트래킹에 대한 더 자세한 내용은 여기에서 확인하세요.

극단적인 경우 법률 및 개인 정보 보호 준수를 위해서 모든 SDK 트래킹을 중지해야 할 수도 있습니다. 이 작업은 isStopTracking API를 사용하여 수행할 수 있습니다. 이 API가 호출되면, SDK는 서버와 더 이상 통신하지 않고 기능이 중지될 것입니다.

AppsFlyerLib.getInstance().stopTracking(true, context);

There are several different scenarios for user opt-out. We highly recommend following the exact instructions for the scenario, that is relevant for your app.

In any event, the SDK can be reactivated by calling the same API, by passing false.

AppsFlyerLib.getInstance().trackAppLaunch(getApplicationContext(), AF_DEV_KEY);

customerUserID가 설정될 때까지 SDK 초기화를 지연시킬 수 있습니다. 이 기능은 customerUserID를 얻기 전까지 SDK가 동작을 시작할 수 없도록 합니다. 이 API를 사용하면 customerUserID를 얻고 트래킹을 시작하기 전까지 모든 인앱이벤트 및 기타 SDK API 호출이 무시됩니다.

To indicate that the SDK should delay initialization for the customer user id call

AppsFlyerLib.getInstance().waitForCustomerUserId(true);

immediately before the init() method. The rest of the SDK initialization should remain unchanged.

Once the customerUserID has been provided, call

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

to provide the SDK with the relevant customer user id and trigger the SDK to begin its normal tracking.

public class AFApplication extends Application {
   private static final String AF_DEV_KEY = ;
   @Override
   public void onCreate() {
       super.onCreate();
       AppsFlyerConversionListener conversionDataListener = 
 new AppsFlyerConversionListener() {
           ...
       };
 AppsFlyerLib.getInstance().waitForCustomerUserId(true); 
       AppsFlyerLib.getInstance().init(AF_DEV_KEY, getConversionListener(), getApplicationContext());
 AppsFlyerLib.getInstance().startTracking(this);
       // customerUserID를 얻는 코드를 구현하세요. 
 // ...
 // 여기서 호출되는 모든 AppsFlyer SDK 코드는 무시됩니다.
 //customerUserID를 사용할 수 있게 되면 다음의 API를 호출하세요:
 AppsFlyerLib.getInstance().setCustomerIdAndTrack( "customer_id", this);⏎ }⏎}

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

사전 설치된 앱의 안드로이드 어트리뷰션을 위한 몇 가지 방법이 있습니다.

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

If you want to receive a confirmation that the tracking request was successfully received by the AppsFlyer servers, it is possible to implement the AppsFlyerTrackingRequestListener listener.

The onTrackingRequestSuccess() callback method is invoked for every 200 response to an attribution request made by the SDK.

The onTrackingRequestFailure(String error) callback method is invoked for any other response and returns the response as the error string.

Implementation Example

AppsFlyerLib.getInstance().startTracking(this.getApplication(),"devKey", myListener());
private AppsFlyerTrackingRequestListener myListener() {   
    return new AppsFlyerTrackingRequestListener() {  
        @Override public void onTrackingRequestSuccess() { 
            Log.d("Debug", "Got 200 response from server");    
        }   @Override public void onTrackingRequestFailure(String error) { 
            Log.d("Debug", error); 
            }   
        }; 
    }