메인 콘텐츠로 건너뛰기
@capgo/capacitor-appsflyer 분석 오픈 소스

앱스 플라이어 Capacitor 플러그인

앱스 플라이어 attribution, 분석, 지연된 깊이 링크 및 OneLink 지원을 Capacitor 앱에 추가하세요

설치

bun add @capgo/capacitor-appsflyer bunx cap sync
npm, pnpm 또는 yarn
  • npm install @capgo/capacitor-appsflyer
  • pnpm add @capgo/capacitor-appsflyer
  • yarn add @capgo/capacitor-appsflyer

안내

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, 그리고 플러그인을 추가하거나 업데이트 제품 워크플로우에 대한 구현 세부 사항은 플러그인을 추가하거나 업데이트.

FAQ

AppsFlyer 플러그인 FAQ

Capacitor 앱에 AppsFlyer 플러그인을 설치하는 방법은 무엇입니까?

bun add @capgo/capacitor-appsflyer (또는 npm install @capgo/capacitor-appsflyer) 명령어를 실행한 후 bunx cap sync 명령어를 실행하여 iOS와 Android 프로젝트가 네이티브 code를 인식하도록 합니다. 그리고 capgo/capacitor-appsflyer를 import하여 앱 code에 추가합니다.

@capgo/capacitor-appsflyer는 React, Vue 및 Angular과 호환되나요?

네. AppsFlyer는 Capacitor 패키지이므로 Ionic, React, Vue, Angular, Svelte 및 일반 JavaScript와 같은 웹 프레임워크가 Capacitor 내에서 실행되는 경우에 호환됩니다.

어떤 Capacitor 버전이 @capgo/capacitor-appsflyer에서 지원하는가?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

@capgo/capacitor-appsflyer는 무료이며 오픈 소스인가요?

네. code은 GitHub에 공개되어 있으며 https://github.com/Cap-go/capacitor-appsflyer/에서 무료로 설치할 수 있습니다. npm에서 버그 리포트와 풀 리퀘스트를 환영합니다.

code을 AppsFlyer를 사용하여 App Store 리뷰 없이 업데이트할 수 있나요?

code을 설치하거나 업그레이드하면 네이티브 code이 변경되므로 새로운 스토어 빌드를 필요로 합니다. 그 후에 Capgo 라이브 업데이트를 사용하여 JavaScript, HTML 및 CSS 변경 사항이 플러그인을 호출하는 경우 즉시 배포할 수 있습니다.

앱 리뷰 기다리지 않고 AppsFlyer 변경을 배포하세요.

플러그인이 스토어 빌드에 포함된 후, Capgo 라이브 업데이트 사용자에게 JavaScript, HTML 및 CSS 변경을 몇 분 내에 푸시합니다.

Capgo로 시작하세요.