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.

설치

Capgo의 AI-assisted 설치를 사용하여 플러그인을 설치할 수 있습니다. 다음 명령어를 사용하여 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와 클라이언트 토큰을 native 앱에서 설정하세요. 플러그인은 이러한 값을 생성하지 않습니다.

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" />

String 리소스를 추가하세요 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);

진실의 근원

공개 __CAPGO_KEEP_0__이 업스트림에서 변경될 때 다시 싱크를 실행하세요. src/definitions.ts. Re-run the sync when the public API changes upstream.

시작부터 계속 섹션

If you are using 시작하기 자연 플러그인 작업을 계획하기 위해, Using @capgo/capacitor-facebook-analytics Facebook Analytics 플러그인에서 사용하는 @capgo/capacitor-facebook-analytics Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리에서 사용하는 제품 워크플로우 Capacitor 플러그인들에 의해 Capgo Capacitor 플러그인들에 의해 Capgo에서 사용하는 구현 세부 정보 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트에서 사용하는 구현 세부 정보, Ionic Enterprise 플러그인 대체 Ionic Enterprise 플러그인 대체에서 사용하는 제품 워크플로우