AdSelector

  • Artículo

Contiene los métodos para filtrar y ordenar una lista de anuncios. Para obtener información sobre los selectores, vea Selectores.

Métodos

Nombre del método Tipo de valor devuelto Descripción
forDateRange(Object dateFrom, Object dateTo) AdSelector Aplica las fechas de inicio y finalización para seleccionar métricas de rendimiento.
forDateRange(string dateRange) AdSelector Aplica el intervalo de fechas predefinido para seleccionar métricas de rendimiento.
get AdIterator Obtiene un iterador usado para recorrer en iteración la lista de anuncios.
orderBy(string orderBy) AdSelector Aplica el orden especificado a los anuncios seleccionados.
withCondition(string condition) AdSelector Aplica criterios de filtro a los anuncios.
withIds(string[] ids) AdSelector Obtiene anuncios con los identificadores especificados.
withLimit(int limit) AdSelector Obtiene los n anuncios principales que coinciden con los criterios de selección.

forDateRange(Object dateFrom, Object dateTo)

Aplica las fechas de inicio y finalización para seleccionar métricas de rendimiento.

Especifique un intervalo de fechas solo si:

  • Puede aplicar condiciones o ordenar que hagan referencia a campos de métricas de rendimiento.
  • Quiere obtener datos de rendimiento de los objetos que está seleccionando. Por ejemplo, si tiene previsto llamar al getStats() método .

Puede especificar los parámetros de fecha mediante cadenas u objetos. Para usar cadenas, especifique la fecha en el formulario AAAAMMDD. Si usa objetos, cree 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.

El intervalo de fechas es inclusivo. Si especifica varios intervalos de fechas, solo se usa el último intervalo de fechas.

Argumentos

Nombre Tipo Descripción
dateFrom Objeto Fecha de inicio del intervalo de fechas que especifica los datos de rendimiento que se van a incluir en el selector.
dateTo Objeto Fecha de finalización del intervalo de fechas que especifica los datos de rendimiento que se van a incluir en el selector.

Valores devueltos

Tipo Descripción
AdSelector Selector con intervalo de fechas aplicado.

forDateRange(String dateRange)

Aplica el intervalo de fechas predefinido para seleccionar métricas de rendimiento.

Especifique un intervalo de fechas solo si:

  • Puede aplicar condiciones o ordenar que hagan referencia a campos de métricas de rendimiento.
  • Quiere obtener datos de rendimiento de los objetos que está seleccionando. Por ejemplo, si tiene previsto llamar al getStats() método .

Si especifica varios intervalos de fechas, solo se usa el último intervalo de fechas.

Valores de intervalo de fecha admitidos:

  • HOY
  • AYER
  • LAST_WEEK
  • LAST_BUSINESS_WEEK
  • LAST_7_DAYS
  • THIS_WEEK_SUN_TODAY
  • LAST_14_DAYS
  • LAST_30_DAYS
  • LAST_WEEK_SUN_SAT
  • THIS_MONTH
  • LAST_MONTH
  • ALL_TIME

Argumentos

Nombre Tipo Descripción
dateRange Cadena Cadena de intervalo de fechas predefinida que especifica los datos de rendimiento que se van a incluir en el selector. La cadena de intervalo de fechas predefinida distingue mayúsculas de minúsculas.

Valores devueltos

Tipo Descripción
AdSelector Selector con intervalo de fechas aplicado.

Obtener

Obtiene un iterador usado para recorrer en iteración la lista de anuncios.

Valores devueltos

Tipo Descripción
AdIterator Iterador usado para recorrer en iteración los anuncios seleccionados.

orderBy(String orderBy)

Aplica el orden especificado a los anuncios seleccionados.

Especifique el parámetro orderBy en el formulario "columnName orderDirection" donde:

  • columnName es una de las columnas admitidas.
  • orderDirection es el orden en el que se ordenan los resultados. Establezca en ASC para ordenar los resultados en orden ascendente o DESC para ordenar los resultados en orden descendente. El valor predeterminado es ASC.

Por ejemplo, la siguiente llamada devuelve anuncios en orden ascendente por AverageCpc.

selector = selector.orderBy("AverageCpc");

Los selectores admiten la ordenación de entidades solo por un campo. No puede ordenar la lista de entidades por campo x, y dentro de x por campo y, etc. Si especifica más de una orderBy() llamada en una cadena o en llamadas de selector independientes, Scripts ordena la lista de entidades mediante el campo especificado en la última orderBy() llamada. 

Argumentos

Nombre Tipo Descripción
Orderby string Orden que se va a aplicar.

Valores devueltos

Tipo Descripción
AdSelector Selector con orden aplicado.

withCondition(String condition)

Aplica criterios de filtro a los anuncios.

Especifique el parámetro de condición en el formulario "columnName operator value" donde:

Operadores

El operador que use depende del tipo de columna. Los operadores distinguen mayúsculas de minúsculas. Por ejemplo, use STARTS_WITH en lugar de starts_with.

Operadores para columnas que contienen enteros y valores largos:

<
<=
>
>=
=
!=

Operadores para columnas que contienen valores dobles:

<
>

Operadores para columnas que contienen valores de cadena:

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

