Getting Started

설치

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

SDK를 초기화하고 시작하기 위해 AppsFlyer를 사용하세요. 이 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

인앱 구매에 사용할 통화를 설정합니다. 세자리 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

앱스 플라이어가 짧은 링크에 숨겨진 인정을 위한 매개 변수를 해석할 수 있도록 브랜드 OneLink 도메인을 등록합니다.

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

await AppsFlyer.setOneLinkCustomDomain({} as AFOnelinkDomain);

appendParametersToDeepLinkingURL

OneLink가 없는 앱 링크 깊이 링크에 대한 인정을 활성화합니다. 이 메서드를 호출하기 전에 startSDK(). Include at least pid 및 is_retargeting=true 인 파라미터 맵에 포함.

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

await AppsFlyer.appendParametersToDeepLinkingURL({} as AFAppendToDeepLink);

setResolveDeepLinkURLs

AppsFlyer OneLink이 다른 Universal Link 안에 wrapping되어 있을 때 사용합니다. 이 옵션을 사용하면 SDK가 wrapping된 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

클립보드 복사

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

await AppsFlyer.setSharingFilterForPartners({} as AFFilters);

setAdditionalData

앱스 플라이어의 고유한 장치 ID를 가져옵니다. (앱의 새로운 설치마다 생성됩니다.).

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

await AppsFlyer.setAdditionalData({} as AFData);

getAppsFlyerUID

클립보드 복사

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에서 광고 식별자 수집을 무시합니다. 이에는 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 Search Ads의 기여를 거부합니다.

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

await AppsFlyer.disableCollectASA({} as AFDisable);

setHost

사용자 정의 호스트를 설정합니다.

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

await AppsFlyer.setHost({} as AFHost);

generateInviteLink

__CAPGO_KEEP_0__

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

await AppsFlyer.generateInviteLink({} as AFLinkGenerator);

validateAndLogInAppPurchaseAndroid

API

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

await AppsFlyer.validateAndLogInAppPurchaseAndroid({} as AFAndroidInAppPurchase);

validateAndLogInAppPurchaseIos

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

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

await AppsFlyer.validateAndLogInAppPurchaseIos({} as AFIosInAppPurchase);

getSdkVersion

AppsFlyer SDK 버전을 앱에 사용하는 버전입니다.

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

await AppsFlyer.getSdkVersion();

enableFacebookDeferredApplinks

Enable the collection of Facebook Deferred AppLinks. Requires Facebook SDK and Facebook app on target/client device. This API must be invoked before initializing the AppsFlyer SDK in order to function properly.

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

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

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

await AppsFlyer.setCurrentDeviceLanguage({} as AFLanguage);

logCrossPromoteImpression

크로스 프로모션 캠페인에서 사용되는 광고 앱 ID를 사용하여 인상 로그를 기록합니다. AppsFlyer 대시보드에서 앱 ID를 확인하세요.

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

__CAPGO_KEEP_2__

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

await AppsFlyer.setPhoneNumber({} as AFPhone);

setPartnerData

__CAPGO_KEEP_3__

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

await AppsFlyer.setPartnerData({} as AFPartnerData);

logInvite

__CAPGO_KEEP_4__

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

await AppsFlyer.logInvite({} as AFLogInvite);

setDisableNetworkData

__CAPGO_KEEP_5__

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

await AppsFlyer.setDisableNetworkData({} as AFDisable);

enableTCFDataCollection

TCF v2.2과 호환되는 CMP를 사용하는 사용자에 대한 동의 데이터 자동 수집을 위해 사용합니다. flag 값은 앱 세션 간에 유지됩니다.

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, 및 배너를 통해 앱에서 생성됩니다. 이 메서드를 사용하여 광고 수익을 기록할 수 있습니다.

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

AppSet ID 수집을 비활성화합니다. SDK 초기화 전에 호출하면 App Set ID가 수집되지 않습니다. SDK 초기화 후에 호출하면 App Set ID가 수집되지만 요청 패킷에 포함되지 않습니다. Android 전용입니다.

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

await AppsFlyer.disableAppSetId();

validateAndLogInAppPurchaseV2

API 서버에서 인앱 구매 인증 V2를 위한 것입니다. 인앱 구매 인증이 성공적으로 완료되면 af_purchase 이벤트와 관련된 값이 자동으로 로그됩니다.

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

await AppsFlyer.validateAndLogInAppPurchaseV2({} as AFPurchaseDetailsV2);

실질적인 출처

이 페이지는 플러그인의 src/definitions.ts공개 API이 업스트림에서 변경될 때 다시 동기화를 실행하세요.

Getting Started

Getting Started 계획 대시보드 및 __CAPGO_KEEP_0__ 운영을 위해 to plan dashboard and API operations, connect it with Using @capgo/capacitor-appsflyer for the native capability in Using @capgo/capacitor-appsflyer, API 개요 API 개요의 구현 세부 정보를 위해 소개 소개의 구현 세부 정보를 위해 API 키 API 키의 구현 세부 정보를 위해, 및 장치 장치의 구현 세부 정보를 위해