Informes filtrados

Ya está disponible la nueva API de Search Ads 360 Reporting. La nueva API proporciona Flexibilidad mejorada para crear informes personalizados e integrar los datos en sus aplicaciones de informes y procesos. Más información sobre cómo migrar a la nueva experiencia de Search Ads 360 Reporting y cómo usarla API

De forma predeterminada, tu informe contendrá todos los datos dentro de reportScope que que se especifica en tu solicitud. Si desea que un informe contenga solo los datos que coincidan con un conjunto puedes agregar uno o más filtros a un informe. Solo las filas que satisfacen todos los filtros un resultado de la consulta.

Por ejemplo, puede solicitar un informe de todas las palabras clave en una agencia. Después Puedes especificar un filtro para que solo las palabras clave con URLs de página de destino comiencen con www.example.com y www.otro-ejemplo.com aparecen en el informe.

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

Cada filtro especifica una columna para 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.Sprockets.com" no coincidirán una columna que contenga "www.sprockets.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 que sea menor que el valor especificado.

Si especificas este filtro para una columna Boolean, la API de Search Ads 360 convertirá false. a un valor numérico de 0 y de true a 1. Si especificas este filtro para una columna String, la API compara la 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 que sea mayor que uno de los valores en la lista de filtros.

Si especificas este filtro para una columna Boolean, la API convierte false. a un valor numérico de 0 y de true a 1. Si especificas este filtro para una columna String, la API compara la 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 que sea menor o igual que uno de los valores en la lista del filtro.

Si especificas este filtro para una columna Boolean, la API convierte false. a un valor numérico de 0 y de true a 1. Si especificas este filtro para una columna String, la API compara la 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 que sea mayor o igual que uno de los valores en la lista del filtro.

Si especificas este filtro para una columna Boolean, la API convierte false. a un valor numérico de 0 y de true a 1. Si especificas este filtro para una columna String, la API compara la 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 de un informe de palabras clave, el informe contendrá solo las palabras clave que no especificaron un CPC máximo. 0
isNotNull La columna debe contener un valor. 0
startsWith

La columna debe comenzar con una de las cadenas de la lista del filtro.

Solo es válido para String columnas.

variable
containsSubstring

La columna debe contener la totalidad o parte de una de las cadenas especificadas en el en la lista de filtros.

Por ejemplo, un filtro containsSubstring con los valores:
["ham", "cheese"]
devolvería filas con este valor:
hamburger
cheeseburger

pero no mostraría filas con estos valores:
lobster roll
lettuce
high amplitude (high amplitude incluye la subcadena "h am", pero el filtro evalúa todos los caracteres, incluidos los espacios)

Solo es válido para String columnas.

variable
doesNotContainSubstring

La columna no debe contener ninguna de las cadenas de la lista de filtros.

Por ejemplo, un filtro doesNotContainSubstring con los valores:
["ham", "cheese"]
devolvería filas con este valor:
lobster roll
lettuce

pero no mostraría filas con estos valores:
hamburguesa
hamburguesa con queso

Solo es válido para String columnas.

variable
containsElement

La columna debe contener al menos uno de los valores de la lista de filtros. 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 valores
["foo", "bar"]
filtrando la columna effectiveLabels solo mostrará campañas etiquetadas con foo, bar o ambos.

variable