URL and tracking fields in reports

Page Summary

outlined_flag

• Tracking templates, final URLs, final mobile URLs, and custom parameters are available as attributes when retrieving reports.

• Final URLs and final mobile URLs are rendered in the report as repeated string values.

• Custom parameters are returned as repeated message objects of the type CustomParameter.

Tracking templates, final URLs, final mobile URLs, final URL suffixes, and custom parameters are available as attributes when retrieving reports using GoogleAdsService.

Repeated string URL fields

Fields such as final_urls and final_mobile_urls are returned in reports as repeated string values.

Textproto response format

final_urls: "http://www.example.com/locations/mars/"
final_urls: "http://www.example.com/cruise/space/"

Sample query for responsive search ads

The following Google Ads Query Language (GAQL) query retrieves the final URLs, final mobile URLs, and final URL suffix for responsive search ads:

SELECT
  ad_group_ad.ad.id,
  ad_group_ad.ad.final_urls,
  ad_group_ad.ad.final_mobile_urls,
  ad_group_ad.ad.final_url_suffix
FROM ad_group_ad
WHERE ad_group_ad.ad.type = RESPONSIVE_SEARCH_AD

Custom parameters

Custom parameters are returned as repeated message objects of type CustomParameter.

Textproto response format

url_custom_parameters {
  key: "promocode"
  value: "NYC123"
}
url_custom_parameters {
  key: "season"
  value: "spring"
}

Sample query for ad groups

The following query retrieves custom parameters configured at the ad group level for search standard ad groups:

SELECT
  ad_group.id,
  ad_group.name,
  ad_group.url_custom_parameters
FROM ad_group
WHERE ad_group.type = SEARCH_STANDARD