본문 바로가기

Facebook Analytics 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/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 매개변수입니다.

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/capacitor-facebook-analytics 사용하기 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-facebook-analytics @capgo/capacitor-facebook-analytics의 구현 세부 사항은 시작하기 Getting Started의 구현 상세 내용은 Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor Plugins 구현 세부 사항 및 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트의 구현 세부 사항은.

자주 묻는 질문

Facebook Analytics 플러그인 FAQ

Capacitor 앱에 Facebook Analytics 플러그인을 설치하는 방법은 무엇인가요?

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

@capgo/capacitor-facebook-analytics은 React, Vue, Angular와 호환되나요?

네. Facebook Analytics는 Capacitor 패키지이므로 Ionic, React, Vue, Angular, Svelte, 순수 JavaScript를 포함해 Capacitor 안에서 실행되는 모든 웹 프레임워크와 호환됩니다.

@capgo/capacitor-facebook-analytics이 지원하는 Capacitor 버전은 무엇인가요?

Capgo 플러그인은 Capacitor의 메이저 버전을 따릅니다. 사용 중인 Capacitor 메이저 버전과 일치하는 플러그인 메이저 버전을 사용하세요 (예: Capacitor 8에는 플러그인 v8). 유지 관리되는 버전은 GitHub README의 호환성 표에서 확인할 수 있습니다.

@capgo/capacitor-facebook-analytics은 무료이며 오픈 소스인가요?

네. 소스 code는 https://github.com/Cap-go/capacitor-facebook-analytics/ 에서 GitHub에 공개되어 있으며, npm에서 무료로 설치할 수 있습니다. 버그 리포트와 풀 리퀘스트를 환영합니다.

Facebook Analytics를 사용하는 code를 App Store 리뷰 없이 업데이트할 수 있나요?

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

앱 심사 대기 없이 Facebook Analytics 변경 사항을 배포하세요

스토어 빌드에 플러그인이 포함되면, Capgo live updates로 JavaScript, HTML, CSS 변경 사항을 몇 분 만에 사용자에게 푸시할 수 있습니다.

Capgo로 시작하기