Getting Started

이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함한 설정 명령어를 복사하세요.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-facebook-analytics`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/facebook-analytics/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

설치

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-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 앱 ID 및 클라이언트 토큰을 설정하세요. 플러그인은 이러한 값을 자동으로 생성하지 않습니다.

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

Meta 값을 추가하세요 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>

광고주 추적 활성화

사용자의 동의 흐름이 추적을 허용한 후에 이 함수를 호출하세요.

await FacebookAnalytics.enableAdvertiserTracking();

iOS 17 이상에서 FBSDK v17+는 앱 추적 투명도(App Tracking Transparency)를 직접 읽습니다. 사용자의 앱 ATT 흐름을 사용하여 추적에 의존하는 이벤트를 로깅하기 전에 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업스트림에서 pubic API이 변경될 때 다시 싱크를 실행하세요.

시작부터 계속

Capacitor 플러그인을 사용 중이라면 시작하기 자연 플러그인 작업을 계획하기 위해, Facebook Analytics 플러그인을 사용하기 위해 @capgo/capacitor-facebook-analytics 자연 플러그인 기능을 사용하기 위해 Facebook Analytics 플러그인을 사용하기 위해 @capgo/capacitor-facebook-analytics Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리에서 제품 워크플로우 Capacitor 플러그인들에 의해 Capgo Capacitor 플러그인들에 의해 Capgo에서 구현 세부 정보 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트에서 구현 세부 정보 아이오닉 엔터프라이즈 플러그인 대체 아이오닉 엔터프라이즈 플러그인 대체에서 제품 워크플로우