Getting Started
이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함한 설정 지시를 복사하세요.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-appsflyer`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/appsflyer/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
설치
설치 섹션bun add @capgo/capacitor-appsflyerbunx cap sync수입
수입 섹션import { AppsFlyer } from '@capgo/capacitor-appsflyer';import type { AFAdRevenueData, AFAndroidInAppPurchase, AFAnonymizeUser, AFAppendToDeepLink, AFConsentData, AFConsentOptions, AFCuid, AFCurrency, AFData, AFDisable, AFEmails, AFEnableTCFDataCollection, AFEvent, AFFbDAL, AFFilters, AFHost, AFInit, AFIosInAppPurchase, AFLanguage, AFLatLng, AFLinkGenerator, AFLogInvite, AFOnelinkDomain, AFOnelinkID, AFPartnerData, AFPath, AFPhone, AFPromotion, AFPurchaseDetailsV2, AFPushPayload, AFUninstall, AFUrls,} from '@capgo/capacitor-appsflyer';API 개요
API 개요 섹션initSDK
__CAPGO_KEEP_2__앱스 플라이어 SDK를 초기화하고 시작하기 위해 이 메서드를 사용하세요. API은 앱이 시작되면 가능한 한 빨리 호출되어야 합니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.initSDK({} as AFInit);startSDK
startSDK수동 시작 모드에서만 앱스 플라이어 SDK을 시작하는 방법입니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.startSDK();logEvent
logEvent인앱 이벤트를 로그합니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logEvent({} as AFEvent);setCustomerUserId
setCustomerUserId고유 ID를 설정하여 앱스 플라이어의 고유 ID와 다른 기기의 ID를 교차 참조할 수 있습니다. 이 ID는 원시 데이터 보고서 및 Postback API에서 사용할 수 있습니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setCustomerUserId({} as AFCuid);setCurrencyCode
setCurrencyCode인앱 구매에 사용할 통화를 설정합니다. 3자리 ISO 4217 code을 제공하세요.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setCurrencyCode({} as AFCurrency);updateServerUninstallToken
__CAPGO_KEEP_0__Android 또는 iOS에서 다른 플러그인으로 수집한 GCM/FCM 토큰을 전달하거나 APNs 토큰을 전달하여 앱을 제거하는 측정 토큰을 AppsFlyer로 전달합니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.updateServerUninstallToken({} as AFUninstall);setAppInviteOneLink
__CAPGO_KEEP_0__OneLink ID를 사용하여 초대 인정을 위한 기본 링크로 설정합니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setAppInviteOneLink({} as AFOnelinkID);setOneLinkCustomDomain
OneLink 도메인을 브랜드화하여 AppsFlyer가 짧은 링크에 숨겨진 인정을 위한 매개 변수를 해석할 수 있도록 합니다.__CAPGO_KEEP_0__
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setOneLinkCustomDomain({} as AFOnelinkDomain);appendParametersToDeepLinkingURL
__CAPGO_KEEP_0____CAPGO_KEEP_0__ startSDK()__CAPGO_KEEP_0__ pid and is_retargeting=true __CAPGO_KEEP_0__의 매개 변수 맵에 있습니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.appendParametersToDeepLinkingURL({} as AFAppendToDeepLink);setResolveDeepLinkURLs
'setResolveDeepLinkURLs'라는 제목의 섹션AppsFlyer OneLink이 다른 Universal Link 안에.wrap되어 있을 때 사용하세요. 이것은 wrap된 URL을 SDK이 깊이 링크가 올바르게 작동하도록 해줍니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setResolveDeepLinkURLs({} as AFUrls);addPushNotificationDeepLinkPath
'addPushNotificationDeepLinkPath'라는 제목의 섹션SDK이 푸시 알림 패키지에서 깊이 링크 값을 추출하는 방법을 설정합니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.addPushNotificationDeepLinkPath({} as AFPath);setSharingFilter
'setSharingFilter'라는 제목의 섹션지정된 AppsFlyer 파트너로 이벤트가 전파되는 것을 막습니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setSharingFilter({} as AFFilters);setSharingFilterForAllPartners
setSharingFilterForAllPartners모든 AppsFlyer 파트너로 이벤트 전파를 중지합니다. setSharingFilter를 덮어씁니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setSharingFilterForAllPartners();setSharingFilterForPartners
setSharingFilterForPartners지정된 AppsFlyer 파트너로 이벤트 전파를 중지합니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setSharingFilterForPartners({} as AFFilters);setAdditionalData
setAdditionalDataAppsFlyer로 추가 키-값 데이터를 전송합니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setAdditionalData({} as AFData);getAppsFlyerUID
getAppsFlyerUID앱 설치 시 AppsFlyer의 고유 장치 ID를 가져옵니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.getAppsFlyerUID();anonymizeUser
anonymizeUser앱스플라이어 분석을 위한 사용자 데이터를 익명화합니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.anonymizeUser({} as AFAnonymizeUser);stop
stop이 API을 호출하면 SDK은 더 이상 서버와 통신하지 않으며 작동을 중단합니다. 사용자 옵인/옵아웃 구현 시 유용합니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.stop();disableSKAdNetwork
disableSKAdNetworkSKAdNetwork를 비활성화합니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableSKAdNetwork({} as AFDisable);disableAdvertisingIdentifier
disableAdvertisingIdentifierSDK에서 다양한 광고 ID의 수집을 비활성화합니다. 이에는 Apple Identity for Advertisers (IDFA), Google Advertising ID (GAID), OAID 및 Amazon Advertising ID (AAID)가 포함됩니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableAdvertisingIdentifier({} as AFDisable);disableCollectASA
disableCollectASA 섹션 제목애플 검색 광고(attribution)에서 제외.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableCollectASA({} as AFDisable);setHost
setHost 섹션 제목사용자 지정 호스트 설정.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setHost({} as AFHost);generateInviteLink
generateInviteLink 섹션 제목기존 사용자들이 친구 및 연락처를 새로운 사용자로 초대할 수 있도록 하는 기능.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.generateInviteLink({} as AFLinkGenerator);validateAndLogInAppPurchaseAndroid
validateAndLogInAppPurchaseAndroid 섹션 제목API : 앱 내 구매 서버 검증. 구매가 성공적으로 검증되면 af_purchase 이벤트와 관련된 값이 자동으로 로그되게 됩니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.validateAndLogInAppPurchaseAndroid({} as AFAndroidInAppPurchase);validateAndLogInAppPurchaseIos
validateAndLogInAppPurchaseIos 섹션 제목See the source definitions for the current contract.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.validateAndLogInAppPurchaseIos({} as AFIosInAppPurchase);getSdkVersion
getSdkVersion 섹션 제목SDK을 사용하는 AppsFlyer 버전을 가져옵니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.getSdkVersion();enableFacebookDeferredApplinks
enableFacebookDeferredApplinks 섹션 제목Facebook Deferred AppLinks를 수집하도록 활성화합니다. Facebook SDK 및 Facebook 앱이 대상/클라이언트 기기에서 설치되어 있어야 합니다. 이 API은 AppsFlyer SDK을 초기화하기 전에 호출되어야 하며 올바르게 작동하기 위해선 반드시 호출되어야 합니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.enableFacebookDeferredApplinks({} as AFFbDAL);sendPushNotificationData
sendPushNotificationData 섹션 제목푸시 알림 캠페인에서 데이터를 측정하고 가져옵니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.sendPushNotificationData({} as AFPushPayload);setCurrentDeviceLanguage
setCurrentDeviceLanguage기기 언어 설정
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setCurrentDeviceLanguage({} as AFLanguage);logCrossPromoteImpression
logCrossPromoteImpression크로스 프로모션 캠페인에서의 노출 로그. AppsFlyer 대시보드에서 프로모티드 앱 ID를 사용하세요.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logCrossPromoteImpression({} as AFPromotion);setUserEmails
setUserEmails사용자 이메일 설정 및 암호화
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setUserEmails({} as AFEmails);logLocation
logLocation사용자 위치 로그
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logLocation({} as AFLatLng);setPhoneNumber
전화번호 설정SHA-256 암호화된 문자열로 전송됩니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setPhoneNumber({} as AFPhone);setPartnerData
파트너 데이터 설정파트너 통합을 위한 사용자 정의 데이터를 전송할 수 있습니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setPartnerData({} as AFPartnerData);logInvite
인바이팅 로그인바이팅 이벤트 (af_invite)를 로그할 때 사용합니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logInvite({} as AFLogInvite);setDisableNetworkData
네트워크 데이터 수집을 비활성화장치에서 네트워크 제공자 이름 (캐리어)과 SIM 제공자 이름을 수집하지 않도록 옵트아웃합니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setDisableNetworkData({} as AFDisable);enableTCFDataCollection
TCF 데이터 수집 활성화TCF v2.2과 호환되는 CMP를 사용하는 사용자에게 자동으로 동의 데이터 수집을 활성화/비활성화하는 데 사용합니다. 앱 세션 간에 플래그 값이 유지됩니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.enableTCFDataCollection({} as AFEnableTCFDataCollection);setConsentData
사용자 동의 데이터 설정TCF v2.2과 호환되지 않는 CMP를 사용하는 앱의 경우 사용자 동의 데이터를 직접 SDK에 제공하는 데 사용합니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setConsentData({} as AFConsentData);logAdRevenue
광고 수익 로깅광고 수익을 추적하면 앱 소유자가 사용자 LTV와 캠페인 ROI를 완벽하게 이해할 수 있습니다. rewarded videos, offer walls, interstitials, banner 광고를 표시하여 광고 수익이 발생합니다. 이 메서드를 사용하여 광고 수익을 로깅할 수 있습니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logAdRevenue({} as AFAdRevenueData);setConsentDataV2
사용자 동의 데이터 설정 v2TCF v2.2과 호환되지 않는 CMP를 사용하는 앱의 경우 사용자 동의 데이터를 직접 SDK에 제공하는 데 사용합니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setConsentDataV2({} as AFConsentOptions);isSDKStarted
SDK가 시작되었는지 확인하는 방법입니다.이 메서드를 사용하여 현재 세션에서 AppsFlyer SDK가 이미 시작되었는지 확인할 수 있습니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.isSDKStarted();isSDKStopped
SDK가 중지되었는지 확인하는 방법입니다.이 메서드를 사용하여 AppsFlyer SDK가 현재 중지되었는지 확인할 수 있습니다.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.isSDKStopped();disableAppSetId
AppSet ID 수집을 비활성화합니다. __CAPGO_KEEP_0__ 초기화 전에 호출하면 App Set ID가 수집되지 않습니다. 초기화 후에 호출하면 App Set ID가 수집되지만 요청 패킷에 포함되지 않습니다. Android 전용.Disables AppSet ID collection. If called before SDK init, App Set ID will not be collected. If called after init, App Set ID will be collected but not sent in request payloads. Android only.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableAppSetId();validateAndLogInAppPurchaseV2
클립보드에 복사API
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.validateAndLogInAppPurchaseV2({} as AFPurchaseDetailsV2);원본
원본이 페이지는 플러그인의 src/definitions.ts공개 API이 업스트림에서 변경될 때 다시 싱크를 실행하세요.
시작하기
시작하기이러한 기능을 사용하는 경우 시작하기 계획 대시보드 및 API 작업을 위해 연결하세요. Using @capgo/capacitor-appsflyer Using @capgo/capacitor-appsflyer API 개요 API 개요에 대한 구현 세부 정보를 위해 소개 __CAPGO_KEEP_0__ 키에 대한 구현 세부 정보를 위해 API 키 API 키 및 장치에 대한 구현 세부 정보를 위해 장치 __CAPGO_KEEP_0__ 페이지 편집