Getting Started

설치

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-facebook-analytics` plugin in my project.

만약 Manual Setup을 선호한다면, 다음 명령어를 실행하고 아래의 플랫폼별 설명서를 따라주세요:

bun add @capgo/capacitor-facebook-analytics
bunx cap sync

Import

import {
  FacebookAnalytics,
  FacebookEventName,
  FacebookEventParameterName,
} from '@capgo/capacitor-facebook-analytics';

Native Setup

Meta 앱 아이디와 클라이언트 토큰을 네이티브 앱에서 설정하세요. 플러그인은 이러한 값을 자동으로 생성하지 않습니다.

iOS

iOS에 Meta 값을 추가하세요 Info.plist:

<key>FacebookAppID</key>
<string>YOUR_FACEBOOK_APP_ID</string>
<key>FacebookClientToken</key>
<string>YOUR_FACEBOOK_CLIENT_TOKEN</string>
<key>FacebookDisplayName</key>
<string>YOUR_APP_NAME</string>

Android

클립보드에 복사 AndroidManifest.xml:

<meta-data android:name="com.facebook.sdk.ApplicationId" android:value="@string/facebook_app_id" />
<meta-data android:name="com.facebook.sdk.ClientToken" android:value="@string/facebook_client_token" />

클립보드에 복사 android/app/src/main/res/values/strings.xml:

<string name="facebook_app_id">YOUR_FACEBOOK_APP_ID</string>
<string name="facebook_client_token">YOUR_FACEBOOK_CLIENT_TOKEN</string>

광고주 추적 활성화

Add the string resources in your project to the clipboard.

await FacebookAnalytics.enableAdvertiserTracking();

iOS 17 이상에서 FBSDK v17+는 앱 추적성 투명성(App Tracking Transparency)을 직접 읽습니다. 앱의 ATT 흐름을 사용하여 추적에 의존하는 이벤트를 로깅하기 전에 사용하세요.

표준 이벤트 로깅

await FacebookAnalytics.logEvent({
  event: FacebookEventName.CompletedRegistration,
  params: {
    [FacebookEventParameterName.RegistrationMethod]: 'email',
  },
});

통화로 구성된 값 이벤트 로깅

await FacebookAnalytics.logEvent({
  event: FacebookEventName.AddedToCart,
  valueToSum: 19.99,
  currency: 'USD',
  params: {
    [FacebookEventParameterName.ContentType]: 'product',
    [FacebookEventParameterName.ContentId]: 'sku-123',
  },
});

구매 로깅

await FacebookAnalytics.logPurchase({
  amount: 9.99,
  currency: 'USD',
});

클립보드 복사

const { status } = await FacebookAnalytics.getAdvertiserTrackingStatus();
console.log('Advertiser tracking enabled:', status);

실질적인 출처

플러그인에서 생성된 페이지입니다. src/definitions.ts공개 API이 업스트림에서 변경될 때 다시 싱크를 실행하세요.

Getting Started에서 계속

Capgo를 사용 중이라면 Getting Started Capgo를 사용 중이라면 Capgo를 사용 중이라면 @capgo/capacitor-facebook-analytics를 연결하세요. 자연스러운 기능을 사용하기 위해 @capgo/capacitor-facebook-analytics를 사용하세요. Capgo 플러그인 디렉토리 Capgo 플러그인은 __CAPGO_KEEP_1__에서 제공됩니다. Capacitor 플러그인은 Capgo에서 제공됩니다. Capacitor 플러그인의 구현 세부 사항은 Capgo에서 확인할 수 있습니다. 플러그인을 추가하거나 업데이트 하세요. __CAPGO_KEEP_0__ 플러그인의 구현 세부 사항은 플러그인을 추가하거나 업데이트 할 때 확인할 수 있습니다. Ionic Enterprise 플러그인 대체 옵션 Ionic Enterprise 플러그인 대체 옵션의 제품 워크플로입니다.