Mapping ValueTrack Parameters with Report Fields

ValueTrack parameters are URL parameters you can add to your ads' langing 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. The mapping is 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).
{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 extension that was clicked.
{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.
{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".