analytics package

Firebase Analytics 웹 SDK. 이 SDK는 Node.js 환경에서 작동하지 않습니다.

기능

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

인터페이스

상호 작용 설명
해석학 Firebase Analytics의 인스턴스입니다.
Analytics통화옵션 logEvent 등과 같은 Analytics 메소드 호출에 전달할 수 있는 추가 옵션입니다.
Analytics설정 Analytics 인스턴스 초기화 옵션.
동의설정 동의 유형별 동의 상태를 설정합니다. 자세한 내용은 동의 상태 및 동의 유형에 대한 GA4 참조 문서를 확인하세요. .
ControlParams 표준 gtag.js 제어 매개변수. 자세한 내용은 GA4 참조 문서를 확인하세요. .
CustomParams 사용자가 gtag 에 전달할 수 있는 모든 맞춤 매개변수입니다.
EventParams 표준 gtag.js 이벤트 매개변수입니다. 자세한 내용은 GA4 참조 문서를 확인하세요. .
GtagConfigParams gtag.js 에서 인식되는 일반적인 Google Analytics 구성 설정 집합입니다.
안건 표준 Google Analytics Item 유형.
홍보 이전에 일부 Google Analytics 이벤트에서 사용된 필드입니다.
설정옵션 Firebase Analytics 인스턴스에 대한 맞춤 옵션을 지정합니다. firebase.analytics() 초기화하기 전에 이를 설정해야 합니다.

유형 별칭

유형 별칭 설명
동의상태문자열 특정 동의 유형이 승인되었는지 또는 거부되었는지 여부입니다.
통화 표준 Google Analytics 통화 유형입니다.
맞춤이벤트 이름 권장 이벤트 이름의 표준 목록에 없는 맞춤 이벤트 이름 문자열입니다.
이벤트 이름 문자열 표준 Google Analytics 이벤트 이름을 입력합니다. logEvent 또한 모든 사용자 정의 문자열을 허용하고 이를 사용자 정의 이벤트 이름으로 해석합니다.

기능(앱, ...)

getAnalytics(앱)

지정된 앱에 대한 Analytics 인스턴스를 반환합니다.

서명:

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

매개변수

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

보고:

해석학

초기화분석(앱, 옵션)

지정된 앱에 대한 Analytics 인스턴스를 반환합니다.

서명:

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

매개변수

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

보고:

해석학

함수(analyticsInstance, ...)

getGoogleAnalyticsClientId(analyticsInstance)

웹 클라이언트에 대한 고유한 Google Analytics 식별자를 검색합니다. client_id 보기 .

서명:

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

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학

보고:

약속<문자열>

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 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;

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 '추가_결제_정보'
eventParams { 쿠폰?: EventParams ['쿠폰']; 통화?: EventParams ['통화']; 항목?: EventParams ['항목']; Payment_type?: EventParams ['결제_유형']; 값?: EventParams ['값']; [키: 문자열]: 모두; }
옵션 Analytics통화옵션

보고:

무효의

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 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;

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 '구매' | '환불하다'
eventParams { 값?: EventParams ['값']; 통화?: EventParams ['통화']; transaction_id: EventParams ['거래_ID']; 세금?: EventParams ['세']; 배송 여부: EventParams ['배송']; 항목?: EventParams ['항목']; 쿠폰?: EventParams ['쿠폰']; 소속 여부: EventParams ['입회']; [키: 문자열]: 모두; }
옵션 Analytics통화옵션

보고:

무효의

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 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;

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 '화면_뷰'
eventParams { firebase_screen: EventParams ['firebase_screen']; firebase_screen_class: EventParams ['firebase_screen_class']; [키: 문자열]: 모두; }
옵션 Analytics통화옵션

보고:

무효의

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 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;

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 '검색' | 'view_search_results'
eventParams { 검색어?: EventParams ['검색어']; [키: 문자열]: 모두; }
옵션 Analytics통화옵션

보고:

무효의

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 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;

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 '선택_콘텐츠'
eventParams { content_type?: EventParams ['컨텐츠 타입']; item_id?: EventParams ['항목_ID']; [키: 문자열]: 모두; }
옵션 Analytics통화옵션

보고:

무효의

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 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;

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 '물품을 고르시 오'
eventParams { 항목?: EventParams ['항목']; item_list_name?: EventParams ['항목_목록_이름']; item_list_id?: EventParams ['항목_목록_ID']; [키: 문자열]: 모두; }
옵션 Analytics통화옵션

