Как сопоставлять параметры 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 Идентификатор группы объявлений. Используйте его, если вы настроили данные отслеживания на уровне аккаунта или кампании и хотите узнать, из какой группы было показано объявление.
{adposition} Сопоставляется с комбинацией следующих параметров:

Поля, которое сопоставляется с местоположением объявления (например, "вверху" или "сбоку"), нет.

Позиция вашего объявления на странице. Например, значение 1t2 расшифровывается так: страница 1, показ над результатами поиска (буква "t" от английского слова "top"), позиция 2.
{advanced_booking_window} segments.hotel_booking_window_days Количество дней между датой клика по объявлению и датой заезда, указанной в рекламе. Например, если клик зарегистрирован 5 июня, а дата заезда – 8 июня, то будет указано значение "3".
{campaignid} campaign.id Идентификатор кампании. Используйте его, если вы настроили данные отслеживания на уровне аккаунта и хотите узнать, из какой кампании было показано объявление.
{creative} ad_group_ad.ad.id Уникальный идентификатор объявления.
{device} segments.device Тип устройства, с которого поступил клик.
{feeditemid} Нет (закат; используйте asset.id с {extensionid}) Идентификатор расширения на основе фида, на которое нажал пользователь. Примечание. Расширения на основе фидов больше не поддерживаются, и в поддерживаемых версиях Google Ads API нет соответствующего ресурса для отчетов. Расширения на основе объектов используют {extensionid}, который сопоставляется с asset.id.
{extensionid} asset.id Идентификатор расширения на основе объектов, на которое нажал пользователь.
{hotelcenter_id} segments.hotel_center_id Идентификатор аккаунта Hotel Center, связанного с кампанией, в которой было создано объявление, по которому был выполнен клик.
{hotel_id} segments.partner_hotel_id Идентификатор гостиницы из фида гостиниц связанного аккаунта.
{keyword} segments.keyword.ad_group_criterion

Обратите внимание, что текстовый запрос можно найти по названию ресурса критерия.

Для поисковой сети: ключевое слово из вашего аккаунта, соответствующее поисковому запросу. Для контекстно-медийной сети: ключевое слово из вашего аккаунта, соответствующее содержанию сайта.
{loc_interest_ms} click_view.area_of_interest.most_specific Идентификатор местоположения, указанного в поисковом запросе пользователя. Идентификатор критерия можно найти с помощью GeoTargetConstantService.SuggestGeoTargetConstants.
{loc_physical_ms} click_view.location_of_presence.most_specific Идентификатор местоположения пользователя в момент клика. Идентификатор критерия можно найти с помощью GeoTargetConstantService.SuggestGeoTargetConstants.
{lpurl} Конечный URL. Экранируется, если параметр {lpurl} указан не в начале шаблона отслеживания. Если параметр {lpurl} находится в другой части шаблона, то символы ?, =, ", #, \t, ' и пробел ([space]) экранируются.
{matchtype} Тип соответствия ключевого слова, по которому было показано объявление. Подробнее о типах соответствия…
{merchant_id} segments.product_merchant_id Идентификатор аккаунта Google Merchant Center, к которому относится товарное объявление.
{placement} Сайт, на котором пользователь нажал на ваше объявление. Он соответствует критериям таргетинга по ключевым словам или таргетинга на места размещения (в зависимости от настроек кампании).
{product_channel} segments.product_channel Тип канала продаж, через который реализуется товар, рекламируемый в объявлении.
{product_country} segments.product_country Страна, в которой продается товар, представленный в объявлении.
{product_id} segments.product_item_id Идентификатор товара, рекламируемого в объявлении (берется из вашего фида данных в Google Merchant Center).
{product_language} segments.product_language Язык, на котором приведена информация о товаре (согласно фиду данных Merchant Center).
{product_partition_id} ad_group_criterion.criterion_id Уникальный идентификатор группы товаров, к которой относится рекламируемый товар.
{rate_rule_id} segments.hotel_rate_rule_id Идентификатор любой специальной цены, по которой был получен клик. Рекламодатели в сфере туризма могут предлагать специальные цены для определенных категорий пользователей (например, для участников программ лояльности), для пользователей устройств определенного типа (например, скидки для пользователей смартфонов) или для отдельных стран.
{store_code} segments.product_store_id В кампании с каналом "Местный ассортимент" вы увидите уникальный идентификатор местного магазина.
{targetid} Идентификатор ключевого слова (kwd), соответствия без ключевых слов в AI Max (kwl), динамического поискового объявления (dsa) или цели списка ремаркетинга (aud), вызывающий показ объявления. Например, если вы добавите в группу объявлений список ремаркетинга с идентификатором критерия 456 и настроите таргетинг на ключевое слово с идентификатором 123, параметр {targetid} будет заменен на kwd-123:aud-456.
{travel_start_day}
{travel_start_month}
{travel_start_year}
segments.hotel_check_in_date День, месяц и год даты заезда, указанные в объявлении.

Как параметры ValueTrack сопоставляются в интерфейсе Google Рекламы и Google Ads API

В таблице ниже сопоставляются параметры ValueTrack в интерфейсе Google Рекламы и Google Ads API, в частности со значениями перечисления AdNetworkType.

Название интерфейса Перечисление API Параметр ValueTrack Примечания
Контекстно-медийная сеть CONTENT d Для партнерских видеоресурсов Google с параметром ValueTrack vp, который также отображается в API как CONTENT.
Google TV GOOGLE_TV gtv  
Межсетевой MIXED x Параметр ValueTrack есть не всегда.
Google Поиск SEARCH g  
Сайты поисковых партнеров SEARCH_PARTNERS s или a a – соответствие AI Max, обычно связанное с трафиком без ключевых слов.
Н/Д UNKNOWN Н/Д Возвращается, когда значение сети в интерфейсе Google Рекламы не поддерживается в запрошенной версии Google Ads API.
Н/Д UNSPECIFIED Н/Д  
YouTube YOUTUBE ytv  
Каналы Google UNKNOWN   В кампании для создания спроса не возвращается параметр сети ValueTrack.