Grupo de anuncios

Contiene los métodos usados para administrar un grupo de anuncios.

Métodos

Nombre del método Tipo de valor devuelto Description
addLocation(int locationId) TargetedLocationOperation Crea un segmento de ubicación en este grupo de anuncios a partir de un identificador de ubicación.
addLocation(int, locationId, double bidModifier) TargetedLocationOperation Crea un segmento de ubicación en este grupo de anuncios a partir de un identificador de ubicación y un modificador de puja.
Anuncios AdSelector Obtiene un selector que se usa para filtrar la lista de anuncios de este grupo de anuncios.
applyLabel(string name) void Aplica la etiqueta a este grupo de anuncios.
Pujas AdGroupBidding Obtiene los métodos usados para administrar el importe de la puja de este grupo de anuncios.
habilitar void Habilita este grupo de anuncios.
excludeLocation(int locationId) ExcludedLocationOperation Crea una exclusión de ubicación en este grupo de anuncios a partir de un identificador de ubicación.
getCampaign Campaña Obtiene la campaña a la que pertenece este grupo de anuncios.
getEndDate BingAdsDate Obtiene la fecha en que los anuncios de este grupo de anuncios dejan de servirse.
getEntityType string Obtiene el tipo de esta entidad.
getId string Obtiene el identificador que identifica exclusivamente a este grupo de anuncios.
getName string Obtiene el nombre de este grupo de anuncios.
getStartDate BingAdsDate Obtener la fecha en la que los anuncios de este grupo de anuncios empiezan a publicarse.
getStats Estadísticas Obtiene los datos de rendimiento de este grupo de anuncios.
isEnabled Booleano Obtiene un valor booleano que indica si este grupo de anuncios está habilitado.
isPaused Booleano Obtiene un valor booleano que indica si este grupo de anuncios está en pausa.
isRemoved Booleano Obtiene un valor booleano que indica si se ha quitado este grupo de anuncios.
palabras clave KeywordSelector Obtiene un selector que se usa para filtrar la lista de palabras clave de este grupo de anuncios.
Etiquetas LabelSelector Obtiene un selector que se usa para filtrar la lista de etiquetas asociadas a este grupo de anuncios.
newAd AdBuilderSpace Obtiene un objeto que contiene métodos para obtener creadores de anuncios.
newKeywordBuilder KeywordBuilder Obtiene un generador que se usa para agregar una palabra clave a este grupo de anuncios.
pausar void Pausa este grupo de anuncios.
productGroups ProductGroupSelector Obtiene un selector que se usa para filtrar la lista de grupos de productos de este grupo de anuncios.
removeLabel(nombre de la cadena) void Quita la etiqueta de este grupo de anuncios.
RootProductGroup Grupo de productos Obtiene el grupo de productos raíz de este grupo de anuncios.
setEndDate(string endDate) void Establece la fecha en que los anuncios de este grupo de anuncios dejan de servirse.
setEndDate(Object endDate) void Establece la fecha en que los anuncios de este grupo de anuncios dejan de servirse.
setName(String name) void Establece el nombre del grupo de anuncios.
setStartDate(string startDate) void Establece la fecha en que los anuncios de este grupo de anuncios comienzan a publicarse.
setStartDate(Object startDate) void Establece la fecha en que los anuncios de este grupo de anuncios comienzan a publicarse.
Segmentación AdGroupTargeting Proporciona acceso a los criterios de segmentación a nivel de grupo de anuncios: segmentación por ubicación.
Direcciones URL AdGroupUrls Contiene los métodos usados para administrar las URL finales, la plantilla de seguimiento y los parámetros personalizados del grupo de anuncios.

addLocation(int locationId)

Crea un segmento de ubicación en este grupo de anuncios a partir de un identificador de ubicación.

Valores devueltos

Tipo Description
TargetedLocationOperation El objeto de operación utilizado para comprobar si la ubicación de destino se agregó correctamente.

addLocation(int, locationId, double bidModifier)

Crea un segmento de ubicación en este grupo de anuncios a partir de un identificador de ubicación y un modificador de puja.

Valores devueltos

Tipo Description
TargetedLocationOperation El objeto de operación utilizado para comprobar si la ubicación de destino se agregó correctamente.

