Supported entities

  • A table summarizes the support for individual fields of Upgraded URLs across various Google Ads entities like Customer, Campaign, AdGroup, Ad, AdGroupCriterion, and FeedItem (Sitelink).

  • The table indicates support for Final URL, Final mobile URL, Final app URL, Custom parameters, and Tracking template for these entities using checkmarks.

  • For AdGroupCriterion, Ad, and FeedItem (Sitelink), specifying a tracking template requires setting the final URL, except for Dynamic Search Ads, Shopping ads, and Shopping product partitions.

  • Sitelinks utilize FeedItem attributes for Upgraded URLs, with relevant placeholders found in PlaceholderType and SitelinkPlaceholderField, and custom parameters settable via the url_custom_parameters property.

  • Changes to Upgraded URL fields can trigger an editorial review, potentially stopping ad serving, depending on the specific Google Ads entity.

The following table summarizes the support for individual fields of Upgraded URLs in various Google Ads entities.

Google Ads Entity Final URL Final mobile URL Final app URL Final URL suffix Custom parameters Tracking template
Customer Checkmark Checkmark
Campaign Checkmark Checkmark Checkmark
AdGroup Checkmark Checkmark Checkmark
Ad Checkmark Checkmark Checkmark Checkmark Checkmark Checkmark
AdGroupCriterion Checkmark Checkmark Checkmark Checkmark Checkmark
Asset (e.g., Sitelink) Checkmark Checkmark Checkmark Checkmark Checkmark
FeedItem (Legacy sitelink) Checkmark Checkmark Checkmark Checkmark Checkmark
  • v24 and later: Feed-based sitelink placeholder fields and placeholder types are removed. Sitelinks and their tracking parameters must be managed using SitelinkAsset attached through CustomerAsset, CampaignAsset, or AdGroupAsset. Upgraded URL fields (final_urls, final_mobile_urls, final_url_suffix, tracking_url_template, and url_custom_parameters) are configured directly on the enclosing Asset resource.
  • v23 and earlier: Sitelinks also supported Upgraded URLs using legacy FeedItem attributes.

Review policy for supported entities

Changes to Upgraded URL fields may trigger an editorial review, preventing your ads from serving until the review is complete, depending on the entity type:

Google Ads Entity Final URL Final mobile URL Final app URL Final URL suffix Custom parameters Tracking template
Customer N/A N/A N/A

Serving

 N/A

Serving
Campaign N/A N/A N/A

Serving

Serving

Serving
AdGroup N/A N/A N/A

Serving

Serving

Serving
AdGroupCriterion

Stopped

Stopped

 N/A

Stopped

Stopped

Stopped
Asset

Stopped

Stopped

 N/A

Stopped

Stopped

Stopped
FeedItem (Legacy sitelink)

Stopped

Stopped

 N/A

Stopped

Stopped

Stopped
Ad

Stopped

Stopped

Stopped

Stopped

Stopped

Stopped
Previous
Upgraded URL fields
Next
ValueTrack parameters for Upgraded URLs