Relatórios filtrados

A nova API Search Ads 360 Reporting já está disponível. A nova API oferece mais flexibilidade para criar relatórios personalizados e integrar os dados aos seus aplicativos de geração de relatórios e processos. Saiba mais sobre como migrar e usar os novos relatórios do Search Ads 360 API.

Por padrão, seu relatório conterá todos os dados dentro do reportScope que especificado pela solicitação. Se você quiser que um relatório contenha apenas os dados que correspondem a um conjunto de critérios, você pode adicionar um ou mais filtros a um relatório. Somente as linhas que atendem a todos os filtros são retornadas.

Por exemplo, é possível solicitar um relatório de todas as palavras-chave de uma agência. Depois, especifique um filtro para que somente as palavras-chave com URLs da página de destino que comecem com www.example.com e www.another-example.com aparecerão no relatório.

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

Cada filtro especifica uma coluna a ser filtrada, um operador e uma lista de valores que devem estar na coluna especificada:

"filters": [
  {
   "column" : column to filter on,
   "operator" : operator specifying the type of filter,
   "values" : list of values
  },
  { ... another filter can go here ... }
]
Observação: não é possível filtrar algumas colunas. Na referência Tipos de relatório, cada coluna indica se for Filterable.

Operadores de filtro

Todos os filtros diferenciam maiúsculas de minúsculas. Ou seja, um filtro com "www.Sprockets.com" não correspondem uma coluna que contenha "www.sprockets.com".

Operador Descrição Número de valores compatíveis
equals A coluna precisa corresponder exatamente ao valor especificado. 1
notEquals A coluna não pode corresponder ao valor especificado. 1
in

A coluna precisa corresponder exatamente a um dos valores na lista do filtro.

Não é válido para tipos de dados de lista (como String list).

variável
lessThan

A coluna precisa conter um valor menor que o especificado.

Se você especificar este filtro para uma coluna Boolean, a API Search Ads 360 converterá false. como um valor numérico de 0 e true a 1. Se você especificar esse filtro para uma coluna String, a API vai comparar o ordem lexicográfica.

Não é válido para tipos de dados de lista (como String list).

1
greaterThan

A coluna deve conter um valor maior que um dos valores em à lista do filtro.

Se você especificar esse filtro para uma coluna Boolean, a API converterá false. como um valor numérico de 0 e true a 1. Se você especificar esse filtro para uma coluna String, a API vai comparar o ordem lexicográfica.

Não é válido para tipos de dados de lista (como String list).

1
lessThanOrEqual

A coluna deve conter um valor menor ou igual a um dos valores na lista do filtro.

Se você especificar esse filtro para uma coluna Boolean, a API converterá false. como um valor numérico de 0 e true a 1. Se você especificar esse filtro para uma coluna String, a API vai comparar o ordem lexicográfica.

Não é válido para tipos de dados de lista (como String list).

1
greaterThanOrEqual

A coluna deve conter um valor maior ou igual a um dos valores na lista do filtro.

Se você especificar esse filtro para uma coluna Boolean, a API converterá false. como um valor numérico de 0 e true a 1. Se você especificar esse filtro para uma coluna String, a API vai comparar o ordem lexicográfica.

Não é válido para tipos de dados de lista (como String list).

1
isNull A coluna precisa estar vazia. Por exemplo, se você especificar isNull para a coluna keywordMaxCpc em um relatório de palavras-chave, o relatório conterá apenas palavras-chave que não especificaram um CPC máx. 0
isNotNull A coluna precisa conter um valor. 0
startsWith

A coluna precisa começar com uma das strings da lista do filtro.

Válido apenas para colunas String.

variável
containsSubstring

A coluna deve conter todas ou parte de uma das strings especificadas no na lista do filtro.

Por exemplo, um filtro containsSubstring com os valores:
["ham", "cheese"] e
retornaria linhas com este valor:
hamburger e
cheeseburger

mas não retornaria linhas com estes valores:
lobster roll
lettuce e
high amplitude (high amplitude inclui a substring "h am", mas todos os caracteres, incluindo espaços, são avaliados pelo filtro

Válido apenas para colunas String.

variável
doesNotContainSubstring

A coluna não pode conter nenhuma das strings da lista do filtro.

Por exemplo, um filtro doesNotContainSubstring com os valores:
["ham", "cheese"] e
retornaria linhas com este valor:
lobster roll e
lettuce

mas não retornaria linhas com estes valores:
hambúrguer
hambúrguer de queijo

Válido apenas para colunas String.

variável
containsElement

A coluna precisa conter pelo menos um dos valores na lista do filtro. Válido apenas para colunas com tipos de dados de lista (como String list).

Por exemplo, em um relatório campaign, um filtro containsElement com os valores:
["foo", "bar"] (
) filtrando a coluna effectiveLabels retornaria somente campanhas rotuladas com foo, bar ou ambos.

variável