AssetGroupSelector

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

Ejemplo de uso:

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

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

Métodos

Nombre del método Tipo de valor devuelto Description
get AssetGroupIterator Obtiene un iterador utilizado para iterar a través de la lista de grupos de activos.
orderBy(string orderBy) AssetGroupSelector Aplica el orden especificado a los grupos de activos seleccionados.
withCondition(condición de cadena) AssetGroupSelector Aplica criterios de filtro a los grupos de recursos.
withIds(string[] ids) AssetGroupSelector Obtiene los grupos de activos con los identificadores especificados.
withLimit(int limit) AssetGroupSelector Obtiene los n grupos de activos principales que coinciden con los criterios de selección.

obtener

Obtiene un iterador utilizado para iterar a través de la lista de grupos de activos.

Valores devueltos

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

orderBy(String orderBy)

Aplica el orden especificado a los grupos de activos 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 activos 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
AssetGroupSelector Selector con orden aplicado.

withCondition(condición de cadena)

Aplica criterios de filtro a los grupos de recursos.

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 recursos. 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
Estado enumeración El estado del grupo de recursos. Los valores que pueden distinguir mayúsculas de minúsculas son:
  • HABILITADO
  • EN PAUSA
  • SE QUITÓ
En este ejemplo solo se devuelven los grupos de activos habilitados.

withCondition("Status = ENABLED")
Nombre string Nombre del grupo de recursos.

withCondition("Name CONTAINS_IGNORE_CASE 'sport'")
Nombre de campaña string El nombre de la campaña.

withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
KeywordMaxCpc double La puja de CPC del grupo de activos. La puja se realiza en la moneda de la cuenta.

withCondition("KeywordMaxCpc > 5.0")
CampaignStatus enumeración El estado de la campaña. Los valores que pueden distinguir mayúsculas de minúsculas son:
  • HABILITADO
  • EN PAUSA
  • SE QUITÓ
Este ejemplo devuelve solo los grupos de activos cuya campaña principal está en pausa.

withCondition("CampaignStatus = PAUSED")
LabelNames juego de cadenas Una lista de uno o varios nombres de etiqueta que distinguen mayúsculas de minúsculas. Utilízalo para obtener los grupos de activos asociados a las etiquetas nombradas.

withCondition("LabelNames CONTAINS_ANY ['bar', 'foo']")
Tipo de campaña enumeración El tipo de campaña. Los valores que pueden distinguir mayúsculas de minúsculas son:
  • SEARCH_AND_CONTENT
  • COMPRAS
  • DYNAMIC_SEARCH_ADS
En este ejemplo se devuelven solo los grupos de activos cuyo tipo de campaña principal es Compras.

withCondition("CampaignType = SHOPPING")

Argumentos

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

Valores devueltos

Tipo Description
AssetGroupSelector Selector con la condición aplicada.

withIds(string[] ids)

Obtiene los grupos de activos 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 activos 33333.

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

Argumentos

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

Valores devueltos

Tipo Description
AssetGroupSelector con los identificadores aplicados.

withLimit(int limit)

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

Argumentos

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

Valores devueltos

Tipo Description
AssetGroupSelector Selector con límite aplicado.

Vea también

Campaign.assetGroups()

  • Last updated on