개요

AppsFlyerLib 는 앱스플라이어 안드로이드 SDK의 메인 클래스이며, 대부분의 메서드를 캡슐화합니다.

SDK 참조 인덱스로 되돌아갑니다.

라이브러리 가져오기

import com.appsflyer.AppsFlyerLib;

SDK 인스턴스에 액세스하기

SDK 싱글톤 인스턴스에 액세스하는 방법:

AppsFlyerLib appsflyer = AppsFlyerLib.getInstance();

메서드

addPushNotificationDeepLinkPath

Method signature

void addPushNotificationDeepLinkPath(java.lang.String... deepLinkPath)

설명
앱스플라이어 SDK가 푸시 알림 페이로드에서 딥링크 값을 추출하는 방식을 설정합니다.

입력 인수

유형이름설명
String...deepLinkPath딥링크의 JSON 경로에 해당하는 String배열입니다.

반환
void.

사용법 예시
기본 설정:

AppsFlyerLib.getInstance().addPushNotificationDeepLinkPath("af_push_link");
AppsFlyerLib.getInstance().addPushNotificationDeepLinkPath("af_push_link")

고급 설정:

AppsFlyerLib.getInstance().addPushNotificationDeepLinkPath("deeply", "nested", "deep_link");
AppsFlyerLib.getInstance().addPushNotificationDeepLinkPath("deeply", "nested", "deep_link")

이 호출은 다음 페이로드 구조와 일치합니다.

{
  "deeply": {
    "nested": {
      "deep_link": "https://yourdeeplink2.onelink.me"
    }
  }
}

anonymizeUser

Method signature

void anonymizeUser(boolean shouldAnonymize)

설명
사용자의 설치, 이벤트 및 세션을 익명 처리 합니다.

입력 인수

유형이름설명
booleanshouldAnonymize기본 값: false.

반환
void

사용법 예시

AppsFlyerLib.getInstance().anonymizeUser(true);
AppsFlyerLib.getInstance().anonymizeUser(true)

appendParametersToDeepLinkingURL

Method signature

void appendParametersToDeepLinkingURL(java.lang.String contains,
                                                      java.util.Map<java.lang.String,java.lang.String> parameters)

설명
(원링크 없이) 앱을 이용하여 딥링킹을 하는 앱 소유주가 앱과 관련된 도메인을 통해 앱 세션을 어트리뷰션할 수 있도록 합니다.

🚧

다음을 호출하기 전에 이 메서드를 호출하십시오: start

다음에 다음 파라미터를 제공해야 합니다: parameters Map:

  • pid
  • is_retargeting 은 다음으로 설정되어야 합니다. true

입력 인수

유형이름설명
Stringcontains 딥링크 URL에 포함된 문자열
Map<String, String>parameters일치하는 URL에 추가되는 어트리뷰션 파라미터

반환
void

사용법 예시

HashMap<String, String> urlParameters = new HashMap<>();
urlParameters.put("pid", "exampleDomain"); // Required
urlParameters.put("is_retargeting", "true"); // Required
AppsFlyerLib.getInstance().appendParametersToDeepLinkingURL("example.com", urlParameters);
AppsFlyerLib.getInstance().appendParametersToDeepLinkingURL("example.com",
mapOf("pid" to "exampleDomain", "is_retargeting" to "true")) // Required

위 예시에서 앱스플라이어 서버로 전송되는 어트리뷰션 URL은 다음과 같습니다.

example.com?pid=exampleDomain&is_retargeting=true

enableFacebookDeferredApplinks

Method signature

void enableFacebookDeferredApplinks(boolean isEnabled)

설명
Facebook Deferred AppLinks 모음을 사용하도록 설정합니다. 대상/클라이언트 기기에 Facebook SDK와 Facebook 앱을 요구합니다.

이 API를 적절하게 작동시키려면 앱스플라이어 SDK를 초기화하기 전에 먼저 호출해야 합니다.
입력 인수

유형이름설명
booleanisEnabled Facebook의 디퍼드 앱 링크를 앱스플라이어 SDK에서 처리해야 하는 경우 사용합니다.

반환
void

enableLocationCollection

V6.8.0에서 삭제됨

Method signature

AppsFlyerLib enableLocationCollection(boolean flag)

설명
마지막으로 알려진 위치를 수집하려면 앱스플라이어 SDK를 사용합니다. 다음 ACCESS_COARSE_LOCATION and ACCESS_FINE_LOCATION Manifest 권한이 필요합니다.

입력 인수

유형이름설명
booleanflag

반환
void

enableTCFDataCollection

Method signature

AppsFlyerLib enableTCFDataCollection (boolean flag)

설명

