Leer en inglés

Compartir a través de


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

Nombre del método Tipo de valor devuelto Descripción
Construir AdGroupOperation 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.
withBiddingStrategy(string biddingStrategy) AdGroupBuilder Establece la estrategia de pujas del grupo de anuncios.
withCpc(double cpc) AdGroupBuilder Establece la puja de CPC máxima del grupo de anuncios.
withCpm(double cpm) AdGroupBuilder Establece la puja máxima de CPM del grupo de anuncios.
withCpv(double cpv) AdGroupBuilder Establece la puja de CPV máxima del grupo de anuncios.
withCustomParameters(Object customParameters) AdGroupBuilder Establece los parámetros personalizados del grupo de anuncios.
withEndDate(string endDate) AdGroupBuilder Establece la fecha en la que los anuncios del grupo de anuncios dejan de servir.
withEndDate(Object endDate) AdGroupBuilder Establece la fecha en la que los anuncios del grupo de anuncios dejan de servir.
withLanguage(string language) AdGroupBuilder Establece el idioma usado por este grupo de anuncios.
withName(string name) AdGroupBuilder Establece el nombre del grupo de anuncios.
withStartDate(string startDate) AdGroupBuilder Establece la fecha en que los anuncios del grupo de anuncios comienzan a publicarse.
withStartDate(Object startDate) AdGroupBuilder Establece la fecha en que los anuncios del grupo de anuncios comienzan a publicarse.
withStatus(string status) AdGroupBuilder Establece el estado del grupo de anuncios.
withTrackingTemplate(string trackingTemplate) AdGroupBuilder Establece la plantilla de seguimiento del grupo de anuncios.

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

Tipo Descripción
AdGroupOperation Objeto de operación que se usa para comprobar si el grupo de anuncios se agregó correctamente.

withBiddingStrategy(string biddingStrategy)

Establece la estrategia de pujas del grupo de anuncios.

Argumentos

Nombre Tipo Descripción
biddingStrategy string Estrategia de puja que se va a aplicar al grupo de anuncios. A continuación se muestran los posibles valores que distinguen mayúsculas de minúsculas.
  • MANUAL_CPC
  • MANUAL_CPM
  • MANUAL_CPV
Para obtener información sobre estas estrategias, consulte Tipos de estrategias de puja.

Valores devueltos

Tipo Descripción
AdGroupBuilder Generador de grupos de anuncios con la estrategia de puja aplicada.

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

Nombre Tipo Descripción
Cpc double Puja de CPC máxima del grupo de anuncios. La moneda de la cuenta determina los valores de puja mínimo y máximo. Para obtener más información, consulte Monedas de puja y presupuesto.

Valores devueltos

Tipo Descripción
AdGroupBuilder Generador de grupos de anuncios con la oferta de CPC aplicada.

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

Nombre Tipo Descripción
Cpm double La puja máxima de CPM del grupo de anuncios. La moneda de la cuenta determina los valores de puja mínimo y máximo. Para obtener más información, consulte Monedas de puja y presupuesto.

Valores devueltos

Tipo Descripción
AdGroupBuilder Generador de grupos de anuncios con la puja de CPM aplicada.

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

Nombre Tipo Descripción
Cpv double Puja de CPV máxima del grupo de anuncios. La moneda de la cuenta determina los valores de puja mínimo y máximo. Para obtener más información, consulte Monedas de puja y presupuesto.

Valores devueltos

Tipo Descripción
AdGroupBuilder Generador de grupos de anuncios con la puja de CPV aplicada.

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

Nombre Tipo Descripción
customParameters Objeto Mapa de hasta tres parámetros personalizados para aplicar al grupo de anuncios. Por ejemplo, {key1: 'value1', key2: 'value2', key3: 'value3'}, donde key es el nombre y el valor del parámetro personalizado es el valor del parámetro. El nombre puede contener un máximo de 16 caracteres de 8 bytes y el valor puede contener un máximo de 200 caracteres de 8 bytes.

Valores devueltos

Tipo Descripción
AdGroupBuilder Generador de grupos de anuncios con los parámetros personalizados aplicados.

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

Nombre Tipo Descripción
endDate string Fecha para dejar de publicar anuncios. Especifique la fecha en el formulario, AAAAMMDD.

Valores devueltos

Tipo Descripción
AdGroupBuilder Generador de grupos de anuncios con la fecha de finalización aplicada.

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

Nombre Tipo Descripción
endDate Objeto Fecha para dejar de publicar anuncios. Especifique la fecha mediante un objeto con los campos siguientes:
  • year
  • month
  • Día

Por ejemplo: var date = {year: 2018, month: 5, day: 13};

El mes se basa en uno, donde el 1 es enero y el 12 es diciembre.

Valores devueltos

Tipo Descripción
AdGroupBuilder Generador de grupos de anuncios con la fecha de finalización aplicada.

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

Nombre Tipo Descripción
language string Idioma usado por los anuncios del grupo de anuncios. Por ejemplo, inglés. La cadena no distingue mayúsculas de minúsculas. No use un código de lenguaje de dos caracteres. Para obtener una lista de los idiomas admitidos, consulte Lenguajes de anuncios.

Valores devueltos

Tipo Descripción
AdGroupBuilder Generador de grupos de anuncios con el idioma aplicado.

withName(string name)

Establece el nombre del grupo de anuncios.

Argumentos

Nombre Tipo Descripción
name string Nombre del grupo de anuncios. Se requiere el nombre. El nombre puede contener un máximo de 256 caracteres y debe ser único entre todos los grupos de anuncios activos de la campaña.

Valores devueltos

Tipo Descripción
AdGroupBuilder Generador de grupos de anuncios con el nombre aplicado.

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

Nombre Tipo Descripción
endDate string Fecha para empezar a publicar anuncios. Especifique la fecha en el formulario, AAAAMMDD.

Valores devueltos

Tipo Descripción
AdGroupBuilder Generador de grupos de anuncios con la fecha de inicio aplicada.

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

Nombre Tipo Descripción
endDate Objeto Fecha para empezar a publicar anuncios. Especifique la fecha mediante un objeto con los campos siguientes:
  • year
  • month
  • Día

Por ejemplo: var date = {year: 2018, month: 5, day: 13};

El mes se basa en uno, donde el 1 es enero y el 12 es diciembre.

Valores devueltos

Tipo Descripción
AdGroupBuilder Generador de grupos de anuncios con la fecha de inicio aplicada.

withStatus(string status)

Establece el estado del grupo de anuncios.

Argumentos

Nombre Tipo Descripción
status String Estado del grupo de anuncios. A continuación se muestran los posibles valores que distinguen mayúsculas de minúsculas.
  • HABILITADO
  • PAUSA
  • QUITADO
El valor predeterminado es PAUSED.

Valores devueltos

Tipo Descripción
AdGroupBuilder Generador de grupos de anuncios con el estado aplicado.

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

Nombre Tipo Descripción
trackingTemplate string Plantilla de seguimiento que se va a usar con el grupo de anuncios.

Valores devueltos

Tipo Descripción
AdGroupBuilder Generador de grupos de anuncios con la plantilla de seguimiento aplicada.

Consulte también

Campaign.newAdGroupBuilder()