이러한 측정기준 및 측정항목은 Analytics Data API 유입경로 보고서에서 지원됩니다.
크기
다음 측정기준은 속성에 대한 유입경로 보고서에서 요청할 수 있습니다.
Dimension 리소스의 name 필드에 'API 이름'을 지정합니다.
| API 이름 | UI 이름 | 세그먼트에서 사용 가능 | 설명 |
|---|---|---|---|
| achievementId | 업적 ID | 예 | 이벤트의 업적 ID입니다. 이벤트 매개변수 achievement_id로 입력됩니다. |
| adFormat | 광고 형식 | 예 | 광고의 모양과 위치를 설명합니다. 일반적인 형식으로는 Interstitial, Banner, Rewarded, Native advanced이 있습니다. |
| adSourceName | 광고 소스 | 아니요 | 광고를 게재한 소스 네트워크입니다. 일반적인 소스에는 AdMob Network, Liftoff, Facebook Audience Network, Mediated house ads가 포함됩니다. |
| adUnitName | 광고 단위 | 아니요 | 이 광고 단위를 설명하기 위해 선택한 이름입니다. 광고 단위는 사용자에게 광고를 게재하기 위해 앱에 배치하는 컨테이너입니다. |
| appVersion | 앱 버전 | 예 | 앱의 버전 이름(Android) 또는 약식 번들 버전(iOS)입니다. |
| audienceId | 잠재고객 ID | 아니요 | 잠재고객의 숫자 식별자입니다. 사용자는 보고서 기간 동안 사용자가 속한 잠재고객으로 보고됩니다. 현재 사용자 행동은 보고서의 이전 잠재고객 멤버십에 영향을 미치지 않습니다. |
| audienceName | 잠재고객 이름 | 아니요 | 잠재고객의 이름입니다. 사용자는 보고서 기간 동안 사용자가 속한 잠재고객으로 보고됩니다. 현재 사용자 행동은 보고서의 이전 잠재고객 멤버십에 영향을 미치지 않습니다. |
| brandingInterest | 관심분야 | 아니요 | 쇼핑 유입경로에서 상위 단계에 있는 사용자가 보여준 관심분야입니다. 사용자가 여러 관심분야 카테고리의 집계에 포함될 수 있습니다. 예를 들면 Shoppers, Lifestyles & Hobbies/Pet Lovers, Travel/Travel Buffs/Beachbound Travelers입니다. |
| browser | 브라우저 | 예 | 웹사이트를 볼 때 사용한 브라우저입니다. |
| campaignId | 캠페인 ID | 아니요 | 마케팅 캠페인의 식별자입니다. 전환 이벤트에 대해서만 표시됩니다. |
| campaignName | 실행 | 아니요 | 마케팅 캠페인의 이름입니다. 전환 이벤트에 대해서만 표시됩니다. |
| 문자 | 문자 기반이란 | 예 | 이벤트 게임 속 플레이어 캐릭터입니다. 이벤트 매개변수 character로 입력됩니다. |
| city | 도시 | 예 | 사용자 활동이 시작된 도시입니다. |
| cityId | 도시 ID | 예 | 사용자 활동이 발생한 도시의 지역 ID로, IP 주소에서 파생됩니다. |
| cohort | 동질 집단 | 아니요 | 요청에 있는 동질 집단의 이름입니다. 동질 집단은 연속된 날짜 그룹에 웹사이트 또는 앱을 사용하기 시작한 사용자의 집합입니다. 요청에 동질 집단 이름이 지정되지 않은 경우 동질 집단의 이름은 0부터 시작하는 색인(예: cohort_0, cohort_1)으로 지정됩니다. |
| cohortNthDay | 일간 사용자 집단 | 아니요 | 동질 집단에 속한 사용자의 firstSessionDate를 기준으로 한 오프셋입니다. 예를 들어 시작일과 종료일이 2020년 3월 1일인 동질 집단을 선택한 경우 2020년 3월 2일의 경우 cohortNthDay는 0001이 됩니다. |
| cohortNthMonth | 월간 사용자 집단 | 아니요 | 동질 집단에 속한 사용자의 firstSessionDate를 기준으로 한 월 오프셋입니다. 월 경계는 캘린더 월 경계와 일치합니다. 예를 들어 시작일과 종료일이 2020년 3월에 설정된 동질 집단을 선택한 경우 2020년 4월에 있으면 cohortNthMonth는 0001입니다. |
| cohortNthWeek | 주간 사용자 집단 | 아니요 | 동질 집단의 사용자에 대한 firstSessionDate를 기준으로 한 주 오프셋입니다. 주는 일요일에 시작하여 토요일에 끝납니다. 예를 들어 시작일과 종료일이 2020년 11월 8일에서 2020년 11월 14일 사이인 동질 집단을 선택한 경우 2020년 11월 15일부터 2020년 11월 21일 사이의 기간에 대해 cohortNthWeek는 0001이 됩니다. |
| contentGroup | 콘텐츠 그룹 | 예 | 게시된 콘텐츠의 항목에 적용되는 카테고리입니다. 이벤트 매개변수 content_group로 입력됩니다. |
| contentId | Content ID | 예 | 선택한 콘텐츠의 식별자입니다. 이벤트 매개변수 content_id로 입력됩니다. |
| contentType | 콘텐츠 유형 | 예 | 선택한 콘텐츠의 카테고리입니다. 이벤트 매개변수 content_type로 입력됩니다. |
| country | 국가 | 예 | 사용자 활동이 시작된 국가입니다. |
| countryId | 국가 ID | 예 | 사용자 활동이 발생한 국가의 지역 ID로, IP 주소에서 가져온 값입니다. ISO 3166-1 alpha-2 표준에 따라 형식이 지정됩니다. |
| date | 날짜 | 예 | YYYYMMDD 형식으로 표시되는 이벤트 날짜입니다. |
| dateHour | 날짜 + 시간(YYYYMMDDHH) | 아니요 | YYYYMMDDHH 형식으로 날짜와 시간을 결합한 값입니다. |
| dateHourMinute | 날짜 시간 및 분 | 아니요 | YYYYMMDDHHMM 형식의 날짜, 시간, 분을 결합한 값입니다. |
| 일 | 일차 | 예 | 01에서 31 사이의 2자리 숫자로 표시된 날입니다. |
| dayOfWeek | 요일 | 예 | 요일 한 주의 첫날이 일요일인 [0,6] 범위의 값을 반환합니다. |
| defaultChannelGrouping | 기본 채널 그룹 | 아니요 | 전환의 기본 채널 그룹은 주로 소스 및 매체를 기반으로 합니다. Direct, Organic Search, Paid Social, Organic Social, Email, Affiliates, Referral, Paid Search, Video, Display를 포함하는 열거형입니다. |
| deviceCategory | 기기 카테고리 | 예 | 기기의 유형(데스크톱, 태블릿, 모바일)입니다. |
| deviceModel | 기기 모델 | 예 | 휴대기기 모델입니다 (예: iPhone 10,6). |
| eventName | 이벤트 이름 | 예 | 이벤트 이름 |
| fileExtension | 파일 확장자 | 예 | 다운로드한 파일의 확장자입니다 (예: pdf 또는 txt). 향상된 측정이 사용 설정된 경우 자동으로 입력됩니다. 이벤트 매개변수 file_extension로 입력됩니다. |
| fileName | 파일 이름 | 예 | 다운로드한 파일의 페이지 경로입니다 (예: /menus/dinner-menu.pdf). 향상된 측정이 사용 설정된 경우 자동으로 입력됩니다. 이벤트 매개변수 file_name로 입력됩니다. |
| firstSessionDate | 첫 번째 세션 날짜 | 예 | 사용자의 첫 세션이 발생한 날짜로, YYYYMMDD 형식으로 지정됩니다. |
| firstUserCampaignId | 신규 사용자 캠페인 ID | 아니요 | 사용자를 처음 획득한 마케팅 캠페인의 식별자입니다. Google Ads 캠페인이 포함됩니다. |
| firstUserCampaignName | 신규 사용자 캠페인 | 예 | 사용자를 최초로 획득한 마케팅 캠페인의 이름. Google Ads 및 수동 캠페인이 포함됩니다. |
| firstUserDefaultChannelGrouping | 신규 사용자 기본 채널 그룹 | 예 | 사용자를 처음 획득한 기본 채널 그룹입니다. 기본 채널 그룹은 주로 소스 및 매체를 기반으로 합니다. Direct, Organic Search, Paid Social, Organic Social, Email, Affiliates, Referral, Paid Search, Video, Display를 포함하는 열거형입니다. |
| firstUserGoogleAdsAccountName | 첫 사용자 Google Ads 계정 이름 | 아니요 | 사용자를 처음 획득한 Google Ads의 계정 이름입니다. |
| firstUserGoogleAdsAdGroupId | 첫 사용자 Google Ads 광고그룹 ID | 아니요 | 사용자를 처음 획득한 Google Ads의 광고그룹 ID입니다. |
| firstUserGoogleAdsAdGroupName | 신규 사용자 Google Ads 광고그룹 이름 | 아니요 | 사용자를 처음 획득한 Google Ads의 광고그룹 이름입니다. |
| firstUserGoogleAdsAdNetworkType | 신규 사용자 Google Ads 광고 네트워크 유형 | 예 | 사용자를 처음 획득한 광고 네트워크입니다. Google search, Search partners, Google Display Network, Youtube Search, Youtube Videos, Cross-network, Social, (universal campaign)를 포함하는 열거형입니다. |
| firstUserGoogleAdsCampaignType | 첫 사용자 Google Ads 캠페인 유형 | 아니요 | 사용자를 처음 획득한 Google Ads 캠페인의 캠페인 유형입니다. 캠페인 유형에 따라 고객에게 광고가 게재되는 위치와 Google Ads에서 사용할 수 있는 설정 및 옵션이 달라집니다. 캠페인 유형은 검색, 디스플레이, 쇼핑, 동영상, 디스커버리, 앱, 스마트, 호텔, 지역, 실적 최대화를 포함하는 목록입니다. 자세한 내용은 적절한 캠페인 유형 선택하기를 참고하세요. |
| firstUserGoogleAdsCreativeId | 첫 사용자 Google Ads 광고 소재 ID | 아니요 | 사용자를 처음 획득한 Google Ads 광고 소재의 ID입니다. 광고 소재 ID는 개별 광고를 식별합니다. |
| firstUserGoogleAdsCustomerId | 첫 사용자 Google Ads 고객 ID | 아니요 | 사용자를 처음 획득한 Google Ads의 고객 ID입니다. Google Ads의 고객 ID는 Google Ads 계정을 고유하게 식별합니다. |
| firstUserGoogleAdsKeyword | 첫 사용자 Google Ads 키워드 텍스트 | 아니요 | 사용자를 처음 획득한 일치 키워드입니다. 키워드는 적합한 고객에게 광고를 게재하기 위해 선택한 제품 또는 서비스를 설명하는 단어나 구문입니다. 키워드에 대해 자세히 알아보려면 키워드: 정의를 참고하세요. |
| firstUserGoogleAdsQuery | 첫 사용자 Google Ads 쿼리 | 아니요 | 사용자를 처음 획득한 검색어입니다. |
| firstUserManualAdContent | 첫 번째 사용자 수동 광고 콘텐츠 | 예 | 사용자를 처음 획득한 광고 콘텐츠입니다. utm_content 매개변수로 입력됩니다. |
| firstUserManualTerm | 첫 번째 사용자 수동 검색어 | 예 | 사용자를 처음 획득한 검색어입니다. utm_term 매개변수로 입력됩니다. |
| firstUserMedium | 신규 사용자 매체 | 예 | 웹사이트 또는 앱에서 사용자를 처음 획득한 매체입니다. |
| firstUserSource | 신규 사용자 소스 | 예 | 웹사이트 또는 앱에서 사용자를 처음 획득한 소스입니다. |
| firstUserSourceMedium | 신규 사용자 소스/매체 | 아니요 | 측정기준 firstUserSource 및 firstUserMedium의 결합된 값입니다. |
| firstUserSourcePlatform | 신규 사용자 소스 플랫폼 | 아니요 | 사용자를 처음 획득한 소스 플랫폼입니다. UTM을 사용하는 트래픽에 Manual를 반환하는 이 필드에 의존하지 마세요. 곧 출시될 기능 출시에 대해 이 필드가 Manual를 반환하는 값에서 (not set)를 반환하는 값으로 업데이트됩니다. |
| fullPageUrl | 전체 페이지 URL | 아니요 | 방문한 웹페이지의 호스트 이름, 페이지 경로, 쿼리 문자열입니다. 예를 들어 https://www.example.com/store/contact-us?query_string=true의 fullPageUrl 부분은 www.example.com/store/contact-us?query_string=true입니다. |
| funnelStepName | 단계 | 아니요 | 유입경로 단계에 할당된 설명이 포함된 이름입니다. 예를 들어 요청의 세 번째 유입경로 단계에서 name = Purchase를 지정하면 유입경로 보고서 응답의 이 funnelStepName 측정기준에 대해 3. Purchase이(가) 생성됩니다. |
| funnelStepNewVsContinuing | 신규 및 계속 | 아니요 | 이전 유입경로 단계에 있었던 사용자는 유입경로 단계를 계속 진행하고 있는 것입니다. 그렇지 않으면 신규 사용자입니다. 이 측정기준은 개방형 유입경로에서만 의미가 있으며 new 및 continuing라는 두 값을 반환합니다. |
| funnelStepNextAction | 유입경로 다음 액션 | 아니요 | 다음 액션은 현재 단계를 완료한 후 사용자가 획득한 다음 측정기준 값(다음 단계의 완료 포함)입니다. 예를 들어 요청된 다음 액션 측정기준이 eventName인 경우, 이 측정기준은 i단계에 도달한 후 다음 이벤트의 이름을 반환합니다. 이 다음 액션은 i+1단계를 달성한 이벤트를 제외하고 i번째 단계를 완료한 이벤트는 제외됩니다. |
| googleAdsAccountName | Google Ads 계정 이름 | 아니요 | 전환 이벤트로 이어진 캠페인의 Google Ads 계정 이름입니다. Google Ads API의 customer.descriptive_name에 해당합니다. |
| googleAdsAdGroupId | Google Ads 광고그룹 ID | 아니요 | 전환 이벤트에 기여한 광고 그룹 ID입니다. |
| googleAdsAdGroupName | Google Ads 광고 그룹 이름 | 아니요 | 전환 이벤트에 기여한 광고 그룹 이름입니다. |
| googleAdsAdNetworkType | Google Ads 광고 네트워크 유형 | 아니요 | 전환의 광고 네트워크 유형입니다. Google search, Search partners, Google Display Network, Youtube Search, Youtube Videos, Cross-network, Social, (universal campaign)를 포함하는 열거형입니다. |
| googleAdsCampaignType | Google Ads 캠페인 유형 | 아니요 | 전환 이벤트에 기여한 Google Ads 캠페인의 캠페인 유형입니다. 캠페인 유형에 따라 고객에게 광고가 게재되는 위치와 Google Ads에서 사용할 수 있는 설정 및 옵션이 달라집니다. 캠페인 유형은 검색, 디스플레이, 쇼핑, 동영상, 디스커버리, 앱, 스마트, 호텔, 지역, 실적 최대화를 포함하는 목록입니다. 자세한 내용은 적절한 캠페인 유형 선택하기를 참고하세요. |
| googleAdsCreativeId | Google Ads 광고 소재 ID | 아니요 | 전환 이벤트에 기여한 Google Ads 광고 소재의 ID입니다. 광고 소재 ID는 개별 광고를 식별합니다. |
| googleAdsCustomerId | Google Ads 고객 ID | 아니요 | 전환 이벤트로 이어진 캠페인의 Google Ads 고객 ID입니다. Google Ads의 고객 ID는 Google Ads 계정을 고유하게 식별합니다. |
| googleAdsKeyword | Google Ads 키워드 텍스트 | 아니요 | 전환 이벤트로 이어진 일치 키워드입니다. 키워드는 적합한 고객에게 광고를 게재하기 위해 선택한 제품 또는 서비스를 설명하는 단어나 구문입니다. 키워드에 대해 자세히 알아보려면 키워드: 정의를 참고하세요. |
| googleAdsQuery | Google Ads 검색어 | 아니요 | 전환 이벤트로 이어진 검색어입니다. |
| groupId | 그룹 ID | 예 | 이벤트 게임의 플레이어 그룹 ID입니다. 이벤트 매개변수 group_id로 입력됩니다. |
| hostName | 호스트 이름 | 예 | URL의 하위 도메인 및 도메인 이름이 포함됩니다. 예를 들어 www.example.com/contact.html의 호스트 이름은 www.example.com입니다. |
| 시간 | 시간 | 예 | 이벤트가 기록된 하루 중 두 자리 수의 시간입니다. 이 측정기준의 범위는 0~23이며 속성의 시간대로 보고됩니다. |
| isConversionEvent | 전환 이벤트임 | 예 | 이벤트가 전환인 경우 문자열 true입니다. 이벤트는 수집 시점에 전환으로 표시됩니다. 이벤트의 전환 표시에 대한 변경사항은 앞으로 적용됩니다. Google 애널리틱스에서 모든 이벤트를 전환으로 표시할 수 있으며, 일부 이벤트 (예: first_open, purchase)는 기본적으로 전환으로 표시됩니다. 자세한 내용은 전환 정보를 참고하세요. |
| itemAffiliation | 상품 제휴 | 아니요 | 개별 상품과 연결된 제휴사 (파트너/공급업체, 있는 경우)의 이름 또는 코드입니다. affiliation 항목 매개변수로 채워집니다. |
| itemBrand | 상품 브랜드 | 아니요 | 상품의 브랜드 이름입니다. |
| itemCategory | 상품 카테고리 | 아니요 | 상품이 분류되는 계층별 카테고리입니다. 예를 들어 의류/남성/여름/셔츠/티셔츠에서는 의류가 상품 카테고리입니다. |
| itemCategory2 | 상품 카테고리 2 | 아니요 | 상품이 분류되는 계층별 카테고리입니다. 예를 들어 의류/남성/여름/셔츠/티셔츠에서는 남성이 상품 카테고리 2입니다. |
| itemCategory3 | 상품 카테고리 3 | 아니요 | 상품이 분류되는 계층별 카테고리입니다. 예를 들어 의류/남성/여름/셔츠/티셔츠에서는 여름이 상품 카테고리 3입니다. |
| itemCategory4 | 상품 카테고리 4 | 아니요 | 상품이 분류되는 계층별 카테고리입니다. 예를 들어 의류/남성/여름/셔츠/티셔츠에서는 셔츠가 상품 카테고리 4입니다. |
| itemCategory5 | 상품 카테고리 5 | 아니요 | 상품이 분류되는 계층별 카테고리입니다. 예를 들어 의류/남성/여름/셔츠/티셔츠에서는 티셔츠가 상품 카테고리 5입니다. |
| itemId | 상품 ID | 아니요 | 상품의 ID |
| itemListId | 상품 목록 ID | 아니요 | 상품 목록의 ID입니다. |
| itemListName | 상품 목록 이름 | 아니요 | 상품 목록의 이름입니다. |
| itemName | 상품 이름 | 아니요 | 상품의 이름 |
| itemPromotionCreativeName | 상품 프로모션 광고 소재 이름 | 아니요 | 상품 프로모션 광고 소재의 이름입니다. |
| itemPromotionId | 상품 프로모션 ID | 아니요 | 상품 프로모션의 ID입니다. |
| itemPromotionName | 상품 프로모션 이름 | 아니요 | 상품 프로모션의 이름입니다. |
| itemVariant | 상품 옵션 | 아니요 | 제품의 구체적인 변형입니다(예: 사이즈는 XS, S, M, L, 색상은 빨강, 파랑, 초록, 검은색). item_variant 매개변수로 채워집니다. |
| landingPage | 방문 페이지 | 예 | 세션의 첫 번째 페이지 조회와 연결된 페이지 경로 + 쿼리 문자열입니다. |
| language | 언어 | 예 | 사용자 브라우저 또는 기기의 언어 설정입니다(예: 영어). |
| languageCode | 언어 코드 | 예 | 사용자 브라우저 또는 기기의 언어 설정 (ISO 639)입니다. 예: en-us |
| 레벨 | 수준 | 예 | 플레이어의 게임 내 레벨입니다. 이벤트 매개변수 level로 입력됩니다. |
| linkClasses | 클래스 연결 | 예 | 외부 연결 링크의 HTML 클래스 속성입니다. 예를 들어 사용자가 <a class="center" href="www.youtube.com"> 링크를 클릭하면 이 측정기준은 center을 반환합니다. 향상된 측정이 사용 설정된 경우 자동으로 채워집니다. 이벤트 매개변수 link_classes로 입력됩니다. |
| linkDomain | 도메인 연결 | 예 | 외부 연결 링크의 대상 도메인입니다. 예를 들어 사용자가 <a href="www.youtube.com"> 링크를 클릭하면 이 측정기준은 youtube.com을 반환합니다. 향상된 측정이 사용 설정된 경우 자동으로 채워집니다. 이벤트 매개변수 link_domain로 입력됩니다. |
| linkId | 연결 ID | 예 | 외부 연결 링크 또는 파일 다운로드의 HTML ID 속성입니다. 예를 들어 사용자가 <a id="socialLinks" href="www.youtube.com"> 링크를 클릭하면 이 측정기준은 socialLinks을 반환합니다. 향상된 측정이 사용 설정된 경우 자동으로 채워집니다. 이벤트 매개변수 link_id로 입력됩니다. |
| linkText | 링크 텍스트 | 예 | 파일 다운로드의 링크 텍스트입니다. 향상된 측정이 사용 설정된 경우 자동으로 채워집니다. 이벤트 매개변수 link_text로 입력됩니다. |
| linkUrl | 링크 URL | 예 | 외부 연결 링크 또는 파일 다운로드의 전체 URL입니다. 예를 들어 사용자가 <a href="https://www.youtube.com/results?search_query=analytics"> 링크를 클릭하면 이 측정기준은 https://www.youtube.com/results?search_query=analytics을 반환합니다. 향상된 측정이 사용 설정된 경우 자동으로 채워집니다. 이벤트 매개변수 link_url로 입력됩니다. |
| manualAdContent | 수동 광고 콘텐츠 | 아니요 | 전환 이벤트에 기여한 광고 콘텐츠입니다. utm_content 매개변수로 입력됩니다. |
| manualTerm | 수동 검색어 | 아니요 | 전환 이벤트에 기여한 검색어입니다. utm_term 매개변수로 입력됩니다. |
| 중간 | 보통 | 아니요 | 전환 이벤트에 기여한 매체입니다. |
| method | 메서드 | 예 | 이벤트가 트리거된 메서드입니다. 이벤트 매개변수 method로 입력됩니다. |
| 분 | 분 | 아니요 | 이벤트가 기록된 시간의 두 자리 분입니다. 이 측정기준의 범위는 0~59이며 속성의 시간대로 보고됩니다. |
| mobileDeviceBranding | 기기 브랜드 | 예 | 제조업체 또는 브랜드 이름(예: 삼성, HTC, Verizon, T-Mobile)입니다. |
| mobileDeviceMarketingName | 기기 | 예 | 브랜드 기기 이름입니다 (예: Galaxy S10 또는 P30 Pro). |
| mobileDeviceModel | 휴대기기 모델 | 예 | 휴대기기 모델 이름입니다 (예: iPhone X 또는 SM-G950F). |
| 월 | 월 | 예 | 01에서 12 사이의 2자리 정수로 표시된 이벤트가 열리는 달입니다. |
| newVsReturning | 신규 사용자/재사용자 | 예 | 신규 사용자의 이전 세션수는 0회이고 재방문 사용자의 이전 세션수는 1회 이상입니다. 이 측정기준은 new 또는 returning의 두 값을 반환합니다. |
| nthDay | N일 | 아니요 | 기간이 시작된 이후 지난 일수입니다. |
| nthHour | N시간 | 아니요 | 기간이 시작된 이후 지난 시간입니다. 시작 시간은 0000입니다. |
| nthMinute | N분 | 아니요 | 기간이 시작된 이후 지난 시간(분)입니다. 시작 시간(분)은 0000입니다. |
| nthMonth | N월 | 아니요 | 기간이 시작된 이후 지난 개월 수입니다. 시작 달은 0000입니다. |
| nthWeek | N주 | 아니요 | 기간이 시작된 이후 지난 주 수를 나타내는 숫자입니다. |
| nthYear | 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로 입력됩니다. |
| pageLocation | 페이지 위치 | 예 | 방문한 웹페이지의 프로토콜, 호스트 이름, 페이지 경로, 쿼리 문자열입니다. 예를 들어 https://www.example.com/store/contact-us?query_string=true의 pageLocation 부분은 https://www.example.com/store/contact-us?query_string=true입니다. 이벤트 매개변수 page_location로 입력됩니다. |
| pagePath | 페이지 경로 | 아니요 | 호스트 이름과 방문한 웹페이지의 쿼리 문자열 사이의 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 | 페이지 제목 | 예 | 사이트에서 사용한 웹페이지 제목입니다. |
| percentScrolled | 스크롤 비율 | 예 | 사용자가 페이지에서 스크롤한 후의 비율입니다 (예: 90). 향상된 측정이 사용 설정된 경우 자동으로 채워집니다. 이벤트 매개변수 percent_scrolled로 입력됩니다. |
| platform | 플랫폼 | 예 | 앱이나 웹사이트가 실행된 플랫폼(예: 웹, iOS, Android)입니다. 보고서에서 스트림 유형을 확인하려면 platform 및streamId를 모두 사용하세요. |
| platformDeviceCategory | 플랫폼/기기 카테고리 | 예 | 웹사이트 또는 모바일 앱이 실행된 플랫폼 및 기기의 유형입니다. (예: Android / 모바일) |
| 지역 | 지역 | 예 | 사용자 활동이 발생한 지역입니다(IP 주소 기준). |
| screenResolution | 화면 해상도 | 예 | 사용자 모니터의 화면 해상도입니다. 예: 1920x1080 |
| searchTerm | 검색어 | 예 | 사용자가 검색한 검색어입니다. 예를 들어 사용자가 /some-page.html?q=some-term을(를) 방문하면 이 측정기준은 some-term을 반환합니다. 향상된 측정이 사용 설정된 경우 자동으로 채워집니다. 이벤트 매개변수 search_term로 입력됩니다. |
| 세그먼트 | 세그먼트 | 아니요 | 세그먼트는 애널리틱스 데이터의 하위 집합입니다. 예를 들어 사용자의 전체 집합 중에서 특정 국가 또는 도시 기준 사용자 세그먼트나 자세한 내용은 세그먼트 작성 도구를 참고하세요. 세그먼트 측정기준은 1부터 시작하는 프리픽스와 함께 요청의 세그먼트에 할당된 이름을 반환합니다. 즉, 첫 번째 세그먼트의 이름이 요청에서 Paid Traffic인 경우 이 세그먼트는 응답에서 1. Paid Traffic입니다. 요청에 세그먼트 이름이 지정되지 않은 경우 세그먼트 이름이 1부터 시작하는 이름 (예: 1. Segment, 2. Segment 등)으로 지정됩니다. |
| sessionCampaignId | 세션 캠페인 ID | 아니요 | 세션의 마케팅 캠페인 ID입니다. Google Ads 및 Search Ads 360과 같은 통합 연결을 통한 수동 캠페인 및 캠페인이 포함됩니다. |
| sessionCampaignName | 세션 캠페인 | 예 | 세션의 마케팅 캠페인 이름입니다. Google Ads 및 Search Ads 360과 같은 통합 연결을 통한 수동 캠페인 및 캠페인이 포함됩니다. |
| sessionDefaultChannelGrouping | 세션 기본 채널 그룹 | 예 | 세션의 기본 채널 그룹은 주로 소스 및 매체를 기반으로 합니다. Direct, Organic Search, Paid Social, Organic Social, Email, Affiliates, Referral, Paid Search, Video, Display를 포함하는 열거형입니다. |
| sessionGoogleAdsAccountName | 세션 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 search, Search partners, Google Display Network, Youtube Search, Youtube Videos, Cross-network, Social, (universal campaign)를 포함하는 열거형입니다. |
| sessionGoogleAdsCampaignType | 세션 Google Ads 캠페인 유형 | 아니요 | 이 세션으로 이어진 Google Ads 캠페인의 캠페인 유형입니다. 캠페인 유형에 따라 고객에게 광고가 게재되는 위치와 Google Ads에서 사용할 수 있는 설정 및 옵션이 달라집니다. 캠페인 유형은 검색, 디스플레이, 쇼핑, 동영상, 디스커버리, 앱, 스마트, 호텔, 지역, 실적 최대화를 포함하는 목록입니다. 자세한 내용은 적절한 캠페인 유형 선택하기를 참고하세요. |
| sessionGoogleAdsCreativeId | 세션 Google Ads 광고 소재 ID | 아니요 | 웹사이트 또는 앱의 세션으로 연결되는 Google Ads 광고 소재의 ID입니다. 광고 소재 ID는 개별 광고를 식별합니다. |
| sessionGoogleAdsCustomerId | 세션 Google Ads 고객 ID | 아니요 | 세션으로 이어진 Google Ads의 고객 ID입니다. Google Ads의 고객 ID는 Google Ads 계정을 고유하게 식별합니다. |
| sessionGoogleAdsKeyword | 세션 Google Ads 키워드 텍스트 | 아니요 | 세션으로 이어진 일치 키워드입니다. 키워드는 적합한 고객에게 광고를 게재하기 위해 선택한 제품 또는 서비스를 설명하는 단어나 구문입니다. 키워드에 대해 자세히 알아보려면 키워드: 정의를 참고하세요. |
| sessionGoogleAdsQuery | 세션 Google Ads 검색어 | 아니요 | 세션으로 이어진 검색어입니다. |
| sessionManualAdContent | 세션 수동 광고 콘텐츠 | 예 | 세션으로 이어진 광고 콘텐츠입니다. utm_content 매개변수로 입력됩니다. |
| sessionManualTerm | 세션 수동 검색어 | 예 | 세션으로 이어진 검색어입니다. utm_term 매개변수로 입력됩니다. |
| sessionMedium | 세션 매체 | 예 | 웹사이트 또는 앱에서 세션을 시작한 매체입니다. |
| sessionSa360AdGroupName | 세션 SA360 광고 그룹 이름 | 아니요 | 이 세션으로 이어진 Search Ads 360의 광고그룹 이름입니다. |
| sessionSa360CampaignName | 세션 SA360 캠페인 | 아니요 | 이 세션으로 이어진 Search Ads 360의 캠페인 이름입니다. |
| sessionSa360CreativeFormat | 세션 SA360 광고 소재 형식 | 아니요 | 이 세션으로 이어진 Search Ads 360의 광고 소재 유형입니다. 예를 들면 Responsive search ad 또는 Expanded text ad이 있습니다. 자세한 내용은 GA4 트래픽 소스 측정기준을 참고하세요. |
| sessionSa360EngineAccountId | 세션 SA360 엔진 계정 ID | 아니요 | 이 세션으로 이어진 SA360 엔진 계정의 ID입니다. |
| sessionSa360EngineAccountName | 세션 SA360 엔진 계정 이름 | 아니요 | 이 세션으로 이어진 SA360의 엔진 계정 이름입니다. |
| sessionSa360EngineAccountType | 세션 SA360 엔진 계정 유형 | 아니요 | 이 세션으로 이어진 Search Ads 360의 엔진 계정 유형입니다. 예를 들면 google ads, bing, baidu입니다. |
| sessionSa360Keyword | 세션 SA360 키워드 텍스트 | 아니요 | 이 세션으로 이어진 Search Ads 360의 검색엔진 키워드입니다. |
| sessionSa360Medium | 세션 SA360 매체 | 아니요 | 이 세션으로 이어진 Search Ads 360의 검색엔진 키워드입니다. 예를 들면 다음과 같습니다. cpc |
| sessionSa360Query | 세션 SA360 검색어 | 아니요 | 이 세션으로 이어진 Search Ads 360의 검색어입니다. |
| sessionSa360Source | 세션 SA360 소스 | 아니요 | Search Ads 360에서 이 세션으로 이어진 트래픽의 소스입니다. 예를 들면 example.com 또는 google이 있습니다. |
| sessionSource | 세션 소스 | 예 | 웹사이트 또는 앱에서 세션을 시작한 소스입니다. |
| sessionSourceMedium | 세션 소스/매체 | 아니요 | 측정기준 sessionSource 및 sessionMedium의 결합된 값입니다. |
| sessionSourcePlatform | 세션 소스 플랫폼 | 아니요 | 세션 캠페인의 소스 플랫폼입니다. UTM을 사용하는 트래픽에 Manual를 반환하는 이 필드에 의존하지 마세요. 곧 출시될 기능 출시에 대해 이 필드가 Manual를 반환하는 값에서 (not set)를 반환하는 값으로 업데이트됩니다. |
| shippingTier | 배송 등급 | 아니요 | 구매한 상품의 배송을 위해 선택한 배송 등급입니다 (예: 일반 배송, 항공, 다음날). shipping_tier 이벤트 매개변수로 채워집니다. |
| signedInWithUserId | 사용자 ID로 로그인함 | 예 | 사용자가 User-ID 기능으로 로그인한 경우 문자열 yes입니다. User-ID에 대해 자세히 알아보려면 User-ID로 플랫폼 간 활동 측정하기를 참고하세요. |
| source | 소스 | 아니요 | 전환 이벤트에 기여한 소스입니다. |
| sourceMedium | 소스/매체 | 아니요 | 측정기준 source 및 medium의 결합된 값입니다. |
| sourcePlatform | 소스 플랫폼 | 아니요 | 전환 이벤트 캠페인의 소스 플랫폼입니다. UTM을 사용하는 트래픽에 Manual를 반환하는 이 필드에 의존하지 마세요. 곧 출시될 기능 출시에 대해 이 필드가 Manual를 반환하는 값에서 (not set)를 반환하는 값으로 업데이트됩니다. |
| streamId | 스트림 ID | 예 | 앱 또는 웹사이트의 숫자 데이터 스트림 식별자입니다. |
| streamName | 스트림 이름 | 예 | 앱 또는 웹사이트의 데이터 스트림 이름입니다. |
| testDataFilterName | 테스트 데이터 필터 이름 | 아니요 | 테스트 상태의 데이터 필터의 이름입니다. 이벤트 매개변수 값에 따라 데이터 필터를 사용하여 이벤트 데이터를 보고서에 포함하거나 제외할 수 있습니다. 자세한 내용은 데이터 필터를 참고하세요. |
| transactionId | 거래 ID | 예 | 전자상거래 데이터의 ID입니다. |
| unifiedPagePathScreen | 페이지 경로 및 화면 클래스 | 예 | 이벤트가 기록된 페이지 경로 (웹) 또는 화면 클래스 (앱)입니다. |
| unifiedPageScreen | 페이지 경로 + 쿼리 문자열 및 화면 클래스 | 예 | 이벤트가 기록된 페이지 경로 및 쿼리 문자열 (웹) 또는 화면 클래스 (앱)입니다. |
| unifiedScreenClass | 페이지 제목 및 화면 클래스 | 예 | 이벤트가 기록된 페이지 제목 (웹) 또는 화면 클래스 (앱)입니다. |
| unifiedScreenName | 페이지 제목 및 화면 이름 | 예 | 이벤트가 기록된 페이지 제목 (웹) 또는 화면 이름 (앱)입니다. |
| userAgeBracket | 연령 | 예 | 사용자의 연령대입니다. |
| userGender | 성별 | 예 | 사용자의 성별입니다. |
| videoProvider | 동영상 제공업체 | 예 | 동영상의 소스입니다 (예: youtube). 향상된 측정이 사용 설정된 경우 삽입된 동영상의 경우 자동으로 채워집니다. 이벤트 매개변수 video_provider로 입력됩니다. |
| videoTitle | 동영상 제목 | 예 | 동영상 제목입니다. 향상된 측정이 사용 설정된 경우 삽입된 동영상에 대해 자동으로 채워집니다. 이벤트 매개변수 video_title로 입력됩니다. |
| videoUrl | 동영상 URL | 예 | 동영상의 URL입니다. 향상된 측정이 사용 설정된 경우 삽입된 동영상에 대해 자동으로 채워집니다. 이벤트 매개변수 video_url로 입력됩니다. |
| virtualCurrencyName | 가상화폐 이름 | 예 | 사용자가 상호작용하는 가상 화폐의 이름입니다. 예: 게임에서 보석 구매 또는 구매 virtual_currency_name 이벤트 매개변수로 채워집니다. |
| 표시 | 표시되어야 합니다. | 예 | 콘텐츠가 표시되면 true를 반환합니다. 향상된 측정이 사용 설정된 경우 삽입된 동영상에 대해 자동으로 채워집니다. 이벤트 매개변수 visible로 입력됩니다. |
| 주 | 주 | 예 | 01에서 53 사이의 2자리 숫자로 표시된 이벤트가 열리는 주입니다. 매주 일요일에 시작됩니다. 1월 1일은 항상 01번째 주에 속합니다. 한 해의 첫 번째 주와 마지막 주는 대부분 7일 미만입니다. 한 해의 첫 번째 주와 마지막 주를 제외한 다른 주는 항상 7일입니다. 1월 1일이 일요일인 연도의 경우, 해당 연도의 첫 번째 주와 이전 해의 마지막 주가 7일입니다. |
| 년 | 연도 | 예 | 이벤트의 4자리 연도입니다(예: 2020). |
맞춤 측정기준
Data API를 사용하면 이벤트 및 사용자 범위 맞춤 측정기준에 대한 보고서를 만들 수 있습니다. 맞춤 측정기준에 대한 자세한 내용은 이벤트 범위 맞춤 측정기준 및 측정항목 보고와 맞춤 사용자 속성을 참고하세요. 맞춤 측정기준은 API 보고서 요청에서 측정기준의 매개변수 이름 및 범위로 지정됩니다. 예를 들어 매개변수 이름이 "achievement_id"인 이벤트 범위 맞춤 측정기준에 대한 보고서를 생성하려면 Data API 요청에 "customEvent: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의 맞춤 채널 그룹을 참고하세요. 맞춤 채널 그룹은 API 보고서 요청에서 측정기준의 범위 및 채널 그룹 ID로 지정됩니다. 예를 들어 ID가 9432931인 세션 범위 맞춤 채널에 대한 보고서를 생성하려면 Data API 요청에 "sessionCustomChannelGroup:9432931"를 포함합니다. 속성에 이 ID의 커스텀 채널이 없으면 이 API 요청이 실패합니다.
다음은 맞춤 채널 그룹의 일반적인 구문입니다. Metadata API 메서드를 쿼리하여 속성의 모든 맞춤 채널 그룹을 나열할 수 있습니다.
| 일반 API 이름 | 설명 |
|---|---|
| sessionCustomChannelGroup:custom_channel_id | 이 세션으로 이어진 맞춤 채널입니다. |
| firstUserCustomChannelGroup:custom_channel_id | 이 사용자를 처음 획득한 맞춤 채널입니다. |
| customChannelGroup:custom_channel_id | 전환 이벤트로 이어진 맞춤 채널입니다. |
측정항목
다음 측정항목은 모든 속성의 유입경로 보고서에 포함될 수 있습니다.
| API 이름 | UI 이름 | 설명 |
|---|---|---|
| activeUsers | 활성 사용자 | 내 사이트 또는 앱을 방문한 개별 사용자의 수입니다. |
| funnelStepAbandonmentRate | 이탈률 | 이 단계에서 유입경로를 이탈한 사용자의 비율입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.412는 사용자 중 41.2% 가 이 단계에서 유입경로를 이탈했음을 의미합니다. |
| funnelStepAbandonments | 이탈수 | 이 단계에서 유입경로를 이탈한 절대 사용자 수입니다. |
| funnelStepCompletionRate | 완료율 | 유입경로의 이 단계를 완료한 사용자의 비율입니다. 이 측정항목은 분수로 반환됩니다. 예를 들어 0.588은 사용자 중 58.8% 가 이 유입경로 단계를 완료했음을 의미합니다. |