ValueTrack 매개변수를 보고서 필드에 매핑

ValueTrack 매개변수는 광고의 방문 페이지 URL에 추가할 수 있는 URL 매개변수입니다. 이 매개변수는 광고 클릭의 소스에 대한 정보를 수집합니다. 광고 클릭에 대해 자세히 알아보거나 이제 막 추적을 시작하는 경우에 사용하면 유용합니다.

자동 태그 추가를 사용 설정하면 모든 URL에 Google 클릭 식별자 (GCLID) 가 자동으로 추가되며 나중에 이를 사용하여 광고 클릭을 보고서의 행에 매핑할 수 있습니다.

ValueTrack 매개변수의 작동 방식에 대한 개요는 ValueTrack 매개변수 정보를 참고하세요. ValueTrack 매개변수의 전체 목록은 사용 가능한 ValueTrack 매개변수 섹션의 ValueTrack 매개변수로 추적 설정하기를 참고하세요.

Google 애널리틱스 및 관련 API는 클릭에 대한 측정항목을 수집하는 또 다른 옵션을 제공합니다.

Google Ads API 보고에는 ValueTrack 매개변수에 해당하는 필드를 쿼리할 수 있는 리소스와 뷰가 있습니다. 그러나 매핑된 필드에 동일한 텍스트 값이 있는 것은 아닙니다. 예를 들어 {matchtype}이 e과 같으면 (일치검색의 약어) ad_group_criterion.keyword.match_type 과 같은 해당 보고서 필드에 EXACT가 표시됩니다. 다음 표에 몇 가지 매핑 예시가 나와 있습니다.

ValueTrack 매개변수를 보고서 필드에 매핑하는 방법

ValueTrack 매개변수 보고서 리소스의 필드 설명
{adgroupid} ad_group.id 광고그룹 ID. (계정 또는 캠페인 단위로 추적 정보를 설정했고 광고를 게재하는 광고그룹을 확인하려는 경우 이 매개변수를 사용합니다.)
{adposition} 다음의 조합에 매핑됩니다.

'상단' 또는 '측면'과 같은 광고의 위치에 매핑되는 필드는 없습니다.

광고가 게재된 페이지의 위치로 '1t2'와 같은 값이 있습니다(이는 페이지 1, 상단, 위치 2를 의미함).
{advanced_booking_window} segments.hotel_booking_window_days 광고 클릭이 이루어진 날짜와 광고된 체크인 날짜 사이의 일수입니다. 예를 들어 광고 클릭이 이루어진 날짜가 6월 5일이고 체크인 날짜가 6월 8일인 경우 '3'입니다.
{campaignid} campaign.id 캠페인 ID. (계정 단위로 추적 정보를 설정했고 광고를 게재하는 캠페인을 확인하려는 경우 이 매개변수를 사용합니다.)
{creative} ad_group_ad.ad.id 광고의 고유 ID
{device} segments.device 클릭이 발생한 기기의 유형입니다.
{feeditemid} 없음 (지원 중단됨, asset.id와 함께 {extensionid} 사용) 클릭된 피드 기반 확장 소재의 ID입니다. 참고: 피드 기반 확장 소재는 지원 중단되었으며 지원되는 Google Ads API 버전에는 상응하는 보고 리소스가 없습니다. 애셋 기반 확장 소재 는 {extensionid}를 사용하며, 이는 asset.id에 매핑됩니다.
{extensionid} asset.id 클릭된 애셋 기반 확장 소재의 ID입니다.
{hotelcenter_id} segments.hotel_center_id 클릭된 광고를 게재한 캠페인에 연결된 Hotel Center 계정 ID입니다.
{hotel_id} segments.partner_hotel_id 연결된 계정의 호텔 피드에서 생성된 호텔의 호텔 ID
{keyword} segments.keyword.ad_group_criterion

