AdsApp.​PlacementBuilder

AI-generated Key Takeaways

• The PlacementBuilder is used to create or exclude placements for display campaigns.

• It requires a URL and allows optional CPC or CPM bids to be set.

• build() creates a Placement, while exclude() creates an ExcludedPlacement.

• withCpc(), withCpm(), and withUrl() methods are used to configure the placement.

Builder for Placement objects.

Example usage:

var placementBuilder = adGroup.display().newPlacementBuilder()
    .withUrl("http://www.site.com")  // required
    .withCpc(0.50)                   // optional
    .build()                         // create the placement

Methods:

Member	Type	Description
build()	AdsApp.PlacementOperation	Builds the placement.
exclude()	AdsApp.ExcludedPlacementOperation	Builds the excluded placement.
withCpc(cpc)	AdsApp.PlacementBuilder	Sets the max CPC bid of the new placement to the specified value.
withCpm(cpm)	AdsApp.PlacementBuilder	Sets the CPM bid of the new placement to the specified value.
withUrl(url)	AdsApp.PlacementBuilder	Sets the URL of the placement.

build()

Builds the placement. Returns a PlacementOperation that corresponds to the creation of the Placement.

Return values:

Type	Description
AdsApp.PlacementOperation	The PlacementOperation.

exclude()

Builds the excluded placement. Returns an ExcludedPlacementOperation that corresponds to the creation of the ExcludedPlacement.

Return values:

Type	Description
AdsApp.ExcludedPlacementOperation	The ExcludedPlacementOperation.

withCpc(cpc)

Sets the max CPC bid of the new placement to the specified value.

Arguments:

Name	Type	Description
cpc	double	The max CPC bid of the placement.

Return values:

Type	Description
AdsApp.PlacementBuilder	The placement builder with the specified max CPC.

withCpm(cpm)

Sets the CPM bid of the new placement to the specified value.

See Cost-per-thousand impressions (CPM) for more information.

Arguments:

Name	Type	Description
cpm	double	The CPM bid of the placement.

Return values:

Type	Description
AdsApp.PlacementBuilder	The placement builder with the specified CPM.

withUrl(url)

Sets the URL of the placement. This field is required.

Arguments:

Name	Type	Description
url	String	The placement URL.

Return values:

Type	Description
AdsApp.PlacementBuilder	A PlacementBuilder with the specified URL.