Enables the collection of Transparency and Consent Framework (TCF) data from SharedPreferences. The data was placed in SharedPreferences by the device TCF v2.2 compatible Consent Management Platform (CMP).

입력 인수

유형이름설명
booleanflagA boolean value to enable (true) or disable (false) the collection of TCF data. The SDK collects TCF data when the flag is set to true.

반환
void

getAppsFlyerUID

Method signature

java.lang.String getAppsFlyerUID(Context context)

설명
앱스플라이어의 고유 기기 ID를 가져옵니다. SDK는 앱 설치 시 앱스플라이어의 고유 기기 ID를 생성합니다. SDK가 시작되면 이 ID가 첫 번째 앱 인스톨의 ID로 기록됩니다.

입력 인수

유형이름설명
Contextcontext 애플리케이션/액티비티 컨텍스트입니다.

반환
앱스플라이어의 고유 기기 ID를 반환합니다.

사용법 예시

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

getAttributionId

Method signature

java.lang.String getAttributionId(Context context)

설명
Facebook 어트리뷰션 ID를 가져옵니다(있는 경우).

입력 인수

유형이름설명
Contextcontext애플리케이션/액티비티 컨텍스트입니다.

반환
void

사용법 예시

String attributionId = AppsFlyerLib.getInstance().getAttributionId(this);
String attributionId = AppsFlyerLib.getInstance().getAttributionId(this)

getHostName

Method signature

java.lang.String getHostName()

설명
호스트 이름을 가져옵니다.
기본값은 "appsflyer.com"입니다.

입력 인수
이 함수는 파라미터를 사용하지 않습니다.

반환

유형설명
String현재 설정된 호스트 이름입니다.

사용법 예시

getHostPrefix

Method signature

java.lang.String getHostPrefix()

설명
사용자정의 세트 호스트 접두사를 가져옵니다.

입력 인수
이 함수는 파라미터를 사용하지 않습니다.

반환
호스트 접두사를 반환합니다.

getInstance

Method signature

AppsFlyerLib getInstance()

설명
이 문서에 설명된 SDK 인스턴스를 반환합니다. 이 인스턴스로 메서드에 액세스할 수 있습니다.

입력 인수
이 함수는 파라미터를 사용하지 않습니다.

반환
AppsFlyerLib 싱글톤 인스턴스를 반환합니다.

getOutOfStore

Method signature

java.lang.String getOutOfStore(Context context)

설명
써드파티 앱 저장소 리퍼러 값을 가져옵니다.

입력 인수

유형이름설명
Contextcontext 애플리케이션/액티비티 컨텍스트입니다.

반환
AF_Store 값을 반환합니다.

getSdkVersion

Method signature

java.lang.String getSdkVersion()

설명
앱이 사용하는 앱스플라이어 SDK 버전을 가져옵니다.

입력 인수
이 함수는 파라미터를 사용하지 않습니다.

반환
앱스플라이어 SDK 버전을 반환합니다.

init

Method signature

AppsFlyerLib init(java.lang.String key,
                                  AppsFlyerConversionListener conversionDataListener,
                                  Context context)

설명
이 메서드는 앱스플라이어 SDK를 초기화할 때 사용합니다. 이 API는 중지된 경우 애플리케이션의 onCreate 호출합니다.

입력 인수

유형이름설명
Stringkey앱스플라이어 dev key
AppsFlyerConversionDataListenerconversionDataListener(선택사항) AppsFlerConversionDataListener를 구현하여 앱스플라이어의 전환 데이터에 액세스합니다. 이는 null이 될 수 있습니다.
Contextcontext애플리케이션 컨텍스트입니다.

반환
void

사용법 예시
SDK 초기화를 참조하십시오.

isPreInstalledApp

Method signature

boolean isPreInstalledApp(Context context)

설명
제조사 사전 설치에 대한 부울 지표입니다.

입력 인수

유형이름설명
Contextcontext 애플리케이션/액티비티 컨텍스트입니다.

반환
boolean.

사용법 예시

isStopped

Method signature

boolean isStopped()

설명
SDK가 중지되었는지 확인합니다.

입력 인수
이 함수는 파라미터를 사용하지 않습니다.

반환

유형설명
boolean true 내부에서 호출되어야 하며, 그렇지 않은 경우 false 로 호출되어야 합니다.

사용법 예시

logAdRevenue

Added in v6.15.0
Method signature


public abstract void logAdRevenue(
            @NonNull AFAdRevenueData adRevenueData, 
            @Nullable Map<String, Object> additionalParameters
    );

설명

The method sends an ad revenue event to AppsFlyer. See more information in Ad revenue.

입력 파라미터

이름유형설명
adRevenueDataAFAdRevenueDataAn object that encapsulates all the mandatory parameters of the adRevenue event. The object is passed to the logAdRevenue method.
additionalParametersMap<String, Object>An optional dictionary containing additional parameters to log with the adRevenue event.

