자동 수집 이벤트는 앱 또는 사이트(아래 표에서 이벤트 이름 아래에 표시됨)와의 기본적인 상호작용에 의해 트리거됩니다. Google 태그 또는 Firebase용 Google 애널리틱스 SDK를 사용하면 추가로 코드를 작성하지 않아도 이러한 이벤트를 수집할 수 있습니다.
별도로 명시되지 않는 한 애널리틱스는 Android 및 iOS 앱의 이벤트를 수집합니다. 이러한 이벤트의 이름과 매개변수는 BigQuery의 원시 이벤트 데이터에 액세스할 때 유용합니다.
아래에 나온 각 이벤트 매개변수와 Google 애널리틱스에서 각 매개변수가 측정기준 또는 측정항목을 업데이트하는 방식을 알아보려면 Google 애널리틱스 이벤트 매개변수를 참고하세요.
참고:
다음은 맞춤 이벤트를 비롯한 모든 이벤트와 함께 기본적으로 수집되는 여러 매개변수입니다.
- 웹 스트림:
- language
- page_location
- page_referrer
- page_title
- screen_resolution
- 앱 스트림:
- app_version
- firebase_screen_id
- firebase_screen_class
이벤트 매개변수에 할당된 값은 100자(영문 기준) 이하여야 합니다. page_title 매개변수는 300자(영문 기준) 이하여야 합니다. page_referrer 매개변수는 420자(영문 기준) 이하여야 합니다. page_location 매개변수는 1,000자(영문 기준) 이하여야 합니다.
page_location 매개변수를 재정의하는 경우 URL 경로가 올바른지 확인하세요. 잘못된 URL 경로를 할당하면 페이지 위치 측정기준이 비어 있게 됩니다. 캠페인 URL 작성 도구를 사용하여 URL 경로가 유효한지 확인할 수 있습니다.
화면 조회수 추적을 사용 중지하지 않는 한 firebase_screen_id 및 firebase_screen_class 매개변수는 자동으로 수집됩니다.
| 이벤트 | 자동으로 트리거되는 시점 | 매개변수 |
|---|---|---|
|
ad_click (앱) |
사용자가 광고를 클릭할 때 AdMob에서 Google 모바일 광고 SDK를 통해서나 Ad Manager에서 Ad Manager 통합을 통해 수신되는 게시자 이벤트 이 이벤트는 BigQuery로 내보내지 못합니다. |
ad_event_id |
|
ad_exposure (앱) |
모바일 광고 SDK에서 게재하는 광고가 화면에 하나 이상 있을 때 이 이벤트는 보고서에 표시되지 않으며 BigQuery로 내보내지 못합니다. |
firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time |
|
ad_impression (앱) |
사용자가 노출된 광고를 볼 때 AdMob에서 Google 모바일 광고 SDK를 통해서나 Ad Manager에서 Ad Manager 통합을 통해 수신되는 게시자 이벤트 이 이벤트는 BigQuery로 내보내지 못합니다. 참고: |
ad_event_id, value |
|
ad_query (앱) |
모바일 광고 SDK에서 광고를 요청할 때 이 이벤트는 보고서에 표시되지 않으며 BigQuery로 내보내지 못합니다. |
ad_event_id |
|
ad_reward (앱) |
모바일 광고 SDK에서 게재하는 보상형 광고를 통해 리워드가 부여될 때 | ad_unit_code, reward_type, reward_value |
|
adunit_exposure (앱) |
모바일 광고 SDK에서 게재하는 광고 단위가 화면에 표시될 때 이 이벤트는 보고서에 표시되지 않으며 BigQuery로 내보내지 못합니다. |
firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time |
|
app_clear_data (앱) |
사용자가 앱 데이터를 재설정 또는 삭제하여 모든 설정과 로그인 데이터를 삭제할 때 Android만 해당 |
|
|
app_exception (앱) |
앱이 비정상 종료되거나 장애 또는 예외가 발생할 때 이 이벤트는 Firebase Crashlytics를 통합할 때 전송됩니다. |
fatal, timestamp, engagement_time_msec |
|
app_remove (앱) |
애플리케이션 패키지가 Android 기기에서 삭제(제거)될 때 Android만 해당 |
|
|
app_store_refund (앱) |
Google Play에서 인앱 구매를 환불할 때 Android만 해당 이 이벤트는 BigQuery로 내보내지 못합니다. |
product_id, value, currency, quantity |
|
app_store_ subscription_cancel (앱) |
Google Play에서 유료 구독이 취소될 때 Android만 해당 최초 구독 일자가 2019년 7월 1일 이후여야 합니다. 이 이벤트는 BigQuery로 내보내지 못합니다. |
product_id, price, value, currency, cancellation_reason |
|
app_store_ subscription_convert (앱) |
무료 체험 구독이 유료 구독으로 전환될 때 이 이벤트는 기본 주요 이벤트로 설정됩니다. 최초 구독 일자가 2019년 7월 1일 이후여야 합니다. 초기 무료 체험판 구독은 in_app_purchase로 기록되며 subscription 매개변수가 true로 설정됩니다. 이 이벤트는 BigQuery로 내보내지 못합니다. |
product_id, price, value, currency, quantity |
|
app_store_ subscription_renew (앱) |
유료 구독이 갱신될 때 이 이벤트는 기본 주요 이벤트로 설정됩니다. 최초 구독 일자가 2019년 7월 1일 이후여야 합니다. 이 이벤트는 BigQuery로 내보내지 못합니다. |
product_id, price, value, currency, quantity, renewal_count |
|
app_update (앱) |
앱이 새 버전으로 업데이트되고 다시 실행될 때 이전 앱 버전 ID가 매개변수로 전달됩니다. 이 이벤트는 Google Play Console에서 보고하는 일일 기기 업그레이드 수 측정항목과 다른 개념입니다. 업그레이드는 애플리케이션 바이너리의 업데이트를 의미하지만, app_update 이벤트는 업그레이드된 앱이 이후에 실행될 때 트리거됩니다. |
previous_app_version |
|
click (웹) |
사용자가 현재 도메인에서 나가는 링크를 클릭할 때마다 기본적으로 외부 연결 링크 클릭 이벤트는 현재 도메인 외부로 연결되는 모든 링크에 대해 발생합니다. 교차 도메인 측정 용도로 구성된 도메인으로 연결되는 링크는 외부 연결 링크 클릭 이벤트를 트리거하지 않습니다. 매개변수는 다음 측정기준을 채웁니다. 기본적으로 향상된 측정을 통해 수집됩니다. |
link_classes, link_domain, link_id, link_url, outbound(불리언) |
|
dynamic_link_app_open (앱) |
사용자가 동적 링크를 통해 앱을 다시 열 때 참고: Firebase 동적 링크는 현재 지원 중단되었으므로 이 이벤트는 단계적으로 중단됩니다. 이 변경사항에 대해 자세히 알아보기 |
source, medium, campaign, link_id, accept_time |
|
dynamic_link_ app_update (앱) |
앱이 새 버전으로 업데이트되고 동적 링크를 통해 열릴 때 Android만 해당 참고: Firebase 동적 링크는 현재 지원 중단되었으므로 이 이벤트는 단계적으로 중단됩니다. 이 변경사항에 대해 자세히 알아보기 |
source, medium, campaign, link_id, accept_time |
|
dynamic_link_ first_open (앱) |
사용자가 동적 링크를 통해 처음으로 앱을 열 때 참고: Firebase 동적 링크는 현재 지원 중단되었으므로 이 이벤트는 단계적으로 중단됩니다. 이 변경사항에 대해 자세히 알아보기 |
source, medium, campaign, link_id, accept_time |
|
error (앱) |
오류가 있어 기록될 수 없는 이벤트 대신 기록됩니다. 이 이벤트는 보고서에 표시되지 않으며 BigQuery로 내보내지 못합니다. |
firebase_error, firebase_error_value |
|
file_download (웹) |
사용자가 다음 유형의 파일(일반 파일 확장자 포함)로 연결되는 링크를 클릭할 때
이 이벤트는 기본적으로 향상된 측정을 통해 수집됩니다. 이벤트를 트리거하는 파일 확장자 보기 |
file_extension, file_name link_classes, link_id, link_text, link_url |
|
firebase_campaign (앱) |
캠페인 매개변수가 있는 상태로 앱이 실행될 때 |
source, medium, campaign, term, content, gclid, aclid, cp1, anid, click_timestamp, campaign_info_source |
|
firebase_in_app_ message_action (앱) |
사용자가 Firebase 인앱 메시지에서 특정 액션을 수행할 때 | message_name, message_device_time, message_id |
|
firebase_in_app_ message_dismiss (앱) |
사용자가 Firebase 인앱 메시지를 닫을 때 | message_name, message_device_time, message_id |
|
firebase_in_app_ message_impression (앱) |
사용자에게 Firebase 인앱 메시지가 표시될 때 | message_name, message_device_time, message_id |
|
first_open (앱) |
앱 설치 또는 재설치 후 처음으로 앱을 실행할 때 이 이벤트는 사용자가 기기에 앱을 다운로드할 때가 아니라 앱을 처음으로 사용할 때 트리거됩니다. 순수 다운로드 횟수는 Google Play Console 또는 iTunesConnect에서 확인하세요. Apple의 iOS 14 앱 추적 프롬프트를 수락하는 사용자의 first_open 주요 이벤트 측정을 지원합니다. |
previous_gmp_app_id, updated_with_analytics, previous_first_open_count, system_app, system_app_update, deferred_analytics_collection, reset_analytics_cause, engagement_time_msec |
|
first_visit (앱, 웹) |
사용자가 웹사이트를 처음 방문하거나 애널리틱스를 사용하는 Android 인스턴트 앱을 처음으로 실행할 때 | client_id, ga_session_id, ga_session_number, ignore_referrer, page_location, page_referrer, page_title, traffic_type |
|
form_start (웹) |
사용자가 한 세션에서 처음으로 양식과 상호작용할 때 기본적으로 향상된 측정을 통해 수집됩니다. |
form_id, form_name, form_destination |
|
form_submit (웹) |
사용자가 양식을 제출할 때 기본적으로 향상된 측정을 통해 수집됩니다. |
form_id, form_name, form_destination, form_submit_text |
|
in_app_purchase (앱) |
사용자가 Apple App Store 또는 Google Play 스토어에서 최초 구독을 포함한 인앱 구매를 완료할 때 제품 ID, 제품 이름, 통화, 수량이 매개변수로 전달됩니다. 이 이벤트는 Firebase용 Google 애널리틱스 SDK가 포함된 앱 버전에 의해서만 트리거됩니다. Android Android 앱의 인앱 구매 데이터를 확인하려면 애널리틱스를 Google Play에 연결하세요. 애널리틱스에서는 유료 앱 구매 수익을 자동으로 측정하지 않습니다. 또한 Google 애널리틱스에 보고된 수익은 Google Play Console에 표시되는 값과 다를 수 있습니다. 애널리틱스에서는 무효 또는 테스트로 신고된 이벤트를 무시합니다. Google Play 결제 테스트에 대해 자세히 알아보세요. iOS 애널리틱스에서는 유료 앱 구매 수익과 환불을 자동으로 측정하지 않습니다. 애널리틱스에서는 무효 또는 샌드박스로 신고된 이벤트를 무시합니다. |
product_id, price, value, currency, quantity, subscription, free_trial, introductory_price |
|
notification_dismiss (앱) |
사용자가 FCM(Firebase 클라우드 메시징)에서 보낸 알림을 닫을 때 Android만 해당 |
message_name, message_time, message_device_time, message_id, topic, label, message_channel |
|
notification_foreground (앱) |
앱이 포그라운드에 있는 동안에 FCM에서 보낸 알림이 수신될 때 | message_name, message_time, message_device_time, message_id, topic, label, message_channel, message_type |
|
notification_open (앱) |
FCM에서 보낸 알림을 사용자가 열 때 | message_name, message_time, message_device_time, message_id, topic, label, message_channel |
|
notification_receive (앱) |
앱이 백그라운드에 있는 동안 FCM에서 보낸 알림이 기기에 수신될 때 Android만 해당 |
message_name, message_time, message_device_time, message_id, topic, label, message_channel, message_type |
|
os_update (앱) |
기기 운영체제가 새 버전으로 업데이트될 때. 이전 운영체제 버전 ID가 매개변수로 전달됩니다. | previous_os_version |
|
page_view (웹) |
페이지가 로드되거나 활성 사이트에서 브라우저 기록 상태가 변할 때 기본적으로 향상된 측정을 통해 수집됩니다. |
page_location(페이지 URL), page_referrer(이전 페이지 URL), engagement_time_msec |
|
screen_view (앱) |
화면 전환이 발생하고 다음 기준 중 하나가 충족될 때
|
firebase_screen, firebase_screen_class, firebase_screen_id, firebase_previous_screen, firebase_previous_class, firebase_previous_id, engagement_time_msec |
|
scroll (웹) |
사용자가 각 페이지에서 처음으로 하단에 도달할 때(세로 기준으로 페이지의 90% 이상이 표시될 때) 기본적으로 향상된 측정을 통해 수집됩니다. |
engagement_time_msec |
|
session_start (앱, 웹) |
사용자가 앱 또는 웹사이트에 참여할 때 세션 ID 및 세션 번호는 세션마다 자동으로 생성되어 세션의 각 이벤트와 연결됩니다. 자세히 알아보기 |
client_id, ga_session_id, ga_session_number, ignore_referrer, page_location, page_referrer, page_title, traffic_type |
|
user_engagement (앱, 웹) |
앱이 포그라운드에 있거나 웹페이지가 최소 1초간 포커스 내에 있을 때 자세히 알아보기 |
engagement_time_msec |
|
video_complete (웹) |
동영상이 끝날 때 JS API 지원이 가능한 삽입된 YouTube 동영상의 경우 기본적으로 향상된 측정을 통해 수집됩니다. |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible(불리언) |
|
video_progress (웹) |
동영상 재생 시간이 전체 시간의 10%, 25%, 50%, 75%를 넘을 때 JS API 지원이 가능한 삽입된 YouTube 동영상의 경우 기본적으로 향상된 측정을 통해 수집됩니다. |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible(불리언) |
|
video_start (웹) |
동영상 재생이 시작될 때 JS API 지원이 가능한 삽입된 YouTube 동영상의 경우 기본적으로 향상된 측정을 통해 수집됩니다. |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible(불리언) |
|
view_search_results (웹) |
사용자가 사이트 검색을 할 때마다(URL 쿼리 매개변수가 있을 경우 사이트 검색을 한 것으로 간주) 기본적으로 향상된 측정을 통해 수집됩니다. |
search_term, 선택적으로 'q_<additional key="">'(이때 <additional key="">는 고급 설정에서 수집하도록 지정한 추가 쿼리 매개변수와 일치함) 참고: 이 이벤트는 값이 1인 경우(즉, 문자열이 해당 세션에 고유한 경우)에만 unique_search_term 매개변수를 전송합니다. |
참고: 다음 정규식과 일치하는 파일 확장자는 file_download 이벤트를 트리거합니다.
pdf|xlsx?|docx?|txt|rtf|csv|exe|key|pp(s|t|tx)|7z|pkg|rar|gz|zip|avi|mov|mp4|mpe?g|wmv|midi?|mp3|wav|wma