시작하기

설치

Capgo의 AI 보조 설치를 사용하여 플러그인을 설치할 수 있습니다. 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 초기화 및 시작을 위해 이 메서드를 사용하세요. 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를 AppsFlyer의 고유 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

Android에서 GCM/FCM 토큰 또는 iOS에서 APNs 토큰을 전달하여 다른 플러그인에서 수집한 토큰을 사용합니다. AppsFlyer로 비활성화 측정 토큰을 전달하기 위해 사용합니다.

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

AppsFlyer가 짧은 링크 내에 숨겨진 attribution 매개 변수를 해독할 수 있도록 브랜드된 OneLink 도메인을 등록합니다.

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

await AppsFlyer.setOneLinkCustomDomain({} as AFOnelinkDomain);

appendParametersToDeepLinkingURL

App Links의 deep 링크에 대한 attribution을 활성화합니다. 이 메서드를 호출하기 전에 startSDK(). 최소한 pid 그리고 is_retargeting=true 인자 map에 포함되어야 합니다.

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

await AppsFlyer.appendParametersToDeepLinkingURL({} as AFAppendToDeepLink);

setResolveDeepLinkURLs

AppsFlyer OneLink가 다른 Universal Link 안에 wrap되어 있는 경우 사용하세요. 이것은 SDK가 wrap된 URL을 해독하여 deep linking이 올바르게 작동하도록 해줍니다.

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

await AppsFlyer.setResolveDeepLinkURLs({} as AFUrls);

addPushNotificationDeepLinkPath

push 알림 경로 추가에서 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 파트너로 이벤트가 전파되는 것을 중지합니다. AppsFlyer 파트너 공유 필터 설정을 덮어씁니다.

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

앱스 플라이어의 고유 장치 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에서 다양한 광고 식별자를 수집하는 것을 비활성화합니다. 이에는 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

클립보드 복사

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

AppsFlyer 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

크로스 프로모션 캠페인에 대한 인상 로그합니다. AppsFlyer 대시보드에서 표시되는 광고 앱 ID를 사용하십시오.

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

await AppsFlyer.setCurrentDeviceLanguage({} as AFLanguage);

logCrossPromoteImpression

AppsFlyer

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

장치에서 네트워크 제공자 이름 (carrier)과 SIM 제공자 이름을 수집하지 않습니다.

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

await AppsFlyer.setDisableNetworkData({} as AFDisable);

enableTCFDataCollection

TCF 데이터 수집을 자동으로 활성/비활성화합니다. 사용자가 CMP를 사용하는 경우.

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

await AppsFlyer.enableTCFDataCollection({} as AFEnableTCFDataCollection);

setConsentData

사용자가 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

이 메서드를 사용하여 현재 세션에서 AppsFlyer SDK가 이미 시작되었는지 확인할 수 있습니다.

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

await AppsFlyer.isSDKStarted();

isSDKStopped

이 메서드를 사용하여 현재 AppsFlyer SDK가 중지되었는지 확인할 수 있습니다.

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

await AppsFlyer.isSDKStopped();

disableAppSetId

AppSet ID 수집을 비활성화합니다. SDK 초기화 이전에 호출된 경우 App Set ID가 수집되지 않습니다. 초기화 이후에 호출된 경우 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을 기반으로 생성되었습니다. upstream의 API가 공개되면 다시 싱크를 실행하세요.

Getting Started에서 계속

이 기능을 사용 중이라면 Getting Started API를 사용하여 대시보드와 API 연산을 계획하고 싶다면 API와 연결하세요. capgo @capgo/capacitor-appsflyer를 사용하여 capgo 네이티브 기능을 사용하세요. for the native capability in Using @capgo/capacitor-appsflyer, API Overview for the implementation detail in API Overview, 소개 __CAPGO_KEEP_0__ 키 API Keys for the implementation detail in API Keys, and Devices 장치에 대한 구현 세부 정보.