반환

void.

AFAdRevenueData

An object that encapsulates all mandatory adRevenue data received from the mediation network.

Definition

data class AFAdRevenueData(
    val monetizationNetwork: String,
    val mediationNetwork: MediationNetwork,
    val currencyIso4217Code: String,
    val revenue: Double
)

AFAdRevenueData parameters

이름유형설명
monetizationNetwork문자열The monetization network name.
mediationNetworkMediationNetworkThe mediation network enum.
currencyIso4217Code문자열The ad revenue event currency is a String validated against currencyIso4217Code
revenueDoubleThe ad revenue event amount.

MediationNetwork

이름유형Comments
ironsource문자열
applovinmax문자열
googleadmob문자열
fyber문자열
appodeal문자열
admost문자열
topon문자열
tradplus문자열
yandex문자열
chartboost문자열
unity문자열
customMediation문자열중재 솔루션이 지원되는 중재 파트너 목록에 없습니다.
directMonetizationNetwork문자열이 앱은 중재 없이 수익화 네트워크와 직접 통합됩니다.

logEvent

Method signature

void logEvent(Context context,
                              java.lang.String eventName,
                              java.util.Map<java.lang.String,java.lang.Object> eventValues)

설명
인앱 이벤트를 기록합니다.

입력 인수

유형이름설명
Contextcontext 애플리케이션/액티비티 컨텍스트입니다.
StringeventName 이벤트 이름
MapeventValues 이벤트 값입니다.

반환
void

사용법 예시

logEvent

Method signature

void logEvent(Context context,
                              java.lang.String eventName,
                              java.util.Map<java.lang.String,java.lang.Object> eventValues,
                              AppsFlyerRequestListener listener)

설명
AppsFlyerRequestListener가 있는 logEvent와 동일합니다. HttpURLConnection.HTTP_OK
서버는 AppsFlyerRequestListener#onSuccess()
메서드를 호출할 것입니다. 오류가 발생하는 경우 AppsFlerRequestListener#onError(int, String)이
오류를 반환합니다.

입력 인수
이 함수는 파라미터를 사용하지 않습니다.
반환
void

사용법 예시

logLocation

Method signature

void logLocation(Context context,
                                 double latitude,
                                 double longitude)

설명
사용자의 위치를 수동으로 기록합니다.

이 메서드는 af_location_coordinates 인앱 이벤트를 af_lat and af_long 이벤트 파라미터를 사용하여 만듭니다.

입력 인수

유형이름설명
Contextcontext 애플리케이션/액티비티 컨텍스트입니다.
doublelatitude LATITUDE
doublelongitude LONGITUDE

반환
void

사용법 예시

logSession

Method signature

void logSession(Context ctx)

설명
앱이 백그라운드 유틸리티 앱인 경우, 액티비티의 onCreate()에서 이 API를 사용하여 세션을 수동으로 기록하고 전송할 수 있습니다.

입력 인수

유형이름설명
Contextctx애플리케이션/액티비티 컨텍스트입니다.

사용법 예시

public void logSession(Context context);
public void logSession(Context context)

반환
void

onPause

Method signature

void onPause(Context context)

설명
Cocos2dx 플랫폼의 경우에만 해당합니다.
Cocos2dx에는 고유의 applicationDidEnterBackground 이벤트가 있습니다.
따라서 'onPause'는 JNI에 의해 C++에서 호출될 것입니다.

입력 인수

유형이름설명
Contextcontext 애플리케이션/액티비티 컨텍스트입니다.

반환
void

사용법 예시

performOnAppAttribution

V6.3.2부터는 사용 중단
Method signature

void performOnAppAttribution(Context context,
                                             java.net.URI link)

설명
딥링크를 수동으로 분석하는 데 사용합니다.

입력 인수

유형이름설명
Contextcontext 애플리케이션/액티비티 컨텍스트입니다.
java.net.URIlink 분석을 위한 링크입니다.

반환
void

사용법 예시

AppsFlyerLib.getInstance().performOnAppAttribution(context, uri);
AppsFlyerLib.getInstance().performOnAppAttribution(context, uri)

performOnDeepLinking

V6.3.1 이상에서 추가됨

Method signature

 public void performOnDeepLinking(@NonNull Intent intent, @NonNull Context context);

설명
딥링크 분석에 수동 트리거를 사용할 수 있도록 합니다. 이 메서드를 사용하면 SDK를 시작하기 전에 호출을 지연하는 앱이 딥링크를 분석하도록 합니다.

  • 만일 DeepLinkListener 가 등록된 경우 디퍼드 딥링킹 및 직접 딥링킹을 모두 지원하고
  • 만일 AppsFlyerConversionListener 가 등록된 경우 직접 딥링킹만 지원합니다.

