개요
“개요” 섹션Capacitor 앱에 AppsFlyer 어트리뷰션, 분석, 디퍼드 딥링크 및 OneLink 지원을 추가하세요
다음으로 시작하세요 initSDK() 그리고 아래에 나열된 다른 핵심 메서드도 살펴보세요.
플랫폼 지원
“플랫폼 지원” 섹션| 플랫폼 | 지원 | 참고 사항 |
|---|---|---|
| iOS | 지원 | 네이티브 |
| Android | 지원 | 네이티브 |
| 웹 | 아니요 | Capacitor.getPlatform()으로 보호하세요 |
핵심 기능
“핵심 기능” 섹션initSDK- 이 메서드로 AppsFlyer SDK를 초기화하고 시작하세요. API 호출은 앱이 실행되자마자 해야 합니다.startSDK- 수동 시작 모드에서만 AppsFlyer SDK를 시작하려면 이 메서드를 사용하세요.logEvent- 인앱 이벤트를 로깅합니다.setCustomerUserId- 자체 고객 ID를 설정하면 사용자의 고유 ID를 AppsFlyer의 고유 ID 및 다른 기기의 ID와 교차 참조할 수 있습니다. 이 ID는 raw-data 보고서와 Postback API에서 제공되어 내부 ID와의 교차 참조가 가능합니다.
공개 API
“Public API” 섹션| 메서드 | 설명 |
|---|---|
addListener('conversion_callback', listener) | 다음 항목을 포함한 전환 콜백을 수신합니다: onConversionDataSuccess 및 onConversionDataFail, 그중 OnConversionDataResult payloads. |
addListener('oaoa_callback', listener) | 다음 항목을 포함한 앱 오픈 어트리뷰션 콜백을 수신합니다: onAppOpenAttribution 및 onAttributionFailure, 그중 OnAppOpenAttribution payloads. |
addListener('udl_callback', listener) | 통합 딥링크 콜백을 수신하려면 다음을 사용하세요: OnDeepLink payloads. |
initSDK | AppsFlyer SDK를 초기화하고 시작하려면 이 메서드를 사용하세요. 이 API은 앱이 실행되자마자 호출되어야 합니다. |
startSDK | 수동 시작 모드에서만 AppsFlyer SDK를 시작하려면 이 메서드를 사용하세요. |
logEvent | 인앱 이벤트를 로깅합니다. |
setCustomerUserId | 자체 고객 ID를 설정하면 자체 고유 ID를 AppsFlyer의 고유 ID 및 다른 기기의 ID와 교차 참조할 수 있습니다. 이 ID는 raw-data 보고서와 Postback API에서 내부 ID와 교차 참조할 수 있도록 제공됩니다. |
setCurrencyCode | 인앱 결제에 사용되는 통화를 설정합니다. ISO 4217 기준의 3자리 code를 입력하세요. |
updateServerUninstallToken | 다른 플러그인이 수집한 Android의 GCM/FCM 토큰 또는 iOS의 APNs 토큰을 전달합니다. 앱 삭제 측정 토큰을 AppsFlyer로 전달할 때 사용하세요. |
setAppInviteOneLink | 초대 어트리뷰션의 기본 링크로 사용될 OneLink ID를 설정합니다. |
setOneLinkCustomDomain | 브랜드 OneLink 도메인을 등록하여 AppsFlyer가 단축 링크에 숨겨진 어트리뷰션 파라미터를 해석할 수 있도록 합니다. |
appendParametersToDeepLinkingURL | OneLink 없이 App Links 딥링크의 어트리뷰션을 활성화합니다. 이 메서드를 호출하기 전에 startSDK(). 최소한 다음을 포함해야 합니다: pid 및 is_retargeting=true 를 parameters map에 포함하세요. |
setResolveDeepLinkURLs | AppsFlyer OneLink이 다른 Universal Link로 감싸져 있는 경우에 사용합니다. 이를 통해 SDK가 감싸진 URL을 해석하여 딥 링크가 정상적으로 작동하도록 합니다. |
addPushNotificationDeepLinkPath | SDK가 푸시 알림 페이로드에서 딥 링크 값을 추출하는 방식을 설정합니다. |
setSharingFilter | 이벤트를 지정된 AppsFlyer 파트너에게 전달하지 않도록 차단합니다. |
setSharingFilterForAllPartners | 이벤트를 모든 AppsFlyer 파트너에게 전달하지 않도록 차단합니다. setSharingFilter 설정을 덮어씁니다. |
setSharingFilterForPartners | 이벤트를 지정된 AppsFlyer 파트너에게 전달하지 않도록 차단합니다. |
setAdditionalData | AppsFlyer로 전송할 추가 키-값 데이터를 설정합니다. |
getAppsFlyerUID | AppsFlyer의 고유 디바이스 ID(앱을 새로 설치할 때마다 생성됨)를 가져옵니다. |
anonymizeUser | AppsFlyer 분석에서 사용자가 수신 거부(Opt-Out)하도록 설정합니다(사용자 데이터 익명화). |
stop | 이 API가 호출되면, SDK은 더 이상 서버와 통신하지 않으며 작동을 중단합니다. 사용자 동의/거부(opt-in/opt-out) 기능을 구현할 때 유용합니다. |
disableSKAdNetwork | SKAdNetwork를 옵트아웃합니다. |
disableAdvertisingIdentifier | SDK를 통한 다양한 광고 ID 수집을 비활성화합니다. 여기에는 Apple IDFA(Identity for Advertisers), Google GAID(Google Advertising ID), OAID, Amazon AAID(Amazon Advertising ID)가 포함됩니다. |
disableCollectASA | Apple Search Ads 어트리뷰션을 옵트아웃합니다. |
setHost | 커스텀 호스트를 설정합니다. |
generateInviteLink | 기존 사용자가 친구나 연락처를 앱의 신규 사용자로 초대할 수 있도록 허용합니다. |
validateAndLogInAppPurchaseAndroid | 인앱 결제 서버 검증을 위한 API입니다. 검증에 성공하면 관련 값이 포함된 af_purchase 이벤트가 자동으로 기록됩니다. |
validateAndLogInAppPurchaseIos | 현재 동작 방식은 소스 정의를 참조하세요. |
getSdkVersion | 앱에서 사용 중인 AppsFlyer SDK 버전을 가져옵니다. |
enableFacebookDeferredApplinks | Facebook Deferred AppLinks 수집을 활성화합니다. 대상/클라이언트 기기에 Facebook SDK 및 Facebook 앱이 설치되어 있어야 합니다. 정상 작동을 위해 AppsFlyer SDK를 초기화하기 전에 이 API를 호출해야 합니다. |
sendPushNotificationData | 푸시 알림 캠페인의 데이터를 측정하고 가져옵니다. |
setCurrentDeviceLanguage | 기기 언어를 설정합니다. 데이터는 Raw Data Reports에 표시됩니다. |
logCrossPromoteImpression | 교차 프로모션 캠페인의 일부로 impression을 로그로 기록합니다. AppsFlyer dashboard에 표시된 그대로 프로모션 앱 ID를 사용하세요. |
setUserEmails | 사용자 이메일을 설정하고 암호화합니다. |
logLocation | 사용자의 위치를 수동으로 기록합니다. |
setPhoneNumber | SHA-256으로 암호화된 문자열로 전송됩니다. |
setPartnerData | 파트너 연동을 위한 커스텀 데이터를 전송할 수 있습니다. |
logInvite | 사용자 초대 인앱 이벤트(af_invite)를 기록할 때 사용합니다. |
setDisableNetworkData | 기기에서 네트워크 사업자(carrier) 및 SIM 사업자 이름을 수집하지 않도록 설정할 때 사용합니다. |
enableTCFDataCollection | CMP를 사용하는 사용자의 동의 데이터 자동 수집 여부를 설정합니다. 플래그 값은 앱 세션 간에 유지됩니다. |
setConsentData | 사용자 동의 데이터를 수동으로 설정할 때 사용합니다. 앱이 TCF v2.2 호환 CMP를 사용하지 않는 경우, 다음 메서드를 사용하여 SDK에 동의 데이터를 직접 전달하세요. |
logAdRevenue | 광고 수익을 어트리뷰션함으로써 앱 소유자는 사용자 LTV와 캠페인 ROI를 완벽하게 파악할 수 있습니다. 광고 수익은 앱 내 보상형 동영상, 오퍼월, 전면 광고 및 배너를 통해 발생합니다. 이 메서드를 사용하여 광고 수익을 기록할 수 있습니다. |
setConsentDataV2 | 사용자 동의 데이터를 수동으로 설정할 때 사용합니다. 앱이 TCF v2.2 호환 CMP를 사용하지 않는 경우, 다음 메서드를 사용하여 SDK에 동의 데이터를 직접 전달하세요. |
isSDKStarted | 현재 세션에서 AppsFlyer SDK이 이미 시작되었는지 확인하는 데 사용합니다. |
isSDKStopped | 현재 AppsFlyer SDK이 중지된 상태인지 확인하는 데 사용합니다. |
disableAppSetId | AppSet ID 수집을 비활성화합니다. SDK 초기화 전에 호출하면 App Set ID가 수집되지 않습니다. 초기화 후에 호출하면 App Set ID가 수집되지만 요청 페이로드에는 포함되지 않습니다. Android 전용입니다. |
validateAndLogInAppPurchaseV2 | 인앱 결제 V2 서버 검증을 위한 API입니다. 검증에 성공하면 관련 값이 포함된 af_purchase 이벤트가 자동으로 기록됩니다. |
Source of Truth
“Source Of Truth” 섹션이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-appsflyer.
@capgo/capacitor-appsflyer에서 계속하기
“@capgo/capacitor-appsflyer에서 계속하기” 섹션사용 중이라면 @capgo/capacitor-appsflyer 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-appsflyer 사용하기 @capgo/capacitor-appsflyer 사용 시 네이티브 기능을 위해, Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor 플러그인 구현 상세 내용에 대해서는, 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 구현 상세 내용에 대해서는, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우에 대해서는.
