API 측정기준 및 측정항목

애널리틱스 Data API 쿼리에서 지원되는 측정기준 및 측정항목입니다.

크기

모든 속성에서 보고서에 다음 측정기준을 요청할 수 있습니다. 보고서 측정기준의 측정기준 열에 대한 측정기준의 이름 필드에 'API 이름'을 지정합니다.

API 이름 UI 이름 설명
업적 ID 업적 ID 이벤트 게임의 업적 ID입니다. 이벤트 매개변수 'achievement_id'로 입력됩니다.
광고 형식 광고 형식 광고가 표시되는 방식과 위치를 설명합니다. 전형적인 형식으로 '전면 광고', '배너', '보상형', '네이티브 광고 고급형' 등이 있습니다.
광고 소스 이름 광고 소스 광고를 게재한 소스 네트워크입니다. 일반인 소스로는 'AdMob 네트워크', 'Liftoff', 'Facebook Audience Network', '중재된 하우스 광고'가 있습니다.
광고 단위 이름 광고 단위 이 광고 단위를 설명하기 위해 선택한 이름입니다. 광고 단위는 사용자에게 광고를 게재하기 위해 앱에 배치하는 컨테이너입니다.
appVersion 앱 버전 앱의 버전 이름(Android) 또는 약식 번들 버전(iOS)입니다.
잠재고객 ID 잠재고객 ID 잠재고객의 숫자 식별자입니다. 사용자는 보고서 기간 동안 사용자가 속한 잠재고객으로 보고됩니다. 현재 사용자 행동은 보고서의 이전 잠재고객 멤버십에 영향을 미치지 않습니다.
잠재고객 이름 잠재고객 이름 잠재고객의 이름입니다. 사용자는 보고서 기간 동안 사용자가 속한 잠재고객으로 보고됩니다. 현재 사용자 행동은 보고서의 이전 잠재고객 멤버십에 영향을 미치지 않습니다.
brandingInterest 관심분야 쇼핑 유입경로에서 상위 단계에 있는 사용자가 보여준 관심분야입니다. 사용자가 여러 관심분야 카테고리의 집계에 포함될 수 있습니다. 예: '쇼핑객', '라이프스타일 및 취미/애완견 애호가', '여행/여행 애호가/해변 여행자'
브라우저 브라우저 웹사이트를 볼 때 사용한 브라우저입니다.
캠페인 ID 캠페인 ID 마케팅 캠페인의 식별자입니다. 전환 이벤트에 대해서만 표시됩니다. Google Ads 캠페인, 수동 캠페인 및 기타 캠페인이 포함됩니다.
캠페인 이름 실행 마케팅 캠페인의 이름입니다. 전환 이벤트에 대해서만 표시됩니다. Google Ads 캠페인, 수동 캠페인 및 기타 캠페인이 포함됩니다.
문자 글자 이벤트 게임 속 플레이어 캐릭터입니다. 이벤트 매개변수 'character'로 입력됩니다.
city 도시 사용자 활동이 시작된 도시입니다.
cityId 도시 ID 사용자 활동이 발생한 도시의 지역 ID(IP 주소 기준)입니다.
cohort 동질 집단 요청에 있는 동질 집단의 이름입니다. 동질 집단이란 연속된 그룹의 그룹에서 웹사이트 또는 앱을 사용하기 시작한 사용자 집합을 말합니다. 요청에 동질 집단 이름이 지정되어 있지 않으면 동질 집단의 이름이 0 기준 색인(사용자 집단_0, 동질 집단_1 등)에 따라 지정됩니다.
cohortNthDay 일간 사용자 집단 동질 집단의 사용자에 대한 firstSessionDate를 기준으로 한 날짜 오프셋입니다. 예를 들어 시작일과 종료일이 2020-03-01인 동질 집단이 선택된 경우 2020-03-02 날짜의 동질 집단은 0001이 됩니다.
cohortNthMonth 월간 사용자 집단 동질 집단의 사용자에 대한 firstSessionDate를 기준으로 한 월 오프셋입니다. 월 경계는 월 경계와 일치합니다. 예를 들어 시작일과 종료일이 2020년 3월인 동질 집단을 선택한 경우 2020년 4월의 경우 동질 집단 NthMonth는 0001이 됩니다.
cohortNthWeek 주간 사용자 집단 동질 집단의 사용자에 대한 firstSessionDate를 기준으로 한 주 오프셋입니다. 주는 일요일에 시작되어 토요일에 끝납니다. 예를 들어 시작일과 종료일이 2020-11-08~2020-11-14인 동질 집단을 선택한 경우 2020-11-15~2020-11-21 범위의 날짜는 동질 집단이 0001이 됩니다.
contentGroup 콘텐츠 그룹 게시된 콘텐츠의 항목에 적용되는 카테고리입니다. 이벤트 매개변수 'content_group'으로 입력됩니다.
콘텐츠 ID Content ID 선택한 콘텐츠의 식별자입니다. 이벤트 매개변수 'content_id'로 입력됩니다.
contentType 콘텐츠 유형 선택한 콘텐츠의 카테고리입니다. 이벤트 매개변수 'content_type'으로 입력됩니다.
continent 대륙 사용자 활동이 발생한 대륙입니다. 예: '미주' 또는 '아시아').
대륙 ID 대륙 ID 사용자 활동이 발생한 대륙의 지역 ID이며 IP 주소에서 가져옵니다.
국가 국가 사용자 활동이 시작된 국가입니다.
countryId 국가 ID 사용자 활동이 발생한 국가의 지역 ID(IP 주소 기준)입니다. ISO 3166-1 alpha-2 표준에 따라 형식이 지정되었습니다.
date 날짜 YYYYMMDD 형식으로 표시되는 이벤트 날짜입니다.
dateHour 날짜 + 시간(YYYYMMDDHH) YYYYMMDDHH 형식으로 된 날짜 및 시간의 합산 값입니다.
dateHourMinute 날짜, 시간, 분 YYYYMMDDHHMM 형식의 날짜, 시간, 분을 결합한 값입니다.
일차 01에서 31 사이의 2자리 숫자로 표시된 날입니다.
dayOfWeek 요일 요일의 정수입니다. 한 주의 첫날이 일요일인 [0,6] 범위의 값을 반환합니다.
요일 이름 요일 이름 요일(영어) 이 측정기준의 값은 일요일, 월요일 등입니다.
기본 채널 그룹 기본 채널 그룹 전환의 기본 채널 그룹은 주로 소스 및 매체를 기반으로 합니다. '직접', '자연 검색', '유료 소셜', '자연 소셜', '이메일', '제휴사', '추천', '유료 검색', '동영상', '디스플레이'를 포함하는 열거형입니다.
deviceCategory 기기 카테고리 기기의 유형(데스크톱, 태블릿, 모바일)입니다.
기기 모델 기기 모델 휴대기기 모델 (예: iPhone 10,6)입니다.
eventName 이벤트 이름 이벤트 이름
파일 확장자 파일 확장자 다운로드한 파일의 확장자입니다(예: 'pdf', 'txt'). 향상된 측정을 사용 설정하면 자동으로 채워집니다. 이벤트 매개변수 'file_extension'으로 입력됩니다.
파일 이름 파일 이름 다운로드한 파일의 페이지 경로(예: '/menus/dinner-menu.pdf')입니다. 향상된 측정을 사용 설정하면 자동으로 채워집니다. 이벤트 매개변수 'file_name'로 입력됩니다.
첫 번째 세션 날짜 첫 번째 세션 날짜 사용자의 첫 번째 세션이 발생한 날짜로, YYYYMMDD 형식입니다.
첫 사용자 캠페인 ID 신규 사용자 캠페인 ID 사용자를 처음 획득한 마케팅 캠페인의 식별자입니다. Google Ads 캠페인, 수동 캠페인 및 기타 캠페인이 포함됩니다.
첫 사용자 캠페인 이름 신규 사용자 캠페인 사용자를 최초로 획득한 마케팅 캠페인의 이름. Google Ads 캠페인, 수동 캠페인 및 기타 캠페인이 포함됩니다.
첫 사용자 기본 채널 그룹 신규 사용자 기본 채널 그룹 사용자를 처음 획득한 기본 채널 그룹입니다. 기본 채널 그룹은 주로 소스 및 매체를 기반으로 합니다. '직접', '자연 검색', '유료 소셜', '자연 소셜', '이메일', '제휴사', '추천', '유료 검색', '동영상', '디스플레이'를 포함하는 열거형입니다.
첫 사용자 Google Ads 계정 이름 첫 사용자 Google Ads 계정 이름 사용자를 처음 획득한 Google Ads의 계정 이름입니다.
첫 사용자 Google Ads 광고그룹 ID 첫 사용자 Google Ads 광고그룹 ID 사용자를 처음 획득한 Google Ads의 광고그룹 ID입니다.
첫 사용자 GoogleAdsAdGroupName 신규 사용자 Google Ads 광고그룹 이름 사용자를 처음 획득한 Google Ads의 광고그룹 이름입니다.
첫 사용자 Google Ads 광고 네트워크 유형 신규 사용자 Google Ads 광고 네트워크 유형 사용자를 최초로 획득한 광고 네트워크입니다. 'Google 검색', '검색 파트너', 'Google 디스플레이 네트워크', 'YouTube 검색', 'YouTube 동영상', '교차 네트워크', '소셜', '(유니버설 캠페인)'을 포함하는 열거형입니다.
첫 사용자 Google Ads 캠페인 ID 첫 사용자 Google Ads 캠페인 ID 사용자를 처음 획득한 Google Ads 마케팅 캠페인의 식별자입니다.
첫 사용자 Google Ads 캠페인 이름 첫 번째 사용자 Google Ads 캠페인 사용자를 처음 획득한 Google Ads 마케팅 캠페인의 이름입니다.
첫 사용자 Google Ads 캠페인 유형 첫 사용자 Google Ads 캠페인 유형 사용자를 처음 획득한 Google Ads 캠페인의 캠페인 유형입니다. 캠페인 유형에 따라 고객에게 광고가 게재되는 위치와 Google Ads에서 사용할 수 있는 설정 및 옵션이 달라집니다. 캠페인 유형은 Google 검색, 디스플레이, 쇼핑, 동영상, 디스커버리, 앱, 스마트, 호텔, 지역, 실적 최대화로 구성됩니다. 자세한 내용은 https://support.google.com/google-ads/answer/2567043을 참고하세요.
첫 사용자 Google Ads 광고 소재 ID 첫 사용자 Google Ads 광고 소재 ID 사용자를 처음 획득한 Google Ads 광고 소재의 ID입니다. 광고 소재 ID는 개별 광고를 식별합니다.
첫 사용자 Google Ads 고객 ID 첫 사용자 Google Ads 고객 ID 사용자를 처음 획득한 Google Ads의 고객 ID입니다. Google Ads의 고객 ID는 Google Ads 계정을 고유하게 식별합니다.
첫 사용자 Google Ads 키워드 첫 사용자 Google Ads 키워드 텍스트 사용자 획득이 처음 발생한 일치 키워드입니다. 키워드는 적합한 고객에게 광고를 게재하기 위해 선택한 제품 또는 서비스를 설명하는 단어나 구문입니다. 키워드에 대해 자세히 알아보려면 https://support.google.com/google-ads/answer/6323을 참조하세요.
첫 사용자 Google Ads 쿼리 첫 사용자 Google Ads 쿼리 사용자를 최초로 획득한 검색어입니다.
첫 사용자 수동 광고 콘텐츠 첫 번째 사용자 수동 광고 콘텐츠 사용자 획득이 처음 발생한 광고 콘텐츠입니다. utm_content 매개변수로 입력됩니다.
첫 사용자 수동 조건 첫 번째 사용자 수동 검색어 사용자를 최초로 획득한 용어. utm_term 매개변수로 입력됩니다.
첫 사용자 매체 신규 사용자 매체 웹사이트 또는 앱으로 사용자를 처음 획득한 매체입니다.
첫 사용자 소스 신규 사용자 소스 내 웹사이트 또는 앱으로 사용자를 처음 획득한 소스입니다.
첫 사용자 소스 매체 신규 사용자 소스/매체 측정기준 'firstUserSource'와 'firstUserMedium'의 결합된 값입니다.
첫 사용자 소스 플랫폼 신규 사용자 소스 플랫폼 사용자를 처음 획득한 소스 플랫폼입니다. UTM을 사용하는 트래픽의 경우 '수동'을 반환하는 필드에 의존하지 마세요. 이 필드는 예정된 기능 출시에서 '수동'을 반환하는 대신 '(설정되지 않음)'을 반환합니다.
fullPageUrl 전체 페이지 URL 방문한 웹페이지의 호스트 이름, 페이지 경로, 쿼리 문자열입니다. 예를 들어 https://www.example.com/store/contact-us?query_string=true의 fullPageUrl 부분은 www.example.com/store/contact-us?query_string=true입니다.
Google Ads 계정 이름 Google Ads 계정 이름 전환 이벤트로 이어진 캠페인의 Google Ads 계정 이름입니다. Google Ads API의 customer.descriptive_name에 해당합니다.
Google Ads 광고그룹 ID Google Ads 광고그룹 ID 전환 이벤트에 기여한 광고그룹 ID입니다.
Google Ads 광고그룹 이름 Google Ads 광고그룹 이름 전환 이벤트에 기여한 광고그룹 이름입니다.
Google Ads 광고 네트워크 유형 Google Ads 광고 네트워크 유형 전환의 광고 네트워크 유형입니다. 'Google 검색', '검색 파트너', 'Google 디스플레이 네트워크', 'YouTube 검색', 'YouTube 동영상', '교차 네트워크', '소셜', '(유니버설 캠페인)'을 포함하는 열거형입니다.
Google Ads 캠페인 ID Google Ads 캠페인 ID 전환 이벤트에 기여한 Google Ads 캠페인의 캠페인 ID입니다.
Google Ads 캠페인 이름 Google Ads 캠페인 전환 이벤트에 기여한 Google Ads 캠페인의 캠페인 이름입니다.
Google Ads 캠페인 유형 Google Ads 캠페인 유형 전환 이벤트에 기여한 Google Ads 캠페인의 캠페인 유형입니다. 캠페인 유형에 따라 고객에게 광고가 게재되는 위치와 Google Ads에서 사용할 수 있는 설정 및 옵션이 달라집니다. 캠페인 유형은 Google 검색, 디스플레이, 쇼핑, 동영상, 디스커버리, 앱, 스마트, 호텔, 지역, 실적 최대화로 구성됩니다. 자세한 내용은 https://support.google.com/google-ads/answer/2567043을 참고하세요.
Google Ads 광고 소재 ID Google Ads 광고 소재 ID 전환 이벤트에 기여한 Google Ads 광고 소재 ID입니다. 광고 소재 ID는 개별 광고를 식별합니다.
Google Ads 고객 ID Google Ads 고객 ID 전환 이벤트로 이어진 캠페인의 Google Ads 고객 ID입니다. Google Ads의 고객 ID는 Google Ads 계정을 고유하게 식별합니다.
Google Ads 키워드 Google Ads 키워드 텍스트 전환 이벤트로 이어진 일치 키워드입니다. 키워드는 적합한 고객에게 광고를 게재하기 위해 선택한 제품 또는 서비스를 설명하는 단어나 구문입니다. 키워드에 대해 자세히 알아보려면 https://support.google.com/google-ads/answer/6323을 참조하세요.
Google Ads 쿼리 Google Ads 검색어 전환 이벤트로 이어진 검색어입니다.
그룹 ID 그룹 ID 이벤트 게임의 플레이어 그룹 ID입니다. 이벤트 매개변수 'group_id'로 입력됩니다.
hostName 호스트 이름 URL의 하위 도메인 및 도메인 이름이 포함됩니다. 예를 들어 www.example.com/contact.html의 호스트 이름은 www.example.com입니다.
시간 시간 이벤트가 기록된 2자리 시간입니다. 이 측정기준의 범위는 0~23이며 속성의 시간대로 보고됩니다.
isConversionEvent 전환 이벤트임 이벤트가 전환인 경우 문자열 'true'입니다. 이벤트는 수집 시점에 전환으로 표시되며 앞으로는 이벤트 전환 표시의 변경사항이 적용됩니다. Google 애널리틱스에서 모든 이벤트를 전환으로 표시할 수 있으며 일부 이벤트 (예: first_open, purchase)는 기본적으로 전환으로 표시됩니다. 자세한 내용은 https://support.google.com/analytics/answer/9267568을 참고하세요.
ISO 주 ISO 주(1년 기준) 매주 월요일에 시작되는 ISO 주 번호. 자세한 내용은 http://en.wikipedia.org/wiki/ISO_week_date를 참조하세요. 값의 예로는 01, 02, 53이 있습니다.
ISO 연도 ISO 연도 이벤트의 ISO 연도입니다. 자세한 내용은 http://en.wikipedia.org/wiki/ISO_week_date를 참조하세요. 값의 예로는 2022 및 2023이 있습니다.
ISO 연도가 있는 주 ISO 주(ISO 연도 기준) isoWeek 및 isoYear를 결합한 값입니다. 값의 예로는 201652, 201701 등이 있습니다.
상품 제휴 상품 제휴 개별 항목과 연결된 제휴사(파트너/공급업체)(있는 경우)의 이름 또는 코드입니다. 'affiliation' 항목 매개변수로 입력됩니다.
itemBrand 상품 브랜드 상품의 브랜드 이름입니다.
itemCategory 항목 카테고리 상품이 분류되는 계층별 카테고리입니다. 예를 들어 의류/남성/여름/셔츠/티셔츠에서는 의류가 상품 카테고리입니다.
상품 카테고리 2 상품 카테고리 2 상품이 분류되는 계층별 카테고리입니다. 예를 들어 의류/남성/여름/셔츠/티셔츠에서는 남성이 상품 카테고리 2입니다.
상품 카테고리 3 상품 카테고리 3 상품이 분류되는 계층별 카테고리입니다. 예를 들어 의류/남성/여름/셔츠/티셔츠에서는 여름이 상품 카테고리 3입니다.
상품 카테고리 4 상품 카테고리 4 상품이 분류되는 계층별 카테고리입니다. 예를 들어 의류/남성/여름/셔츠/티셔츠에서는 셔츠가 상품 카테고리 4입니다.
상품 카테고리5 상품 카테고리 5 상품이 분류되는 계층별 카테고리입니다. 예를 들어 의류/남성/여름/셔츠/티셔츠에서는 티셔츠가 상품 카테고리 5입니다.
itemId 상품 ID 상품의 ID
상품 목록 ID 상품 목록 ID 상품 목록의 ID입니다.
itemListName 상품 목록 이름 상품 목록의 이름입니다.
itemListPosition 상품 목록 위치 상품의(예: 판매하는 제품) 목록 내 위치입니다. 이 측정기준은 items 배열의 'index' 매개변수로 태그할 때 채워집니다.
itemLocationID 상품 위치 ID 상품과 연결된 실제 위치 (예: 오프라인 상점 위치) 연결된 항목에 해당하는 Google 장소 ID를 사용하는 것이 좋습니다. 맞춤 위치 ID를 사용할 수도 있습니다. 이 필드는 items 배열의 'location_id' 매개변수로 태그를 지정하여 채워집니다.
itemName 항목 이름 상품의 이름
itemPromotionCreativeName 상품 프로모션 광고 소재 이름 상품 프로모션 광고 소재의 이름입니다.
상품 프로모션 광고 소재 슬롯 상품 프로모션 광고 소재 슬롯 상품과 연결된 프로모션 광고 소재 슬롯의 이름입니다. 이 측정기준은 이벤트 또는 항목 수준의 'creative_slot' 매개변수로 태그에 지정할 수 있습니다. 매개변수가 이벤트 및 상품 수준 모두에서 지정된 경우 상품 수준 매개변수가 사용됩니다.
itemPromotionId 상품 프로모션 ID 상품 프로모션의 ID입니다.
itemPromotionName 상품 프로모션 이름 상품 프로모션의 이름입니다.
itemVariant 상품 옵션 제품의 구체적인 변형(예: 크기에는 XS, S, M, L, 색상에는 빨간색, 파란색, 녹색, 검은색이 있습니다. 'item_variant' 매개변수로 입력됩니다.
landingPage 방문 페이지 세션의 첫 번째 페이지 조회와 연결된 페이지 경로입니다.
방문 페이지 플러스 쿼리 문자열 방문 페이지 + 쿼리 문자열 세션의 첫 번째 페이지 조회와 연결된 페이지 경로 + 쿼리 문자열입니다.
language 언어 사용자의 브라우저 또는 기기의 언어 설정(예: 영어)
언어 코드 언어 코드 사용자 브라우저 또는 기기의 언어 설정(ISO 639)입니다(예: 'en-us').
레벨 수준 플레이어의 게임 내 레벨입니다. 이벤트 매개변수 'level'로 입력됩니다.
링크클래스 클래스 연결 아웃바운드 링크의 HTML 클래스 속성입니다. 예를 들어 사용자가 '' 링크를 클릭하면 이 측정기준은 'center'를 반환합니다. 향상된 측정을 사용 설정하면 자동으로 채워집니다. 이벤트 매개변수 'link_classes'로 입력됩니다.
linkDomain 도메인 연결 아웃바운드 링크의 대상 도메인입니다. 예를 들어 사용자가 '' 링크를 클릭하면 이 측정기준은 'youtube.com'을 반환합니다. 향상된 측정을 사용 설정하면 자동으로 채워집니다. 이벤트 매개변수 'link_domain'으로 입력됩니다.
링크 ID 연결 ID 발신 링크 또는 파일 다운로드의 HTML ID 속성입니다. 예를 들어 사용자가 '' 링크를 클릭하면 이 측정기준은 'socialLinks'를 반환합니다. 향상된 측정을 사용 설정하면 자동으로 채워집니다. 이벤트 매개변수 'link_id'로 입력됩니다.
linkText 링크 텍스트 파일 다운로드의 링크 텍스트입니다. 향상된 측정을 사용 설정하면 자동으로 채워집니다. 이벤트 매개변수 'link_text'로 입력됩니다.
linkUrl 링크 URL 외부 연결 링크 또는 파일 다운로드의 전체 URL입니다. 예를 들어 사용자가 '' 링크를 클릭하면 이 측정기준은 'https://www.youtube.com/results?search_query=analytics'를 반환합니다. 향상된 측정을 사용 설정하면 자동으로 채워집니다. 이벤트 매개변수 'link_url'로 입력됩니다.
수동 광고 콘텐츠 수동 광고 콘텐츠 전환 이벤트에 기여한 광고 콘텐츠입니다. utm_content 매개변수로 입력됩니다.
수동 검색어 수동 검색어 전환 이벤트에 기여한 검색어입니다. utm_term 매개변수로 입력됩니다.
중간 중간 전환 이벤트에 기여한 매체입니다.
method 메서드 이벤트가 트리거된 메서드입니다. 이벤트 매개변수 'method'로 입력됩니다.
이벤트가 기록된 2자리 분입니다. 이 측정기준의 범위는 0~59이며 속성의 시간대로 보고됩니다.
mobileDeviceBranding 기기 브랜드 제조업체 또는 브랜드 이름(예: 삼성, HTC, Verizon, T-Mobile)입니다.
mobileDeviceMarketingName 기기 브랜드 기기 이름 (예: Galaxy S10 또는 P30 Pro)
mobileDeviceModel 휴대기기 모델 휴대기기 모델 이름입니다 (예: iPhone X 또는 SM-G950F).
01에서 12 사이의 2자리 정수로 표시된 이벤트가 열리는 달입니다.
신규 Vs재방문 신규 사용자/재사용자 신규 사용자에게는 이전 세션이 없으며 재사용자가 이전 세션이 1개 이상 있습니다. 이 측정기준은 '신규' 또는 '재구매'라는 두 값을 반환합니다.
nthDay N일 기간이 시작된 이후 지난 일수입니다.
nthHour N시간 기간이 시작된 이후 지난 시간입니다. 시작 시간은 0000입니다.
nthMinute N분 기간이 시작된 이후 지난 분 단위입니다. 시작 시간은 0,000입니다.
nthMonth N월 기간이 시작된 이후 지난 개월 수입니다. 시작 달은 0000입니다.
nthWeek N주 기간이 시작된 이후 지난 주 수를 나타내는 숫자입니다.
n년 N년 기간이 시작된 이후 지난 년 수입니다. 시작 연도는 0000입니다.
operatingSystem 운영체제 앱 또는 웹사이트 방문자가 사용한 운영체제입니다. Windows 및 Android와 같은 데스크톱 및 모바일 운영체제 포함
operatingSystemVersion OS 버전 웹사이트 또는 앱 방문자가 사용한 운영체제 버전입니다. 예를 들어 Android 10의 버전은 10, iOS 13.5.1의 버전은 13.5.1입니다.
operatingSystemWithVersion 운영체제 및 버전 운영체제 및 버전입니다. 예: Android 10 또는 Windows 7
orderCoupon 주문 쿠폰 주문 수준 쿠폰의 코드입니다.
아웃바운드 발신 사이트로 연결되는 링크가 속성 도메인의 일부가 아닌 경우 'true'를 반환합니다. 향상된 측정을 사용 설정하면 자동으로 채워집니다. 이벤트 매개변수 'outbound'로 입력됩니다.
페이지 위치 페이지 위치 방문한 웹페이지의 프로토콜, 호스트 이름, 페이지 경로 및 쿼리 문자열입니다. 예를 들어 https://www.example.com/store/contact-us?query_string=true의 pageLocation 부분은 https://www.example.com/store/contact-us?query_string=true입니다. 이벤트 매개변수 'page_location'으로 입력됩니다.
페이지 경로 페이지 경로 방문한 웹페이지의 호스트 이름과 쿼리 문자열 사이의 URL 부분입니다. 예를 들어 https://www.example.com/store/contact-us?query_string=true의 pagePath 부분은 /store/contact-us입니다.
pagePathPlusQueryString 페이지 경로 + 쿼리 문자열 방문한 웹페이지의 호스트 이름 다음에 오는 URL 부분입니다. 예를 들어 https://www.example.com/store/contact-us?query_string=true의 pagePathPlusQueryString 부분은 /store/contact-us?query_string=true입니다.
pageReferrer 페이지 리퍼러 호스트 이름과 경로를 포함한 전체 참조 URL입니다. 이 참조 URL은 사용자의 이전 URL이며 이 웹사이트의 도메인 또는 다른 도메인일 수 있습니다. 이벤트 매개변수 'page_referrer'로 입력됩니다.
pageTitle 페이지 제목 사이트에서 사용한 웹페이지 제목입니다.
Scrolled 스크롤 비율 사용자가 아래로 스크롤한 비율 (예: '90')입니다. 향상된 측정을 사용 설정하면 자동으로 채워집니다. 이벤트 매개변수 'percent_scrolled'로 입력됩니다.
플랫폼 플랫폼 앱이나 웹사이트가 실행된 플랫폼(예: 웹, iOS, Android)입니다. 스트림의 스트림 유형을 확인하려면 platform 및streamId를 모두 사용합니다.
platformDeviceCategory 플랫폼/기기 카테고리 웹사이트 또는 모바일 앱이 실행된 플랫폼 및 기기 유형입니다. (예: Android / 모바일)
region 리전 사용자 활동이 발생한 지역입니다(IP 주소 기준).
screenResolution 화면 해상도 사용자 모니터의 화면 해상도입니다. 예: 1920x1080
searchTerm 검색어 사용자가 검색한 검색어입니다. 예를 들어 사용자가 '/some-page.html?q=some-term'을 방문하면 이 측정기준은 'some-term'을 반환합니다. 향상된 측정을 사용 설정하면 자동으로 채워집니다. 이벤트 매개변수 'search_term'으로 입력됩니다.
세션 캠페인 ID 세션 캠페인 ID 세션의 마케팅 캠페인 ID입니다. Google Ads 캠페인, 수동 캠페인 및 기타 캠페인이 포함됩니다.
sessionCampaignName 세션 캠페인 세션의 마케팅 캠페인 이름입니다. Google Ads 캠페인, 수동 캠페인 및 기타 캠페인이 포함됩니다.
sessionDefaultChannelGroup 세션 기본 채널 그룹 세션의 기본 채널 그룹은 주로 소스 및 매체를 기반으로 합니다. '직접', '자연 검색', '유료 소셜', '자연 소셜', '이메일', '제휴사', '추천', '유료 검색', '동영상', '디스플레이'를 포함하는 열거형입니다.
세션 Google Ads 계정 이름 세션 Google Ads 계정 이름 세션으로 이어진 Google Ads의 계정 이름입니다. Google Ads API의 customer.descriptive_name에 해당합니다.
sessionGoogleAdsAdGroupId 세션 Google Ads 광고그룹 ID 세션의 Google Ads 광고그룹 ID입니다.
sessionGoogleAdsAdGroupName 세션 Google Ads 광고그룹 이름 세션의 Google Ads 광고그룹 이름입니다.
sessionGoogleAdsAdNetworkType 세션 Google Ads 광고 네트워크 유형 세션으로 이어진 광고 네트워크입니다. 'Google 검색', '검색 파트너', 'Google 디스플레이 네트워크', 'YouTube 검색', 'YouTube 동영상', '교차 네트워크', '소셜', '(유니버설 캠페인)'을 포함하는 열거형입니다.
세션 Google Ads 캠페인 ID 세션 Google Ads 캠페인 ID 이 세션으로 이어진 Google Ads 캠페인의 캠페인 ID입니다.
GoogleGoogle Ads 캠페인 이름 세션 Google Ads 캠페인 이 세션으로 이어진 Google Ads 캠페인의 캠페인 이름입니다.
GoogleGoogle Ads 캠페인 유형 세션 Google Ads 캠페인 유형 이 세션으로 이어진 Google Ads 캠페인의 캠페인 유형입니다. 캠페인 유형에 따라 고객에게 광고가 게재되는 위치와 Google Ads에서 사용할 수 있는 설정 및 옵션이 달라집니다. 캠페인 유형은 Google 검색, 디스플레이, 쇼핑, 동영상, 디스커버리, 앱, 스마트, 호텔, 지역, 실적 최대화로 구성됩니다. 자세한 내용은 https://support.google.com/google-ads/answer/2567043을 참고하세요.
sessionGoogleAdsCreativeId 세션 Google Ads 광고 소재 ID 웹사이트 또는 앱에서 세션으로 이어지는 Google Ads 광고 소재의 ID입니다. 광고 소재 ID는 개별 광고를 식별합니다.
세션 Google Ads 고객 ID 세션 Google Ads 고객 ID 세션으로 이어진 Google Ads의 고객 ID입니다. Google Ads의 고객 ID는 Google Ads 계정을 고유하게 식별합니다.
세션 Google Ads 키워드 세션 Google Ads 키워드 텍스트 세션으로 이어진 일치 키워드입니다. 키워드는 적합한 고객에게 광고를 게재하기 위해 선택한 제품 또는 서비스를 설명하는 단어나 구문입니다. 키워드에 대해 자세히 알아보려면 https://support.google.com/google-ads/answer/6323을 참조하세요.
sessionGoogleAdsQuery 세션 Google Ads 검색어 세션으로 이어진 검색어입니다.
sessionManualAdContent 세션 수동 광고 콘텐츠 세션으로 이어진 광고 콘텐츠입니다. utm_content 매개변수로 입력됩니다.
sessionManualTerm 세션 수동 검색어 세션으로 이어진 용어입니다. utm_term 매개변수로 입력됩니다.
sessionMedium 세션 매체 웹사이트 또는 앱에서 세션을 시작한 매체입니다.
sessionSa360광고그룹 이름 세션 SA360 광고그룹 이름 이 세션으로 이어진 Search Ads 360의 광고그룹 이름입니다.
sessionSa360캠페인 ID 세션 SA360 캠페인 ID 이 세션으로 이어진 Search Ads 360의 캠페인 ID입니다.
sessionSa360캠페인 이름 세션 SA360 캠페인 이 세션으로 이어진 Search Ads 360의 캠페인 이름입니다.
sessionSa360광고 소재 형식 세션 SA360 광고 소재 형식 이 세션으로 이어진 Search Ads 360의 광고 소재 유형입니다. 예: '반응형 검색 광고' 또는 '확장 텍스트 광고' 자세한 내용은 GA4 트래픽 소스 측정기준을 참고하세요.
sessionSa360엔진 계정 ID 세션 SA360 엔진 계정 ID 이 세션으로 이어진 SA360의 엔진 계정 ID입니다.
sessionSa360엔진계정이름 세션 SA360 엔진 계정 이름 이 세션으로 이어진 SA360의 엔진 계정 이름입니다.
sessionSa360EngineAccountType 세션 SA360 엔진 계정 유형 이 세션으로 이어진 Search Ads 360의 엔진 계정 유형입니다. 예: 'google ads', 'bing', 'baidu'
sessionSa360키워드 세션 SA360 키워드 텍스트 이 세션으로 이어진 Search Ads 360의 검색엔진 키워드입니다.
sessionSa360Medium 세션 SA360 매체 이 세션으로 이어진 Search Ads 360의 검색엔진 키워드입니다. 예: 'cpc'
sessionSa360쿼리 세션 SA360 검색어 이 세션으로 이어진 Search Ads 360의 검색어입니다.
sessionSa360소스 세션 SA360 소스 이 세션으로 이어진 Search Ads 360의 트래픽 소스입니다. 예: 'example.com' 또는 'google'
sessionSource 세션 소스 웹사이트 또는 앱에서 세션을 시작한 소스입니다.
sessionSourceMedium 세션 소스/매체 측정기준 'sessionSource'와 'sessionMedium'을 결합한 값입니다.
세션 소스 플랫폼 세션 소스 플랫폼 세션 캠페인의 소스 플랫폼입니다. UTM을 사용하는 트래픽의 경우 '수동'을 반환하는 필드에 의존하지 마세요. 이 필드는 예정된 기능 출시에서 '수동'을 반환하는 대신 '(설정되지 않음)'을 반환합니다.
배송 등급 배송 등급 구매한 상품의 배송을 위해 선택한 배송 등급입니다(예: 일반 배송, 항공, 다음날). 'shipping_tier' 이벤트 매개변수로 입력됩니다.
로그인한 사용자 ID 사용자 ID로 로그인함 사용자가 User-ID 기능으로 로그인한 경우 문자열 '예' User-ID에 대한 자세한 내용은 https://support.google.com/analytics/answer/9213390을 참조하세요.
소스 소스 전환 이벤트에 기여한 소스입니다.
소스 매체 소스/매체 '소스'와 '매체' 측정기준의 조합된 값입니다.
소스 플랫폼 소스 플랫폼 전환 이벤트 캠페인의 소스 플랫폼입니다. UTM을 사용하는 트래픽의 경우 '수동'을 반환하는 필드에 의존하지 마세요. 이 필드는 예정된 기능 출시에서 '수동'을 반환하는 대신 '(설정되지 않음)'을 반환합니다.
스트림 ID 스트림 ID 앱 또는 웹사이트의 숫자 데이터 스트림 식별자입니다.
스트림 이름 스트림 이름 앱 또는 웹사이트의 데이터 스트림 이름입니다.
testDataFilterId 테스트 데이터 필터 ID 테스트 상태에 있는 데이터 필터의 숫자 식별자입니다. 이벤트 매개변수 값에 따라 데이터 필터를 사용하여 이벤트 데이터를 보고서에 포함하거나 제외할 수 있습니다. 자세한 내용은 https://support.google.com/analytics/answer/10108813을 참고하세요.
testDataFilterName 테스트 데이터 필터 이름 테스트 상태의 데이터 필터의 이름입니다. 이벤트 매개변수 값에 따라 데이터 필터를 사용하여 이벤트 데이터를 보고서에 포함하거나 제외할 수 있습니다. 자세한 내용은 https://support.google.com/analytics/answer/10108813을 참고하세요.
transactionId 거래 ID 전자상거래 데이터의 ID입니다.
통합 페이지 경로 화면 페이지 경로 및 화면 클래스 이벤트가 기록된 페이지 경로 (웹) 또는 화면 클래스 (앱)입니다.
통합 페이지 화면 페이지 경로 + 쿼리 문자열 및 화면 클래스 이벤트가 기록된 페이지 경로 및 쿼리 문자열 (웹) 또는 화면 클래스 (앱)입니다.
통합 화면 클래스 페이지 제목 및 화면 클래스 이벤트가 기록된 페이지 제목 (웹) 또는 화면 클래스 (앱)입니다.
unifiedScreenName 페이지 제목 및 화면 이름 이벤트가 기록된 페이지 제목 (웹) 또는 화면 이름 (앱)입니다.
userAgeBracket 연령 사용자의 연령대입니다.
userGender 성별 사용자의 성별입니다.
videoProvider 동영상 제공업체 동영상의 소스(예: 'youtube')입니다. 향상된 측정을 사용 설정한 경우 삽입된 동영상에 자동으로 채워집니다. 이벤트 매개변수 'video_provider'로 입력됩니다.
동영상 제목 동영상 제목 동영상 제목입니다. 향상된 측정을 사용 설정한 경우 삽입된 동영상에 자동으로 채워집니다. 이벤트 매개변수 'video_title'로 입력됩니다.
동영상 URL 동영상 URL 동영상의 URL입니다. 향상된 측정을 사용 설정한 경우 삽입된 동영상에 자동으로 채워집니다. 이벤트 매개변수 'video_url'로 입력됩니다.
가상 통화 이름 가상화폐 이름 사용자가 상호작용하는 가상 화폐의 이름(예: 게임에서 보석 사용 또는 구매) 이벤트 매개변수 'virtual_currency_name'로 입력됩니다.
표시 Visible 콘텐츠가 표시되면 'true'를 반환합니다. 향상된 측정을 사용 설정한 경우 삽입된 동영상에 자동으로 채워집니다. 이벤트 매개변수 'visible'로 입력됩니다.
01에서 53 사이의 2자리 숫자로 표시된 이벤트가 열리는 주입니다. 매주 일요일에 시작 1월 1일은 항상 01번째 주에 포함됩니다. 대부분의 연도에서 첫 번째와 마지막 주는 7일 미만입니다. 한 해의 첫 번째와 마지막 주 이외의 주는 항상 7일입니다. 1월 1일이 일요일인 경우 해당 연도의 첫 번째 주 및 이전 해의 마지막 주는 7일입니다.
연도 이벤트가 열리는 4자리 연도입니다(예: 2020).
yearMonth 연도 월 연도와 월을 더한 값입니다. 값 예시로는 202212 또는 202301이 있습니다.
yearWeek 연도 주 연도와 주를 합산한 값입니다. 값 예시로는 202253 또는 202301이 있습니다.

맞춤 측정기준

Data API는 이벤트 및 사용자 범위 맞춤 측정기준에 대한 보고서를 만들 수 있습니다. 맞춤 측정기준에 대해 자세히 알아보려면 이벤트 범위 맞춤 측정기준 및 측정항목 보고맞춤 사용자 속성을 참고하세요. 맞춤 측정기준은 측정기준의 매개변수 이름 및 범위로 API 보고서 요청에서 지정됩니다. 예를 들어 Data API 요청에 'customEvent:achievement_id'를 포함하면 매개변수 이름이 'achievement_id'인 이벤트 범위 맞춤 측정기준에 대한 보고서가 생성됩니다. 속성에서 이 이벤트 범위 맞춤 측정기준을 등록하지 않은 경우 이 API 요청은 실패합니다.

이벤트 범위 맞춤 측정기준이 2020년 10월 전에 등록된 경우 이 측정기준은 이벤트 이름과 함께 API 요청에 지정되어야 합니다. 예를 들어 매개변수 이름이 'achievement_id'이고 이벤트 이름이 'level_up'인 이벤트 범위 맞춤 측정기준에 'customEvent:achievement_id[level_up]'을 포함합니다. 2020년 10월, 애널리틱스는 맞춤 매개변수 보고이벤트 범위 맞춤 측정기준 및 측정항목 보고로 대체했습니다.

다음은 맞춤 측정기준에 대한 일반적인 구문입니다. Metadata API 메서드를 쿼리하여 속성의 모든 맞춤 측정기준을 나열할 수 있습니다. 다음은 Metadata API 메서드를 사용하는 예입니다.

일반 API 이름 설명
customEvent:parameter_name parameter_name의 이벤트 범위 맞춤 측정기준
customEvent:parameter_name[event_name] 2020년 10월 전에 등록된 경우 parameter_name의 이벤트 범위 맞춤 측정기준
customUser:parameter_name parameter_name의 사용자 범위 맞춤 측정기준

맞춤 채널 그룹

Data API는 맞춤 채널 그룹에 대한 보고서를 만들 수 있습니다. 맞춤 채널 그룹에 대한 자세한 내용은 GA4의 맞춤 채널 그룹에 대한 도움말을 참조하세요. 맞춤 채널 그룹은 측정기준 범위 및 채널 그룹 ID에 의해 API 보고서 요청에서 지정됩니다. 예를 들어 Data API 요청에 'sessionCustomChannelGroup:9432931'을 포함하여 ID가 9432931인 세션 범위 맞춤 채널에 대한 보고서를 생성합니다. 속성에 이 ID를 가진 맞춤 채널이 없는 경우 이 API 요청은 실패합니다.

맞춤 채널 그룹의 일반적인 문법은 다음과 같습니다. Metadata API 메서드를 쿼리하여 속성의 모든 맞춤 채널 그룹을 나열할 수 있습니다.

일반 API 이름 설명
sessionCustomChannelGroup:맞춤_채널_ID 이 세션으로 연결되는 맞춤 채널입니다.
firstUserCustomChannelGroup:맞춤_채널_ID 이 사용자를 처음 획득한 맞춤 채널입니다.
customChannelGroup:맞춤_채널_ID 전환 이벤트로 이어진 맞춤 채널입니다.

측정항목

보고서에서 다음 측정항목을 요청할 수 있습니다. 보고서 측정항목의 측정항목 열에 있는 측정항목 이름 필드에 'API 이름'을 지정합니다.

API 이름 UI 이름 설명
active1DayUsers 1일 활성 사용자 1일 기간 내 사이트 또는 앱의 개별 활성 사용자 수입니다. 1일 기간에는 보고서 기간의 마지막 날이 포함됩니다. 참고: 활성 사용자 수와 동일합니다.
active28DayUsers 28일 활성 사용자 28일 기간 내 사이트 또는 앱의 고유한 활성 사용자 수입니다. 28일 기간에는 보고서 기간의 마지막 날이 포함됩니다.
active7DayUsers 7일 활성 사용자 7일 기간 내 사이트 또는 앱의 고유한 사용자 수입니다. 7일 기간에는 보고서 기간의 마지막 날이 포함됩니다.
활성 사용자 활성 사용자 수 내 사이트 또는 앱을 방문한 개별 사용자의 수입니다.
adUnitExposure 광고 단위 노출 광고 단위가 사용자에게 노출된 시간(밀리초)입니다.
addToCarts 장바구니에 추가 사용자가 장바구니에 상품을 추가한 횟수입니다.
advertiserAdClicks 광고 클릭수 사용자가 속성에 도달하기 위해 광고를 클릭한 총 횟수입니다. 연결된 Search Ads 360 광고주와 같은 연결된 통합에서 발생한 클릭수를 포함합니다. 데이터 가져오기에서 업로드한 클릭수도 포함됩니다.
광고주 광고비용 광고 비용 광고에 지불한 총 금액입니다. 연결된 Google Ads 계정과 같은 통합 통합에서 발생한 비용이 포함됩니다. 데이터 가져오기에서 업로드된 비용도 포함됩니다. 자세한 내용은 비용 데이터 가져오기를 참조하세요.
광고주 광고비용당클릭 광고 클릭당비용 클릭당비용은 광고 비용을 광고 클릭수로 나눈 값이며 약칭 CPC입니다.
광고주 광고비용전환 전환당비용 전환당비용은 광고 비용을 전환수로 나눈 값입니다.
advertiserAdImpressions 광고 노출수 총 노출수입니다. 연결된 Display & Video 360 광고주와 같은 연결된 통합에서 발생한 노출수가 포함됩니다. 데이터 가져오기에서 업로드한 노출수도 포함됩니다.
평균 구매 수익 평균 구매 수익 이벤트의 거래 그룹에 발생한 평균 구매 수익입니다.
평균구매수익당지불사용자 ARPPU 유료 사용자당 평균 수익 (ARPPU)은 구매 이벤트를 기록한 활성 사용자당 총 구매 수익입니다. 요약 측정항목은 선택한 기간에 대해 분석합니다.
사용자당 평균 구매 수익 사용자당 평균 구매 수익 활성 사용자당 평균 구매 수익은 이벤트를 기록한 활성 사용자당 총 구매 수익입니다. 요약 측정항목은 선택한 기간에 대해 분석합니다.
사용자당 평균 수익 ARPU 활성 사용자당 평균 수익(ARPU)입니다. 요약 측정항목은 선택한 기간에 대해 분석합니다. ARPU는 총 수익을 사용하며 AdMob 예상 수입을 포함합니다.
평균 세션 시간 평균 세션 시간 사용자 세션의 평균 시간(초)입니다.
이탈률 이탈률 참여하지 않은 세션 비율 ((세션 제외)을 세션수로 나눈 값)입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.2761은 세션의 27.61% 가 이탈했다는 의미입니다.
cartToViewRate 조회수 대비 장바구니 추가 비율 장바구니에 제품을 추가한 사용자 수를 동일한 제품을 조회한 사용자 수로 나눈 값입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.1132는 제품을 조회한 사용자 중 11.32% 가 장바구니에 동일한 제품을 추가했다는 의미입니다.
checkouts 결제 횟수 사용자가 결제 과정을 시작한 횟수입니다. 이 측정항목은 'begin_checkout' 이벤트의 발생 횟수를 계산합니다.
cohortActiveUsers 사용자 집단 활성 사용자 동질 집단에서 n번째 날짜/주/월에 해당하는 기간에 활성 상태인 사용자 수입니다. 예를 들어 동질 집단 NthWeek = 0001인 경우 이 측정항목은 첫 번째 주에 활성 상태인 사용자 (동질 집단 내)의 수입니다.
cohortTotalUsers 사용자 집단 총 사용자 동질 집단의 총 사용자 수입니다. 이 측정항목은 각 동질 집단의 모든 보고서 행에서 동일한 값입니다. 동질 집단은 공유 획득 날짜에 따라 정의되므로 동질 집단 사용자 수는 동질 집단 선택 기간에 동질 집단 사용자 수와 동일합니다. ochort의 선택 범위보다 늦게 보고되는 행의 경우 사용자 집단이 동질 집단 사용자보다 작은 것이 일반적입니다. 이 차이는 나중 날짜에 비활성 상태인 동질 집단의 사용자를 나타냅니다. 동질 집단 사용자 수는 동질 집단의 사용자 유지율을 계산하는 데 일반적으로 ActiveActiveUsers/cohortTotalUsers 측정항목 표현식에 사용됩니다. activeUsers와 totalUsers 간의 관계는 동질 집단 ActiveUsers와 동질 집단 사용자 간의 관계와 다릅니다.
전환수 전환수 전환 이벤트 수입니다. 이벤트는 수집 시점에 전환으로 표시되며 앞으로는 이벤트 전환 표시의 변경사항이 적용됩니다. Google 애널리틱스에서 모든 이벤트를 전환으로 표시할 수 있으며 일부 이벤트 (예: first_open, purchase)는 기본적으로 전환으로 표시됩니다. 자세한 내용은 https://support.google.com/analytics/answer/9267568을 참고하세요.
비정상 종료의 영향을 받은 사용자 비정상 종료의 영향을 받은 사용자 보고서의 이 행에서 비정상 종료를 기록한 사용자 수입니다. 예를 들어 날짜별 시계열 보고서인 경우 이 측정항목은 해당 날짜에 하나 이상의 비정상 종료가 발생한 총 사용자 수를 보고합니다. 비정상 종료는 이름이 'app_exception'인 이벤트입니다.
비정상 종료가 발생하지 않은 사용자 비율 비정상 종료가 발생하지 않은 사용자의 비율 보고서의 이 행에 있는 비정상 종료 이벤트가 없는 사용자 수를 총 사용자 수로 나눈 값입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.9243은 사용자의 92.43% 가 비정상 종료를 경험하지 않았음을 의미합니다.
다우퍼우 DAU/MAU 1일 활성 사용자인 30일 활성 사용자의 이동 비율 이 측정항목은 분수로 반환됩니다. 예를 들어 0.113은 30일 활성 사용자의 11.3% 도 1일 활성 사용자였음을 의미합니다.
다우퍼우 DAU/WAU 7일 활성 사용자 수와 1일 활성 사용자 수의 롤링 비율입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.082는 7일 활성 사용자의 8.2% 가 1일 활성 사용자였음을 의미합니다.
ecommercePurchases 전자상거래 구매 사용자가 구매를 완료한 횟수입니다. 이 측정항목에서는 'purchase' 이벤트를 집계하지만 'in_app_purchase' 및 구독 이벤트는 계산하지 않습니다.
참여 세션 참여 세션수 10초 넘게 지속되었거나, 전환 이벤트가 발생했거나, 화면 조회수가 2회 이상인 세션 수입니다.
참여율 참여율 참여 세션수 (참여 세션수를 세션수로 나눈 값)입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.7239는 세션의 72.39% 가 참여 세션임을 나타냅니다.
eventCount 이벤트 수 이벤트 수입니다.
이벤트 수 사용자당 사용자당 이벤트 수 사용자당 평균 이벤트 수입니다 (이벤트 수를 활성 사용자 수로 나눈 값).
eventValue 이벤트 값 'value'라는 이벤트 매개변수의 합계입니다.
세션당 이벤트 세션당 이벤트 수 세션당 평균 이벤트 수입니다 (이벤트 수를 세션수로 나눈 값).
최초 구매 전환율 최초 구매자 전환 처음으로 구매한 활성 사용자의 비율입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.092는 활성 사용자의 9.2% 가 최초 구매자였음을 의미합니다.
최초 구매자 수 첫 구매자 첫 구매 이벤트를 완료한 사용자 수입니다.
신규 사용자당 신규 구매자 수 신규 사용자당 최초 구매자 수 신규 사용자당 평균 최초 구매자 수입니다.
총수익 총 항목 수익 상품에서만 발생한 총 수익입니다. 총 상품 수익은 가격과 수량을 곱한 값입니다. 상품 수익에는 세금 및 배송비가 포함되지 않습니다. 세금 및 배송비는 상품 수준이 아닌 이벤트에서 지정됩니다. 총 상품 수익에는 환불이 포함되지 않습니다.
총매출수익 총 구매 수익 내 앱 또는 사이트에서 발생한 구매 수익의 합계입니다. 총 구매 수익은 'purchase', 'ecommerce_purchase', 'in_app_purchase', 'app_store_subscription_convert', 'app_store_subscription_renew' 이벤트의 수익을 합산합니다. 구매 수익은 태그의 'value' 매개변수로 지정됩니다.
itemListClickEvents 상품 목록 클릭 이벤트 사용자가 목록에 표시된 상품을 클릭한 횟수입니다. 이 측정항목은 'select_item' 이벤트의 발생 횟수를 집계합니다.
itemListClickThroughRate 상품 목록 클릭률 목록을 선택한 사용자 수를 동일한 목록을 조회한 사용자 수로 나눈 값입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.2145는 목록을 조회한 사용자 중 21.45% 가 동일한 목록을 선택했다는 의미입니다.
itemListViewEvents 상품 목록 조회 이벤트 상품 목록이 조회된 횟수입니다. 이 측정항목은 'view_item_list' 이벤트의 발생 횟수를 집계합니다.
itemPromotionClickThroughRate 상품 프로모션 클릭률 프로모션을 선택한 사용자 수를 동일한 프로모션을 조회한 사용자 수로 나눈 값입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.1382는 프로모션을 조회한 사용자 중 13.82% 가 프로모션도 선택했다는 의미입니다.
itemRefundAmount 상품 환불 금액 상품 환불 금액은 상품에서만 환불된 총 거래 수익입니다. 상품 환불 금액은 '환불' 이벤트의 가격 및 수량을 곱한 값입니다.
itemRevenue 상품 수익 상품 구매에서 발생한 총 수익에서 환불된 상품 거래 수익만 차감됩니다. 상품 수익은 가격과 수량을 곱한 값입니다. 상품 수익에는 세금 및 배송비가 포함되지 않습니다. 세금 및 배송비는 상품 수준이 아닌 이벤트에서 지정됩니다.
itemViewEvents 상품 조회 이벤트 상품 세부정보가 조회된 횟수입니다. 측정항목은 '조회_항목' 이벤트의 발생 횟수를 집계합니다.
장바구니에 상품을 추가함 장바구니에 추가된 상품 수 단일 상품의 장바구니에 추가된 단위 수입니다. 이 측정항목은 'add_to_cart' 이벤트의 품목 수를 집계합니다.
itemsCheckedOut 결제된 상품 수 단일 상품의 결제 단위 수입니다. 이 측정항목은 'begin_checkout' 이벤트에서 항목의 수량을 계산합니다.
항목이 클릭됨 목록에서 클릭된 상품 수 단일 항목에서 목록에서 클릭한 단위의 수입니다. 이 측정항목은 'select_item' 이벤트의 항목 수를 집계합니다.
상품 클릭 프로모션 프로모션에서 클릭된 상품 수 단일 상품의 프로모션에서 클릭한 단위 수입니다. 이 측정항목은 'select_promotion' 이벤트의 상품 수를 집계합니다.
구입한 항목 구매한 상품 수 구매 이벤트에 포함된 단일 상품의 단위 수입니다. 이 측정항목은 구매 이벤트에 포함된 항목의 수량을 계산합니다.
항목 조회 조회된 상품 수 단일 항목에서 조회한 단위 수입니다. 이 측정항목은 'view_item' 이벤트의 상품 수를 집계합니다.
itemViewedInList 목록에서 조회된 상품 수 단일 항목에서 목록에 표시된 단위 수입니다. 이 측정항목은 'view_item_list' 이벤트의 상품 수를 집계합니다.
itemsViewedInPromo 프로모션에서 조회된 상품 수 단일 상품의 프로모션에서 조회된 단위 수입니다. 이 측정항목은 'view_promotion' 이벤트의 상품 수를 집계합니다.
newUsers 신규 사용자 수 내 사이트와 처음 상호작용했거나 내 앱을 처음 실행한 사용자 수입니다 (트리거된 이벤트: first_open 또는 first_visit).
자연 Google 검색 평균 게재순위 자연 Google 검색 평균 게재순위 Search Console에서 보고된 검색어의 웹사이트 URL 평균 순위입니다. 예를 들어 어떤 검색어가 사용될 때 사이트 URL의 게재순위가 3위이고, 다른 검색어에서 게재순위가 7위이면 평균 게재순위는 (3+7)/2인 5위입니다. 이 측정항목을 사용하려면 활성화된 Search Console 링크가 필요합니다.
자연 Google 검색 클릭률 자연 Google 검색결과 클릭률 Search Console에서 보고된 자연 Google 검색 클릭률입니다. 클릭률은 노출당 클릭수입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.0588은 노출수의 약 5.88% 가 클릭수로 이어졌음을 의미합니다. 이 측정항목을 사용하려면 활성화된 Search Console 링크가 필요합니다.
자연 Google 검색 클릭수 자연 Google 검색결과 클릭수 Search Console에서 보고된 자연 Google 검색 클릭수입니다. 이 측정항목을 사용하려면 활성화된 Search Console 링크가 필요합니다.
자연 Google 검색 노출수 자연 Google 검색결과 노출수 Search Console에서 보고된 자연 Google 검색 노출수입니다. 이 측정항목을 사용하려면 활성화된 Search Console 링크가 필요합니다.
promotionClicks[프로모션 클릭수] 프로모션 클릭수 상품 프로모션이 클릭된 횟수입니다. 이 측정항목은 'select_promotion' 이벤트의 발생 횟수를 계산합니다.
promotionView 프로모션 조회수 상품 프로모션이 조회된 횟수입니다. 이 측정항목은 '조회_프로모션' 이벤트의 발생 횟수를 집계합니다.
publisherAdClicks 게시자 광고 클릭수 ad_click 이벤트 수입니다.
publisherAdImpressions 게시자 광고 노출수 ad_impression 이벤트 수입니다.
구매 수익 구매 수익 구매 수익에서 앱 또는 사이트에서 발생한 거래 수익에서 차감된 금액입니다. 구매 수익은 'purchase', 'ecommerce_purchase', 'in_app_purchase', 'app_store_subscription_convert', 'app_store_subscription_renew' 이벤트의 수익을 합산합니다. 구매 수익은 태그의 'value' 매개변수로 지정됩니다.
구매율 조회수 대비 구매 비율 제품을 구매한 사용자 수를 동일한 제품을 조회한 사용자 수로 나눈 값입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.128은 제품을 조회한 사용자 중 12.8% 가 동일한 제품을 구매했다는 의미입니다.
구매자 전환율 구매자 전환 1회 이상 구매 거래를 한 활성 사용자의 비율입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.412는 사용자의 41.2% 가 구매자였음을 의미합니다.
환불 금액 환불 금액 환불된 총 거래 수익입니다. 환불 금액은 'refund' 및 'app_store_refund' 이벤트의 환불 수익을 합산합니다.
광고 투자수익 광고 투자수익 광고 투자수익 (ROAS)은 총 수익을 광고주 광고 비용으로 나눈 값입니다.
screenPageViews 사용자가 조회한 앱 화면 또는 웹페이지의 수입니다. 한 페이지 또는 한 화면을 반복해서 조회한 횟수도 집계에 포함됩니다. (screen_view 이벤트 + page_view 이벤트)
세션당 페이지 조회수 조회 세션당 조회수 사용자가 세션별로 조회한 앱 화면 또는 웹페이지의 수입니다. 한 페이지 또는 한 화면을 반복해서 조회한 횟수도 집계에 포함됩니다. (screen_view 이벤트 수 + page_view events 이벤트 수) ÷ 세션 수.
ScreenPageViewsPerUser 사용자당 조회수 활성 사용자당 사용자가 조회한 앱 화면 또는 웹페이지의 수입니다. 한 페이지 또는 한 화면을 반복해서 조회한 횟수도 집계에 포함됩니다. (screen_view 이벤트 수 + page_view events 이벤트 수) / 활성 사용자 수로 계산됩니다.
scrolledUsers 스크롤한 사용자 페이지의 90% 이상을 아래로 스크롤한 순 사용자 수입니다.
세션전환율 세션 전환율 전환 이벤트가 트리거된 세션의 비율입니다.
sessions 세션수 사이트 또는 앱에서 시작된 세션 수입니다 (트리거된 이벤트: session_start).
sessionsPerUser 사용자당 세션수 사용자당 평균 세션수 (세션수를 활성 사용자로 나눈 값)입니다.
shippingAmount[배송비] 배송비 거래와 연결된 배송비입니다. 'shipping' 이벤트 매개변수로 입력됩니다.
taxAmount 세액 거래와 연결된 세액입니다. 이벤트 매개변수 'tax'로 입력됩니다.
총 광고 수익 총 광고 수익 AdMob 및 서드 파티 소스에서 발생한 총 광고 수익입니다.
총 구매자 수 전체 구매자 수 선택한 기간 동안 구매 이벤트를 로깅한 사용자 수입니다.
총수익 총수익 구매, 구독, 광고 수익의 합계 (구매 수익, 구독 수익, 광고 수익)에서 환불된 거래 수익을 차감한 금액입니다.
totalUsers 총 사용자 수 이벤트가 기록될 때 사이트 또는 앱이 사용 중이었는지 여부와 관계없이 하나 이상의 이벤트를 기록한 순 사용자 수입니다.
transactions 거래 구매 수익이 발생한 거래 이벤트의 수입니다. 거래 이벤트는 in_app_purchase, ecommerce_purchase, purchase, app_store_subscription_renew, app_store_subscription_convert, 환불입니다.
구매당 거래수 구매자당 거래 수 구매자당 평균 거래수입니다.
사용자 전환율 사용자 전환율 전환 이벤트를 트리거한 사용자의 비율입니다.
userEngagementDuration 사용자 참여 웹사이트 또는 앱이 사용자 기기의 포그라운드에 있는 총 시간(초)입니다.
WauPerMau WAU/MAU 7일 활성 사용자 중 30일 활성 사용자의 롤링 비율입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.234는 30일 활성 사용자의 23.4% 가 7일 활성 사용자였음을 의미합니다.

커스텀 측정항목

Data API는 이벤트 범위 맞춤 측정항목에 대한 보고서를 만들 수 있습니다. 맞춤 측정항목에 대해 자세히 알아보려면 이벤트 범위 맞춤 측정기준 및 측정항목 보고를 참고하세요. 커스텀 측정항목은 API 매개변수 요청에서 측정항목의 매개변수 이름 및 범위로 지정됩니다. 예를 들어 매개변수 이름이 'levels_unlocked'인 이벤트 범위 맞춤 측정항목의 보고서를 생성하려면 Data API 요청에 'customEvent:levels_unlocked'를 포함합니다. 속성에서 이 이벤트 범위 맞춤 측정항목을 등록하지 않은 경우 이 API 요청은 실패합니다.

이벤트 범위 커스텀 측정항목이 2020년 10월 이전에 등록되었다면 API 요청에 이벤트 이름으로 측정항목을 지정해야 합니다. 예를 들어 매개변수 이름이 'levels_unlocked'이고 이벤트 이름이 'tutorial_start'인 이벤트 범위 맞춤 측정항목의 경우 'customEvent:levels_unlocked[tutorial_start]'를 포함합니다. 2020년 10월, 애널리틱스는 맞춤 매개변수 보고이벤트 범위 맞춤 측정기준 및 측정항목 보고로 대체했습니다.

다음은 커스텀 측정항목의 일반적인 구문입니다. Metadata API 메서드를 쿼리하여 속성의 모든 커스텀 측정항목을 나열할 수 있습니다. 다음은 Metadata API 메서드를 사용하는 예입니다.

일반 API 이름 설명
customEvent:parameter_name parameter_name의 이벤트 범위 맞춤 측정항목
customEvent:parameter_name[event_name ] 2020년 10월 이전에 등록한 parameter_name의 이벤트 범위 맞춤 측정항목

커스텀 측정항목 대안

속성에서 등록하는 커스텀 측정항목은 합계, 평균, 개수 등 3가지 API 측정항목 변형을 생성합니다. 대부분의 요청은 맞춤 측정항목의 합계를 사용합니다. 맞춤 측정항목의 평균은 요약 통계에 유용합니다. 맞춤 횟수는 매개변수의 발생 횟수가 유용한 경우 흥미롭습니다.

Metadata API 메서드를 쿼리하여 속성에 대한 맞춤 측정항목의 모든 변형을 나열할 수 있습니다. 다음은 맞춤 평균에 Metadata API 메서드를 사용하는 예입니다.

일반 API 이름 설명
customEvent:parameter_name parameter_name 이벤트 범위 맞춤 측정항목의 합계
averageCustomEvent:매개변수_이름 parameter_name에 대한 이벤트 범위 맞춤 측정항목의 평균 값
countCustomEvent:매개변수_이름 parameter_name의 이벤트 범위 맞춤 측정항목이 발생한 횟수

전환 1회의 전환율 측정항목

속성에 등록하는 각 전환 이벤트는 보고서에서 요청할 수 있는 전환율 측정항목을 생성합니다. 전환당 2개의 전환율 측정항목(전환 1회의 세션 기반 전환율과 전환 1회의 사용자 기반 전환율)이 있습니다.

Metadata API 메서드를 쿼리하여 속성의 특정 전환에 대한 모든 전환율 측정항목을 나열할 수 있습니다. 전환으로 등록되지 않은 이벤트의 전환율을 요청하려고 하면 요청이 실패합니다. 다음은 전환 1회의 전환율 측정항목에 Metadata API 메서드를 사용하는 예입니다.

일반 API 이름 설명
sessionConversionRate:이벤트_이름 특정 전환 이벤트가 트리거된 세션의 비율입니다.
userConversionRate:이벤트_이름 특정 전환 이벤트를 트리거한 사용자의 비율입니다.