딥링킹을 통해 시작할 수 있는 액티비티에 대해서는 ActivityonResume에서 호출하는 것이 좋습니다.
일러두기: 이 API에서 처리되는 직접 딥링크는 서버에 리포트되지 않습니다.

사용법 예시

@Override
protected void onResume() {
  super.onResume();

  AppsFlyerLib appsflyer = AppsFlyerLib.getInstance();
  appsflyer.performOnDeepLinking(getIntent(),this);
}

입력 인수

유형이름설명
Intentintent
Contextcontext 애플리케이션/액티비티 컨텍스트입니다.

반환
void

registerConversionListener

Method signature

void registerConversionListener(Context context,
                                                AppsFlyerConversionListener conversionDataListener)

설명
전환 데이터 리스너를 등록합니다. 또한 init 를 사용하여 리스터를 등록할 수도 있습니다.

입력 인수

유형이름설명
Contextcontext 애플리케이션/액티비티 컨텍스트입니다.
AppsFlyerConversionListenerconversionDataListenerThe AppsFlyerConversionListener : 등록할 객체입니다.

반환
void

사용법 예시

// conversionDataListener is an object of type AppsFlyerConversionListener.
AppsFlyerLib.getInstance().registerConversionListener(getApplicationContext(), conversionDataListener);
// conversionDataListener is an object of type AppsFlyerConversionListener.
AppsFlyerLib.getInstance().registerConversionListener(getApplicationContext(), conversionDataListener)

다음은 다음 메서드의 구현예입니다: AppsFlyerConversionListener.

registerValidatorListener (LEGACY)

Method signature

void registerValidatorListener(Context context,
                                               AppsFlyerInAppPurchaseValidatorListener validationListener)

설명
다음 validateAndLogInAppPurchase API에 대한 유효성 검사 리스터를 등록합니다.

입력 인수

유형이름설명
Contextcontext애플리케이션/액티비티 컨텍스트입니다.
AppsFlyerInAppPurchaseValidatorListenervalidationListenerThe AppsFlyerInAppPurchaseValidatorListener : 등록할 객체입니다.

반환
void

사용법 예시

sendAdRevenue (LEGACY)

Deprecated in v6.15.0

(Supported until SDK v6.14.2 For versions including and above v6.15.0 use logAdRevenue)

Method signature

void sendAdRevenue(Context context,
                                   java.util.Map<java.lang.String,java.lang.Object> eventValues)

설명

입력 인수

유형이름설명
Contextcontext애플리케이션/액티비티 컨텍스트입니다.
Map<String, Object>validationListener

반환
void

sendPushNotificationData

Method signature

void sendPushNotificationData(Activity activity)

설명
푸시 알림 캠페인에서 데이터를 측정하고 가져옵니다. 푸시 알림에서 실행되는 onCreate 메서드( Activity에 속한) 내부에서 이 메서드를 호출합니다.

입력 인수

유형이름설명
ActivityactivityThe Activity 은 알림을 통해 실행됩니다.

반환
void.

사용법 예시

setAdditionalData

📘

Calling setAddiotionalData before first launch will have the additional data included in installs, sessions, as well as in-app events.

Method signature

void setAdditionalData(java.util.Map<java.lang.String,java.lang.Object> customData)

설명
이벤트의 페이로드에 커스텀 데이터를 추가하는 데 사용합니다. 로데이터 리포트에 나타납니다.
입력 인수

유형이름설명
HashMapcustomData

반환
void.

setAndroidIdData

Method signature

void setAndroidIdData(java.lang.String aAndroidId)

설명
안드로이드 버전이 안드로이드 KitKat(4.4) 이상이고 기기가 Google Play Services를 포함하고 있으면, 기본적으로 SDK가 IMEI 및 안드로이드 ID를 수집하지 않습니다.  이 API를 사용해 앱스플라이어에 안드로이드 ID를 발송합니다.

입력 인수

유형이름설명
StringaAndroidId안드로이드 기기 ID

반환
void

setAppId

Method signature

void setAppId(java.lang.String id)

설명

입력 인수

유형이름설명
Stringid안드로이드 앱 ID

반환
void

setAppInviteOneLink

Method signature

void setAppInviteOneLink(java.lang.String oneLinkId)

설명
앱 추천 어트리뷰트에 사용해야 하는 원링크 ID를 설정합니다. 앱 추천에 대해 생성되는 링크는 이 원링크를 기본 링크로 사용할 것입니다. 앱 추천 어트리뷰션을 위한 원링크 설정하기를 참조하세요.

입력 인수

유형이름설명
StringoneLinkId앱스플라이어 대시보드에서 확보한 원링크 ID입니다.

