본문으로 건너뛰기

Facebook 분석 Capacitor 플러그인

Meta/Facebook App Events 분석을 위한 표준 이벤트, 구매 로깅, 통화 매개변수 및 광고주 추적 제어

설치

bun add @capgo/capacitor-facebook-analytics bunx cap sync
npm, pnpm 또는 yarn
  • npm install @capgo/capacitor-facebook-analytics
  • pnpm add @capgo/capacitor-facebook-analytics
  • yarn add @capgo/capacitor-facebook-analytics

가이드

Capacitor에서 Facebook Analytics를 사용하는 방법

장치에서 테스트

Capgo 앱을 다운로드한 후 QR code를 스캔하세요.

Facebook Analytics 플러그인 미리보기 QR code

@capgo/capacitor-facebook-analytics를 사용하세요.

iOS 및 Android에서 Capacitor 앱에 대한 Meta/Facebook App Events 분석을 사용하세요.

설치

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

이 플러그인이 제공하는 기능

  • initAppEvents - Facebook App Events를 수동으로 활성화하세요.
  • logEvent - 매개 변수, 값 및 통화와 함께 표준 또는 사용자 지정 App Events를 로깅하세요.
  • logPurchase - 금액 및 통화와 함께 구매 이벤트를 로깅하세요.
  • enableAdvertiserTracking - 지원되는 경우 원시 광고주 추적을 활성화하세요.
  • disableAdvertiserTracking - 네이티브 광고주 추적을 지원하는 경우에만 비활성화합니다.
  • getAdvertiserTrackingStatus - 현재 광고주 추적 상태를 읽습니다.
  • getPluginVersion - 네이티브 플러그인 버전을 읽습니다.

예시 사용

logEvent

Facebook 매개 변수와 함께 표준 이벤트를 로깅합니다.

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

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

logEvent 값과 통화

값이 있는 표준 이벤트를 매개 변수와 함께 보냅니다. fb_currency parameter.

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

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

logPurchase

구매 이벤트를 로깅합니다.

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

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

전체 참조

capgo/capacitor-facebook-analytics에서 계속 진행하세요.

만약 __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-facebook-analytics를 사용 중이라면 capgo/capacitor-facebook-analytics를 사용하여 __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-facebook-analytics와 연결하여 capgo/capacitor-facebook-analytics의 구현 세부 사항을 참조하세요. @capgo/capacitor-페이스북 분석 Getting Started의 구현 세부 사항을 참조하세요. __CAPGO_KEEP_0__ 플러그인 디렉토리 Capgo 플러그인 디렉토리의 제품 워크플로를 참조하세요. Capgo 플러그인들 Capgo의 Capacitor 플러그인들에 대한 구현 세부 사항을 참조하세요. for Capacitor 구현 세부 사항에 대한 Capgo 플러그인에 의해 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트에 대한 구현 세부 정보입니다.

FAQ

페이스북 애널리틱스 플러그인 FAQ

Facebook 분석 플러그인을 Capacitor 앱에 어떻게 설치하나요?

Run "bun add @capgo/capacitor-facebook-analytics" (또는 "npm install @capgo/capacitor-facebook-analytics")를 실행한 다음 "bunx cap sync"를 실행하여 iOS 및 Android 프로젝트가 네이티브 code를 인식하도록 하세요. 그리고 "@capgo/capacitor-facebook-analytics"를 앱 code에서 임포트하세요.

Facebook 분석 플러그인 @capgo/capacitor-facebook-analytics는 React, Vue 및 Angular과 함께 작동하나요?

네. Facebook 분석 플러그인은 Capacitor 패키지이므로, Capacitor 내에서 실행되는 모든 웹 프레임워크와 함께 작동합니다. 예를 들어, Ionic, React, Vue, Angular, Svelte 및 plain JavaScript도 포함됩니다.

Which Capacitor version does @capgo/capacitor-facebook-analytics support?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

Facebook 분석 플러그인 @capgo/capacitor-facebook-analytics는 무료이고 오픈 소스인가요?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-facebook-analytics/ and the package is free to install from npm. Bug reports and pull requests are welcome.

code가 Facebook 분석 플러그인을 사용하는 경우 App Store 리뷰 없이 업데이트가 가능한가요?

code 플러그인을 설치하거나 업그레이드하면 네이티브 code이 변경되므로, 새로운 스토어 빌드를 필요로 합니다. 그 후에 JavaScript, HTML 및 CSS 변경 사항이 플러그인을 호출하는 경우 Capgo Live Update를 통해 즉시 배포할 수 있습니다.

앱 리뷰 대기 없이 Facebook Analytics 변경을 배포하세요

플러그인을 스토어 빌드에 추가한 후, Capgo에서 라이브 업데이트 기능을 사용하여 사용자에게 몇 분만에 자바스크립트, HTML 및 CSS 변경 사항을 푸시합니다.

Capgo으로 시작하세요