ValueTrack parameters are URL parameters you can add to your ads' landing page URLs. They collect information about the source of your ad clicks, and are best used when you want to learn more about the clicks on your ad or if you are starting out with tracking.
Enabling auto-tagging automatically adds a Google Click Identifier (GCLID) to every URL and can be used later to map an ad click to a row in the report.
For an overview of how ValueTrack parameters work, you can refer to this guide. For a complete list of ValueTrack parameters, see the Available ValueTrack Parameters section in Set up tracking with ValueTrack parameters.
Another option for gathering metrics on clicks is through Google Analytics and its associated API.
In Google Ads API reporting, there are resources and views where you can query fields
that correspond to ValueTrack parameters. However, the mapped field does not
necessarily have identical text value. For example, when {matchType}
equals e (which is short for exact match), a corresponding report field
such as ad_group_criterion.keyword.match_type
will show EXACT. Some example mappings are shown in the table below.
How ValueTrack parameters map to report fields
| ValueTrack Parameter | Field(s) in report resources | Description |
|---|---|---|
| {adgroupid} | ad_group.id | The ad group ID. (Use this when you've set up your tracking info at the account or campaign level and want to know which ad group served your ad.) |
| {adposition} |
Maps to a combination of:
Note that currently there isn't a field that maps to the ad's location (for example: "top", "side", etc.) |
The position on the page where your ad appeared, with a value like "1t2" (this means page 1, top, position 2). |
| {advanced_booking_window} | segments.hotel_booking_window_days | The number of days between the date of the ad click and the check-in date being advertised (for example, ‘3’ for an ad clicked on June-5 with a check-in date of June-8.) |
| {campaignid} | campaign.id | The campaign ID. (Use this when you've set up your tracking info at the account level and want to know which campaign served your ad.) |
| {creative} | ad_group_ad.ad.id | A unique ID for your ad. |
| {device} | segments.device | The type of device the click came from. |
| {feeditemid} | feed_item.id | The ID of the Feed-based extension that was clicked. |
| {extensionid} | asset.id | The ID of the Asset-based extension that was clicked. |
| {hotelcenter_id} | segments.hotel_center_id | The ID of the Hotel Center account linked to the campaign that generated the ad when clicked. |
| {hotel_id} | segments.partner_hotel_id | The hotel ID of the hotel from the associated account’s hotel feed. |
| {keyword} |
segments.keyword.ad_group_criterion
Note that the text query can be found using the criterion resource name. |
For the Search Network, the keyword from your account that is matched to the search query. For the Display Network, the keyword from your account that is matched to the content. |
| {loc_interest_ms} | click_view.area_of_interest.most_specific | The ID of the location of interest that helped trigger the ad. (You can look up a criterion ID using GeoTargetConstantService.SuggestGeoTargetConstants) |
| {loc_physical_ms} | click_view.location_of_presence.most_specific | The ID of the geographical location of the click. (You can look up a criterion ID using GeoTargetConstantService.SuggestGeoTargetConstants) |
| {lpurl} |
The final URL. It will be escaped unless you put {lpurl} at the beginning
of your tracking template. If {lpurl} is not at the beginning of your
tracking template, the following characters are escaped:
?, =, ", #,
\t, ', and [space].
|
|
| {matchtype} | The match type of the keyword that triggered your ad. (Read more about match types.) | |
| {merchant_id} | segments.product_merchant_id | The ID of the Google Merchant Center account directly owning the clicked Shopping Ad. |
| {placement} | The content site where your ad was clicked (for keyword-targeted campaigns), or the matching placement targeting criteria for the site where your ad was clicked (for placement-targeted campaigns). | |
| {product_channel} | segments.product_channel | The type of shopping channel through which the product featured in the clicked Product Listing Ad is sold. |
| {product_country} | segments.product_country | The country of sale for the product in the clicked ad. |
| {product_id} | segments.product_item_id | The ID of the product featured in the clicked ad, as indicated in your Merchant Center data feed. |
| {product_language} | segments.product_language | The language of your product information, as indicated in your Merchant Center data feed. |
| {product_partition_id} | ad_group_criterion.criterion_id | The unique ID for the product group the clicked product ad belongs to. |
| {rate_rule_id} | segments.hotel_rate_rule_id | The identifier of any special price that was clicked on. Travel advertisers can apply conditional rates to specific users (for example, loyalty members), specific devices (for example, discount for mobile users), and specific countries. |
| {store_code} | segments.product_store_id | With a campaign using the local shopping channel, you'll see the unique ID of the local store. |
| {targetid} | The ID of the keyword (labeled "kwd"), dynamic search ad ("dsa"), or remarketing list target ("aud") that triggered an ad. For example, if you add a remarketing list to your ad group (criterion ID "456") and target the keyword ID "123", the {targetid} would be replaced by "kwd-123:aud-456". | |
| {travel_start_day} {travel_start_month} {travel_start_year} |
segments.hotel_check_in_date | The check-in date’s day/month/year displayed in the ad. |