보고서 필드와 ValueTrack 매개변수 매핑

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

자동 태그 추가를 사용 설정하면 모든 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} 다음 조합에 매핑됩니다.

'top' 또는 'side'와 같이 광고 위치에 매핑되는 필드가 없습니다.

페이지에서 광고가 게재된 위치(예: '1t2'). '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} feed_item.id 클릭된 피드 기반 광고 확장의 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. ( GeoTargetConstantService.SuggestGeoTargetConstants를 사용하여 기준 ID를 조회할 수 있습니다.)
{loc_physical_ms} click_view.location_of_presence.most_specific 클릭이 발생한 지리적 위치의 ID. ( GeoTargetConstantService.SuggestGeoTargetConstants를 사용하여 기준 ID를 조회할 수 있습니다.)
{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'), 동적 검색 광고 ('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 광고에 표시되는 체크인 날짜의 일/월/연도입니다.

ValueTrack 매개변수가 Google Ads UI와 Google Ads API 간에 매핑되는 방식

이 표는 Google Ads API 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 검색 검색 g  
검색 파트너 SEARCH_PARTNERS s  
해당 사항 없음 UNKNOWN 해당 사항 없음 Google Ads API가 아직 enum을 지원하지 않지만 enum이 UI에 있는 경우 Google Ads API는 UNKNOWN를 반환합니다.
해당 사항 없음 UNSPECIFIED 해당 사항 없음
YouTube YOUTUBE ytv  
Google 소유 채널 UNKNOWN   디맨드젠은 네트워크 ValueTrack 매개변수를 반환하지 않습니다.
이전
UI 보고서