将 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。(您可以使用 查找条件 ID GeoTargetConstantService.SuggestGeoTargetConstants。)
{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 之间进行映射

下表将 ValueTrack 参数在 Google Ads 界面和 Google Ads API 之间进行映射,特别是映射到 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 API 版本不支持 Google Ads 界面中的网络值时返回。
不适用 UNSPECIFIED 不适用  
YouTube YOUTUBE ytv  
Google 自有渠道 UNKNOWN   需求开发广告系列不会返回网络 ValueTrack 参数。