보고:

무효의

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 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;

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 '선택_프로모션' | '보기_프로모션'
eventParams { 항목?: EventParams ['항목']; Promotion_id?: EventParams ['프로모션_ID']; Promotion_name?: EventParams ['프로모션_이름']; [키: 문자열]: 모두; }
옵션 Analytics통화옵션

보고:

무효의

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 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;

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 'set_checkout_option'
eventParams { checkout_step?: EventParams ['체크아웃_단계']; checkout_option?: EventParams ['체크아웃_옵션']; [키: 문자열]: 모두; }
옵션 Analytics통화옵션

보고:

무효의

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 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;

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 '공유하다'
eventParams { 방법?: EventParams ['방법']; content_type?: EventParams ['컨텐츠 타입']; item_id?: EventParams ['항목_ID']; [키: 문자열]: 모두; }
옵션 Analytics통화옵션

보고:

무효의

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

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

서명:

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

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 '가입하기'
eventParams { 방법?: EventParams ['방법']; [키: 문자열]: 모두; }
옵션 Analytics통화옵션

보고:

무효의

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 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;

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 '타이밍_완료'
eventParams { 이름: 문자열; 값: 숫자; event_category?: 문자열; event_label?: 문자열; [키: 문자열]: 모두; }
옵션 Analytics통화옵션

보고:

무효의

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 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;

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 '추가_배송_정보'
eventParams { 쿠폰?: EventParams ['쿠폰']; 통화?: EventParams ['통화']; 항목?: EventParams ['항목']; Shipping_tier?: EventParams ['배송_등급']; 값?: EventParams ['값']; [키: 문자열]: 모두; }
옵션 Analytics통화옵션

보고:

무효의

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 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;

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 '보기_카트' | '아이템보기'
eventParams { 통화?: EventParams ['통화']; 항목?: EventParams ['항목']; 값?: EventParams ['값']; [키: 문자열]: 모두; }
옵션 Analytics통화옵션

보고:

무효의

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 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;

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 'view_item_list'
eventParams { 항목?: EventParams ['항목']; item_list_name?: EventParams ['항목_목록_이름']; item_list_id?: EventParams ['항목_목록_ID']; [키: 문자열]: 모두; }
옵션 Analytics통화옵션

보고:

무효의

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

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

서명:

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

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 맞춤이벤트 이름 <티>
eventParams { [키: 문자열]: 임의; }
옵션 Analytics통화옵션

보고:

무효의

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 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;

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 '장바구니에 추가' | '위시리스트에 추가' | 'remove_from_cart'
eventParams { 통화?: EventParams ['통화']; 값?: EventParams ['값']; 항목?: EventParams ['항목']; [키: 문자열]: 모두; }
옵션 Analytics통화옵션

보고:

무효의

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 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;

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 'begin_checkout'
eventParams { 통화?: EventParams ['통화']; 쿠폰?: EventParams ['쿠폰']; 값?: EventParams ['값']; 항목?: EventParams ['항목']; [키: 문자열]: 모두; }
옵션 Analytics통화옵션

보고:

무효의

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 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;

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 '체크아웃_진행'
eventParams { 통화?: EventParams ['통화']; 쿠폰?: EventParams ['쿠폰']; 값?: EventParams ['값']; 항목?: EventParams ['항목']; checkout_step?: EventParams ['체크아웃_단계']; checkout_option?: EventParams ['체크아웃_옵션']; [키: 문자열]: 모두; }
옵션 Analytics통화옵션

보고:

무효의

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

예외 측정을 참조하세요. .

서명:

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

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 '예외'
eventParams { 설명?: EventParams ['설명']; 치명적?: EventParams ['치명적인']; [키: 문자열]: 모두; }
옵션 Analytics통화옵션

보고:

무효의

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

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

서명:

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

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 'generate_lead'
eventParams { 값?: EventParams ['값']; 통화?: EventParams ['통화']; [키: 문자열]: 모두; }
옵션 Analytics통화옵션

보고:

무효의

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 Firebase 웹 앱 인스턴스와 자동으로 연결합니다.

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

서명:

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

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 '로그인'
eventParams { 방법?: EventParams ['방법']; [키: 문자열]: 모두; }
옵션 Analytics통화옵션

보고:

무효의

