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)
설명
(원링크 없이) 앱을 이용하여 딥링킹을 하는 앱 소유주가 앱과 관련된 도메인을 통해 앱 세션을 어트리뷰션할 수 있도록 합니다.
다음을 호출하기 전에 이 메서드를 호출하십시오:
start
다음에 다음 파라미터를 제공해야 합니다: parameters
Map
:
pid
is_retargeting
은 다음으로 설정되어야 합니다.true
입력 인수
유형 | 이름 | 설명 |
---|---|---|
String | contains | 딥링크 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를 초기화하기 전에 먼저 호출해야 합니다.
입력 인수
유형 | 이름 | 설명 |
---|---|---|
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
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).
입력 인수
유형 | 이름 | 설명 |
---|---|---|
boolean | flag | A 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로 기록됩니다.
입력 인수
유형 | 이름 | 설명 |
---|---|---|
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 로 호출되어야 합니다. |
사용법 예시
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.
입력 파라미터
이름 | 유형 | 설명 |
---|---|---|
adRevenueData | AFAdRevenueData | An object that encapsulates all the mandatory parameters of the adRevenue event. The object is passed to the logAdRevenue method. |
additionalParameters | Map<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. |
mediationNetwork | MediationNetwork | The mediation network enum. |
currencyIso4217Code | 문자열 | The ad revenue event currency is a String validated against currencyIso4217Code |
revenue | Double | The 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)
설명
인앱 이벤트를 기록합니다.
입력 인수
유형 | 이름 | 설명 |
---|---|---|
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에서 처리되는 직접 딥링크는 서버에 리포트되지 않습니다.
사용법 예시
@Override
protected void onResume() {
super.onResume();
AppsFlyerLib appsflyer = AppsFlyerLib.getInstance();
appsflyer.performOnDeepLinking(getIntent(),this);
}
입력 인수
유형 | 이름 | 설명 |
---|---|---|
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 (LEGACY)
Method signature
void registerValidatorListener(Context context,
AppsFlyerInAppPurchaseValidatorListener validationListener)
설명
다음 validateAndLogInAppPurchase
API에 대한 유효성 검사 리스터를 등록합니다.
입력 인수
유형 | 이름 | 설명 |
---|---|---|
Context | context | 애플리케이션/액티비티 컨텍스트입니다. |
AppsFlyerInAppPurchaseValidatorListener | validationListener | The 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)
설명
입력 인수
유형 | 이름 | 설명 |
---|---|---|
Context | context | 애플리케이션/액티비티 컨텍스트입니다. |
Map<String, Object> | validationListener |
반환
void
sendPushNotificationData
Method signature
void sendPushNotificationData(Activity activity)
설명
푸시 알림 캠페인에서 데이터를 측정하고 가져옵니다. 푸시 알림에서 실행되는 onCreate
메서드( Activity
에 속한) 내부에서 이 메서드를 호출합니다.
입력 인수
유형 | 이름 | 설명 |
---|---|---|
Activity | activity | The 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)
설명
이벤트의 페이로드에 커스텀 데이터를 추가하는 데 사용합니다. 로데이터 리포트에 나타납니다.
입력 인수
유형 | 이름 | 설명 |
---|---|---|
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
.
setConsentData
Method signature
AppsFlyerLib.getInstance().setConsentData(AppsFlyerConsent afConsent)
설명
Transfers consent data to the SDK.
입력 인수
유형 | 이름 | 설명 |
---|---|---|
AppsFlyerConsent | afConsent | An object containing user consent data |
setCurrencyCode
Method signature
void setCurrencyCode(java.lang.String currencyCode)
설명
인앱 구매에 대한 통화를 설정합니다. 통화 코드는 3문자 ISO 4217 코드여야 합니다.
입력 인수
유형 | 이름 | 설명 |
---|---|---|
String | currencyCode | 3 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를 시작하는 데 사용합니다.
입력 인수
유형 | 이름 | 설명 |
---|---|---|
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)
This function replaces the deprecated setSharingFilter
and setSharingFilterForAllPartners
설명
SDK가 데이터 공유에서 제외해야 하는 파트너를 설정할 수 있습니다.
입력 인수
유형 | 이름 | 설명 |
---|---|---|
String... | partners | 제외하려는 하나 이상의 파트너 식별자입니다. 문자/숫자 및 밑줄만 포함해야 합니다. 최대 파트너 ID 길이: 45 |
일러두기:
필요한 파트너 ID를 확인하려면:
- 모든 활성 연동 목록에 대해 활성 연동 API 가져오기를 실행합니다.
- 메서드(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.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가 더 이상 서버와 통신하지 않고 작동을 중지합니다.
사용자 옵트인/옵트아웃을 구현할 때 유용합니다.
SDK 재시작
이후
stop(true)
이 호출된 후에stop(false)
을 호출한 다음 다음을 호출해야 합니다:start()
입력 인수
유형 | 이름 | 설명 |
---|---|---|
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
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 * | AFPurchaseDetails | An object that encapsulates all data related to the purchase provided to the validateAndLogInAppPurchase method. |
additionalParameters | Map<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
이름 | 유형 | 설명 |
---|---|---|
purchaseType | AFPurchaseType | Field 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
유효성 검증에 성공하면 관련 값이 있는 이벤트가 자동으로 기록됩니다.
구매 검증에 대한 자세한 안내를 참조하세요.
입력 인수
유형 | 이름 | 설명 |
---|---|---|
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);
최신 데이터 약 2개월 전