안내
How to use AppsFlyer in Capacitor
@capgo/capacitor-앱플라이어
AppsFlyer attribution, analytics, 및 deep links를 위한 Capacitor 플러그인
설치
bun add @capgo/capacitor-appsflyer
bunx cap sync
bunx cap sync code 플러그인의 네이티브 코드를 프로젝트에 복사합니다. 플러그인 업그레이드 후 다시 실행하세요.
Import
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
API 한눈에
| 설명 | Description |
|---|---|
initSDK |
앱스플라이어를 초기화하고 시작하기 위해 이 방법을 사용하세요. SDK을 호출해야 하는데, 이 API을 가능한 한 앱이 시작되자마자 호출해야 합니다. |
startSDK |
SDK에서 이벤트를 로깅하세요. |
logEvent |
__CAPGO_KEEP_0__ |
setCustomerUserId |
고유 ID를 설정하면 앱스 플라이어의 고유 ID와 다른 기기의 ID와 함께 cross-reference 할 수 있습니다. 이 ID는 raw-data 보고서와 Postback API에서 사용할 수 있습니다. |
setCurrencyCode |
인앱 구매의 통화 설정입니다. 통화 code은 3 자리 ISO 4217 code이어야 합니다. |
updateServerUninstallToken |
(안드로이드) 3 자리 플러그인에서 GCM/FCM 토큰을 앱스 플라이어 서버로 전달할 수 있습니다. Uninstall 로그를 사용할 수 있습니다. (iOS) 3 자리 플러그인에서 APN 토큰을 앱스 플라이어 서버로 전달할 수 있습니다. Uninstall 로그를 사용할 수 있습니다. |
setAppInviteOneLink |
사용자 초대에 대한 attribution을 위해 사용할 OneLink ID를 설정합니다. 사용자 초대에 대한 링크는 이 OneLink을 기본 링크로 사용합니다. |
setOneLinkCustomDomain |
앱스 플라이어 SDK가 숨겨진 (단축 링크 ID에서 해독된) attribution 매개 변수를 성공적으로 해결하기 위해, 앱스 플라이어 대시보드에서 구성된 브랜드 도메인이 제공된 경우, 이 메서드에 도메인을 제공해야 합니다. |
appendParametersToDeepLinkingURL |
앱 링크를 사용하여 깊이 연결 (OneLink 없이)하는 앱 소유자가 사용하는 경우, 사용자가 도메인과 관련된 세션을 시작할 수 있습니다. 이 메서드를 호출하기 전에 start를 호출해야 합니다. 다음 매개 변수를 매핑에 제공해야 합니다: pid는 retargeting 여부가 true로 설정되어야 합니다. |
setResolveDeepLinkURLs |
광고주들은 AppsFlyer OneLink를 다른 Universal Link 안에 wrapping 할 수 있습니다. 이 Universal Link는 앱을 호출하지만, deep linking 데이터는 AppsFlyer로 전파되지 않습니다. setResolveDeepLinkURLs를 사용하여 SDK를 구성하여 wrapping된 OneLink URL을 해독할 수 있으므로 deep linking이 올바르게 발생할 수 있습니다. |
addPushNotificationDeepLinkPath |
푸시 알림 패키지에서 deep link 값을 추출하는 방법을 SDK가 어떻게 추출하는지 구성합니다. |
setSharingFilter |
지정된 AppsFlyer 파트너로 이벤트 전파를 중지합니다. |
setSharingFilterForAllPartners |
모든 AppsFlyer 파트너로 이벤트 전파를 중지합니다. setSharingFilter를 덮어씁니다. |
setSharingFilterForPartners |
지정된 AppsFlyer 파트너로 이벤트 전파를 중지합니다. |
setAdditionalData |
AppsFlyer로 추가 데이터를 전송할 수 있습니다. 자세한 내용은. |
getAppsFlyerUID |
AppsFlyer의 고유한 장치 ID(앱을 설치할 때마다 새로 생성)를 가져옵니다. |
anonymizeUser |
AppsFlyer 분석에서 사용자 데이터를 익명화합니다. |
stop |
이 API를 호출하면 SDK는 더 이상 서버와 통신하지 않고 작동을 중지합니다. 사용자 동의/거부 구현 시 유용합니다. |
disableSKAdNetwork |
SKAdNetwork에서 Opt-out합니다. |
disableAdvertisingIdentifier |
SDK에서 광고 ID 수집을 비활성화합니다. 이에는 Apple Identity for Advertisers (IDFA), Google Advertising ID (GAID), OAID 및 Amazon Advertising ID (AAID)가 포함됩니다. |
disableCollectASA |
Apple Search Ads attribution에서 Opt-out합니다. |
setHost |
호스트를 사용자 지정하세요. |
generateInviteLink |
기존 사용자가 친구와 연락처를 새로운 사용자로 초대할 수 있도록 허용합니다. |
validateAndLogInAppPurchaseAndroid |
API을 사용하여 앱 내 구매를 서버에서 검증합니다. 검증이 성공하면 관련된 값이 포함된 af_purchase 이벤트가 자동으로 로깅됩니다. |
validateAndLogInAppPurchaseIos |
현재 동작에 대한 소스 정의를 참조하세요. |
getSdkVersion |
SDK 버전을 사용하여 앱에서 사용하는 AppsFlyer 버전을 가져옵니다. |
enableFacebookDeferredApplinks |
Facebook Deferred AppLinks의 수집을 활성화합니다. Facebook SDK과 Facebook 앱이 대상/클라이언트 기기에 설치되어 있어야 합니다. 이 API은 AppsFlyer SDK를 초기화하기 전에 호출되어야 합니다. |
sendPushNotificationData |
푸시 알림 캠페인에서 데이터를 측정하고 가져옵니다. |
setCurrentDeviceLanguage |
기기의 언어를 설정합니다. 데이터는 Raw Data Reports에서 표시됩니다. |
logCrossPromoteImpression |
크로스 프로모션 캠페인에서 인상을 로깅합니다. AppsFlyer 대시보드에서 나타나는 프로모션 앱 ID를 사용하도록 확인하세요. |
setUserEmails |
사용자 이메일을 설정하고 암호화합니다. |
logLocation |
사용자의 위치를 수동으로 로깅합니다. |
setPhoneNumber |
SHA-256 암호화된 문자열로 전송됩니다. |
setPartnerData |
파트너 통합을 위한 사용자 데이터를 전송할 수 있습니다. |
logInvite |
사용자 초대 이벤트 (af_invite)를 로그합니다. |
setDisableNetworkData |
네트워크 제공자 이름 (carrier)과 SIM 제공자 이름을 수집하지 않도록 선택합니다. |
enableTCFDataCollection |
CMP를 사용하는 사용자에 대한 자동으로 수집되는 동의 데이터를 선택/해제합니다. Flag 값은 앱 세션 간에 유지됩니다. |
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 init 전에 호출하면 App Set ID가 수집되지 않습니다. init 후에 호출하면 App Set ID가 수집되지만 요청 패킷에 포함되지 않습니다. Android 전용. |
validateAndLogInAppPurchaseV2 |
API for server-side in-app purchase V2. 구매 관련 값이 포함된 af_purchase 이벤트가 자동으로 로깅됩니다. |
예시
initSDK()
이 메서드를 사용하여 앱스 플라이어 SDK를 초기화하고 시작합니다. 이 API는 앱이 시작되면 즉시 호출되어야 합니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
const result = await AppsFlyer.initSDK({
devKey: 'dev-key-123',
appID: 'app-id-123',
});
console.log(result);
startSDK()
이 메서드를 사용하여 앱스 플라이어 SDK를 시작합니다. 그러나 수동 시작 모드에서만 사용합니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
const result = await AppsFlyer.startSDK();
console.log(result);
logEvent()
앱 내 이벤트를 로깅합니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
const result = await AppsFlyer.logEvent({ eventName: 'event' });
console.log(result);
setCustomerUserId()
고유한 고객 ID를 설정하면 앱스 플라이어의 고유 ID와 다른 기기의 ID와 함께 내부 ID와 교차 참조할 수 있습니다. 이 ID는 원시 데이터 보고서와 Postback API에서 사용할 수 있습니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setCustomerUserId({ cuid: 'cuid' });
setCurrencyCode()
인앱 구매의 통화를 설정합니다. 통화 code는 3 자리 ISO 4217 code여야 합니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setCurrencyCode({ currencyCode: 'USD' });
updateServerUninstallToken()
GCM/FCM 토큰을 앱스 플라이어 서버에 전달할 수 있습니다. (안드로이드) 또는 APN 토큰을 전달할 수 있습니다. (iOS) 이 토큰은 언인스톨 로그를 사용할 수 있습니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.updateServerUninstallToken({ token: 'token-123' });
위 표에는 44 개의 핵심 메서드가 나열되어 있습니다. 리스너 및 버전 헬퍼, 각 메서드의 전체 계약은 __CAPGO_KEEP_0__ 저장소에서 문서화되어 있습니다. GitHub 저장소.
이벤트를 듣습니다.
addListener handle을 반환합니다. 화면이 언마운트되면 호출합니다. handle.remove() 전체 참조
__CAPGO_KEEP_0__ 저장소
@capgo/capacitor-앱플라이어에서 계속 사용하세요
__CAPGO_KEEP_0__ reference @capgo/capacitor-앱플라이어 __CAPGO_KEEP_0__ repository reference @capgo/capacitor-앱플라이어 @capgo/capacitor-앱플라이어 구현 세부 사항을 위한 이용 중인 경우 이용 중인 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-appsflyer native plugin 작업을 계획하는 데 사용하는 경우 @Capgo/__CAPGO_KEEP_1__-appsflyer을 연결하세요. 제품 워크플로우에 대한 Capgo 플러그인 디렉토리에서 Capacitor 플러그인에 의해 Capgo 제품 워크플로우에 대한 구현 세부 사항은 Capacitor 플러그인에 의해 Capgo, 그리고 플러그인을 추가하거나 업데이트 제품 워크플로우에 대한 구현 세부 사항은 플러그인을 추가하거나 업데이트.