반환
void.

setCollectAndroidID

Method signature

void setCollectAndroidID(boolean isCollect)

설명
Android ID 수집에 동의. SDK가 안드로이드 ID를 수집하도록 합니다.

입력 인수

유형이름설명
booleanisCollect다음으로 설정 true 을 옵트인.

반환
void.

setCollectIMEI

Method signature

void setCollectIMEI(boolean isCollect)

설명
IMEI 수집에 동의. SDK가 IMEI를 수집하도록 합니다.

입력 인수

유형이름설명
booleanisCollect다음으로 설정 true 을 옵트인.

반환
void.

setCollectOaid

Method signature

void setCollectOaid(boolean isCollect)

설명
OAID ID 수집에서 옵트인/옵트아웃합니다. 기본적으로, SDK는 OAID를 수집을 시도합니다.

입력 인수

유형이름설명
booleanisCollect기본 값: true. 다음으로 설정 false 을 옵트인.

반환
void.

setConsentData

Method signature

AppsFlyerLib.getInstance().setConsentData(AppsFlyerConsent afConsent)

설명

Transfers consent data to the SDK.

입력 인수

유형이름설명
AppsFlyerConsentafConsentAn object containing user consent data

setCurrencyCode

Method signature

void setCurrencyCode(java.lang.String currencyCode)

설명
인앱 구매에 대한 통화를 설정합니다. 통화 코드는 3문자 ISO 4217 코드여야 합니다.

입력 인수

유형이름설명
StringcurrencyCode3 character ISO 4217 code. Defaults to "USD".

반환
void.

setCustomerIdAndLogSession

⚠️

Before calling this method, the method waitForCustomerUserId must be called

Method signature

void setCustomerIdAndLogSession(java.lang.String id,
                                                Context context)

설명
고객 사용자 ID를 설정하고 SDK를 시작하는 데 사용합니다.

입력 인수

유형이름설명
Stringid고객용 고객 ID입니다.
Stringcontext애플리케이션/액티비티 컨텍스트입니다.

반환
void

setCustomerUserId

Method signature

void setCustomerUserId(java.lang.String id)

설명
자체 고객 ID를 설정하면 자체 고유 ID를 앱스플라이어의 고유 ID와 다른 기기의 ID와 연결하여 상호 참조할 수 있습니다. 이 ID는 귀사 내부 ID와 상호 참조할 수 있도록 로데이터 보고서와 포스트백 API에서 찾을 수 있습니다.

입력 인수

유형이름설명
Stringid고객용 고객 ID입니다.

반환
void.

setDebugLog

Method signature

void setDebugLog(boolean shouldEnable)

설명
앱스플라이어 SDK를 위해 디버깅 로그를 활성화합니다. 개발 환경에서만 true로 설정해야 합니다.

입력 인수

유형이름설명
booleanshouldEnable기본 값: false.

반환
void.

사용법 예시

setDisableAdvertisingIdentifiers

V6.3.2에 추가됨
Method signature

void setDisableAdvertisingIdentifiers(boolean disable);

설명
SDK를 통한 다양한 광고 ID의 수집을 비활성화합니다. 여기에는 Google 광고 ID(GAID), OAID및 Amazon 광고 ID(AAID)가 포함됩니다.

입력 인수

유형이름설명
booleandisable기본 값: false.

반환
void.

setDisableNetworkData

V6.7.0에 추가됨
Method signature

void setDisableNetworkData(boolean disable);

설명
기기에서 네트워크 사업자 이름(이동통신사) 및 sim 사업자 이름 수집을 선택 해제하는 데 사용합니다.

입력 인수

유형이름설명
booleandisable기본 값: false.

반환
void.

setExtension

Method signature

void setExtension(java.lang.String extension)

설명
SDK 플러그인 및 확장이 이 필드를 설정합니다.

입력 인수

유형이름설명
Stringextension확장자 이름입니다.

반환
void.

setHost

Method signature

void setHost(java.lang.String hostPrefixName,
                             java.lang.String hostName)

설명
사용자정의 호스트를 설정합니다. 참고: SDK V6.10부터 호스트가 비어 있거나 널(NULL) 값으로 전송되면 API 호출이 무시됩니다.

입력 인수

유형이름설명
StringhostPrefixName호스트 접두사를 반환합니다.
StringhostName호스트 이름입니다.

반환
void.

setImeiData

Method signature

void setImeiData(java.lang.String aImei)

설명
OS 버전이 KitKat(4.4) 이상이고 기기가 Google Play Services를 포함하고 있으면, 기본적으로 SDK가 IMEI 및 안드로이드 ID를 수집하지 않습니다.

입력 인수

유형이름설명
StringaImei기기 IMEI

반환
void.

setIsUpdate

