AdGroupBuilder

Contiene los métodos usados para definir y agregar un grupo de anuncios. Para obtener información sobre los constructores, consulte Constructores.

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 Description
Compilar 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 oferta del grupo de anuncios.
withCpc (doble cpc) AdGroupBuilder Establece la puja de CPC máxima del grupo de anuncios.
withCpm(double cpm) AdGroupBuilder Establece la puja de CPM máxima 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 que los anuncios del grupo de anuncios dejan de servirse.
withEndDate(Object endDate) AdGroupBuilder Establece la fecha en que los anuncios del grupo de anuncios dejan de servirse.
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 Description
AdGroupOperation Un objeto de operación que se usa para comprobar si el grupo de anuncios se agregó correctamente.

withBiddingStrategy(string biddingStrategy)

Establece la estrategia de oferta del grupo de anuncios.

Argumentos

Nombre Tipo Description
estrategia de pujas string La estrategia de pujas que se 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 estrategia de ofertas.

Valores devueltos

Tipo Description
AdGroupBuilder Creador de grupos de anuncios con la estrategia de puja aplicada.

withCpc (doble 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 la estrategia de puja del grupo de anuncios sea MANUAL_CPC. Esta puja se usa si una entidad de nivel inferior, como palabra clave, no la reemplaza.

Argumentos

Nombre Tipo Description
CPC double La puja de CPC máxima del grupo de anuncios. La moneda de la cuenta determina los valores de puja mínimos y máximos. Para obtener más información, consulta Monedas de puja y presupuesto.

Valores devueltos

Tipo Description
AdGroupBuilder Creador de grupos de anuncios con la puja de CPC aplicada.

withCpm(double cpm)

Establece la puja de CPM del grupo de anuncios.

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

Argumentos

Nombre Tipo Description
CPM double La puja de CPM máxima del grupo de anuncios. La moneda de la cuenta determina los valores de puja mínimos y máximos. Para obtener más información, consulta Monedas de puja y presupuesto.

Valores devueltos

Tipo Description
AdGroupBuilder Creador de grupos de anuncios con la puja CPM aplicada.

withCpv(double cpv)

Establece la puja de CPV del grupo de anuncios.

Especifica el importe de la puja que se va a usar por visualización 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 Description
CPV double La puja de CPV máxima del grupo de anuncios. La moneda de la cuenta determina los valores de puja mínimos y máximos. Para obtener más información, consulta Monedas de puja y presupuesto.

Valores devueltos

Tipo Description
AdGroupBuilder Creador de grupos de anuncios con la puja de CPV aplicada.

withCustomParameters(Object customParameters)

Establece los parámetros personalizados del grupo de anuncios para usarlos en las URL finales o en 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, consulte Parámetros personalizados.

Argumentos

Nombre Tipo Description
customParameters Objeto Una asignación de hasta tres parámetros personalizados para aplicar al grupo de anuncios. Por ejemplo, {key1: 'value1', key2: 'value2', key3: 'value3'}, donde clave es el nombre del parámetro personalizado y valor 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 Description
AdGroupBuilder Generador de grupos de anuncios con los parámetros personalizados aplicados.

withEndDate(string endDate)

Establece la fecha en que los anuncios del grupo de anuncios dejan de servirse. 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 La fecha para dejar de publicar anuncios. Especifique la fecha en el formato AAAAMMDD.

Valores devueltos

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

withEndDate(Object endDate)

Establece la fecha en que los anuncios del grupo de anuncios dejan de servirse. 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 La fecha para dejar de publicar anuncios. Especifica la fecha mediante un objeto con los siguientes campos:
  • year
  • month
  • día

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

El mes es de una sola base, donde 1 es enero y 12 es diciembre.

Valores devueltos

Tipo Description
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 principal. Especifica un idioma en el nivel de grupo de anuncios para reemplazar 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 Description
language string El idioma que usan los anuncios en el grupo de anuncios. Por ejemplo, inglés. La cadena no distingue mayúsculas de minúsculas. No utilice un código de idioma de dos caracteres. Para ver una lista de idiomas admitidos, consulta Idiomas de anuncios.

Valores devueltos

Tipo Description
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 El nombre del grupo de anuncios. El nombre es obligatorio. 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 Description
AdGroupBuilder Creador 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 comiencen a publicarse en una fecha específica; De lo contrario, los anuncios comenzarán a publicarse inmediatamente.

Argumentos

Nombre Tipo Descripción
endDate string La fecha para empezar a publicar anuncios. Especifique la fecha en el formato AAAAMMDD.

Valores devueltos

Tipo Description
AdGroupBuilder Creador 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 comiencen a publicarse en una fecha específica; De lo contrario, los anuncios comenzarán a publicarse inmediatamente.

Argumentos

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

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

El mes es de una sola base, donde 1 es enero y 12 es diciembre.

Valores devueltos

Tipo Description
AdGroupBuilder Creador 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 Cadena El estado del grupo de anuncios. A continuación se muestran los posibles valores que distinguen mayúsculas de minúsculas.
  • HABILITADO
  • EN PAUSA
  • SE QUITÓ
El valor predeterminado es PAUSADO.

Valores devueltos

Tipo Description
AdGroupBuilder Creador 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 la FinalUrl de la palabra clave para crear la URL de destino que usa el anuncio. Para obtener más información, consulta ¿Qué parámetros de seguimiento o de URL puedo usar?

Argumentos

Nombre Tipo Description
trackingTemplate string La plantilla de seguimiento que se usará con el grupo de anuncios.

Valores devueltos

Tipo Description
AdGroupBuilder Generador de grupos de anuncios con la plantilla de seguimiento aplicada.

Vea también

Campaign.newAdGroupBuilder()

  • Last updated on