AdGroupSelector
Contiene los métodos para filtrar y ordenar una lista de grupos de anuncios. Para obtener información sobre los selectores, vea Selectores.
Ejemplo de uso:
var iterator = AdsApp.adGroups()
.withCondition("ClickConversionRate > 0.3")
.forDateRange("LAST_WEEK")
.orderBy("Clicks DESC")
.get();
while (iterator.hasNext()) {
var adGroup = iterator.next();
var metrics = adGroup.getStats();
}
Nombre del método | Tipo de valor devuelto | Descripción |
---|---|---|
forDateRange(Object dateFrom, Object dateTo) | AdGroupSelector | Aplica las fechas de inicio y finalización para seleccionar métricas de rendimiento. |
forDateRange(string dateRange) | AdGroupSelector | Aplica el intervalo de fechas predefinido para seleccionar métricas de rendimiento. |
get | AdGroupIterator | Obtiene un iterador usado para recorrer en iteración la lista de grupos de anuncios. |
orderBy(string orderBy) | AdGroupSelector | Aplica el orden especificado a los grupos de anuncios seleccionados. |
withCondition(string condition) | AdGroupSelector | Aplica criterios de filtro a los grupos de anuncios. |
withIds(string[] ids) | AdGroupSelector | Obtiene grupos de anuncios con los identificadores especificados. |
withLimit(int limit) | AdGroupSelector | Obtiene los n grupos de anuncios principales que coinciden con los criterios de selección. |
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.
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. |
Tipo | Descripción |
---|---|
AdGroupSelector | Selector con intervalo de fechas aplicado. |
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
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. |
Tipo | Descripción |
---|---|
AdGroupSelector | Selector con intervalo de fechas aplicado. |
Obtiene un iterador usado para recorrer en iteración la lista de grupos de anuncios.
Tipo | Descripción |
---|---|
AdGroupIterator | Iterador usado para recorrer en iteración los grupos de anuncios seleccionados. |
Aplica el orden especificado a los grupos de 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 grupos de anuncios en orden ascendente según 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.
Nombre | Tipo | Descripción |
---|---|---|
Orderby | string | Orden que se va a aplicar. |
Tipo | Descripción |
---|---|
AdGroupSelector | Selector con orden aplicado. |
Aplica criterios de filtro a los grupos de anuncios.
Especifique el parámetro de condición en el formulario "columnName operator value" donde:
- columnName es una de las columnas admitidas. Si columName se establece en un nombre de columna de métrica de rendimiento, debe especificar un intervalo de fechas mediante forDateRange(String dateRange) o forDateRange(Object dateFrom, Object dateTo).
- operator es uno de los operadores admitidos.
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 para el filtrado de grupos de anuncios. 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 anuncios. Los posibles valores que distinguen mayúsculas de minúsculas son:
withCondition("Status = ENABLED") |
Nombre | string | Nombre del grupo de anuncios.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 anuncios. 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:
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 anuncios 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:
withCondition("CampaignType = SHOPPING") |
Nombre | Tipo | Descripción |
---|---|---|
Condición | string | Condición que se va a aplicar al selector. |
Tipo | Descripción |
---|---|
AdGroupSelector | Selector con la condición aplicada. |
Obtiene grupos de 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 el grupo de anuncios 33333.
var selector = AdsApp.adGroups()
.withIds(['11111', '22222', '33333'])
.withIds(['33333', '44444', '55555']);
Nombre | Tipo | Descripción |
---|---|---|
ids | string[] | Matriz de identificadores de grupo de anuncios. Para conocer los límites, consulte Límites de ejecución de scripts. |
Tipo | Descripción |
---|---|
AdGroupSelector | Selector con los identificadores aplicados. |
Obtiene los n grupos de anuncios principales que coinciden con los criterios de selección.
Nombre | Tipo | Descripción |
---|---|---|
límite | Entero | Número de grupos de anuncios que se devolverán. El número real puede ser menor. |
Tipo | Descripción |
---|---|
AdGroupSelector | Selector con límite aplicado. |