Getting Started

설치

Capgo의 AI-Assisted Setup을 사용하여 플러그인을 설치할 수 있습니다. AI 도구에 Capgo 스킬을 추가하려면 다음 명령어를 사용하세요.

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

다음 명령어를 사용하여 다음 프롬프트를 사용하세요.

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-appsflyer` plugin in my project.

만약 Manual Setup을 선호한다면, 다음 명령어를 실행하여 플러그인을 설치하고 아래의 플랫폼별 지침을 따르시오.

bun add @capgo/capacitor-appsflyer
bunx cap sync

Import

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 개요

initSDK

이 메서드를 사용하여 AppsFlyer SDK을 초기화하고 시작한다. 이 API은 앱이 시작되자마자 호출되어야 한다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.initSDK({} as AFInit);

startSDK

수동 시작 모드에서만 앱스 플라이어 SDK을 시작하는 방법입니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.startSDK();

logEvent

인앱 이벤트를 로그합니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.logEvent({} as AFEvent);

setCustomerUserId

고유 ID를 설정하여 앱스 플라이어의 고유 ID와 다른 기기의 고유 ID를 교차 참조할 수 있습니다. 이 ID는 원시 데이터 보고서 및 Postback API에서 사용할 수 있습니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.setCustomerUserId({} as AFCuid);

setCurrencyCode

인앱 구매에 사용할 통화를 설정합니다. 3자리 ISO 4217 code을 제공하세요.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.setCurrencyCode({} as AFCurrency);

updateServerUninstallToken

안드로이드에서 GCM/FCM 토큰 또는 iOS에서 APNs 토큰을 사용하여 다른 플러그인에서 수집한 토큰을 전달합니다. 앱스 플라이어로 해제 측정 토큰을 전달하기 위해 이 메서드를 사용합니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.updateServerUninstallToken({} as AFUninstall);

setAppInviteOneLink

초대 인정을 위한 OneLink ID를 설정합니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.setAppInviteOneLink({} as AFOnelinkID);

setOneLinkCustomDomain

클립보드에 복사

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.setOneLinkCustomDomain({} as AFOnelinkDomain);

appendParametersToDeepLinkingURL

최소한 startSDK()클립보드에 복사 pid __CAPGO_KEEP_0__ is_retargeting=true __CAPGO_KEEP_0__

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.appendParametersToDeepLinkingURL({} as AFAppendToDeepLink);

setResolveDeepLinkURLs

AppsFlyer OneLink이 다른 Universal Link 안에 wrap되어 있을 때 사용하세요. 이 옵션을 사용하면 SDK가 wrap된 URL을 깊이 있는 링크로 올바르게 처리할 수 있습니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.setResolveDeepLinkURLs({} as AFUrls);

addPushNotificationDeepLinkPath

SDK가 푸시 알림 패킷에서 깊이 있는 링크 값을 추출하는 방법을 설정합니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.addPushNotificationDeepLinkPath({} as AFPath);

setSharingFilter

지정된 AppsFlyer 파트너로 이벤트가 전파되는 것을 막습니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.setSharingFilter({} as AFFilters);

setSharingFilterForAllPartners

모든 AppsFlyer 파트너에게 이벤트가 전파되는 것을 막습니다. setSharingFilter가 덮어씌워집니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.setSharingFilterForAllPartners();

setSharingFilterForPartners

지정된 AppsFlyer 파트너에게 이벤트가 전파되는 것을 막습니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.setSharingFilterForPartners({} as AFFilters);

setAdditionalData

AppsFlyer로 추가 키-값 데이터를 전송합니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.setAdditionalData({} as AFData);

getAppsFlyerUID

앱 설치 시 AppsFlyer의 고유 장치 ID를 가져옵니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.getAppsFlyerUID();

anonymizeUser

앱스플라이어 분석에서 사용자 데이터를 익명화합니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.anonymizeUser({} as AFAnonymizeUser);

stop

API이 호출되면 SDK은 더 이상 서버와 통신하지 않으며 작동을 중지합니다. 사용자 동의/거부 구현 시 유용합니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.stop();

disableSKAdNetwork

SKAdNetwork를 비활성화합니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.disableSKAdNetwork({} as AFDisable);

disableAdvertisingIdentifier

SDK에서 다양한 광고 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

Apple 검색 광고의 기여를 거부합니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.disableCollectASA({} as AFDisable);

setHost

커스텀 호스트를 설정합니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.setHost({} as AFHost);

generateInviteLink

기존 사용자들이 친구와 연락처를 새로운 사용자로 초대할 수 있도록 합니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.generateInviteLink({} as AFLinkGenerator);

validateAndLogInAppPurchaseAndroid

API : 앱 내 구매를 서버에서 검증합니다. 검증이 성공하면 af_purchase 이벤트와 관련된 값이 자동으로 로그됩니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.validateAndLogInAppPurchaseAndroid({} as AFAndroidInAppPurchase);

validateAndLogInAppPurchaseIos

현재 계약의 소스 정의를 참조하세요.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.validateAndLogInAppPurchaseIos({} as AFIosInAppPurchase);

getSdkVersion

앱스 플라이어 SDK 버전을 앱에 사용하는 버전입니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.getSdkVersion();

enableFacebookDeferredApplinks

Facebook Deferred AppLinks의 수집을 활성화합니다. Facebook SDK와 Facebook 앱이 대상/클라이언트 기기에서 설치되어 있어야 합니다. 이 API은 AppsFlyer SDK를 초기화하기 전에 호출되어야 정상적으로 작동합니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.enableFacebookDeferredApplinks({} as AFFbDAL);

sendPushNotificationData

푸시-알림 캠페인에서 데이터를 측정하고 가져옵니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.sendPushNotificationData({} as AFPushPayload);

setCurrentDeviceLanguage

기기 언어를 설정합니다. 데이터는 Raw Data Reports에서 표시됩니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.setCurrentDeviceLanguage({} as AFLanguage);

logCrossPromoteImpression

cross-promotion 캠페인에서 사용하는 광고 앱 ID를 확인한 후 impression을 로깅합니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.logCrossPromoteImpression({} as AFPromotion);

setUserEmails

사용자 이메일을 설정하고 암호화합니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.setUserEmails({} as AFEmails);

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 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 비디오, offer walls, interstitials, banner 광고를 표시하여 광고 수익이 발생합니다. 이 메서드를 사용하여 광고 수익을 로깅할 수 있습니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.logAdRevenue({} as AFAdRevenueData);

setConsentDataV2

TCF v2.2과 호환되지 않는 CMP를 사용하는 앱의 경우, 사용자 동의 데이터를 직접 SDK에 제공하는 데 사용합니다.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.setConsentDataV2({} as AFConsentOptions);

isSDKStarted

SDK가 현재 세션에서 이미 시작되었는지 확인하세요.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.isSDKStarted();

isSDKStopped

SDK가 현재 중지되었는지 확인하세요.

import { AppsFlyer } from '@capgo/capacitor-appsflyer';

await AppsFlyer.isSDKStopped();

disableAppSetId

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업스트림에서 pubic API이 변경될 때 다시 싱크를 실행하세요.

시작부터 계속

이 플러그인을 사용하는 경우 시작 대시보드와 API 운영을 계획하려면 Using @capgo/capacitor-appsflyer Using @capgo/capacitor-appsflyer API 개요 API 개요에 대한 구현 세부 사항에 대해 소개 __CAPGO_KEEP_0__ 키에 대한 구현 세부 사항에 대해 API 키 API 키 및 장치에 대한 구현 세부 사항에 대해 장치 __CAPGO_KEEP_0__ 세부 사항에 대한 구현 세부 사항에 대해