Anuncios

Obtiene un selector que se usa para filtrar la lista de anuncios de este grupo de anuncios.

Valores devueltos

Tipo Description
AdSelector Selector que se usa para filtrar la lista de anuncios de este grupo de anuncios.

applyLabel(string name)

Aplica la etiqueta al grupo de anuncios.

Puedes aplicar un máximo de 50 etiquetas a un grupo de anuncios. Para obtener un ejemplo en el que se agrega una etiqueta a una entidad, consulte Uso de etiquetas.

Argumentos

Nombre Tipo Descripción
name string El nombre de la etiqueta que distingue mayúsculas de minúsculas. Para obtener una lista de etiquetas en esta cuenta que puede aplicar, consulte AdsApp.labels.

Valores devueltos

Tipo Description
void Devuelve el valor nothing.

Pujas

Obtiene los métodos usados para administrar el importe de la puja de este grupo de anuncios.

Valores devueltos:

Tipo Description
AdGroupBidding Contiene los métodos para administrar el importe de la puja de este grupo de anuncios.

habilitar

Habilita este grupo de anuncios.

Valores devueltos

Tipo Description
void Devuelve el valor nothing.

excludeLocation(int locationId)

Crea una exclusión de ubicación en este grupo de anuncios a partir de un identificador de ubicación.

Valores devueltos

Tipo Description
ExcludedLocationOperation El objeto de operación utilizado para comprobar si la ubicación excluida se agregó correctamente.

getCampaign

Obtiene la campaña a la que pertenece este grupo de anuncios.

Valores devueltos

Tipo Description
Campaña La campaña a la que pertenece este grupo de anuncios.

getEndDate

Obtiene la fecha en que los anuncios de este grupo de anuncios dejan de servirse.

Valores devueltos

Tipo Description
BingAdsDate La fecha en la que los anuncios de este grupo de anuncios dejan de servirse.

getEntityType

Obtiene el tipo de esta entidad.

Valores devueltos

Tipo Descripción
string El tipo de esta entidad, que es AdGroup.

getId

Obtiene el identificador que identifica exclusivamente a este grupo de anuncios.

Valores devueltos

Tipo Descripción
string Id. que identifica exclusivamente a este grupo de anuncios.

getName

Obtiene el nombre de este grupo de anuncios.

Valores devueltos

Tipo Descripción
string El nombre de este grupo de anuncios.

getStartDate

Obtiene la fecha en que los anuncios de este grupo de anuncios comienzan a publicarse.

Valores devueltos

Tipo Description
BingAdsDate La fecha en la que los anuncios de este grupo de anuncios empiezan a publicarse.

getStats

Obtiene los datos de rendimiento de este grupo de anuncios.

Para llamar a este método, debes incluir uno de los métodos en la forDateRange cadena del selector de grupos de anuncios .

Valores devueltos:

Tipo Description
Estadísticas Los datos de rendimiento de este grupo de anuncios.

isEnabled

Obtiene un valor booleano que indica si este grupo de anuncios está habilitado.

Valores devueltos:

Tipo Descripción
Booleano Es verdadero si este grupo de anuncios está habilitado; de lo contrario, false.

isPaused

Obtiene un valor booleano que indica si este grupo de anuncios está en pausa.

Valores devueltos:

Tipo Descripción
Booleano Es verdadero si este grupo de anuncios está en pausa; de lo contrario, false.

isRemoved

Obtiene un valor booleano que indica si este grupo de anuncios se quita (elimina).

Valores devueltos

Tipo Descripción
Booleano Es verdadero si se quita este grupo de anuncios; de lo contrario, false.

keywords

Obtiene un selector que se usa para filtrar la lista de palabras clave de este grupo de anuncios.

Valores devueltos

Tipo Description
KeywordSelector Un selector que se usa para filtrar la lista de palabras clave de este grupo de anuncios.

Etiquetas

Obtiene un selector que se usa para filtrar la lista de etiquetas asociadas a este grupo de anuncios.

Valores devueltos

Tipo Description
LabelSelector Un selector que se usa para filtrar la lista de etiquetas asociadas a este grupo de anuncios.

newAd

Obtiene un objeto que contiene métodos para obtener creadores de anuncios.

