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`);
}
}
}
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.