텍스트 쿼리는 기준 리소스 이름을 사용하여 찾을 수 있습니다.

 검색 네트워크의 경우: 검색어와 일치하는 계정의 키워드입니다. 디스플레이 네트워크의 경우: 콘텐츠와 일치하는 계정의 키워드입니다.
{loc_interest_ms} click_view.area_of_interest.most_specific 광고 게재에 도움이 된 관심분야 위치의 ID. (기준 ID는 GeoTargetConstantService.SuggestGeoTargetConstants를 사용하여 조회할 수 있습니다.)
{loc_physical_ms} click_view.location_of_presence.most_specific 클릭이 발생한 지리적 위치의 ID. (기준 ID는 GeoTargetConstantService.SuggestGeoTargetConstants를 사용하여 조회할 수 있습니다.)
{lpurl} 최종 URL. 추적 템플릿 시작 부분에 {lpurl}을 추가하는 경우가 아니면 이스케이프 처리됩니다. {lpurl}이 추적 템플릿의 시작 부분에 있지 않으면 ?, =, ", #, \t, ', [space] 문자가 이스케이프 처리됩니다.
{matchtype} 광고를 트리거한 키워드의 검색 유형입니다. (자세히 알아보기 검색 유형에 대해.)
{merchant_id} segments.product_merchant_id 클릭된 쇼핑 광고를 직접 소유한 Google 판매자 센터 계정의 ID입니다.
{placement} 키워드 타겟팅 캠페인의 경우 광고가 클릭된 콘텐츠 사이트, 게재위치 타겟팅 캠페인의 경우 광고가 클릭된 사이트에 대해 일치하는 게재위치 타겟팅 기준입니다.
{product_channel} segments.product_channel 클릭된 제품 목록 광고에 나온 제품이 판매된 쇼핑 채널 유형입니다.
{product_country} segments.product_country 클릭된 광고에 포함된 제품의 판매 국가입니다.
{product_id} segments.product_item_id 판매자 센터 데이터 피드에 표시되는, 클릭된 광고에 포함된 제품의 ID입니다.
{product_language} segments.product_language 판매자 센터 데이터 피드에 표시되는 제품 정보 언어입니다.
{product_partition_id} ad_group_criterion.criterion_id 클릭된 제품 광고가 속한 제품 그룹의 고유 ID입니다.
{rate_rule_id} segments.hotel_rate_rule_id 클릭된 특별 가격의 식별자입니다. 여행업계의 광고주는 특정 사용자 (예: 멤버십 회원), 특정 기기(예: 모바일 사용자를 위한 할인), 특정 국가를 대상으로 조건부 요금을 적용할 수 있습니다.
{store_code} segments.product_store_id 오프라인 쇼핑 채널을 사용하는 캠페인의 경우 오프라인 매장의 고유 ID가 표시됩니다.
{targetid} 광고를 트리거한 키워드('kwd'), AI Max 키워드 없는 검색('kwl'), 동적 검색 광고('dsa') 또는 리마케팅 목록 타겟('aud')의 ID입니다. 예를 들어 광고그룹에 리마케팅 목록 (기준 ID: '456')을 추가하고 키워드 ID가 '123'인 경우 {targetid}가 'kwd-123:aud-456'으로 바뀝니다.
{travel_start_day}
{travel_start_month}
{travel_start_year}
 segments.hotel_check_in_date 광고에 표시되는 체크인 날짜의 일/월/연도입니다.

Google Ads UI와 Google Ads API 간에 ValueTrack 매개변수를 매핑하는 방법

이 표에서는 Google Ads UI와 Google Ads API 간의 ValueTrack 매개변수를 특히 AdNetworkType enum 값에 매핑합니다.

UI 이름 API enum ValueTrack 매개변수 참고
Google 디스플레이 네트워크 CONTENT d ValueTrack 매개변수 vp가 있는 Google 동영상 파트너의 경우 API에도 CONTENT로 표시됩니다.
Google TV GOOGLE_TV gtv  
교차 네트워크 MIXED x ValueTrack 매개변수가 항상 있는 것은 아닙니다.
Google 검색 SEARCH g  
검색 파트너 SEARCH_PARTNERS s 또는 a a는 AI Max 일치를 나타내며 일반적으로 키워드 없는 검색 트래픽과 연결됩니다.
해당 사항 없음 UNKNOWN 해당 사항 없음 쿼리된 Google Ads API 버전에서 Google Ads UI의 네트워크 값이 지원되지 않는 경우 반환됩니다.
해당 사항 없음 UNSPECIFIED 해당 사항 없음  
YouTube YOUTUBE ytv  
Google 소유 채널 UNKNOWN   디맨드젠 캠페인은 네트워크 ValueTrack 매개변수를 반환하지 않습니다.
이전
UI의 보고서