AppsFlyerLib
개요
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)
설명
사용자의 설치, 이벤트 및 세션을 익명 처리 합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
boolean | shouldAnonymize | 기본 값: 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)
설명
Enables app owners using App Links for deep linking (without OneLink) to attribute sessions initiated via a domain associated with their app.
다음을 호출하기 전에 이 메서드를 호출하십시오:
start
다음에 다음 파라미터를 제공해야 합니다: parameters Map:
pidis_retargeting은 다음으로 설정되어야 합니다.true
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
String | contains | 딥링크 URL에 포함된 문자열 |
Map<String, String> | parameters | 일치하는 URL에 추가되는 어트리뷰션 파라미터 |
반환
void
사용법 예시
HashMap<String, String> urlParameters = new HashMap<>();
parameters.put("pid", "exampleDomain"); // Required
parameters.put("is_retargeting", "true"); // Required
AppsFlyerLib.getInstance().appendParametersToDeepLinkingURL("example.com", parameters);
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를 초기화하기 전에 먼저 호출해야 합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
boolean | isEnabled | Facebook의 디퍼드 앱 링크를 앱스플라이어 SDK에서 처리해야 하는 경우 사용합니다. |
반환
void
enableLocationCollection
V6.8.0에서 삭제됨
Method signature
AppsFlyerLib enableLocationCollection(boolean flag)
설명
마지막으로 알려진 위치를 수집하려면 앱스플라이어 SDK를 사용합니다. 다음 ACCESS_COARSE_LOCATION and ACCESS_FINE_LOCATION Manifest 권한이 필요합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
boolean | flag |
반환
void
getAppsFlyerUID
Method signature
java.lang.String getAppsFlyerUID(Context context)
설명
앱스플라이어의 고유 기기 ID를 가져옵니다. SDK는 앱 설치 시 앱스플라이어의 고유 기기 ID를 생성합니다. SDK가 시작되면 이 ID가 첫 번째 앱 인스톨의 ID로 기록됩니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
Context | context | 애플리케이션/액티비티 컨텍스트입니다. |
반환
앱스플라이어의 고유 기기 ID를 반환합니다.
사용법 예시
String appsFlyerId = AppsFlyerLib.getInstance().getAppsFlyerUID(this);
String appsFlyerId = AppsFlyerLib.getInstance().getAppsFlyerUID(this)
getAttributionId
Method signature
java.lang.String getAttributionId(Context context)
설명
Facebook 어트리뷰션 ID를 가져옵니다(있는 경우).
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
Context | context | 애플리케이션/액티비티 컨텍스트입니다. |
반환
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)
설명
써드파티 앱 저장소 리퍼러 값을 가져옵니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
Context | context | 애플리케이션/액티비티 컨텍스트입니다. |
반환
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 호출합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
String | key | 앱스플라이어 dev key |
AppsFlyerConversionDataListener | conversionDataListener | (선택사항) AppsFlerConversionDataListener를 구현하여 앱스플라이어의 전환 데이터에 액세스합니다. 이는 null이 될 수 있습니다. |
Context | context | 애플리케이션 컨텍스트입니다. |
반환
void
사용법 예시
SDK 초기화를 참조하십시오.
isPreInstalledApp
Method signature
boolean isPreInstalledApp(Context context)
설명
제조사 사전 설치에 대한 부울 지표입니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
Context | context | 애플리케이션/액티비티 컨텍스트입니다. |
반환
boolean.
사용법 예시
isStopped
Method signature
boolean isStopped()
설명
SDK가 중지되었는지 확인합니다.
입력 인수
이 함수는 파라미터를 사용하지 않습니다.
반환
| 유형 | 설명 |
|---|---|
boolean | true 내부에서 호출되어야 하며, 그렇지 않은 경우 false 로 호출되어야 합니다. |
사용법 예시
logEvent
Method signature
void logEvent(Context context,
java.lang.String eventName,
java.util.Map<java.lang.String,java.lang.Object> eventValues)
설명
인앱 이벤트를 기록합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
Context | context | 애플리케이션/액티비티 컨텍스트입니다. |
String | eventName | 이벤트 이름 |
Map | eventValues | 이벤트 값입니다. |
반환
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 이벤트 파라미터를 사용하여 만듭니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
Context | context | 애플리케이션/액티비티 컨텍스트입니다. |
double | latitude | LATITUDE |
double | longitude | LONGITUDE |
반환
void
사용법 예시
logSession
Method signature
void logSession(Context ctx)
설명
앱이 백그라운드 유틸리티 앱인 경우, 액티비티의 onCreate()에서 이 API를 사용하여 세션을 수동으로 기록하고 전송할 수 있습니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
Context | ctx | 애플리케이션/액티비티 컨텍스트입니다. |
사용법 예시
public void logSession(Context context);
public void logSession(Context context)
반환
void
onPause
Method signature
void onPause(Context context)
설명
Cocos2dx 플랫폼의 경우에만 해당합니다.
Cocos2dx에는 고유의 applicationDidEnterBackground 이벤트가 있습니다.
따라서 'onPause'는 JNI에 의해 C++에서 호출될 것입니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
Context | context | 애플리케이션/액티비티 컨텍스트입니다. |
반환
void
사용법 예시
performOnAppAttribution
V6.3.2부터는 사용 중단
Method signature
void performOnAppAttribution(Context context,
java.net.URI link)
설명
딥링크를 수동으로 분석하는 데 사용합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
Context | context | 애플리케이션/액티비티 컨텍스트입니다. |
java.net.URI | link | 분석을 위한 링크입니다. |
반환
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가 등록된 경우 직접 딥링킹만 지원합니다.
딥링킹을 통해 시작할 수 있는 액티비티에 대해서는 Activity의 onResume에서 호출하는 것이 좋습니다.
일러두기: 이 API에서 처리되는 직접 딥링크는 서버에 리포트되지 않습니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
Intent | intent | |
Context | context | 애플리케이션/액티비티 컨텍스트입니다. |
반환
void
registerConversionListener
Method signature
void registerConversionListener(Context context,
AppsFlyerConversionListener conversionDataListener)
설명
전환 데이터 리스너를 등록합니다. 또한 init 를 사용하여 리스터를 등록할 수도 있습니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
Context | context | 애플리케이션/액티비티 컨텍스트입니다. |
AppsFlyerConversionListener | conversionDataListener | The 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
Method signature
void registerValidatorListener(Context context,
AppsFlyerInAppPurchaseValidatorListener validationListener)
설명
다음 validateAndLogInAppPurchase API에 대한 유효성 검사 리스터를 등록합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
Context | context | 애플리케이션/액티비티 컨텍스트입니다. |
AppsFlyerInAppPurchaseValidatorListener | validationListener | The AppsFlyerInAppPurchaseValidatorListener : 등록할 객체입니다. |
반환
void
사용법 예시
sendAdRevenue
Method signature
void sendAdRevenue(Context context,
java.util.Map<java.lang.String,java.lang.Object> eventValues)
설명
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
Context | context | 애플리케이션/액티비티 컨텍스트입니다. |
Map<String, Object> | validationListener |
반환
void
sendPushNotificationData
Method signature
void sendPushNotificationData(Activity activity)
설명
푸시 알림 캠페인에서 데이터를 측정하고 가져옵니다. 푸시 알림에서 실행되는 onCreate 메서드( Activity에 속한) 내부에서 이 메서드를 호출합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
Activity | activity | The Activity 은 알림을 통해 실행됩니다. |
반환
void.
사용법 예시
setAdditionalData
Method signature
void setAdditionalData(java.util.Map<java.lang.String,java.lang.Object> customData)
설명
이벤트의 페이로드에 커스텀 데이터를 추가하는 데 사용합니다. 로데이터 리포트에 나타납니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
HashMap | customData |
반환
void.
setAndroidIdData
Method signature
void setAndroidIdData(java.lang.String aAndroidId)
설명
안드로이드 버전이 안드로이드 KitKat(4.4) 이상이고 기기가 Google Play Services를 포함하고 있으면, 기본적으로 SDK가 IMEI 및 안드로이드 ID를 수집하지 않습니다. 이 API를 사용해 앱스플라이어에 안드로이드 ID를 발송합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
String | aAndroidId | 안드로이드 기기 ID |
반환
void
setAppId
Method signature
void setAppId(java.lang.String id)
설명
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
String | id | 안드로이드 앱 ID |
반환
void
setAppInviteOneLink
Method signature
void setAppInviteOneLink(java.lang.String oneLinkId)
설명
앱 추천 어트리뷰트에 사용해야 하는 원링크 ID를 설정합니다. 앱 추천에 대해 생성되는 링크는 이 원링크를 기본 링크로 사용할 것입니다. 앱 추천 어트리뷰션을 위한 원링크 설정하기를 참조하세요.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
String | oneLinkId | 앱스플라이어 대시보드에서 확보한 원링크 ID입니다. |
반환
void.
setCollectAndroidID
Method signature
void setCollectAndroidID(boolean isCollect)
설명
Android ID 수집에 동의. SDK가 안드로이드 ID를 수집하도록 합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
boolean | isCollect | 다음으로 설정 true 을 옵트인. |
반환
void.
setCollectIMEI
Method signature
void setCollectIMEI(boolean isCollect)
설명
IMEI 수집에 동의. SDK가 IMEI를 수집하도록 합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
boolean | isCollect | 다음으로 설정 true 을 옵트인. |
반환
void.
setCollectOaid
Method signature
void setCollectOaid(boolean isCollect)
설명
OAID ID 수집에서 옵트인/옵트아웃합니다. 기본적으로, SDK는 OAID를 수집을 시도합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
boolean | isCollect | 기본 값: true. 다음으로 설정 false 을 옵트인. |
반환
void.
setCurrencyCode
Method signature
void setCurrencyCode(java.lang.String currencyCode)
설명
인앱 구매에 대한 통화를 설정합니다. 통화 코드는 3문자 ISO 4217 코드여야 합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
String | currencyCode | 3 character ISO 4217 code. Defaults to "USD". |
반환
void.
setCustomerIdAndLogSession
Method signature
void setCustomerIdAndLogSession(java.lang.String id,
Context context)
설명
고객 사용자 ID를 설정하고 SDK를 시작하는 데 사용합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
String | id | 고객용 고객 ID입니다. |
String | context | 애플리케이션/액티비티 컨텍스트입니다. |
반환
void
setCustomerUserId
Method signature
void setCustomerUserId(java.lang.String id)
설명
자체 고객 ID를 설정하면 자체 고유 ID를 앱스플라이어의 고유 ID와 다른 기기의 ID와 연결하여 상호 참조할 수 있습니다. 이 ID는 귀사 내부 ID와 상호 참조할 수 있도록 로데이터 보고서와 포스트백 API에서 찾을 수 있습니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
String | id | 고객용 고객 ID입니다. |
반환
void.
setDebugLog
Method signature
void setDebugLog(boolean shouldEnable)
설명
앱스플라이어 SDK를 위해 디버깅 로그를 활성화합니다. 개발 환경에서만 true로 설정해야 합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
boolean | shouldEnable | 기본 값: false. |
반환
void.
사용법 예시
setDisableAdvertisingIdentifiers
V6.3.2에 추가됨
Method signature
void setDisableAdvertisingIdentifiers(boolean disable);
설명
SDK를 통한 다양한 광고 ID의 수집을 비활성화합니다. 여기에는 Google 광고 ID(GAID), OAID및 Amazon 광고 ID(AAID)가 포함됩니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
boolean | disable | 기본 값: false. |
반환
void.
setDisableNetworkData
V6.7.0에 추가됨
Method signature
void setDisableNetworkData(boolean disable);
설명
기기에서 네트워크 사업자 이름(이동통신사) 및 sim 사업자 이름 수집을 선택 해제하는 데 사용합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
boolean | disable | 기본 값: false. |
반환
void.
setExtension
Method signature
void setExtension(java.lang.String extension)
설명
SDK 플러그인 및 확장이 이 필드를 설정합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
String | extension | 확장자 이름입니다. |
반환
void.
setHost
Method signature
void setHost(java.lang.String hostPrefixName,
java.lang.String hostName)
설명
사용자정의 호스트를 설정합니다. 참고: SDK V6.10부터 호스트가 비어 있거나 널(NULL) 값으로 전송되면 API 호출이 무시됩니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
String | hostPrefixName | 호스트 접두사를 반환합니다. |
String | hostName | 호스트 이름입니다. |
반환
void.
setImeiData
Method signature
void setImeiData(java.lang.String aImei)
설명
OS 버전이 KitKat(4.4) 이상이고 기기가 Google Play Services를 포함하고 있으면, 기본적으로 SDK가 IMEI 및 안드로이드 ID를 수집하지 않습니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
String | aImei | 기기 IMEI |
반환
void.
setIsUpdate
Method signature
void setIsUpdate(boolean isUpdate)
설명
애플리케이션이 업데이트되었음을 수동으로 설정합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
boolean | isUpdate |
반환
void.
setLogLevel
Method signature
void setLogLevel(AFLogger.LogLevel logLevel)
설명
SDK 로그 레벨을 설정합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
String | logLevel | 로그 레벨입니다. |
반환
void.
setMinTimeBetweenSessions
Method signature
void setMinTimeBetweenSessions(int seconds)
설명
세션 간 최소 필요 시간을 맞춤 설정합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
int | seconds | 두 개의 개별 세션으로 계수하기 위해 두 개의 앱 실행 사이에 경과해야 하는 최소 시간을 설정합니다. 설정하지 않으면 세션 간의 최소 시간 기본값은 5초입니다. |
반환
void.
setOaidData
Method signature
void setOaidData(java.lang.String oaid)
설명
기본적으로, SDK는 OAID를 수집하지 않습니다. 이 API를 사용해 앱스플라이어에 OAID를 발송합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
String | oaid | 기기 OAID입니다. |
반환
void.
setOneLinkCustomDomain
Method signature
void setOneLinkCustomDomain(java.lang.String... domains)
설명
앱스플라이어 SDK가 숨겨진 (짧은 링크 ID로 디코딩된) 어트리뷰션 파라미터를 성공적으로 분석하기 위해서는 앱스플라이어 대시보드에서 브랜드 도메인으로 구성된 모든 도메인을 이 메서드에 제공해야 합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
String... | domains | SDK가 브랜드 도메인으로 취급해야 하는 도메인의 배열입니다. SDK는 이를 원링크로 분석하려고 합니다. |
반환
void.
setOutOfStore
Method signature
void setOutOfStore(java.lang.String sourceName)
설명
앱이 다운로드 될, 구글 플레이 외 대체 앱스토어를 지정합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
String | sourceName | 써드파티 앱 저장소입니다. |
반환
void.
사용법 예시
AppsFlyerLib.getInstance().setOutOfStore("baidu");
AppsFlyerLib.getInstance().setOutOfStore("baidu")
setPartnerData
Method signature
void setPartnerData(@NonNull String partnerId, Map<String, Object> data);
설명
파트너 연동 용도로 사용자정의 데이터를 전송할 수 있도록 합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
String | partnerId | 파트너의 ID(일반적으로 "_int" 접미사가 붙음). |
Map | data | 고객 데이터, 특정 파트너와의 연동 구성에 따라 다릅니다. |
반환
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으로 암호화된 문자열로 전송됩니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
String | phoneNumber |
반환
void.
setPreinstallAttribution
Method signature
void setPreinstallAttribution(java.lang.String mediaSource,
java.lang.String campaign,
java.lang.String siteId)
설명
사전 설치가 어트리뷰션된 제조사나 미디어소스를 지칭합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
String | mediaSource | 사전 설치 어트리뷰션에 대한 제조사 또는 미디어소스 이름입니다. |
String | campaign | 사전 설치 어트리뷰션 캠페인 이름입니다. |
String | siteId | 사전 설치 어트리뷰션의 사이트 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)
설명
SDK가 데이터 공유에서 제외해야 하는 파트너를 설정할 수 있습니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
String... | partners | 제외하려는 하나 이상의 파트너 식별자입니다. 문자/숫자 및 밑줄만 포함해야 합니다. 최대 파트너 ID 길이: 45 |
사용법 예시
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)
설명
이벤트가 지정된 앱스플라이어 파트너로 전파되지 않도록 합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
String... | partners | 하나 이상의 파트너 식별자입니다. 문자/숫자 및 밑줄만 포함해야 합니다. 최대 길이: 45 |
반환
void
setSharingFilterForAllPartners
V6.4에서 사용 중단
Method signature
void setSharingFilterForAllPartners()
설명
이벤트가 모든 앱스플라이어 파트너로 전파되지 않도록 합니다. 다음을 덮어씁니다: setSharingFilter.
입력 인수
이 함수는 파라미터를 사용하지 않습니다.
반환
void
setUserEmails
Method signature
void setUserEmails(AppsFlyerProperties.EmailsCryptType cryptMethod,
java.lang.String... emails)
설명
사용자 이메일을 설정하고 암호화합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
AppsFlyerProperties.EmailsCryptType | cryptMethod | 암호화 메서드는 다음과 같습니다.
|
String... | emails | 하나 이상의 사용자 이메일입니다. |
반환
void.
start
Method signature
void start(Context context,
java.lang.String key,
AppsFlyerRequestListener listener)
설명
SDK를 시작합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
Context | context | 애플리케이션에서 호출하는 경우 애플리케이션 콘텍스트 onCreate 메서드, 액티비티이후 실행되는 경우 액티비티 콘텍스트 onResume 호출합니다. |
String | key | 앱스플라이어 dev key |
AppsFlyerRequestListener | listener | (선택사항) 요청 상태를 가져오기 위한 리스너입니다. |
반환
void.
사용법 예시
예제 구현은 SDK 연동하기를 참조하세요.
stop
Method signature
void stop(boolean shouldStop,
Context context)
설명
이 API를 호출한 후에는 당사 SDK가 더 이상 서버와 통신하지 않고 작동을 중지합니다.
사용자 옵트인/옵트아웃을 구현할 때 유용합니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
boolean | shouldStop | 로깅을 중지해야 할 때 사용합니다. |
Context | context | 애플리케이션/액티비티 컨텍스트입니다. |
반환
void.
subscribeForDeepLink
Method signature
void subscribeForDeepLink(DeepLinkListener deepLinkListener,
long timeout)
설명
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
DeepLinkListener | deepLinkListener | |
long | timeout | 선택사항. 밀리초 단위 |
반환
void
unregisterConversionListener
Method signature
void unregisterConversionListener()
설명
이전에 등록된 다음 메서드를 등록 해제합니다: AppsFlyerConversionListener.
입력 인수
이 함수는 파라미터를 사용하지 않습니다.
반환
void
updateServerUninstallToken
Method signature
void updateServerUninstallToken(Context context,
java.lang.String token)
설명
Firebase를 앱 삭제 측정 외 목적으로도 사용하는 개발자들을 위한 것입니다. 더 자세한 내용은 앱 삭제 측정하기를 참조하십시오.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
Context | context | 애플리케이션/액티비티 컨텍스트입니다. |
String | token | Firebase 기기 토큰입니다. |
반환
void
사용법 예시
AppsFlyerlib.getInstance().updateServerUninstallToken(getApplicationContext(), <TOKEN>);
AppsFlyerlib.getInstance().updateServerUninstallToken(getApplicationContext(), <TOKEN>);
validateAndLogInAppPurchase
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 유효성 검증에 성공하면 관련 값이 있는 이벤트가 자동으로 기록됩니다.
구매 검증에 대한 자세한 안내를 참조하세요.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
Context | context | 애플리케이션/액티비티 컨텍스트입니다. |
String | publicKey | Google Play Console에서 얻은 라이선스 키 |
String | signature | data.INAPP_DATA_SIGNATURE from onActivityResult(int requestCode, int resultCode, Intent data) |
String | purchaseData | data.INAPP_PURCHASE_DATA from onActivityResult(int requestCode, int resultCode, Intent data) |
String | price | 구매 가격입니다. skuDetails.getStringArrayList ("DETAILS_LIST")에서 파생되어야 합니다. |
String | currency | 구매 통화입니다. skuDetails.getStringArrayList ("DETAILS_LIST")에서 파생되어야 합니다. |
Map<String, String> | additionalParameters | 구매 시 기록되는 자유형 파라미터입니다(검증된 경우). |
반환
void.
waitForCustomerUserId
Method signature
void waitForCustomerUserId(boolean wait)
설명
이 방법은 customerUserID 가 제공될 때까지 SDK 초기화를 지연합니다.
모든 인앱 이벤트 및 기타 SDK API 호출은 customerUserID 가 제공되고 기록될 때까지 무시됩니다.
입력 인수
| 유형 | 이름 | 설명 |
|---|---|---|
boolean | wait |
반환
void.
사용법 예시
AppsFlyerLib.getInstance().waitForCustomerUserId(true);
AppsFlyerLib.getInstance().waitForCustomerUserId(true);
최신 데이터 7일 전