AdGroupBuilder

Contiene los métodos utilizados para definir y agregar un grupo de anuncios. Para obtener información sobre los generadores, vea Generadores.

Ejemplo de uso:

    // Get a campaign to add the ad group to.
    var iterator = AdsApp.campaigns()
        .withIds(['CAMPAIGN ID GOES HERE'])
        .get();

    while (iterator.hasNext()) {
        var campaign = iterator.next();

        // Get the campaign's ad group builder and add an ad group.
        var operation = campaign.newAdGroupBuilder()
            .withName("AD GROUP NAME GOES HERE")
            .withStatus("ENABLED")
            .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

build

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

Valores devueltos

withBiddingStrategy(string biddingStrategy)

Establece la estrategia de pujas del grupo de anuncios.

Argumentos

Valores devueltos

withCpc(double cpc)

Establece la puja de CPC del grupo de anuncios.

Especifica el importe de la puja que se usará cuando la palabra clave coincida con el término de búsqueda del usuario y se MANUAL_CPC la estrategia de puja del grupo de anuncios. Esta puja se usa si una entidad de nivel inferior, como la palabra clave , no la invalida.

Argumentos

Valores devueltos

withCpm(double cpm)

Establece la puja de CPM del grupo de anuncios.

Especifica el importe de la puja que se usará por cada 1000 impresiones vistas y cuando se MANUAL_CPM la estrategia de puja del grupo de anuncios.

Argumentos

Valores devueltos

withCpv(double cpv)

Establece la puja de CPV del grupo de anuncios.

Especifica el importe de la puja que se usará por vista o por clic en un anuncio de vídeo y cuándo se MANUAL_CPV la estrategia de puja del grupo de anuncios.

Argumentos

Valores devueltos

withCustomParameters(Object customParameters)

Establece los parámetros personalizados del grupo de anuncios que se usarán en las direcciones URL finales o las plantillas de seguimiento.

Los parámetros personalizados son útiles para compartir información dinámica entre varias direcciones URL. Para obtener más información sobre su uso, vea Parámetros personalizados.

Argumentos

Valores devueltos

withEndDate(string endDate)

Establece la fecha en la que los anuncios del grupo de anuncios dejan de servir. Llame a este método solo si desea que los anuncios del grupo dejen de servir en una fecha específica.

Argumentos

Valores devueltos

withEndDate(Object endDate)

Establece la fecha en la que los anuncios del grupo de anuncios dejan de servir. Llame a este método solo si desea que los anuncios del grupo dejen de servir en una fecha específica.

Argumentos

Valores devueltos

withLanguage(string language)

Establece el idioma que usan los anuncios de este grupo de anuncios.

De forma predeterminada, el grupo de anuncios hereda el idioma de su campaña primaria. Especifique un idioma en el nivel de grupo de anuncios para invalidar el idioma especificado en el nivel de campaña o si la campaña no especifica un idioma (el idioma debe especificarse en el nivel de campaña o grupo de anuncios).

Argumentos

Valores devueltos

withName(string name)

Establece el nombre del grupo de anuncios.

Argumentos

Valores devueltos

withStartDate(string startDate)

Establece la fecha en que los anuncios del grupo de anuncios comienzan a publicarse. Llame a este método solo si desea que los anuncios del grupo empiecen a servir en una fecha específica; de lo contrario, los anuncios comienzan a servir inmediatamente.

Argumentos

Valores devueltos

withStartDate(Object startDate)

Establece la fecha en que los anuncios del grupo de anuncios comienzan a publicarse. Llame a este método solo si desea que los anuncios del grupo empiecen a servir en una fecha específica; de lo contrario, los anuncios comienzan a servir inmediatamente.

Argumentos

Valores devueltos

withStatus(string status)

Establece el estado del grupo de anuncios.

Argumentos

Valores devueltos

withTrackingTemplate(string trackingTemplate)

Establece la plantilla de seguimiento del grupo de anuncios.

Las plantillas de seguimiento se usan con finalUrl de la palabra clave para crear la dirección URL de destino usada por el anuncio. Para obtener más información, consulte ¿Qué parámetros de seguimiento o dirección URL puedo usar?

Argumentos

Valores devueltos

Consulte también

Campaign.newAdGroupBuilder()