> For the complete documentation index, see [llms.txt](https://www.analytics-docs.laplacetec.com/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.analytics-docs.laplacetec.com/guide/customdashboard/custom/about_values/ga4.md).

# GA4 데이터

{% hint style="info" %}
GA4 API 데이터는 웹사이트 방문, 유입 경로, 전환 등 사용자 행동 데이터를 수집해 제공합니다.
{% endhint %}

{% hint style="info" %}
GA4 API의 경우 GA4 계정에서 관리되고 있는 커스텀 측정값이 선택이 가능합니다. 단 커스텀 측정값의 경우 GA4 계정 내에서 추가/편집하실 경우 익일 데이터 소싱이 완료된 후 확인이 가능합니다.(오전 9시 전후)
{% endhint %}

<table><thead><tr><th width="219.65625">측정값</th><th>설명</th></tr></thead><tbody><tr><td>활성 사용자</td><td>내 사이트 또는 앱을 방문한 개별 사용자의 수입니다.</td></tr><tr><td>1일 활성 사용자</td><td>1일 기간 내 사이트 또는 앱의 순 활성 사용자 수입니다. 1일 기간에는 보고서 기간의 마지막 날이 포함됩니다. 참고: 활성 사용자 수와 동일합니다.</td></tr><tr><td>28일 활성 사용자</td><td>28일 기간 내 사이트 또는 앱의 순 활성 사용자 수입니다. 28일 기간에는 보고서 기간의 마지막 날이 포함됩니다.</td></tr><tr><td>7일 활성 사용자</td><td>7일 기간 내 사이트 또는 앱의 순 활성 사용자 수입니다. 7일에는 보고서 기간의 마지막 날이 포함됩니다.</td></tr><tr><td>장바구니에 추가</td><td>사용자가 장바구니에 상품을 추가한 횟수입니다.</td></tr><tr><td>광고 단위 노출</td><td>광고 단위가 사용자에게 노출된 시간(밀리초)입니다.</td></tr><tr><td>광고 클릭수</td><td>사용자가 속성에 도달하기 위해 광고를 클릭한 총횟수입니다.연결된 Search Ads 360 광고주와 같은 연결된 통합에서 발생한 클릭수가 포함됩니다.데이터 가져오기에서 업로드된 클릭수도 포함됩니다.</td></tr><tr><td>광고 비용</td><td>광고에 지불한 총 금액입니다.연결된 Google Ads 계정 등의 연결된 통합에서 발생한 비용이 포함됩니다.데이터 가져오기를 통해 업로드된 비용도 포함됩니다.자세한 내용은 비용 데이터 가져오기를 참조하세요.</td></tr><tr><td>AD CPC</td><td>광고 클릭당 평균 비용입니다</td></tr><tr><td>전환당비용</td><td>전환당비용은 광고 비용을 전환수로 나눈 값입니다.</td></tr><tr><td>광고 노출수</td><td>총 노출수입니다.연결된 Display &#x26; Video 360 광고주와 같은 연결된 통합에서 발생한 노출수가 포함됩니다.데이터 가져오기에서 업로드된 노출수도 포함됩니다.</td></tr><tr><td>평균 구매 수익</td><td>이벤트의 거래 그룹에 발생한 평균 구매 수익입니다.</td></tr><tr><td>ARPPU</td><td>유료 사용자당 평균 수익(ARPPU)은 구매 이벤트를 기록한 활성 사용자당 총 구매 수익입니다. 요약 측정항목은 선택한 기간에 대해 분석합니다.</td></tr><tr><td>사용자당 평균 구매 수익</td><td>활성 사용자당 평균 구매 수익은 이벤트를 기록한 활성 사용자당 총 구매 수익입니다. 요약 측정항목은 선택한 기간에 대해 분석합니다.</td></tr><tr><td>ARPU</td><td>활성 사용자당 평균 수익(ARPU)입니다. 요약 측정항목은 선택한 기간에 대해 분석합니다.ARPU는 총 수익을 사용하며 AdMob 예상 수입을 포함합니다.</td></tr><tr><td>평균 세션 시간</td><td>사용자 세션의 평균 시간(초)입니다.</td></tr><tr><td>이탈률</td><td>참여하지 않은 세션의 비율(세션수에서 참여 세션수를 뺀 값)을 세션수로 나눈 값입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.2761은 세션의 27.61 % 가 이탈였음을 의미합니다.</td></tr><tr><td>조회수 대비 장바구니 추가 비율</td><td>장바구니에 제품을 추가한 사용자 수를 동일한 제품을 조회한 사용자 수로 나눈 값입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.1132는 제품을 조회한 사용자 중 11.32 % 가 장바구니에 동일한 제품을 추가했음을 의미합니다.</td></tr><tr><td>결제 횟수</td><td>사용자가 결제 과정을 시작한 횟수입니다. 이 측정항목은 'begin_checkout' 이벤트의 발생을 집계합니다.</td></tr><tr><td>비정상 종료의 영향을 받은 사용자</td><td>보고서의 이 행에 비정상 종료를 로깅한 사용자 수입니다. 예를 들어 날짜별 시계열 보고서의 경우 이 측정항목은 해당 날짜에 비정상 종료가 한 번 이상 발생한 총 사용자 수를 보고합니다.비정상 종료는 이름이 'app_exception'인 이벤트입니다.</td></tr><tr><td>비정상 종료가 발생하지 않은 사용자의 비율</td><td>비정상 종료 이벤트가 없는 사용자 수(보고서의 이 행)를 총 사용자 수로 나눈 값입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.9243은 사용자의 92.43 % 에게 비정상 종료가 발생하지 않았음을 의미합니다.</td></tr><tr><td>DAU / MAU</td><td>30일 활성 사용자 중 1일 활성 사용자인 사용자의 롤링 비율입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.113은 30일 활성 사용자의 11.3 % 가 1일 활성 사용자였음을 의미합니다.</td></tr><tr><td>DAU / WAU</td><td>7일 활성 사용자 중 1일 활성 사용자인 사용자의 롤링 비율입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.082는 7일 활성 사용자의 8.2 % 가 1일 활성 사용자였음을 의미합니다.</td></tr><tr><td>전자상거래 구매 건수</td><td>사용자가 구매를 완료한 횟수입니다. 이 측정항목은 'purchase' 이벤트를 집계하지만 'in_app_purchase' 및 구독 이벤트는 계산하지 않습니다.</td></tr><tr><td>참여 세션수</td><td>10초 넘게 지속되었거나, 전환 이벤트가 발생했거나, 화면 조회수가 2회 이상인 세션수입니다.</td></tr><tr><td>참여율</td><td>참여 세션수의 비율(참여 세션수를 전체 세션수로 나눈 값)입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.7239는 세션의 72.39 % 가 참여 세션이라는 의미입니다.</td></tr><tr><td>이벤트 수</td><td>이벤트 수입니다.</td></tr><tr><td>사용자당 이벤트 수</td><td>사용자당 평균 이벤트 수(이벤트 수를 활성 사용자 수로 나눈 값)입니다.</td></tr><tr><td>세션당 이벤트 수</td><td>세션당 평균 이벤트 수 (이벤트 수를 세션수로 나눈 값)입니다.</td></tr><tr><td>이벤트 값</td><td>value'라는 이벤트 매개변수의 합계입니다.</td></tr><tr><td>최초 구매자 전환</td><td>처음으로 구매한 활성 사용자의 비율입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.092는 활성 사용자의 9.2 % 가 첫 구매자였음을 의미합니다.</td></tr><tr><td>최초 구매자 수</td><td>처음 구매한 순 사용자 수</td></tr><tr><td>신규 사용자당 최초 구매자 수</td><td>신규 사용자당 평균 최초 구매자 수입니다.</td></tr><tr><td>총 항목 수익</td><td>상품에서만 발생한 총 수익입니다.총 상품 수익은 가격과 수량을 곱한 값입니다.세금 및 배송비 값은 상품 수익에서 제외됩니다.세금 및 배송비 값은 상품 수준이 아닌 이벤트에서 지정됩니다.총 항목 수익에는 환불 금액이 포함되지 않습니다.</td></tr><tr><td>총 구매 수익</td><td>내 앱 또는 사이트에서 발생한 구매 수익의 합계입니다.총 구매 수익은 'purchase', 'ecommerce_purchase', 'in_app_purchase', 'app_store_subscription_convert', 'app_store_subscription_renew' 이벤트의 수익을 합산합니다.구매 수익은 태그의 'value' 매개변수로 지정됩니다.</td></tr><tr><td>상품 할인 금액</td><td>전자상거래 이벤트에서 발생한 상품 할인의 금전적 가치입니다. 이 측정항목은 '할인' 항목 매개변수에 따라 태그 지정에 채워집니다.</td></tr><tr><td>상품 목록 클릭 이벤트</td><td>사용자가 목록에 표시된 상품을 클릭한 횟수입니다. 이 측정항목은 'select_item' 이벤트의 발생을 집계합니다.</td></tr><tr><td>상품 목록 클릭률</td><td>목록을 선택한 사용자 수를 동일한 목록을 조회한 사용자 수로 나눈 값입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.2145는 목록을 조회한 사용자 중 21.45 % 가 동일한 목록을 선택했다는 의미입니다.</td></tr><tr><td>상품 목록 조회 이벤트</td><td>상품 목록이 조회된 횟수입니다. 이 측정항목은 'view_item_list' 이벤트의 발생을 집계합니다.</td></tr><tr><td>상품 프로모션 클릭률</td><td>프로모션을 선택한 사용자 수를 동일한 프로모션을 조회한 사용자 수로 나눈 값입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.1382는 프로모션을 본 사용자 중 13.82 % 가 프로모션도 선택했음을 의미합니다.</td></tr><tr><td>상품 환불 금액</td><td>상품 환불 금액은 상품에서만 환불된 총 거래 수익입니다.상품 환불 금액은 '환불' 이벤트의 가격과 수량을 곱한 값입니다.</td></tr><tr><td>상품 수익</td><td>총 구매 수익에서 상품에서만 환불된 거래 수익을 뺀 값입니다.상품 수익은 가격과 수량을 곱한 값입니다.세금 및 배송비 값은 상품 수익에서 제외됩니다.세금 및 배송비 값은 상품 수준이 아닌 이벤트에서 지정됩니다.</td></tr><tr><td>장바구니에 추가된 상품 수</td><td>단일 상품의 장바구니에 추가된 단위 수입니다. 이 측정항목은 'add_to_cart' 이벤트의 항목 수량을 계산합니다.</td></tr><tr><td>결제된 상품 수</td><td>단일 상품에 대해 체크아웃된 단위의 수입니다. 이 측정항목은 'begin_checkout' 이벤트의 상품 수량을 계산합니다.</td></tr><tr><td>목록에서 클릭된 상품 수</td><td>단일 상품의 목록에서 클릭한 단위 수입니다. 이 측정항목은 'select_item' 이벤트의 항목 수량을 계산합니다.</td></tr><tr><td>프로모션에서 클릭된 상품 수</td><td>단일 상품의 프로모션에서 클릭된 단위 수입니다. 이 측정항목은 'select_promotion' 이벤트의 항목 수량을 계산합니다.</td></tr><tr><td>구매한 상품 수</td><td>구매 이벤트에 포함된 단일 상품의 단위 수입니다. 이 측정항목은 구매 이벤트의 상품 수량을 계산합니다.</td></tr><tr><td>조회된 상품 수</td><td>단일 상품이 조회된 단위 수입니다. 이 측정항목은 'view_item' 이벤트의 항목 수량을 계산합니다.</td></tr><tr><td>목록에서 조회된 상품 수</td><td>단일 상품의 목록에서 조회된 단위 수입니다. 이 측정항목은 'view_item_list' 이벤트의 항목 수량을 계산합니다.</td></tr><tr><td>프로모션에서 조회된 상품</td><td>단일 상품의 프로모션에서 조회된 단위 수입니다. 이 측정항목은 'view_promotion' 이벤트의 항목 수량을 계산합니다.</td></tr><tr><td>상품 조회 이벤트</td><td>상품 세부정보가 조회된 횟수입니다. 측정항목은 'view_item' 이벤트의 발생을 집계합니다.</td></tr><tr><td>전환수</td><td>전환 이벤트 수입니다. 이벤트는 수집 시간에 전환으로 표시됩니다.</td></tr><tr><td>신규 사용자</td><td>앱 또는 웹 사이트를 처음으로 방문한 유저의 수입니다.</td></tr><tr><td>자연 Google 검색 평균 게재순위</td><td>Search Console에서 보고된 검색어에 대한 웹사이트 URL의 평균 순위입니다. 예를 들어 어떤 검색어가 사용될 때 사이트 URL의 게재순위가 3위이고, 다른 검색어에서 게재순위가 7위이면 평균 게재순위는(3 + 7) / 2인 5위입니다. 이 측정항목을 사용하려면 활성화된 Search Console 링크가 필요합니다.</td></tr><tr><td>자연 Google 검색결과 클릭수</td><td>Search Console에서 보고된 자연 Google 검색 결과 클릭수입니다. 이 측정항목을 사용하려면 활성화된 Search Console 링크가 필요합니다.</td></tr><tr><td>자연 Google 검색결과 클릭률</td><td>Search Console에서 보고된 자연 Google 검색 결과 클릭률입니다.클릭률은 노출당 클릭수입니다. 이 측정항목은 소수로 표시됩니다. 예를 들어 0.0588은 노출수의 약 5.88 % 에서 클릭이 발생했음을 의미합니다. 이 측정항목을 사용하려면 활성화된 Search Console 링크가 필요합니다.</td></tr><tr><td>자연 Google 검색결과 노출수</td><td>Search Console에서 보고된 자연 Google 검색 결과 노출수입니다. 이 측정항목을 사용하려면 활성화된 Search Console 링크가 필요합니다.</td></tr><tr><td>프로모션 클릭수</td><td>상품 프로모션이 클릭된 횟수입니다. 이 측정항목은 'select_promotion' 이벤트의 발생을 계산합니다.</td></tr><tr><td>프로모션 조회수</td><td>상품 프로모션이 조회된 횟수입니다. 이 측정항목은 'view_promotion' 이벤트의 발생을 계산합니다.</td></tr><tr><td>게시자 광고 클릭수</td><td>ad_click 이벤트 수입니다.</td></tr><tr><td>게시자 광고 노출수</td><td>ad_impression 이벤트 수입니다.</td></tr><tr><td>구매 수익</td><td>구매 수익의 합계에서 앱 또는 사이트에서 발생한 환불 거래 수익을 뺀 값입니다.구매 수익은 'purchase', 'ecommerce_purchase', 'in_app_purchase', 'app_store_subscription_convert', 'app_store_subscription_renew' 이벤트의 수익을 합산합니다.구매 수익은 태그의 'value' 매개변수로 지정됩니다.</td></tr><tr><td>구매자 전환</td><td>1회 이상 구매 거래를 한 활성 사용자의 비율입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.412는 사용자의 41.2 % 가 구매자임을 의미합니다.</td></tr><tr><td>조회수 대비 구매 비율</td><td>제품을 구매한 사용자 수를 동일한 제품을 조회한 사용자 수로 나눈 값입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.128은 제품을 조회한 사용자 중 12.8 % 가 동일한 제품을 구매했음을 의미합니다.</td></tr><tr><td>환불 금액</td><td>환불된 총 거래 수익입니다.환불 금액은 '환불' 및 'app_store_refund' 이벤트의 환불 수익 합계입니다.</td></tr><tr><td>ROAS</td><td>광고 투자수익(ROAS)은 총 수익을 광고주 광고 비용으로 나눈 값입니다.</td></tr><tr><td>조회수</td><td>사용자가 조회한 앱 화면 또는 웹페이지의 수입니다.한 페이지 또는 한 화면을 반복해서 조회한 횟수도 집계에 포함됩니다. (screen_view 이벤트 및 page_view 이벤트)</td></tr><tr><td>세션당 조회수</td><td>사용자가 세션별로 조회한 앱 화면 또는 웹페이지의 수입니다.한 페이지 또는 한 화면을 반복해서 조회한 횟수도 집계에 포함됩니다. (screen_view 이벤트 수 + page_view events 이벤트 수) ÷ 세션 수.</td></tr><tr><td>사용자당 조회수</td><td>활성 사용자당 사용자가 조회한 앱 화면 또는 웹페이지의 수입니다.한 페이지 또는 한 화면을 반복해서 조회한 횟수도 집계에 포함됩니다. (screen_view 이벤트 수 + page_view 이벤트 수) / 활성 사용자 수</td></tr><tr><td>스크롤한 사용자</td><td>페이지의 90 % 이상을 아래로 스크롤한 순 사용자 수입니다.</td></tr><tr><td>세션 전환율</td><td>전환 이벤트가 트리거된 세션의 비율입니다.</td></tr><tr><td>세션수</td><td>사이트 또는 앱에서 시작된 세션수입니다(트리거된 이벤트: session_start).</td></tr><tr><td>사용자당 세션수</td><td>사용자당 평균 세션수(세션수를 활성 사용자 수로 나눈 값)입니다.</td></tr><tr><td>배송비</td><td>거래와 연결된 배송비입니다. 'shipping' 이벤트 매개변수로 입력됩니다.</td></tr><tr><td>세액</td><td>거래와 연결된 세액입니다. 'tax' 이벤트 매개변수로 채워집니다.</td></tr><tr><td>총 광고 수익</td><td>AdMob과 서드 파티 소스 모두에서 발생한 총 광고 수익입니다.</td></tr><tr><td>전체 구매자 수</td><td>선택한 기간 동안 구매 이벤트를 로깅한 사용자 수입니다.</td></tr><tr><td>총수익</td><td>구매, 구독 및 광고 수익의 합계(구매 수익 + 구독 수익 + 광고 수익)에서 환불된 거래 수익을 뺀 값입니다.</td></tr><tr><td>총 사용자 수</td><td>이벤트가 로깅될 때 사이트 또는 앱이 사용 중이었는지와 관계없이 이벤트를 하나 이상 로깅한 개별 사용자 수입니다.</td></tr><tr><td>거래</td><td>구매 수익이 있는 거래 이벤트의 수입니다.거래 이벤트는 in_app_purchase, ecommerce_purchase, purchase, app_store_subscription_renew, app_store_subscription_convert, refund입니다.</td></tr><tr><td>구매자당 거래 수</td><td>구매자당 평균 거래 수입니다.</td></tr><tr><td>사용자 참여</td><td>웹사이트 또는 앱이 사용자 기기의 포그라운드에 있는 총 시간(초)입니다.</td></tr><tr><td>사용자 전환율</td><td>전환 이벤트를 트리거한 사용자의 비율입니다.</td></tr><tr><td>WAU / MAU</td><td>30일 활성 사용자 중 7일 활성 사용자의 롤링 비율입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.234는 30일 활성 사용자의 23.4 % 가 7일 활성 사용자였음을 의미합니다.</td></tr></tbody></table>