ProductGroupSelector

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

Ejemplo de uso:

    var iterator = AdsApp.productGroups()
        .withCondition("ClickConversionRate > 0.3")
        .forDateRange("LAST_WEEK")
        .orderBy("Clicks DESC")
        .get();

    while (iterator.hasNext()) {
        var productGroup = iterator.next();
        var metrics = productGroup.getStats();
    }

Métodos

Nombre del método Tipo de valor devuelto Description
forDateRange(Object dateFrom, Object dateTo) ProductGroupSelector Aplica las fechas de inicio y finalización para seleccionar métricas de rendimiento.
forDateRange(string dateRange) ProductGroupSelector Aplica el intervalo de fechas predefinido para seleccionar las métricas de rendimiento.
get ProductGroupIterator Obtiene un iterador que se usa para iterar a través de la lista de grupos de productos.
orderBy(string orderBy) ProductGroupSelector Aplica el orden especificado a los grupos de productos seleccionados.
withCondition(condición de cadena) ProductGroupSelector Aplica criterios de filtro a los grupos de productos.
withIds(string[] ids) ProductGroupSelector Obtiene los grupos de productos con los identificadores especificados.
withLimit(int limit) ProductGroupSelector Obtiene los n grupos de productos 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 únicamente si:

  • Se aplican condiciones u órdenes que hacen referencia a campos de métricas de rendimiento.
  • Desea obtener datos de rendimiento para los objetos que está seleccionando. Por ejemplo, si tiene previsto getStats() llamar al método.

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

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

Argumentos

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

Valores devueltos

Tipo Description
ProductGroupSelector Selector con intervalo de fechas aplicado.

forDateRange(String dateRange)

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

Especifique un intervalo de fechas únicamente si:

  • Se aplican condiciones u órdenes que hacen referencia a campos de métricas de rendimiento.
  • Desea obtener datos de rendimiento para los objetos que está seleccionando. Por ejemplo, si tiene previsto getStats() llamar al método.

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

Valores de intervalo de fechas 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 Description
Intervalo de fechas Cadena La cadena de intervalo de fechas predefinida que especifica los datos de rendimiento que se incluirán en el selector. La cadena de intervalo de fechas predefinida distingue mayúsculas de minúsculas.

Valores devueltos

Tipo Description
ProductGroupSelector Selector con intervalo de fechas aplicado.

obtener

Obtiene un iterador que se usa para iterar a través de la lista de grupos de productos.

Valores devueltos

Tipo Description
ProductGroupIterator Un iterador utilizado para iterar a través de los grupos de productos seleccionados.

orderBy(String orderBy)

Aplica el orden especificado a los grupos de productos 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 ordenarán los resultados. Establezca 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 grupos de productos en orden ascendente por AverageCpc.

selector = selector.orderBy("AverageCpc");

Los selectores admiten entidades de orden por un solo campo. No puede ordenar la lista de entidades por el campo x, y dentro de x por el campo y, etc. Si especifica más de una orderBy() llamada en una cadena o en selectores independientes, los scripts ordenan la lista de entidades mediante el campo especificado en la última orderBy() llamada. 

Argumentos

Nombre Tipo Description
orderBy string La orden de aplicar.

Valores devueltos

Tipo Description
ProductGroupSelector Selector con orden aplicado.

withCondition(condición de cadena)

Aplica criterios de filtro a los grupos de productos.

Especifique el parámetro de condición en el formulario "valor del operador columnName" 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 de 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 de columnas que contienen una matriz de cadenas:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Columnas admitidas

Columnas admitidas para el filtrado de grupos de productos. Los nombres distinguen mayúsculas de minúsculas.

Las siguientes son 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")
PromedioCpm double withCondition("AverageCpm > 0.65")
ClickConversionRate double withCondition("ClickConversionRate > 0.25")
Clics largo withCondition("Clicks >= 33")
ConversionedClicks largo withCondition("ConvertedClicks >= 10")
Costo double withCondition("Cost > 3.25")

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

El CTR está en el rango 0..1, así que use 0.05 para un 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
Grupo de productos string El valor del grupo de productos. Por ejemplo, si la ruta de acceso es "Todos los productos > Sporting Goods > Winter > Sports Skis > Skis > Downhill Skis > New", puede establecer el operando en Esquís.

withCondition("ProductGroup = Skis")

El selector incluye el grupo de productos Esquís y su grupo de productos "otro caso", si existe.

Tenga en cuenta que es posible que no especifique "OtherCase" como operando.
Puja double El importe de la oferta. Devuelve todos los grupos de productos que coinciden con la condición de puja.

withCondition("Bid < 2.75")

El uso de '<' devuelve grupos con un importe de puja de CPC inferior al importe especificado o que se establece en null. Para evitar que el selector incluya mayúsculas y minúsculas, utilice, por ejemplo, .withCondition("Bid < 2.75").withCondition("Bid > 0.0").

Argumentos

Nombre Tipo Description
condición string La condición que se aplicará al selector.

Valores devueltos

Tipo Description
ProductGroupSelector Selector con la condición aplicada.

withIds(string[] ids)

Obtiene los grupos de productos con los identificadores especificados.

Puede aplicar una o más 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 verdadera Y la condición B es verdadera. Por ejemplo, la siguiente llamada selecciona solo el grupo de producto 33333.

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

Argumentos

Nombre Tipo Descripción
ids string[] Una matriz de identificadores de grupos de productos. Para conocer los límites, consulte Límites de ejecución de scripts.

Valores devueltos

Tipo Description
ProductGroupSelector con los identificadores aplicados.

withLimit(int limit)

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

Argumentos

Nombre Tipo Description
límite Entero El número de grupos de productos que se van a devolver. El número real puede ser menor.

Valores devueltos

Tipo Description
ProductGroupSelector Selector con límite aplicado.

Vea también

AdsApp.productGroups()AdGroup.productGroups()

  • Last updated on