type Placement (v202411)

  • A Placement in Google Ad Manager serves as a container for grouping related AdUnit objects, streamlining ad serving and management.

  • Each Placement is assigned a unique ID, name, and placement code for identification and ad targeting purposes.

  • Placement objects can be managed through the PlacementService, allowing for creation, updates, and adjustments to their properties like status and targeted ad units.

  • Key properties of a Placement include its name, description, status (active, inactive, archived), and the IDs of the targeted ad units it encompasses.

  • Placements inherit properties from SiteTargetingInfo, indicating their potential association with site-level targeting options.
Service
PlacementService
Dependencies
PlacementPage createPlacements() updatePlacements()
▼
Placement
Inheritance
SiteTargetingInfo
▼
Placement

A Placement groups related AdUnit objects.

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

Field
SiteTargetingInfo (inherited)
Placement

id

xsd:long

Uniquely identifies the Placement. This attribute is read-only and is assigned by Google when a placement is created.

name

xsd:string

The name of the Placement. This value is required and has a maximum length of 255 characters.

description

xsd:string

A description of the Placement. This value is optional and its maximum length is 65,535 characters.

placementCode

xsd:string

A string used to uniquely identify the Placement for purposes of serving the ad. This attribute is read-only and is assigned by Google when a placement is created.

status

InventoryStatus

The status of the Placement. This attribute is read-only.

Enumerations
ACTIVE
The object is active.
INACTIVE
The object is no longer active.
ARCHIVED
The object has been archived.

targetedAdUnitIds

xsd:string[]

The collection of AdUnit object IDs that constitute the Placement.

lastModifiedDateTime

DateTime

The date and time this placement was last modified.