Operadores para columnas que contienen valores de enumeración:

=
!=
IN []
NOT_IN []

Operadores para columnas que contienen una matriz de cadenas:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Columnas admitidas

Columnas admitidas para filtrar anuncios. Los nombres de columna distinguen mayúsculas de minúsculas.

A continuación se muestran las columnas de métricas de rendimiento que puede especificar.

Column Tipo Ejemplo
AbsoluteTopImpressionRate double withCondition("AbsoluteTopImpressionRate > 0.25")
AverageCpc double withCondition("AverageCpc < 2.75")
AverageCpm double withCondition("AverageCpm > 0.65")
ClickConversionRate double withCondition("ClickConversionRate > 0.25")
Clics largo withCondition("Clicks >= 33")
ConvertedClicks largo withCondition("ConvertedClicks >= 10")
Costo double withCondition("Cost > 3.25")

El costo está en la moneda de la cuenta.
Ctr double withCondition("Ctr > 0.05")

El CTR está en el intervalo 0..1, por lo que use 0.05 para una CTR del 5 %.
Impresiones largo withCondition("Impressions > 10")
TopImpressionRate double withCondition("TopImpressionRate > 0.25")

Las siguientes son las propiedades de entidad que puede especificar.

Column Tipo Ejemplo
Estado Enumeración Estado del anuncio. Los posibles valores que distinguen mayúsculas de minúsculas son:
  • HABILITADO
  • PAUSA
  • QUITADO
En este ejemplo solo se devuelven anuncios habilitados.

withCondition("Status = ENABLED")
Tipo Enumeración Tipo derivado del anuncio. Los posibles valores que distinguen mayúsculas de minúsculas son:
  • EXPANDED_TEXT_AD
En este ejemplo solo se devuelven anuncios de texto expandido.

withCondition("Type = EXPANDED_TEXT_AD")
CombinedApprovalStatus string Estado de aprobación del anuncio. Los posibles valores que distinguen mayúsculas de minúsculas son:
  • APROBADO
  • APPROVED_LIMITED
  • UNDER_REVIEW
  • DESAPROBÓ
Para obtener información sobre estos valores, vea Valores de estado de aprobación editorial.

En este ejemplo se devuelven anuncios que necesitan atención.

withCondition("CombinedApprovalStatus IN ['APPROVED_LIMITED', 'DISAPPROVED']")
CreativeFinalUrls string Dirección URL final del anuncio.

withCondition("CreativeFinalUrls CONTAINS_IGNORE_CASE 'contoso.com'")
AdGroupName string Nombre del grupo de anuncios al que pertenecen los anuncios.

withCondition("AdGroupName CONTAINS_IGNORE_CASE 'truck'")
AdGroupStatus Enumeración Estado del grupo de anuncios al que pertenecen los anuncios. Los posibles valores que distinguen mayúsculas de minúsculas son:
  • HABILITADO
  • PAUSA
  • QUITADO
En este ejemplo solo se devuelven anuncios cuyo grupo de anuncios primario está en pausa.

withCondition("AdGroupStatus = PAUSED")
CampaignName string Nombre de la campaña a la que pertenecen los anuncios.

withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
CampaignStatus Enumeración Estado de la campaña a la que pertenecen los anuncios. Los posibles valores que distinguen mayúsculas de minúsculas son:
  • HABILITADO
  • PAUSA
  • QUITADO
En este ejemplo solo se devuelven anuncios cuya campaña primaria está en pausa.

withCondition("CampaignStatus = PAUSED")
LabelNames conjunto de cadenas Lista de uno o varios nombres de etiqueta que distinguen mayúsculas de minúsculas. Use para obtener anuncios asociados a las etiquetas con nombre.

withCondition("LabelNames CONTAINS_ANY ['bar', 'foo']")
Id Long Identificador del anuncio que se va a probar. Por ejemplo, puede usar esta columna para comprobar si hay anuncios con identificadores mayores que el identificador especificado.

withCondition('Id > 1234')

Argumentos

Nombre Tipo Descripción
Condición string Condición que se va a aplicar al selector.

Valores devueltos

Tipo Descripción
AdSelector Selector con la condición aplicada.

withIds(string[] ids)

Obtiene anuncios con los identificadores especificados.

Puede aplicar una o varias condiciones a un selector. Una cadena de condiciones se considera una operación AND. Por ejemplo, la entidad solo se selecciona si la condición A es true Y la condición B es true. Por ejemplo, la siguiente llamada selecciona solo ad 33333.

var selector = AdsApp.ads()
    .withIds([11111, 22222, 33333])
    .withIds([33333, 44444, 55555]);

Argumentos

Nombre Tipo Descripción
ids string[] Matriz de identificadores de anuncios. Para conocer los límites, consulte Límites de ejecución de scripts.

Valores devueltos

Tipo Descripción
AdSelector Selector con los identificadores aplicados.

withLimit(int limit)

Obtiene los n anuncios principales que coinciden con los criterios de selección.

Argumentos

Nombre Tipo Descripción
límite Entero Número de anuncios que se devolverán. El número real puede ser menor.

Valores devueltos

Tipo Descripción
AdSelector Selector con límite aplicado.

Consulte también

AdsApp.ads()