analytics package

Firebase 애널리틱스 웹 SDK 이 SDK는 Node.js 환경에서 작동하지 않습니다.

함수

함수 설명
function(앱, ...)
getAnalytics(앱) 지정된 앱의 Analytics 인스턴스를 반환합니다.
초기화 애널리틱스(앱, 옵션) 지정된 앱의 Analytics 인스턴스를 반환합니다.
function(analyticsInstance, ...)
getGoogleAnalyticsClientId(analyticsInstance) 웹 클라이언트의 고유한 Google 애널리틱스 식별자를 검색합니다. client_id를 참고하세요.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.화면 조회수 추적을 참조하세요.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.예외 측정을 참조하세요.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.
logEvent(analyticsInstance, eventName, eventParams, options) 지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.페이지 조회를 참조하세요.
setAnalyticsCollectionEnabled(analyticsInstance, enabled) 이 기기에서 이 앱에 대해 Google 애널리틱스 수집을 사용 설정할지 설정합니다. 전역 window['ga-disable-analyticsId'] = true; 설정
setCurrentScreen(analyticsInstance, screenName, options) gtag config 명령어를 사용하여 screen_name를 설정합니다.
setUserId(analyticsInstance, id, options) gtag config 명령어를 사용하여 user_id를 설정합니다.
setUserProperties(analyticsInstance, properties, options) gtag config 명령어를 사용하여 지정된 모든 매개변수를 설정합니다.
함수()
isSupported() 이는 사용자에게 제공되는 공개 정적 메서드로, 네 가지 검사를 래핑합니다.1. 브라우저 확장 프로그램 환경이 아닌지 확인합니다. 2. 현재 브라우저에서 쿠키가 사용 설정되어 있는지 확인합니다. 3. IndexedDB가 브라우저 환경에서 지원되는지 확인합니다. 4. IndexedDB.open() 사용에 현재 브라우저 컨텍스트가 유효한지 확인합니다.
function(consentSettings, ...)
setConsent(consentSettings) Firebase 애널리틱스가 초기화되면 모든 gtag 참조에서 이 웹 앱에 적용되는 최종 사용자 동의 상태를 설정합니다.ConsentSettings를 사용하여 개별 동의 유형 값을 지정하세요. 기본적으로 동의 유형은 '부여됨'으로 설정됩니다.
function(customParams, ...)
setDefaultEventParameters(customParams) 자동 이벤트를 포함하여 SDK에서 로깅되는 모든 이벤트에 설정될 데이터를 추가합니다. gtag의 'set' 포함 명령의 경우, 전달된 값은 현재 페이지에 유지되며 이후의 모든 이벤트와 함께 전달됩니다.
function(options, ...)
설정(옵션) 맞춤 gtag 또는 dataLayer 이름을 사용하도록 Firebase 애널리틱스를 구성합니다. gtag.js 스크립트가 Firebase 애널리틱스와 별개로 이 페이지에 설치되어 있고 gtag 함수 또는 dataLayer에 기본이 아닌 이름을 사용하는 경우 사용됩니다. getAnalytics()를 호출하기 전에 호출해야 합니다. 그렇지 않으면 아무런 영향을 미치지 않습니다.

인터페이스

인터페이스 설명
애널리틱스 Firebase Analytics의 인스턴스입니다.
애널리틱스 통화 옵션 애널리틱스 메서드 호출에 전달할 수 있는 추가 옵션(예: logEvent)입니다.
애널리틱스 설정 Analytics 인스턴스 초기화 옵션
ConsentSettings 각 동의 유형의 동의 상태 설정입니다. 자세한 내용은 동의 상태 및 동의 유형에 대한 GA4 참조 문서를 확인하세요.
ControlParams 표준 gtag.js 제어 매개변수 자세한 내용은 GA4 참조 문서를 확인하세요.
CustomParams 사용자가 gtag에 전달할 수 있는 모든 맞춤 매개변수
이벤트 매개변수 표준 gtag.js 이벤트 매개변수입니다. 자세한 내용은 GA4 참조 문서를 확인하세요.
GtagConfigParams gtag.js에서 인식하는 일반적인 Google 애널리틱스 구성 설정 집합입니다.
항목 표준 Google 애널리틱스 Item 유형입니다.
프로모션 이전에 일부 Google 애널리틱스 이벤트에서 사용된 필드입니다.
설정 옵션 Firebase 애널리틱스 인스턴스의 커스텀 옵션을 지정합니다. firebase.analytics()를 초기화하기 전에 이를 설정해야 합니다.

