Compartir vía

AssetGroupSelector

  • Artículo

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

Ejemplo de uso:

    var iterator = AdsApp.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 Descripción
get AssetGroupIterator Obtiene un iterador usado para recorrer en iteración la lista de grupos de recursos.
orderBy(string orderBy) AssetGroupSelector Aplica la ordenación especificada a los grupos de recursos seleccionados.
withCondition(string condition) AssetGroupSelector Aplica criterios de filtro a los grupos de recursos.
withIds(string[] ids) AssetGroupSelector Obtiene grupos de recursos con los identificadores especificados.
withLimit(int limit) AssetGroupSelector Obtiene los n grupos de recursos principales que coinciden con los criterios de selección.

Obtener

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

Valores devueltos

Tipo Descripción
AssetGroupIterator Iterador usado para recorrer en iteración los grupos de recursos seleccionados.

orderBy(String orderBy)

Aplica la ordenación especificada a los grupos de recursos 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 llamada siguiente devuelve grupos de recursos 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
AssetGroupSelector Selector con orden aplicado.

withCondition(String condition)

Aplica criterios de filtro a los grupos de recursos.

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 el filtrado de grupos de recursos. Los nombres 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 grupo de recursos. Los posibles valores que distinguen mayúsculas de minúsculas son:
  • HABILITADO
  • PAUSA
  • QUITADO
En este ejemplo solo se devuelven grupos de recursos habilitados.

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

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

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

withCondition("KeywordMaxCpc > 5.0")
CampaignStatus enumeración Estado de la campaña. Los posibles valores que distinguen mayúsculas de minúsculas son:
  • HABILITADO
  • PAUSA
  • QUITADO
En este ejemplo solo se devuelven grupos de recursos 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 grupos de recursos asociados a las etiquetas con nombre.

withCondition("LabelNames CONTAINS_ANY ['bar', 'foo']")
CampaignType enumeración Tipo de campaña. Los posibles valores que distinguen mayúsculas de minúsculas son:
  • SEARCH_AND_CONTENT
  • COMPRAS
  • DYNAMIC_SEARCH_ADS
En este ejemplo solo se devuelven grupos de recursos cuyo tipo de campaña primaria es Shopping.

withCondition("CampaignType = SHOPPING")

Argumentos

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

Valores devueltos

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

withIds(string[] ids)

Obtiene grupos de recursos 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 llamada siguiente selecciona solo el grupo de recursos 33333.

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

Argumentos

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

Valores devueltos

Tipo Descripción
AssetGroupSelector Selector con los identificadores aplicados.

withLimit(int limit)

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

Argumentos

Nombre Tipo Descripción
límite Entero Número de grupos de recursos que se van a devolver. El número real puede ser menor.

Valores devueltos

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

Recursos adicionales

AdsApp.assetGroups()