CampaignAudienceBuilder

Contains the methods for defining and creating a campaign audience association. For information about builders, see Builders.

Example usage:

    // Gets the iterator that iterates all campaigns
    // in the account.
    var shoppingCampaign = AdsApp.shoppingCampaigns().withIds(["123456789"]).get();

    // Loops through all campaigns in the account.
    while (iterator.hasNext()) {
        var campaign = iterator.next();

        // Get the campaign audience's builder.
        var operation = campaign.targeting().newUserListBuilder()
            .withAudienceId("AUDIENCE ID GOES HERE")
            .build();
    
        // See the Builders topic for performance considerations
        // when using the operation object's methods.
        if (!operation.isSuccessful()) {
            for (var error of operation.getErrors()) {
                Logger.log(`${error}\n`);
            }
        }
    }

Methods

Method Name Return Type Description
build CampaignAudienceOperation Creates the campaign audience association and returns an operation object used to check whether the campaign audience association was successfully added.
exclude CampaignExcludedAudienceOperation Excludes the specified audience from this campaign and returns an operation object used to check whether the excluded campaign audience was successfully added.
withAudience(Object userList) CampaignAudienceBuilder Sets the associated user list.
withAudienceId(string audienceId) CampaignAudienceBuilder Sets the associated audience's ID.
withAudienceType(string audienceType) CampaignAudienceBuilder Sets the associated audience's type.
withBidModifier(double modifier) CampaignAudienceBuilder Sets the association's bid modifier.

build

Creates the campaign audience and returns an operation object used to check whether the campaign audience was successfully added.

Returns

Type Description
CampaignAudienceOperation An operation object used to check whether the campaign audience was successfully added.

exclude

Excludes the specified audience from this campaign and returns an operation object used to check whether the excluded campaign audience was successfully added.

Returns

Type Description
CampaignExcludedAudienceOperation An operation object used to check whether the excluded campaign audience was successfully added.

withAudience(Object userList)

Sets the associated user list.

Arguments

Name Type Description
userList string The associated user list.

withAudienceId(string audienceId)

Sets the associated audience's ID.

Arguments

Name Type Description
audienceId string The ID of the associated audience.

withAudienceType(string audienceType)

Sets the associated audience's type.

Arguments

Name Type Description
audienceId string The associated audience's type.

withBidModifier(double modifier)

Sets the association's bid modifier.

Arguments

Name Type Description
modifier double The association's bid modifier.

Returns

Type Description
CampaignAudienceBuilder The campaign audience builder with the bid modifier applied.

Returns

Type Description
CampaignAudienceBuilder The campaign audience builder with the name applied.