Method signature

void setIsUpdate(boolean isUpdate)

설명
애플리케이션이 업데이트되었음을 수동으로 설정합니다.

입력 인수

유형이름설명
booleanisUpdate

반환
void.

setLogLevel

Method signature

void setLogLevel(AFLogger.LogLevel logLevel)

설명
SDK 로그 레벨을 설정합니다.

입력 인수

유형이름설명
StringlogLevel로그 레벨입니다.

반환
void.

setMinTimeBetweenSessions

Method signature

void setMinTimeBetweenSessions(int seconds)

설명
세션 간 최소 필요 시간을 맞춤 설정합니다.

입력 인수

유형이름설명
intseconds두 개의 개별 세션으로 계수하기 위해 두 개의 앱 실행 사이에 경과해야 하는 최소 시간을 설정합니다. 설정하지 않으면 세션 간의 최소 시간 기본값은 5초입니다.

반환
void.

setOaidData

Method signature

void setOaidData(java.lang.String oaid)

설명
기본적으로, SDK는 OAID를 수집하지 않습니다. 이 API를 사용해 앱스플라이어에 OAID를 발송합니다.

입력 인수

유형이름설명
Stringoaid기기 OAID입니다.

반환
void.

setOneLinkCustomDomain

Method signature

void setOneLinkCustomDomain(java.lang.String... domains)

설명
앱스플라이어 SDK가 숨겨진 (짧은 링크 ID로 디코딩된) 어트리뷰션 파라미터를 성공적으로 분석하기 위해서는 앱스플라이어 대시보드에서 브랜드 도메인으로 구성된 모든 도메인을 이 메서드에 제공해야 합니다.

입력 인수

유형이름설명
String...domainsSDK가 브랜드 도메인으로 취급해야 하는 도메인의 배열입니다. SDK는 이를 원링크로 분석하려고 합니다.

반환
void.

setOutOfStore

Method signature

void setOutOfStore(java.lang.String sourceName)

설명
앱이 다운로드 될, 구글 플레이 외 대체 앱스토어를 지정합니다.

입력 인수

유형이름설명
StringsourceName써드파티 앱 저장소입니다.

반환
void.

사용법 예시

AppsFlyerLib.getInstance().setOutOfStore("baidu");
AppsFlyerLib.getInstance().setOutOfStore("baidu")

setPartnerData

Method signature

void setPartnerData(@NonNull String partnerId, Map<String, Object> data);

설명
파트너 연동 용도로 사용자정의 데이터를 전송할 수 있도록 합니다.

입력 인수

유형이름설명
StringpartnerId파트너의 ID(일반적으로 "_int" 접미사가 붙음).
Mapdata고객 데이터, 특정 파트너와의 연동 구성에 따라 다릅니다.

반환
void.

사용법 예시

Map<String, Object> partnerData = new HashMap();
partnerData.put("puid", "123456789");
AppsFlyerLib.getInstance().setPartnerData("test_int", partnerData);
val partnerData = mapOf("puid" to "123456789")
AppsFlyerLib.getInstance().setPartnerData("test_int", partnerData)

setPhoneNumber

Method signature

void setPhoneNumber(java.lang.String phoneNumber)

설명
SHA-256으로 암호화된 문자열로 전송됩니다.

입력 인수

유형이름설명
StringphoneNumber

반환
void.

setPreinstallAttribution

Method signature

void setPreinstallAttribution(java.lang.String mediaSource,
                                              java.lang.String campaign,
                                              java.lang.String siteId)

설명
사전 설치가 어트리뷰션된 제조사나 미디어소스를 지칭합니다.
입력 인수

유형이름설명
StringmediaSource사전 설치 어트리뷰션에 대한 제조사 또는 미디어소스 이름입니다.
Stringcampaign사전 설치 어트리뷰션 캠페인 이름입니다.
StringsiteId사전 설치 어트리뷰션의 사이트 ID입니다.

반환
void.

setResolveDeepLinkURLs

Method signature

void setResolveDeepLinkURLs(java.lang.String... urls)

설명
광고주들은 다른 유니버설 링크 내에서 앱스플라이어 원링크를 래핑할 수 있습니다. 이 유니버설 링크는 앱을 호출하지만, 상세한 링크 데이터는 앱스플라이어에 전파되지 않습니다.

setResolveDeepLinkURLs 를 사용하여 래핑된 원링크 URL을 분석하도록 SDK를 구성할 수 있으며, 이렇게 딥링크를 올바르게 발생시킬 수 있습니다.

입력 인수

유형이름설명
String...urls반드시 명시적 URL을 제공해야 합니다.

반환
void

사용법 예시

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

setSharingFilterForPartners

V6.4에 추가됨
Method signature

void setSharingFilterForPartners(java.lang.String... partners)

