AdsApp.​PlacementBuilder

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:

MemberTypeDescription
build AdsApp.PlacementOperation Builds the placement.
exclude AdsApp.ExcludedPlacementOperation Builds the excluded placement.
withCpc AdsApp.PlacementBuilder Sets the max CPC bid of the new placement to the specified value.
withCpm AdsApp.PlacementBuilder Sets the CPM bid of the new placement to the specified value.
withUrl 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:

TypeDescription
AdsApp.PlacementOperation The PlacementOperation.

exclude()

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

Return values:

TypeDescription
AdsApp.ExcludedPlacementOperation The ExcludedPlacementOperation.

withCpc(cpc)

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

Arguments:

NameTypeDescription
cpc double The max CPC bid of the placement.

Return values:

TypeDescription
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:

NameTypeDescription
cpm double The CPM bid of the placement.

Return values:

TypeDescription
AdsApp.PlacementBuilder The placement builder with the specified CPM.

withUrl(url)

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

Arguments:

NameTypeDescription
url String The placement URL.

Return values:

TypeDescription
AdsApp.PlacementBuilder A PlacementBuilder with the specified URL.