logEvent(analyticsInstance, eventName, eventParams, 옵션)

주어진 eventParams 사용하여 Google Analytics 이벤트를 보냅니다. . 이 메소드는 기록된 이벤트를 이 기기의 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;

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
이벤트 이름 '페이지보기'
eventParams { 페이지 제목?: 문자열; 페이지 위치?: 문자열; 페이지_경로?: 문자열; [키: 문자열]: 모두; }
옵션 Analytics통화옵션

보고:

무효의

setAnalyticsCollectionEnabled(analyticsInstance, 활성화됨)

이 기기에서 이 앱에 대해 Google Analytics 수집을 활성화할지 여부를 설정합니다. 전역 window['ga-disable-analyticsId'] = true;

서명:

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

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학 Analytics 인스턴스.
활성화됨 부울 true인 경우 수집을 활성화하고, false인 경우 비활성화합니다.

보고:

무효의

setCurrentScreen(analyticsInstance, screenName, 옵션)

eventName 'screen_view'로 사용하고 관련 eventParams 추가하세요. . 화면 조회수 추적 보기 .

gtag config 명령어를 사용하여 screen_name 설정 .

서명:

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

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학 Analytics 인스턴스.
화면 이름 설정할 화면 이름입니다.
옵션 Analytics통화옵션

보고:

무효의

setUserId(analyticsInstance, id, 옵션)

gtag config 명령어를 사용하여 user_id 설정 .

서명:

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

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학 Analytics 인스턴스.
ID 문자열 | 없는 설정할 사용자 ID입니다.
옵션 Analytics통화옵션

보고:

무효의

setUserProperties(analyticsInstance, 속성, 옵션)

지정된 모든 매개변수를 설정하려면 gtag config 명령어를 사용하세요.

서명:

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

매개변수

매개변수 유형 설명
Analytics인스턴스 해석학
속성 CustomParams
옵션 Analytics통화옵션

보고:

무효의

기능()

지원됨()

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

  1. 브라우저 확장 환경이 아닌지 확인하세요. 2. 현재 브라우저에서 쿠키가 활성화되어 있는지 확인하세요. 3. 브라우저 환경에서 IndexedDB를 지원하는지 확인하세요. 4. 현재 브라우저 컨텍스트가 IndexedDB.open() 사용하기에 유효한지 확인하십시오. .

서명:

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

보고:

약속<부울>

함수(동의설정, ​​...)

setConsent(동의설정)

Firebase Analytics가 초기화되면 모든 gtag 참조에서 이 웹 앱에 적용 가능한 최종 사용자 동의 상태를 설정합니다.

ConsentSettings를 사용하여 개별 동의 유형 값을 지정합니다. 기본적으로 동의 유형은 "허용됨"으로 설정됩니다.

서명:

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

매개변수

매개변수 유형 설명
동의설정 동의설정 gtag.js에 적용 가능한 최종 사용자 동의 상태를 매핑합니다.

보고:

무효의

함수(customParams, ...)

setDefaultEventParameters(customParams)

자동 이벤트를 포함하여 SDK에서 기록된 모든 이벤트에 대해 설정될 데이터를 추가합니다. gtag의 'set' 명령어를 사용하면 전달된 값이 현재 페이지에 유지되며 모든 후속 이벤트와 함께 전달됩니다.

서명:

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

매개변수

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

보고:

무효의

기능(옵션, ...)

설정(옵션)

맞춤 gtag 또는 dataLayer 이름을 사용하도록 Firebase Analytics를 구성합니다. gtag.js 스크립트가 Firebase Analytics와 별도로 이 페이지에 설치되었으며 gtag 함수 또는 dataLayer 에 기본이 아닌 이름을 사용하는 경우에 사용됩니다. . getAnalytics() 호출하기 전에 호출해야 합니다. 그렇지 않으면 아무런 효과가 없습니다.

서명:

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

매개변수

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

보고:

무효의

동의상태문자열

특정 동의 유형이 승인되었는지 또는 거부되었는지 여부입니다.

서명:

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

통화

표준 Google Analytics 통화 유형입니다.

서명:

export declare type Currency = string | number;

맞춤이벤트 이름

권장 이벤트 이름의 표준 목록에 없는 맞춤 이벤트 이름 문자열입니다.

서명:

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

이벤트 이름 문자열

표준 Google Analytics 이벤트 이름을 입력합니다. 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';