Filtros avançados do clipping

O filter do querySpec publica no esquema o núcleo — channels, sentiment, sources, text, extractedEntity, extractedEntityStance e attribution. Os campos abaixo funcionam igual e só não são listados no manifesto, por peso. Alguns valem em qualquer canal (uf, locality, country, category, program, author, lang); os demais são do clipping.

Envie-os normalmente dentro de querySpec.filter.

Campo	O que recorta
tier	Relevância do veículo na régua do cliente: 1 maior, 2 média, 3 regional/nicho. Só o clipping tem.
uf, locality, country	Estado, praça e país do veículo.
category, program, author, lang	Editoria, programa (rádio/TV), assinatura e idioma.
vehicleType	Tipo dentro do clipping (Impresso, Online, Rádio, TV). É assim que se recorta canal dentro da base do cliente — o canal monitoring já contém todos eles.
project, subject	Projeto e assunto que a operação de clipping atribuiu à matéria.
evaluation, clientTone	A avaliação da equipe do cliente. evaluation junta valores com " + " quando a matéria tem várias associações; clientTone é o companheiro de vocabulário fechado, utilizável como categoria.
motivation	Espontânea (iniciativa do veículo) × provocada (fruto da assessoria).
associationWeight	Peso da marca na matéria (Alto, Medio, Baixo, Nenhum) — separa a capa da menção de passagem.
keywords	A palavra monitorada que trouxe a matéria ao clipping. Casa por pertencimento: matéria trazida por duas palavras entra nos dois recortes.
customFields	Marcador da taxonomia do próprio cliente, no formato "Campo: valor" — o nome do campo vai junto porque clientes diferentes definem campos diferentes.
verified	Se a equipe do cliente conferiu a matéria. Valores como o provedor os grava; matéria sem o dado não casa nenhum dos dois — ausência não é false.

Duas armadilhas que valem repetir

Valor que não existe devolve zero SEM erro. Quase todos estes campos casam a grafia sozinhos (maiúscula, acento e pontuação ignorados). Quatro não: tier, lang, clientTone e verified exigem o valor exato como a conta o grava — copie-o de uma consulta antes de filtrar. E um valor que a conta não usa simplesmente não casa nada — e zero se lê como "não houve", quando era "não existe com esse nome". Consulte os valores que a base tem antes de recortar.

"Nenhuma" em evaluation significa NÃO AVALIADA, nunca "neutra". São coisas diferentes: a primeira é ausência de juízo, a segunda é um juízo.

Exemplo

{
  "querySpec": {
    "id": "capa-tier-1",
    "measures": ["unique", "nrs"],
    "filter": { "tier": ["1"], "associationWeight": ["Alto"], "motivation": ["Espontânea"] },
    "groupBy": ["source"]
  }
}

Veja também

Consultas avançadas (baldes, médias e projeção de campos) e Fontes de Dados (o que a base do Monitoring cobre).