type CreativePlaceholder (v202411)

AI-generated Key Takeaways

• A CreativePlaceholder outlines the anticipated creative's specifications, crucial for forecasting and ensuring alignment with line items.

• It mandates a size definition and optionally accommodates companions for video player environments or creative set roadblocking.

• Key properties include size, creativeTemplateId (for native creatives), companions, applied and effective labels, expected creative count, creativeSizeType, targeting name, and whether it's AMP-only.

• While CreativePlaceholder aids in forecasting, actual creative associations and targeting are managed via LineItemCreativeAssociation during the serving process.

Service

ForecastService LineItemService ProposalLineItemService ProposalService

Dependencies

CreativePlaceholder ProposalLineItem

▼

CreativePlaceholder

A CreativePlaceholder describes a slot that a creative is expected to fill. This is used primarily to help in forecasting, and also to validate that the correct creatives are associated with the line item. A CreativePlaceholder must contain a size, and it can optionally contain companions. Companions are only valid if the line item's environment type is EnvironmentType.VIDEO_PLAYER.

---

Namespace

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

Field
size	Size The dimensions that the creative is expected to have. This attribute is required.
creativeTemplateId	xsd:long The native creative template ID. This value is only required if creativeSizeType is CreativeSizeType.NATIVE.
companions	CreativePlaceholder[] The companions that the creative is expected to have. This attribute can only be set if the line item it belongs to has a LineItem.environmentType of EnvironmentType.VIDEO_PLAYER or LineItem.roadblockingType of RoadblockingType.CREATIVE_SET.
appliedLabels	AppliedLabel[] The set of label frequency caps applied directly to this creative placeholder.
effectiveAppliedLabels	AppliedLabel[] Contains the set of labels applied directly to this creative placeholder as well as those inherited from the creative template from which this creative placeholder was instantiated. This field is readonly and is assigned by Google.
expectedCreativeCount	xsd:int Expected number of creatives that will be uploaded corresponding to this creative placeholder. This estimate is used to improve the accuracy of forecasting; for example, if label frequency capping limits the number of times a creative may be served.
creativeSizeType	CreativeSizeType Describes the types of sizes a creative can be. By default, the creative's size is CreativeSizeType.PIXEL, which is a dimension based size (width-height pair). Enumerations PIXEL Dimension based size, an actual height and width. ASPECT_RATIO Mobile size, that is expressed as a ratio of say 4 by 1, that could be met by a 100 x 25 sized image. INTERSTITIAL Out-of-page size, that is not related to the slot it is served. But rather is a function of the snippet, and the values set. This must be used with 1x1 size. IGNORED Size has no meaning 1. For Click Tracking entities, where size doesn't matter 2. For entities that allow all requested sizes, where the size represents all sizes. NATIVE Native size, which is a function of the how the client renders the creative. This must be used with 1x1 size. AUDIO Audio size. Used with audio ads. This must be used with 1x1 size.
targetingName	xsd:string The name of the CreativeTargeting for creatives this placeholder represents. This attribute is optional. Specifying creative targeting here is for forecasting purposes only and has no effect on serving. The same creative targeting should be specified on a LineItemCreativeAssociation when associating a Creative with the LineItem.
isAmpOnly	xsd:boolean Indicate if the expected creative of this placeholder has an AMP only variant. This attribute is optional. It is for forecasting purposes only and has no effect on serving.