This function replaces the deprecated setSharingFilter and setSharingFilterForAllPartners

설명
SDK가 데이터 공유에서 제외해야 하는 파트너를 설정할 수 있습니다.

입력 인수

유형이름설명
String...partners제외하려는 하나 이상의 파트너 식별자입니다. 문자/숫자 및 밑줄만 포함해야 합니다. 최대 파트너 ID 길이: 45

일러두기:
필요한 파트너 ID를 확인하려면:

  1. 모든 활성 연동 목록에 대해 활성 연동 API 가져오기를 실행합니다.
  2. 메서드(from)를 media_source_name API 응답의 값을 메서드 partners 배열의 입력 값으로 사용합니다.

예외:

  • For Twitter, use twitter 사용(및 다음을 사용하지 않음: twitter_int)

사용법 예시

AppsFlyerLib.getInstance().setSharingFilterForPartners("partner1_int"); // Single partner
AppsFlyerLib.getInstance().setSharingFilterForPartners("partner1_int", "partner2_int"); // Multiple partners
AppsFlyerLib.getInstance().setSharingFilterForPartners("all"); // All partners
AppsFlyerLib.getInstance().setSharingFilterForPartners(); // Reset list (default)
AppsFlyerLib.getInstance().setSharingFilterForPartners("partner1_int") // Single partner
AppsFlyerLib.getInstance().setSharingFilterForPartners("partner1_int", "partner2_int") // Multiple partners
AppsFlyerLib.getInstance().setSharingFilterForPartners("all") // All partners
AppsFlyerLib.getInstance().setSharingFilterForPartners("") // Reset list (default)

setSharingFilter

V6.4에서 사용 중단
Method signature

void setSharingFilter(java.lang.String... partners)

This function is deprecated and has been replaced by setSharingFilterForPartners

설명
Stops events from propagating to the specified AppsFlyer partners.
(Deprecated and replaced by setSharingFilterForPartners)
Input arguments

유형이름설명
String...partners하나 이상의 파트너 식별자입니다. 문자/숫자 및 밑줄만 포함해야 합니다. 최대 길이: 45

반환
void

setSharingFilterForAllPartners

V6.4에서 사용 중단
Method signature

void setSharingFilterForAllPartners()

This function is deprecated and has been replaced by setSharingFilterForPartners

설명
이벤트가 모든 앱스플라이어 파트너로 전파되지 않도록 합니다. 다음을 덮어씁니다: setSharingFilter.

입력 인수
이 함수는 파라미터를 사용하지 않습니다.

반환
void

setUserEmails

Method signature

void setUserEmails(AppsFlyerProperties.EmailsCryptType cryptMethod,
                                   java.lang.String... emails)

설명
사용자 이메일을 설정하고 암호화합니다.

입력 인수

유형이름설명
AppsFlyerProperties.EmailsCryptTypecryptMethod암호화 메서드는 다음과 같습니다.
  • AppsFlyerProperties.EmailsCryptType.NONE
  • AppsFlyerProperties.EmailsCryptType.SHA256
String...emails하나 이상의 사용자 이메일입니다.

반환
void.

start

Method signature

void start(Context context,
                           java.lang.String key,
                           AppsFlyerRequestListener listener)

설명
SDK를 시작합니다.

입력 인수

유형이름설명
Contextcontext애플리케이션에서 호출하는 경우 애플리케이션 콘텍스트 onCreate 메서드, 액티비티이후 실행되는 경우 액티비티 콘텍스트 onResume 호출합니다.
Stringkey앱스플라이어 dev key
AppsFlyerRequestListenerlistener(선택사항) 요청 상태를 가져오기 위한 리스너입니다.

반환
void.

사용법 예시
예제 구현은 SDK 연동하기를 참조하세요.

stop

Method signature

void stop(boolean shouldStop,
                          Context context)

설명
이 API를 호출한 후에는 당사 SDK가 더 이상 서버와 통신하지 않고 작동을 중지합니다.
사용자 옵트인/옵트아웃을 구현할 때 유용합니다.

📘

SDK 재시작

이후 stop(true) 이 호출된 후에 stop(false) 을 호출한 다음 다음을 호출해야 합니다: start()

입력 인수

유형이름설명
booleanshouldStop로깅을 중지해야 할 때 사용합니다.
Contextcontext애플리케이션/액티비티 컨텍스트입니다.

반환
void.

subscribeForDeepLink

Method signature

void subscribeForDeepLink(DeepLinkListener deepLinkListener,
                                          long timeout)

설명

입력 인수

유형이름설명
DeepLinkListenerdeepLinkListener
longtimeout선택사항.
밀리초 단위

반환
void

unregisterConversionListener

Method signature

void unregisterConversionListener()

