Getting Started

__CAPGO_KEEP_1__를 복사하여 __CAPGO_KEEP_0__를 설정하기 위한 지시문을 설정하세요.

        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.

__CAPGO_KEEP_6__

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

Import

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

네이티브 설정

iOS

"iOS"라는 제목의 섹션

클립보드에 복사 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>

안드로이드

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>

광고자 광고 추적 활성화

tracking이 허용된 후 consent flow를 호출하세요.

await FacebookAnalytics.enableAdvertiserTracking();

iOS 17 이상에서 FBSDK v17+는 App Tracking Transparency를 직접 읽습니다. 앱의 ATT flow를 사용하여 tracking에 의존하는 이벤트를 로깅하기 전에 사용하세요.

표준 이벤트 로깅

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

__CAPGO_KEEP_0__를 통한 통화 이벤트 로깅

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

__CAPGO_KEEP_0__를 로깅

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

__CAPGO_KEEP_0__를 읽기

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

__CAPGO_KEEP_0__

이 페이지는 플러그인의 src/definitions.ts. upstream에서 API이 변경될 때 다시 싱크를 실행하세요.

Getting Started

native 플러그인 작업을 계획하고 있으시다면 Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-facebook-analytics Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-facebook-analytics Using @capgo/capacitor-facebook-analytics for the native capability in Using @capgo/capacitor-facebook-analytics, native 플러그인 작업을 계획하고 있으시다면 @Capgo/__CAPGO_KEEP_1__-facebook-analytics를 연결하세요. native 플러그인 작업을 계획하고 있으시다면 @Capgo/__CAPGO_KEEP_1__-facebook-analytics를 연결하세요. Capacitor 플러그인들에 의해 Capgo Capacitor 플러그인들에 의해 Capgo의 구현 세부 정보에 대해 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트의 구현 세부 정보에 대해, 및 아이온 이노베이션 플러그인 대체 아이온 이노베이션 플러그인 대체의 제품 워크플로에 대해.