요약: 앱스플라이어 SDK에 포함된 클래스 및 메서드에 대한 기술 설명.
관련 자료
앱에 Unity 플러그인을 연동하는 방법에 대해 완전히 이해하려면 다음 문서를 읽어보십시오.
- Unity 플러그인 V6 연동 가이드 - 개요
- Unity 플러그인 V6 연동 가이드 - 기본 SDK 연동
- Unity 플러그인 V6 연동 가이드 - 추가 SDK 연동
- Unity 플러그인 V6 연동 가이드—API 참조(본 기사)
안드로이드 및 iOS API
initSDK
설명 |
dev 키와 앱 ID로 플러그인을 초기화합니다. dev 키는 모든 앱에 필요합니다. 앱 ID는 iOS에서만 필요합니다. 앱이 안드로이드 전용인 경우 앱 ID에 null을 전달합니다. 게임 개체에는 IAppsFlyerConversionData 인터페이스가 포함되어 있습니다. |
Method signature |
|
예 |
|
startSDK
설명 |
이 API가 호출되면 SDK가 시작되고, 세션이 즉시 전송되며 모든 배경(background)-전경(foreground) 전환이 발생하면 세션이 기록됩니다. |
Method signature |
|
예 |
|
sendEvent
설명 |
인앱이벤트 기록은 sendEvent를 이벤트명과 값 파라미터와 함께 호출하여 수행됩니다. |
Method signature |
|
예 |
|
stopSDK
설명 |
몇몇 심각한 경우에는 규제 및 개인 정보 보호 준수 요건을 위해서 모든 SDK 기능을 중지해야 하는 경우도 있을 수 있습니다. 이를 위해서는 stopSDK API를 사용합니다. 이 API가 호출되면, SDK는 앱스플라이어 서버와 더 이상 통신하지 않고 기능이 중지될 것입니다. |
Method signature |
|
예 |
|
isSDKStopped
설명 |
stopSDK(부울 값) API를 true로 설정했습니다. |
Method signature |
bool isSDKStopped() |
예 |
|
getSdkVersion
설명 |
앱스플라이어 SDK 버전 가져오기 |
Method signature |
|
예 |
|
setIsDebug
설명 |
디버그 로그 활성화 |
Method signature |
|
예 |
|
setCustomerUserID
설명 |
고객 사용자 ID를 설정합니다. |
Method signature |
|
예 |
|
setAppInviteOneLink
설명 |
사용자 초대 캠페인를 위한 커스텀 어트리뷰션 링크용 원링크 템플릿 ID를 설정합니다. |
Method signature |
|
예 |
|
setAdditionalData
설명 |
외부 파트너 플랫폼으로 보낼 부가 정보를 추가합니다. |
Method signature |
|
예 |
|
setResolveDeepLinkURLs
설명 |
클릭 도메인에서 원링크를 분석합니다. 자세한 내용은 래핑된 딥링크 URL 분석하기 부분을 참고하십시오. |
Method signature |
|
예 |
|
setOneLinkCustomDomain
설명 |
광고주는 이 메서드를 사용하여 무의미한 원링크 도메인을 설정할 수 있습니다. |
Method signature |
|
예 |
|
setcurrencyCode
설명 |
수익 값이 있는 이벤트에 사용하십시오. ISO 통화 코드로 설정 가능합니다. |
Method signature |
|
예 |
|
recordLocation
설명 |
수작업으로 사용자 위치를 기록합니다. |
Method signature |
|
예 |
|
anonymizeUser
설명 |
초기화하는 동안 사용하면, 사용자의 인스톨, 이벤트, 세션을 명시적으로 익명 처리할 수 있습니다. 익명 처리를 중지하려면 anonymizeUser를 다시 호출하여 false로 설정하십시오. |
Method signature |
|
예 |
|
getAppsFlyerId
설명 |
신규 인스톨에 대한 앱스플라이어 고유 ID를 얻는 방법. |
Method signature |
|
예 |
|
setMinTimeBetweenSessions
설명 |
기본 설정으로는, 2개 앱을 실행할 때의 간격이 적어도 5초 이상이 되어야 두 개의 별도 세션으로 집계합니다. 세션 사이의 최소 필요 시간으로 사용자정의 값을 설정합니다. |
Method signature |
|
예 |
|
setUserEmails
설명 |
사용자 이메일을 설정하고 암호화합니다. |
Method signature |
|
예 |
|
setHost
설명 |
사용자정의 호스트를 설정합니다. |
Method signature |
|
예 |
|
getConversionData
설명 |
SDK 수준에서 직접 신규 인스톨마다 실시간으로 사용자 어트리뷰션 데이터에 액세스할 수 있도록 전환 데이터 수신기를 등록합니다. 이렇게 하여 사용자에게 맞춤형 콘텐츠를 제공하거나 앱 내부의 특정 활동을 전송하여 앱에 대한 사용자의 인게이지먼트를 현저하게 높일 수 있습니다. |
Method signature |
|
예 |
|
attributeAndOpenStore
설명 |
클릭을 어트리뷰트하고 앱 스토어의 앱 페이지를 실행합니다. |
Method signature |
|
예 |
|
recordCrossPromoteImpression
설명 |
크로스 프로모션 노출 어트리뷰션은 다음 API 호출을 사용합니다. 크로스 프로모션 대상 앱 ID가 앱스플라이어 대시보드에 나타납니다. 그러므로 꼭 프로모션할 앱의 ID를 사용하십시오. |
Method signature |
|
예 |
|
generateUserInviteLink
설명 |
앱 추천 링크는 LinkGenerator 클래스로 URL을 빌드합니다. 이 클래스 내 여러 가지 setter 메서드에 따라 링크 클릭 시 정보가 수집됩니다. |
Method signature |
|
예 |
|
onAppOpenAttribution
설명 |
앱이 딥링크를 통해 열렸을 때 딥링크 정보를 가져옵니다. |
Method signature |
|
예 |
|
onAppOpenAttributionFailure
설명 |
딥링크 정보를 가져올 때 발생하는 오류를 가져옵니다. |
Method signature |
|
예 |
|
onConversionDataSuccess
설명 |
전환 데이터를 가져오는데 사용되는 메서드입니다. 디퍼드 딥링킹에 활용하기에 유용합니다. 더 알아보기.
|
Method signature |
|
예 |
|
onConversionDataFail
설명 |
인스톨에서 전환 데이터를 가져 오지 못한 경우 오류를 처리합니다. |
Method signature |
|
예 |
|
onInviteLinkGenerated
설명 |
원링크 URL을 생성하기 위한 콜백 성공. |
Method signature |
|
예 |
|
onInviteLinkGeneratedFailure
설명 |
원링크 URL을 생성하기 위한 콜백 실패. |
Method signature |
|
예 |
|
didFinishValidateReceipt
설명 |
validateAndSendInAppPurchase API에 대한 콜백 성공. 안드로이드의 경우: 콜백은 "유효성 검증 성공"을 반환합니다. |
Method signature |
|
예 |
|
didFinishValidateReceiptWithError
설명 |
수신 확인을 위한 콜백 오류. |
Method signature |
|
예 |
|
setPhoneNumber
설명 |
사용자 전화번호를 설정하는 데 사용됩니다. |
Method signature |
|
예 |
|
setSharingFilterForAllPartners(더 이상 사용되지 않음)
설명 |
광고주가 모든 광고 네트워크/연동 파트너에게 데이터를 보내지 않도록 할 때 사용합니다. 더 알아보기 |
Method signature |
|
예 |
|
setSharingFilter(더 이상 사용되지 않음)
설명 |
광고주가 이 메서드를 이용하여 일부(하나 혹은 복수의) 애드 네트워크/연동 파트너를 데이터 공유 대상에서 제외되도록 설정할 수 있습니다. 더 알아보기 |
Method signature |
|
예 |
|
setSharingFilterForPartners
설명 |
광고주가 이 메서드를 이용하여 일부(하나 혹은 복수의) 애드 네트워크/연동 파트너를 데이터 공유 대상에서 제외되도록 설정할 수 있습니다. |
Method signature |
|
예 |
|
안드로이드 API
updateServerUninstallToken
설명 |
앱 제거 측정을 위해 Firebase 기기 토큰을 수작업으로 전달합니다. |
Method signature |
|
예 |
|
setImeiData
설명 |
IMEI를 앱스플라이어에 명시적으로 전송. |
Method signature |
|
예 |
|
setAndroidIdData
설명 |
안드로이드 ID를 앱스플라이어에 명시적으로 전송. |
Method signature |
|
예 |
|
waitForCustomerUserId
설명 |
이 기능은 고객 사용자 ID를 얻기 전까지 SDK가 동작을 시작할 수 없도록 합니다. |
Method signature |
|
예 |
|
setCustomerIdAndStartSDK
설명 |
메서드를 호출하여 SDK에 Customer User ID를 부여하고, SDK가 정상적인 활동을 시작하도록 합니다. |
Method signature |
|
예 |
|
getOutOfStore
설명 |
현재 AF_STORE 값을 가져옵니다. |
Method signature |
|
예 |
|
setOutOfStore
설명 |
수작업으로 AF_STORE 값을 설정합니다. |
Method signature |
|
예 |
|
setCollectAndroidID
설명 |
안드로이드 ID 수집 거부. 앱이 Google Play 서비스를 사용하지 않는 경우 안드로이드 ID는 SDK로 수집합니다. 하지만, Google Play 서비스를 사용하는 앱은 안드로이드 ID를 수집하지 말아야 합니다. 이는 Google Play 정책의 위반입니다 |
Method signature |
|
예 |
|
setCollectIMEI
설명 |
IMEI 수집 거부. 앱이 Google Play 서비스를 사용하지 않는 경우 기기 IMEI는 플러그인으로 수집합니다. 하지만, Google Play 서비스를 사용하는 앱은 IMEI를 수집하지 말아야 합니다. 이는 Google Play 정책 위반입니다. |
Method signature |
|
예 |
|
setIsUpdate
설명 |
애플리케이션이 업데이트되었음을 수동으로 설정합니다. |
Method signature |
|
예 |
|
setPreinstallAttribution
설명 |
사전 인스톨이 어트리뷰트되는 제조업체 또는 미디어소스를 지정합니다. |
Method signature |
|
예 |
|
isPreInstalledApp
설명 |
제조업체에 의한 사전 인스톨에 필요한 부울 표시자. |
Method signature |
|
예 |
|
getAttributionId
설명 |
존재하는 경우 페이스북 어트리뷰션 ID를 가져옵니다. |
Method signature |
|
예 |
|
handlePushNotifications
설명 |
푸시 알림이 기록됩니다. |
Method signature |
|
예 |
|
validateAndSendInAppPurchase
설명 |
인앱 구매에 대한 서버 확인을 위한 API. 유효성 검증에 성공하면 관련 값을 가진 af_purchase 이벤트가 자동으로 전송됩니다. |
Method signature |
|
예 |
|
iOS API
setShouldCollectDeviceName
설명 |
현재 기기 이름(예: "내 iPhone")을 수집하려면 이 플래그를 true로 설정합니다. 기본값은 "false"입니다. |
Method signature |
|
예 |
|
setDisableCollectIAd
설명 |
Apple Search Ads 어트리뷰션 거부. |
Method signature |
|
예 |
|
setUseReceiptValidationSandbox
설명 |
Apple 환경(프로덕션 또는 샌드박스)에서 인앱 구매 영수증 유효성 검사를 수행합니다. 기본값은 "false"입니다. |
Method signature |
|
예 |
|
setUseUninstallSandbox
설명 |
Apple 환경(프로덕션 또는 샌드박스)에서앱 제거 기능을 테스트하도록 이 플래그를 설정합니다. 기본값은 "false"입니다. |
Method signature |
|
예 |
|
validateAndSendInAppPurchase
설명 |
인앱 구매를 전송하고 유효성을 검증하려면 processPurchase 메서드에서 이 메서드를 호출합니다. |
Method signature |
|
예 |
|
registerUninstall
설명 |
원격 알림에 등록하여 앱스플라이어에 푸시 기기 토큰을 제공합니다. |
Method signature |
|
예 |
|
handleOpenUrl
설명 |
딥링킹을 수작업으로 기록하는 데 사용됩니다. |
Method signature |
|
예 |
|
onOpenStoreLinkGenerated
설명 |
Storekit 컴포넌트를 사용하여 해당 앱에 맞는 앱스토어를 열 수 있습니다. 더 알아보기. |
Method signature |
|
예 |
|
disableSKAdNetwork
설명 |
SKAdNetwork 어트리뷰션을 비활성화하도록 합니다. "true"로 설정하여 비활성화하십시오. |
Method signature |
|
예 |
|
waitForATTUserAuthorizationWithTimeoutInterval
설명 |
앱 사용자나 기기 정보(예: IDFA)를 기록하여 앱 관련 데이터로 활용하기 전, 팝업으로 사용자 승인을 요청할 때 사용됩니다. 사용자가 허가하면, IDFA가 SDK에 전달됩니다. 시간 제한 길이는 사용자가 IDFA 수집 허용을 선택할 때까지의 제한된 시간입니다. 타이머가 만료된 후에, IDFA는 수집되지 않습니다. |
Method signature |
|
예 |
|