설명
이전에 등록된 다음 메서드를 등록 해제합니다: AppsFlyerConversionListener.

입력 인수
이 함수는 파라미터를 사용하지 않습니다.

반환
void

updateServerUninstallToken

Method signature

void updateServerUninstallToken(Context context,
                                                java.lang.String token)

설명
Firebase를 앱 삭제 측정 외 목적으로도 사용하는 개발자들을 위한 것입니다. 더 자세한 내용은 앱 삭제 측정하기를 참조하십시오.

입력 인수

유형이름설명
Contextcontext애플리케이션/액티비티 컨텍스트입니다.
StringtokenFirebase 기기 토큰입니다.

반환
void

사용법 예시

AppsFlyerlib.getInstance().updateServerUninstallToken(getApplicationContext(), <TOKEN>);
AppsFlyerlib.getInstance().updateServerUninstallToken(getApplicationContext(), <TOKEN>);

validateAndLogInAppPurchase

Added in v6.14.0

Method signature

public abstract void validateAndLogInAppPurchase(@NonNull AFPurchaseDetails purchaseDetails,
                                                 @Nullable Map<String, String> additionalParameters,
                                                 @Nullable AppsFlyerInAppPurchaseValidationCallback validationCallback);

설명
The method validates a purchase event with the store and if the validation is successful, the SDK sends an af_purchase event to AppsFlyer.

See detailed instructions in Validate and log in-app purchase.

입력 인수

이름유형설명
purchaseDetails *AFPurchaseDetailsAn object that encapsulates all data related to the purchase provided to the validateAndLogInAppPurchase method.
additionalParametersMap<String, String>Additional parameters to log with the purchase.
validationCallback *AppsFlyerInAppPurchaseValidationCallback`A callback for delivering validation results.

반환
void

AFPurchaseDetails

An object that encapsulates all data related to the purchase provided to the validateAndLogInAppPurchase method.

data class AFPurchaseDetails(
    val purchaseType: AFPurchaseType,
    val purchaseToken: String,
    val productId: String,
    val price: String,
    val currency: String
)

AFPurchaseDetails parameters

이름유형설명
purchaseTypeAFPurchaseTypeField to distinguish between one-time purchases and subscriptions. The field can accept either subscription or one-time-purchase.
purchaseToken문자열Token that uniquely identifies a purchase for a given item and user pair. Part of the Billing Library's Purchase class. To retrieve the token call the getPurchaseToken API
productId문자열ID of the product item that has been purchased. Also part of the Billing Library's Purchase class.
price문자열The full price of the one-time purchase or the subscription. Also part of the Billing Library's Purchase class.
currency문자열Currency used to make the purchase.

validateAndLogInAppPurchase (LEGACY)

Deprecated in v6.4

Method signature

void validateAndLogInAppPurchase(Context context,
                                                 java.lang.String publicKey,
                                                 java.lang.String signature,
                                                 java.lang.String purchaseData,
                                                 java.lang.String price,
                                                 java.lang.String currency,
                                                 java.util.Map<java.lang.String,java.lang.String> additionalParameters)

설명
인앱 구매에 대한 서버 확인을 위한 API. 앱스플라이어 af_purchase 유효성 검증에 성공하면 관련 값이 있는 이벤트가 자동으로 기록됩니다.

구매 검증에 대한 자세한 안내를 참조하세요.

입력 인수

유형이름설명
Contextcontext애플리케이션/액티비티 컨텍스트입니다.
StringpublicKeyGoogle Play Console에서 얻은 라이선스 키
Stringsignaturedata.INAPP_DATA_SIGNATURE from onActivityResult(int requestCode, int resultCode, Intent data)
StringpurchaseDatadata.INAPP_PURCHASE_DATA from onActivityResult(int requestCode, int resultCode, Intent data)
Stringprice구매 가격입니다. skuDetails.getStringArrayList ("DETAILS_LIST")에서 파생되어야 합니다.
Stringcurrency구매 통화입니다. skuDetails.getStringArrayList ("DETAILS_LIST")에서 파생되어야 합니다.
Map<String, String>additionalParameters구매 시 기록되는 자유형 파라미터입니다(검증된 경우).

반환
void.

waitForCustomerUserId

Method signature

void waitForCustomerUserId(boolean wait)

설명
이 방법은 customerUserID 가 제공될 때까지 SDK 초기화를 지연합니다.
모든 인앱 이벤트 및 기타 SDK API 호출은 customerUserID 가 제공되고 기록될 때까지 무시됩니다.

입력 인수

유형이름설명
booleanwait

반환
void.

사용법 예시

AppsFlyerLib.getInstance().waitForCustomerUserId(true);
AppsFlyerLib.getInstance().waitForCustomerUserId(true);