将 ValueTrack 参数映射到报告字段

ValueTrack 参数是可以添加到广告着陆页网址的网址参数。这类参数会收集有关广告点击来源的信息。如果您要详细了解有关广告点击的信息,或者如果您刚开始使用跟踪功能,则最好使用这些参数。

启用自动标记后,系统会自动向每个网址添加 Google 点击标识符 (GCLID),该标识符稍后可用于将广告点击与报告中的某一行相关联。

如需简要了解 ValueTrack 参数的运作方式,请参阅 ValueTrack 参数简介。如需查看 ValueTrack 参数的完整列表,请参阅利用 ValueTrack 参数设置跟踪中的可用的 ValueTrack 参数部分。

Google Analytics 及其关联的 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} 搭配使用) 用户点击的基于 Feed 的扩展服务的 ID。 注意:基于 Feed 的扩展服务已停用,在受支持的 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 相关联账号的酒店 Feed 中酒店的 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} 最终到达网址。除非您将 {lpurl} 置于跟踪模板的开头,否则系统会对其进行转义处理。如果 {lpurl} 未放在跟踪模板的开头,则会对以下字符进行转义:?、=、"、#、\t、' 和 [space]。
{matchtype} 触发广告的关键字的匹配类型。 (详细了解匹配类型。)
{merchant_id} segments.product_merchant_id 直接拥有获得点击的购物广告的 Google Merchant Center 账号的 ID。
{placement} 您的广告获得点击时所在的展示广告网络网站(对于关键字定位广告系列);您的广告获得点击时所在网站的匹配展示位置定位条件(对于展示位置定位广告系列)。
{product_channel} segments.product_channel 用户点击的产品详情广告中展示的产品通过哪类购物渠道完成了销售。
{product_country} segments.product_country 获得点击的广告所宣传的产品的目标销售国家/地区。
{product_id} segments.product_item_id 获得点击的广告所宣传的产品的 ID,如 Merchant Center 数据 Feed 中所示。
{product_language} segments.product_language 商品信息的语言,如 Merchant Center 数据 Feed 中所示。
{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 界面和 Google Ads API 之间的映射方式

下表列出了 Google Ads 界面和 Google Ads API 之间的 ValueTrack 参数映射,尤其是与 AdNetworkType 枚举值的映射。

界面名称 API 枚举 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 界面中的某个广告资源网值在查询的 Google Ads API 版本中不受支持时返回。
不适用 UNSPECIFIED 不适用  
YouTube YOUTUBE ytv  
Google 自有渠道 UNKNOWN   需求开发广告系列不会返回网络 ValueTrack 参数。