type SuggestedAdUnit (v202411)

AI-generated Key Takeaways

• SuggestedAdUnit objects represent suggestions for new ad units based on frequently served ad tags that lack corresponding defined ad units.

• These suggestions are read-only and automatically generated when an ad tag is served at least 10 times within a week.

• Each SuggestedAdUnit includes information like a unique ID, serving frequency, hierarchical path, target window, target platform, and suggested sizes.

• The parentPath and path attributes combine to provide the complete hierarchical path of the suggested ad unit upon approval.

• Ad Manager users can leverage these suggestions to easily create new ad units that align with existing ad serving patterns.

Service

SuggestedAdUnitService

Dependencies

SuggestedAdUnitPage

▼

SuggestedAdUnit

A SuggestedAdUnit represents a suggestion for a new ad unit, based on an ad tag that has been served at least ten times in the past week, but which does not correspond to a defined ad unit. This type is read-only.

---

Namespace

https://www.google.com/apis/ads/publisher/v202411

Field
id	xsd:string The unique ID of the suggested ad unit. After API version 201311 this field will be a numerical ID. Earlier versions will return a string value which is the complete path to the suggested ad unit with path elements separated by '/' characters. This attribute is read-only and is populated by Google.
numRequests	xsd:long Returns the number of times the ad tag corresponding to this suggested ad unit has been served in the previous week. Suggested ad units are only created when they have been served at least ten times in that period. This attribute is read-only and is populated by Google.
path	xsd:string[] The hierarchical path from the last existing ad unit after this and all suggested parent ad units have been created. Each path element is a separate ad unit code in the returned list. This attribute is read-only and is populated by Google.
parentPath	AdUnitParent[] The existing hierarchical path leading up to, and including, the parent of the first suggested ad unit in the ad unit hierarchy. The parentPath and the path make up the full path of the suggested ad unit after it is approved. This attribute is read-only and is populated by Google. Note: The ad unit code for each of the parent ad units will not be provided.
targetWindow	AdUnit.TargetWindow The target attribute of the underlying ad tag, as defined in the AdUnit. This attribute is read-only and is populated by Google. Enumerations TOP Specifies that the link should open in the full body of the page. BLANK Specifies that the link should open in a new window.
targetPlatform	TargetPlatform The target platform for the browser that clicked the underlying ad tag. This attribute is read-only and is populated by Google. Enumerations WEB The desktop web. MOBILE Mobile devices. ANY An universal target platform that combines mobile and desktop features.
suggestedAdUnitSizes	AdUnitSize[] The target sizes associated with this SuggestedAdUnit. This attribute is read-only and is populated by Google.