Informes filtrados

La nueva API de informes de Search Ads 360 ya está disponible. La nueva API proporciona una flexibilidad mejorada para crear informes personalizados y, además, integrar los datos en procesos y aplicaciones de informes. Obtén más información para migrar a la nueva API de informes de Search Ads 360 y usarla.

De forma predeterminada, tu informe contendrá todos los datos dentro del reportScope que especifica tu solicitud. Si deseas que un informe contenga solo los datos que coinciden con un conjunto de criterios, puedes agregar uno o más filtros a un informe. Solo se muestran las filas que satisfacen todos los filtros.

Por ejemplo, puede solicitar un informe de todas las palabras clave de una agencia. Luego, puedes especificar un filtro para que solo aparezcan en el informe las palabras clave con URL de página de destino que comiencen con www.example.com y www.another-example.com.

"filters": [
  {
    "column" : { "columnName": "keywordLandingPage" },
    "operator" : "startsWith",
    "values" : [
      "http://www.example.com",
      "http://www.another-example.com"
    ]
  }
]

Cada filtro especifica una columna que se filtrará, un operador y una lista de valores que se espera que estén en la columna especificada:

"filters": [
  {
   "column" : column to filter on,
   "operator" : operator specifying the type of filter,
   "values" : list of values
  },
  { ... another filter can go here ... }
]

Nota: Algunas columnas no se pueden filtrar. En la referencia Tipos de informes, cada columna indica si es Filterable.

Operadores de filtro

Todos los filtros distinguen mayúsculas de minúsculas. Es decir, un filtro con "www.ruedas.com" no coincidirá con una columna que contenga "www.piñónes.com".

Operador	Descripción	Cantidad de valores admitidos
equals	La columna debe coincidir exactamente con el valor especificado.	1
notEquals	La columna no debe coincidir con el valor especificado.	1
in	La columna debe coincidir exactamente con uno de los valores de la lista del filtro. No es válido para los tipos de datos de lista (como String list).	variable
lessThan	La columna debe contener un valor menor que el valor especificado. Si especificas este filtro para una columna Boolean, la API de Search Ads 360 convierte false en un valor numérico de 0 y true en 1. Si especificas este filtro para una columna String, la API compara el orden lexicográfico. No es válido para los tipos de datos de lista (como String list).	1
greaterThan	La columna debe contener un valor mayor que uno de los valores de la lista del filtro. Si especificas este filtro para una columna Boolean, la API convierte false en un valor numérico de 0 y true en 1. Si especificas este filtro para una columna String, la API compara el orden lexicográfico. No es válido para los tipos de datos de lista (como String list).	1
lessThanOrEqual	La columna debe contener un valor menor o igual que uno de los valores de la lista del filtro. Si especificas este filtro para una columna Boolean, la API convierte false en un valor numérico de 0 y true en 1. Si especificas este filtro para una columna String, la API compara el orden lexicográfico. No es válido para los tipos de datos de lista (como String list).	1
greaterThanOrEqual	La columna debe contener un valor mayor o igual que uno de los valores de la lista del filtro. Si especificas este filtro para una columna Boolean, la API convierte false en un valor numérico de 0 y true en 1. Si especificas este filtro para una columna String, la API compara el orden lexicográfico. No es válido para los tipos de datos de lista (como String list).	1
isNull	La columna debe estar vacía. Por ejemplo, si especificas isNull para la columna keywordMaxCpc en un informe de palabras clave, el informe solo contendrá palabras clave que no hayan especificado un CPC máx.	0
isNotNull	La columna debe contener un valor.	0
startsWith	La columna debe comenzar con una de las strings de la lista del filtro. Solo es válido para columnas String.	variable
containsSubstring	La columna debe contener la totalidad o parte de una de las strings especificadas en la lista del filtro. Por ejemplo, un filtro containsSubstring con los valores ["ham", "cheese"] mostraría filas con este valor: hamburger cheeseburger pero no mostraría filas con estos valores: lobster roll lettuce high amplitude (high amplitude incluye la substring “h am”, pero el filtro evalúa todos los caracteres, incluidos los espacios) Solo es válido para columnas String.	variable
doesNotContainSubstring	La columna no debe contener ninguna de las strings de la lista del filtro. Por ejemplo, un filtro doesNotContainSubstring con los valores ["ham", "cheese"] mostraría filas con este valor: lobster roll lettuce pero no mostraría filas con estos valores: hamhamburguesa cheesehamburguesa Solo es válido para columnas String.	variable
containsElement	La columna debe contener al menos uno de los valores de la lista del filtro. Solo es válido para columnas con tipos de datos de lista (como String list). Por ejemplo, en un informe campaign, un filtro containsElement con los siguientes valores: ["foo", "bar"] filtrar en la columna effectiveLabels solo mostraría campañas etiquetadas con foo, bar o ambos.	variable