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.

설치

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

수입

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

네이티브 설정

네이티브 앱에서 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 흐름을 로그인하기 전에 추적에 의존하는 이벤트를 로깅하세요.

표준 이벤트 로깅

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이 변경되면 다시 싱크를 실행하세요.

시작부터 계속

If you are using Getting Started native 플러그인 작업을 계획하려면 Using @capgo/capacitor-facebook-analytics native 기능을 위한 Using @capgo/capacitor-facebook-analytics Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리에서 제품 워크플로우 Capacitor 플러그인들에 의해 Capgo Capacitor 플러그인들에 의해 Capgo의 implementation detail 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트의 implementation detail Ionic Enterprise 플러그인 대체 Capgo 제품 워크플로우에 대한 Ionic Enterprise 플러그인 대체 항목입니다.