유형 별칭

별칭 입력 설명
ConsentStatusString 특정 동의 유형의 수락 또는 거부 여부입니다.
통화 표준 Google 애널리틱스 통화 유형입니다.
맞춤 이벤트 이름 표준 추천 이벤트 이름 목록에 없는 맞춤 이벤트 이름 문자열
EventNameString 표준 Google 애널리틱스 이벤트 이름의 유형입니다. logEvent도 모든 맞춤 문자열을 허용하고 이를 맞춤 이벤트 이름으로 해석합니다.

함수(앱, ...)

getAnalytics(앱)

지정된 앱의 Analytics 인스턴스를 반환합니다.

서명:

export declare function getAnalytics(app?: FirebaseApp): Analytics;

매개변수

매개변수 유형 설명
앱 Firebase 앱 사용할 FirebaseApp입니다.

반환:

애널리틱스

initAnalytics(앱, 옵션)

지정된 앱의 Analytics 인스턴스를 반환합니다.

서명:

export declare function initializeAnalytics(app: FirebaseApp, options?: AnalyticsSettings): Analytics;

매개변수

매개변수 유형 설명
앱 Firebase 앱 사용할 FirebaseApp입니다.
옵션 애널리틱스 설정

반환:

애널리틱스

function(analyticsInstance, ...)

getGoogleAnalyticsClientId(analyticsInstance)

웹 클라이언트의 고유한 Google 애널리틱스 식별자를 검색합니다. client_id를 참고하세요.

서명:

export declare function getGoogleAnalyticsClientId(analyticsInstance: Analytics): Promise<string>;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스

반환:

프로미스<string>

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.

