type SuggestedAdUnit (v202408)
Stay organized with collections
Save and categorize content based on your preferences.
Service
SuggestedAdUnitService
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/v202408
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
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.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-06 UTC.
[null,null,["Last updated 2025-08-06 UTC."],[[["\u003cp\u003eA \u003ccode\u003eSuggestedAdUnit\u003c/code\u003e is a suggestion for a new ad unit based on frequently served ad tags without corresponding ad units.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eSuggestedAdUnit\u003c/code\u003e is read-only and provides data like ID, request frequency, hierarchical path, and target platform.\u003c/p\u003e\n"],["\u003cp\u003eIt includes the \u003ccode\u003eparentPath\u003c/code\u003e and \u003ccode\u003epath\u003c/code\u003e for a full ad unit path after approval.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003etargetWindow\u003c/code\u003e and \u003ccode\u003etargetPlatform\u003c/code\u003e provide insights into ad tag behavior, showing where and how the tag was served.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003esuggestedAdUnitSizes\u003c/code\u003e displays the sizes associated with the proposed ad unit.\u003c/p\u003e\n"]]],["`SuggestedAdUnit` offers read-only suggestions for new ad units based on ad tags served at least ten times weekly without a corresponding defined ad unit. Key information includes the `id`, `numRequests` (frequency of tag service), `path` (hierarchical path of suggested unit), and `parentPath` (existing path to suggested parent unit). Additional attributes are `targetWindow`, `targetPlatform`, and `suggestedAdUnitSizes`, which describe target behavior, the target device, and potential ad sizes, respectively.\n"],null,["# type SuggestedAdUnit (v202408)\n\n**Service** \n**SuggestedAdUnitService** **Dependencies** \n[SuggestedAdUnitPage](/ad-manager/api/reference/v202408/SuggestedAdUnitService.SuggestedAdUnitPage) \n▼\n**SuggestedAdUnit**\n\nA `SuggestedAdUnit` represents a suggestion for a new ad unit, based on an ad tag that has\nbeen served at least ten times in the past week, but which does not correspond to a defined ad\nunit. This type is read-only.\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202408`\n\n| Field ----- ||\n|----------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `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. |\n| ### `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. |\n| ### `path` | ` `xsd:`string[]` The hierarchical path from the [last existing ad unit](#parentPath) 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. |\n| ### `parentPath` | ` `[AdUnitParent](/ad-manager/api/reference/v202408/SuggestedAdUnitService.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. \u003cbr /\u003e |\n| ### `targetWindow` | ` `[AdUnit.TargetWindow](/ad-manager/api/reference/v202408/SuggestedAdUnitService.AdUnit.TargetWindow)` ` The `target` attribute of the underlying ad tag, as defined in the [AdUnit](/ad-manager/api/reference/v202408/InventoryService.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. \u003cbr /\u003e |\n| ### `targetPlatform` | ` `[TargetPlatform](/ad-manager/api/reference/v202408/SuggestedAdUnitService.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. \u003cbr /\u003e |\n| ### `suggestedAdUnitSizes` | ` `[AdUnitSize](/ad-manager/api/reference/v202408/SuggestedAdUnitService.AdUnitSize)`[]` The target sizes associated with this `SuggestedAdUnit`. This attribute is read-only and is populated by Google. |"]]
