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'와 같습니다(페이지 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} |
없음 (일몰, {extensionid}와 함께
asset.id 사용)
|
클릭된 피드 기반 확장 프로그램의 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.
(
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'), 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 |
광고에 표시되는 체크인 날짜의 일/월/연도입니다. |
ValueTrack 매개변수가 Google Ads UI와 Google Ads API 간에 매핑되는 방식
이 표에서는 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 UI의 네트워크 값이 쿼리된 Google Ads API 버전에서 지원되지 않는 경우 반환됩니다. |
| 해당 사항 없음 | UNSPECIFIED |
해당 사항 없음 | |
| YouTube | YOUTUBE |
ytv |
|
| Google 소유 채널 | UNKNOWN |
디맨드젠 캠페인은 네트워크 ValueTrack 매개변수를 반환하지 않습니다. |