서명:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'add_payment_info', eventParams?: {
    coupon?: EventParams['coupon'];
    currency?: EventParams['currency'];
    items?: EventParams['items'];
    payment_type?: EventParams['payment_type'];
    value?: EventParams['value'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName 'add_payment_info' [add_payment_info]
eventParams { 쿠폰?: EventParams['coupon']; 통화?: EventParams['currency']; 항목?: EventParams['items']; payment_type?: EventParams['payment_type']; 값?: EventParams['value']; [key: string]: any; }
옵션 애널리틱스 통화 옵션

반환:

void

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.

서명:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'purchase' | 'refund', eventParams?: {
    value?: EventParams['value'];
    currency?: EventParams['currency'];
    transaction_id: EventParams['transaction_id'];
    tax?: EventParams['tax'];
    shipping?: EventParams['shipping'];
    items?: EventParams['items'];
    coupon?: EventParams['coupon'];
    affiliation?: EventParams['affiliation'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName '구매' | '환불'
eventParams { value?: EventParams['value']; 통화?: EventParams['currency']; 트랜잭션_id: EventParams['transaction_id']; 세금?: EventParams['tax']; 배송?: EventParams['shipping']; 항목?: EventParams['items']; 쿠폰?: EventParams['coupon']; 소속 여부: EventParams['affiliation']; [key: string]: any; }
옵션 애널리틱스 통화 옵션

반환:

void

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

화면 조회수 추적을 참고하세요.

서명:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'screen_view', eventParams?: {
    firebase_screen: EventParams['firebase_screen'];
    firebase_screen_class: EventParams['firebase_screen_class'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName 'screen_view'
eventParams { firebase_screen: EventParams['firebase_screen']; firebase_screen_class: EventParams['firebase_screen_class']; [key: string]: any; }
옵션 애널리틱스 통화 옵션

반환:

void

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.

서명:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'search' | 'view_search_results', eventParams?: {
    search_term?: EventParams['search_term'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName '검색' | 'view_search_results'
eventParams { search_term?: EventParams['search_term']; [key: string]: any; }
옵션 애널리틱스 통화 옵션

반환:

void

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.

서명:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'select_content', eventParams?: {
    content_type?: EventParams['content_type'];
    item_id?: EventParams['item_id'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName '콘텐츠_선택'
eventParams { content_type?: EventParams['content_type']; item_id?: EventParams['item_id']; [key: string]: any; }
옵션 애널리틱스 통화 옵션

반환:

void

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.

서명:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'select_item', eventParams?: {
    items?: EventParams['items'];
    item_list_name?: EventParams['item_list_name'];
    item_list_id?: EventParams['item_list_id'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName '상품 선택'
eventParams { 항목?: EventParams['items']; item_list_name?: EventParams['item_list_name']; item_list_id?: EventParams['item_list_id']; [key: string]: any; }
옵션 애널리틱스 통화 옵션

반환:

void

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.

서명:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'select_promotion' | 'view_promotion', eventParams?: {
    items?: EventParams['items'];
    promotion_id?: EventParams['promotion_id'];
    promotion_name?: EventParams['promotion_name'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName 'select_promotion' [select_promotion] | '프로모션_보기'
eventParams { 항목?: EventParams['items']; promotion_id?: EventParams['promotion_id']; promotion_name?: EventParams['promotion_name']; [key: string]: any; }
옵션 애널리틱스 통화 옵션

반환:

void

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.

서명:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'set_checkout_option', eventParams?: {
    checkout_step?: EventParams['checkout_step'];
    checkout_option?: EventParams['checkout_option'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName 'set_checkout_option'
eventParams { 결제 단계: EventParams['checkout_step']; 결제 옵션: EventParams['checkout_option']; [key: string]: any; }
옵션 애널리틱스 통화 옵션

반환:

void

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.

서명:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'share', eventParams?: {
    method?: EventParams['method'];
    content_type?: EventParams['content_type'];
    item_id?: EventParams['item_id'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName '공유'
eventParams { 메서드?: EventParams['method']; content_type?: EventParams['content_type']; item_id?: EventParams['item_id']; [key: string]: any; }
옵션 애널리틱스 통화 옵션

반환:

void

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.

서명:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'sign_up', eventParams?: {
    method?: EventParams['method'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName '가입'
eventParams { 메서드?: EventParams['method']; [key: string]: any; }
옵션 애널리틱스 통화 옵션

반환:

void

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.

서명:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'timing_complete', eventParams?: {
    name: string;
    value: number;
    event_category?: string;
    event_label?: string;
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName '타이밍_완료'
eventParams { name: string; value: number; event_category?: string; event_label?: string; [key: string]: any; }
옵션 애널리틱스 통화 옵션

반환:

void

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.

서명:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'add_shipping_info', eventParams?: {
    coupon?: EventParams['coupon'];
    currency?: EventParams['currency'];
    items?: EventParams['items'];
    shipping_tier?: EventParams['shipping_tier'];
    value?: EventParams['value'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName 'add_shipping_info' [배송_정보_추가]
eventParams { 쿠폰?: EventParams['coupon']; 통화?: EventParams['currency']; 항목?: EventParams['items']; shipping_tier?: EventParams['shipping_tier']; 값?: EventParams['value']; [key: string]: any; }
옵션 애널리틱스 통화 옵션

반환:

void

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.

서명:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'view_cart' | 'view_item', eventParams?: {
    currency?: EventParams['currency'];
    items?: EventParams['items'];
    value?: EventParams['value'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName '장바구니 보기' | '항목_보기'
eventParams { 통화?: EventParams['currency']; 항목?: EventParams['items']; 값?: EventParams['value']; [key: string]: any; }
옵션 애널리틱스 통화 옵션

반환:

void

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.

서명:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'view_item_list', eventParams?: {
    items?: EventParams['items'];
    item_list_name?: EventParams['item_list_name'];
    item_list_id?: EventParams['item_list_id'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName 'view_item_list'[상품_목록 보기]
eventParams { 항목?: EventParams['items']; item_list_name?: EventParams['item_list_name']; item_list_id?: EventParams['item_list_id']; [key: string]: any; }
옵션 애널리틱스 통화 옵션

반환:

void

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.

서명:

export declare function logEvent<T extends string>(analyticsInstance: Analytics, eventName: CustomEventName<T>, eventParams?: {
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName 맞춤 이벤트 이름<T>
eventParams { [키: 문자열]: 모두; }
옵션 애널리틱스 통화 옵션

반환:

void

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.

서명:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'add_to_cart' | 'add_to_wishlist' | 'remove_from_cart', eventParams?: {
    currency?: EventParams['currency'];
    value?: EventParams['value'];
    items?: EventParams['items'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName '장바구니에_추가' | '위시리스트에_추가' | 'remove_from_cart'
eventParams { 통화?: EventParams['currency']; 값?: EventParams['value']; 항목?: EventParams['items']; [key: string]: any; }
옵션 애널리틱스 통화 옵션

반환:

void

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.

서명:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'begin_checkout', eventParams?: {
    currency?: EventParams['currency'];
    coupon?: EventParams['coupon'];
    value?: EventParams['value'];
    items?: EventParams['items'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName 'begin_checkout'
eventParams { 통화?: EventParams['currency']; 쿠폰?: EventParams['coupon']; 값?: EventParams['value']; 항목?: EventParams['items']; [key: string]: any; }
옵션 애널리틱스 통화 옵션

반환:

void

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.

서명:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'checkout_progress', eventParams?: {
    currency?: EventParams['currency'];
    coupon?: EventParams['coupon'];
    value?: EventParams['value'];
    items?: EventParams['items'];
    checkout_step?: EventParams['checkout_step'];
    checkout_option?: EventParams['checkout_option'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName 'checkout_progress'
eventParams { 통화?: EventParams['currency']; 쿠폰?: EventParams['coupon']; 값?: EventParams['value']; 항목?: EventParams['items']; 결제 단계: EventParams['checkout_step']; 결제 옵션: EventParams['checkout_option']; [key: string]: any; }
옵션 애널리틱스 통화 옵션

반환:

void

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

예외 측정을 참고하세요.

서명:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'exception', eventParams?: {
    description?: EventParams['description'];
    fatal?: EventParams['fatal'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName '예외'
eventParams { 설명?: EventParams['description']; 치명적인가요?: EventParams['fatal']; [key: string]: any; }
옵션 애널리틱스 통화 옵션

반환:

void

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.

서명:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'generate_lead', eventParams?: {
    value?: EventParams['value'];
    currency?: EventParams['currency'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName '리드 생성'
eventParams { value?: EventParams['value']; 통화?: EventParams['currency']; [key: string]: any; }
옵션 애널리틱스 통화 옵션

반환:

void

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

추천 이벤트 매개변수 목록은 GA4 참조 문서에서 확인할 수 있습니다.

서명:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'login', eventParams?: {
    method?: EventParams['method'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName '로그인'
eventParams { 메서드?: EventParams['method']; [key: string]: any; }
옵션 애널리틱스 통화 옵션

반환:

void

logEvent(analyticsInstance, eventName, eventParams, options)

지정된 eventParams를 사용하여 Google 애널리틱스 이벤트를 전송합니다. 이 메서드는 로깅된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

페이지 조회수를 참고하세요.

서명:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'page_view', eventParams?: {
    page_title?: string;
    page_location?: string;
    page_path?: string;
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
eventName '페이지 조회'
eventParams { page_title?: string; page_location?: string; page_path?: string; [key: string]: any; }
옵션 애널리틱스 통화 옵션

반환:

void

setAnalyticsCollectionEnabled(analyticsInstance, enabled)

이 기기에서 이 앱에 대해 Google 애널리틱스 수집을 사용 설정할지 설정합니다. 전역 window['ga-disable-analyticsId'] = true; 설정

서명:

export declare function setAnalyticsCollectionEnabled(analyticsInstance: Analytics, enabled: boolean): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스 Analytics 인스턴스입니다.
사용 설정됨 부울 true인 경우 컬렉션을 활성화하고, false인 경우 수집을 중지합니다.

반환:

void

setCurrentScreen(analyticsInstance, screenName, options)

<ph type="x-smartling-placeholder">
</ph>

eventName를 'screen_view'로 사용 관련성 높은 eventParams를 추가합니다. 화면 조회수 추적을 참고하세요.

gtag config 명령어를 사용하여 screen_name을 설정합니다.

서명:

export declare function setCurrentScreen(analyticsInstance: Analytics, screenName: string, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스 Analytics 인스턴스입니다.
화면 이름 문자열 설정할 화면 이름입니다.
옵션 애널리틱스 통화 옵션

반환:

void

setUserId(analyticsInstance, id, options)

gtag config 명령어를 사용하여 user_id을 설정합니다.

서명:

export declare function setUserId(analyticsInstance: Analytics, id: string | null, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스 Analytics 인스턴스입니다.
id 문자열 | 없음 설정할 사용자 ID입니다.
옵션 애널리틱스 통화 옵션

반환:

void

setUserProperties(analyticsInstance, properties, options)

gtag config 명령어를 사용하여 지정된 모든 매개변수를 설정합니다.

서명:

export declare function setUserProperties(analyticsInstance: Analytics, properties: CustomParams, options?: AnalyticsCallOptions): void;

매개변수

매개변수 유형 설명
analyticsInstance 애널리틱스
속성 CustomParams
옵션 애널리틱스 통화 옵션

반환:

void

함수()

isSupported()

이는 사용자에게 제공되는 공개 정적 메서드로, 네 가지 검사를 래핑합니다.

  1. 브라우저 확장 프로그램 환경이 아닌지 확인합니다. 2. 현재 브라우저에서 쿠키가 사용 설정되어 있는지 확인합니다. 3. IndexedDB가 브라우저 환경에서 지원되는지 확인합니다. 4. IndexedDB.open() 사용에 현재 브라우저 컨텍스트가 유효한지 확인합니다.

서명:

export declare function isSupported(): Promise<boolean>;

반환:

Promise&lt;boolean&gt;

function(consentSettings, ...)

setConsent(consentSettings)

Firebase 애널리틱스가 초기화되면 모든 gtag 참조에서 이 웹 앱에 적용되는 최종 사용자 동의 상태를 설정합니다.

개별 동의 유형 값을 지정하려면 ConsentSettings를 사용하세요. 기본적으로 동의 유형은 '부여됨'으로 설정됩니다.

서명:

export declare function setConsent(consentSettings: ConsentSettings): void;

매개변수

매개변수 유형 설명
동의 설정 ConsentSettings gtag.js에 대해 해당하는 최종 사용자 동의 상태를 매핑합니다.

반환:

void

function(customParams, ...)

setDefaultEventParameters(customParams)

자동 이벤트를 포함하여 SDK에서 로깅되는 모든 이벤트에 설정될 데이터를 추가합니다. gtag의 'set' 포함 명령의 경우, 전달된 값은 현재 페이지에 유지되며 이후의 모든 이벤트와 함께 전달됩니다.

서명:

export declare function setDefaultEventParameters(customParams: CustomParams): void;

매개변수

매개변수 유형 설명
customParams CustomParams 사용자가 gtag.js에 전달할 수 있는 모든 맞춤 매개변수입니다.

반환:

void

function(options, ...)

설정(옵션)

맞춤 gtag 또는 dataLayer 이름을 사용하도록 Firebase 애널리틱스를 구성합니다. gtag.js 스크립트가 Firebase 애널리틱스와 별개로 이 페이지에 설치되어 있고 gtag 함수 또는 dataLayer에 기본이 아닌 이름을 사용하는 경우 사용하기 위한 용도입니다. getAnalytics()를 호출하기 전에 호출해야 합니다. 그렇지 않으면 아무런 영향을 미치지 않습니다.

서명:

export declare function settings(options: SettingsOptions): void;

매개변수

매개변수 유형 설명
옵션 설정 옵션 맞춤 gtag 및 dataLayer 이름.

반환:

void

ConsentStatusString

특정 동의 유형의 수락 또는 거부 여부입니다.

서명:

export declare type ConsentStatusString = 'granted' | 'denied';

통화

표준 Google 애널리틱스 통화 유형입니다.

서명:

export declare type Currency = string | number;

맞춤 이벤트 이름

표준 추천 이벤트 이름 목록에 없는 맞춤 이벤트 이름 문자열

서명:

export declare type CustomEventName<T> = T extends EventNameString ? never : T;

이벤트 이름 문자열

표준 Google 애널리틱스 이벤트 이름의 유형입니다. logEvent도 모든 맞춤 문자열을 허용하고 이를 맞춤 이벤트 이름으로 해석합니다.

서명:

export declare type EventNameString = 'add_payment_info' | 'add_shipping_info' | 'add_to_cart' | 'add_to_wishlist' | 'begin_checkout' | 'checkout_progress' | 'exception' | 'generate_lead' | 'login' | 'page_view' | 'purchase' | 'refund' | 'remove_from_cart' | 'screen_view' | 'search' | 'select_content' | 'select_item' | 'select_promotion' | 'set_checkout_option' | 'share' | 'sign_up' | 'timing_complete' | 'view_cart' | 'view_item' | 'view_item_list' | 'view_promotion' | 'view_search_results';