Valores devueltos

Tipo Description
AdBuilderSpace Objeto que contiene métodos para obtener creadores de anuncios. Por ejemplo, para crear un anuncio de texto expandido, llame al método del expandedTextAdBuilder objeto para obtener el objeto ExpandedTextAdBuilder .

newKeywordBuilder

Obtiene un generador que se usa para agregar una palabra clave a este grupo de anuncios.

Valores devueltos

Tipo Description
KeywordBuilder El generador se usa para agregar una palabra clave a este grupo de anuncios.

pausar

Pausa este grupo de anuncios.

Valores devueltos

Tipo Description
void Devuelve el valor nothing.

productGroups

Obtiene un selector que se usa para filtrar la lista de grupos de productos de este grupo de anuncios.

Valores devueltos

Tipo Description
ProductGroupSelector Selector que se usa para filtrar la lista de grupos de productos de este grupo de anuncios.

removeLabel(nombre de la cadena)

Quita la etiqueta del grupo de anuncios.

Argumentos

Nombre Tipo Descripción
name string El nombre de la etiqueta que distingue mayúsculas de minúsculas. Para obtener una lista de etiquetas asociadas con este grupo de anuncios, consulta Etiquetas.

Valores devueltos

Tipo Description
void Devuelve el valor nothing.

RootProductGroup

Obtiene el grupo de productos raíz de este grupo de anuncios.

Valores devueltos

Tipo Description
Grupo de productos El grupo de productos raíz de este grupo de anuncios. Devuelve un valor nulo si el grupo de anuncios no contiene grupos de productos.

setEndDate(string endDate)

Establece la fecha en que los anuncios de este grupo de anuncios dejan de servirse. Establece una fecha de finalización solo si quieres que los anuncios del grupo dejen de servir en una fecha específica.

Argumentos

Nombre Tipo Descripción
endDate string La fecha en la que los anuncios del grupo de anuncios dejan de servirse. Especifique la fecha en el formato AAAAMMDD.

Valores devueltos

Tipo Description
void Devuelve el valor nothing.

setEndDate(Object endDate)

Establece la fecha en que los anuncios de este grupo de anuncios dejan de servirse. Establece una fecha de finalización solo si quieres que los anuncios del grupo dejen de servir en una fecha específica.

Argumentos

Nombre Tipo Descripción
endDate Objeto La fecha en la que los anuncios de este grupo de anuncios dejan de servirse. 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
void Devuelve el valor nothing.

setName(string name)

Establece el nombre de este grupo de anuncios.

Argumentos

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

Valores devueltos

Tipo Description
void Devuelve el valor nothing.

setStartDate(string startDate)

Establece la fecha en que los anuncios de este grupo de anuncios comienzan a publicarse. Establece una fecha de inicio solo si quieres que los anuncios del grupo comiencen a publicarse en una fecha específica. de lo contrario, comienzan a servir inmediatamente.

Argumentos

Nombre Tipo Descripción
endDate string La fecha en la que los anuncios de este grupo de anuncios empiezan a publicarse. Especifique la fecha en el formato AAAAMMDD.

Valores devueltos

Tipo Description
void Devuelve el valor nothing.

setStartDate(Object startDate)

Establece la fecha en que los anuncios de este grupo de anuncios comienzan a publicarse. Establece una fecha de inicio solo si quieres que los anuncios del grupo comiencen a publicarse en una fecha específica. de lo contrario, comienzan a servir inmediatamente.

Argumentos

Nombre Tipo Descripción
endDate Objeto La fecha en la que los anuncios de este grupo de anuncios empiezan a publicarse. 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
void Devuelve el valor nothing.

Segmentación

Proporciona acceso a los criterios de segmentación a nivel de grupo de anuncios: segmentación por ubicación.

Valores devueltos

Tipo Description
AdGroupTargeting Acceso a los criterios de segmentación por ubicación en este grupo de anuncios.

urls

Contiene los métodos usados para administrar las URL finales, la plantilla de seguimiento y los parámetros personalizados del grupo de anuncios.

Valores devueltos

Tipo Description
AdGroupUrls El objeto que se usa para administrar las URL finales, la plantilla de seguimiento y los parámetros personalizados del grupo de anuncios.

Vea también