AdGroupAudienceBuilder

Contiene los métodos para definir y crear una asociación de audiencia de grupo de anuncios. Para obtener información sobre los generadores, vea Generadores.

Ejemplo de uso:

    // Gets the iterator that iterates all ad groups
    // in the account.
    var iterator = AdsApp.adGroups().get();

    // Loops through all ad groups in the account.
    while (iterator.hasNext()) {
        var adGroup = iterator.next();

        // Get the ad group audience's builder.
        var operation = adGroup.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`);
            }
        }
    }

Métodos

Nombre del método	Tipo de valor devuelto	Descripción
Construir	AdGroupAudienceOperation	Crea la asociación de audiencia del grupo de anuncios y devuelve un objeto de operación que se usa para comprobar si la asociación de audiencia del grupo de anuncios se agregó correctamente.
Excluir	AdGroupExcludedAudienceOperation	Excluye la audiencia especificada de este grupo de anuncios y devuelve un objeto de operación que se usa para comprobar si la audiencia del grupo de anuncios excluida se agregó correctamente.
withAudience(Object userList)	AdGroupAudienceBuilder	Establece la lista de usuarios asociada.
withAudienceId(string audienceId)	AdGroupAudienceBuilder	Establece el identificador de la audiencia asociada.
withAudienceType(string audienceType)	AdGroupAudienceBuilder	Establece el tipo de audiencia asociada.
withBidModifier(double modifier)	AdGroupAudienceBuilder	Establece el modificador de puja de la asociación.

build

Crea la audiencia del grupo de anuncios y devuelve un objeto de operación que se usa para comprobar si la audiencia del grupo de anuncios se agregó correctamente.

Valores devueltos

Tipo	Descripción
AdGroupAudienceOperation	Objeto de operación que se usa para comprobar si la audiencia del grupo de anuncios se agregó correctamente.

Excluir

Excluye la audiencia especificada de este grupo de anuncios y devuelve un objeto de operación que se usa para comprobar si la audiencia del grupo de anuncios excluida se agregó correctamente.

Valores devueltos

Tipo	Descripción
AdGroupExcludedAudienceOperation	Objeto de operación que se usa para comprobar si la audiencia del grupo de anuncios excluida se agregó correctamente.

withAudience(Object userList)

Establece la lista de usuarios asociada.

Argumentos

Nombre	Tipo	Descripción
userList	string	Lista de usuarios asociada.

withAudienceId(string audienceId)

Establece el identificador de la audiencia asociada.

Argumentos

Nombre	Tipo	Descripción
audienceId	string	Identificador de la audiencia asociada.

withAudienceType(string audienceType)

Establece el tipo de audiencia asociada.

Argumentos

Nombre	Tipo	Descripción
audienceId	string	Tipo de audiencia asociada.

withBidModifier(double modifier)

Establece el modificador de puja de la asociación.

Argumentos

Nombre	Tipo	Descripción
Modificador	double	Modificador de puja de la asociación.

Valores devueltos

Tipo	Descripción
AdGroupAudienceBuilder	Generador de audiencias del grupo de anuncios con el modificador de puja aplicado.

Valores devueltos

Tipo	Descripción
AdGroupAudienceBuilder	Generador de audiencias del grupo de anuncios con el nombre aplicado.