Applicazione dei filtri

Il parametro della stringa di query filters limita i dati restituiti in un report dell'API per la gestione di AdSense. Quando utilizzi il parametro filters, indica una dimensione in base alla quale applicare il filtro, seguita dall'espressione di filtro.

Le query filtrate limitano le righe che vengono incluse nel risultato. Ogni riga nel risultato viene testato rispetto al filtro: se il filtro corrisponde, la riga viene viene conservata e, se non corrisponde, la riga viene eliminata.

• Codifica URL: le librerie client codificano automaticamente gli operatori di filtro. Tuttavia, se invii richieste direttamente al protocollo, devi codificare esplicitamente gli operatori di filtro come indicato nella tabella seguente.
• Priorità di filtro: il filtro viene applicato prima di qualsiasi vengono aggregate, in modo che le metriche restituite rappresentino il totale solo per le dimensioni pertinenti.

Sintassi del filtro

Un singolo filtro utilizza il seguente formato:

name operator expression

Con questa sintassi:

• nome: il nome della dimensione in base alla quale filtrare. Ad esempio: AD_CLIENT_ID filtrerà in base all'ID cliente pubblicitario.
• operator: definisce il tipo di corrispondenza del filtro da utilizzare.
• expression: indica i valori inclusi nei risultati.

Tutte le dimensioni che alle metriche oggetto dei report possono essere utilizzati come filtri, con ad eccezione delle dimensioni relative alla data (DATE, WEEK, e MONTH). Per filtrare in base alla data, specifica il per il report.

Operatori di filtro

Esistono due operatori di filtro. Gli operatori devono essere codificati nell'URL per essere inclusi nelle stringhe di query dell'URL.

Operatore	Descrizione	Modulo con codifica URL	Esempio
==	Corrispondenza esatta	%3D%3D	Metriche aggregate in cui il nome del paese è Canada: filters=COUNTRY_NAME%3D%3DCanada
=@	Contiene una sottostringa	%3D@	Metriche aggregate in cui il nome del paese contiene Unito, questo corrisponde a Stati Uniti e Regno Unito, ad esempio: filters=COUNTRY_NAME%3D@United

Filtra espressioni

Esistono un paio di regole importanti per le espressioni di filtro:

• Caratteri riservati agli URL: caratteri come & deve essere codificato nell'URL come al solito. Librerie client eseguire l'operazione al posto tuo, quindi dovrai preoccuparti della codifica solo se quando effettui chiamate dirette al protocollo.
• Caratteri riservati: la virgola e la barra rovesciata devono possono essere preceduti da una barra rovesciata quando appaiono in un'espressione.
  • barra rovesciata \\
  • virgola \,

Nota: assicurati di eseguire l'escape delle barre rovesciate prima per evitare doppi caratteri di escape.

Combinazione di filtri

I filtri possono essere combinati utilizzando i valori booleani OR e AND logica.

Logica OR

La logica OR viene definita utilizzando una virgola (,) all'interno della sezione l'espressione di filtro.

Logica AND

La logica AND si ottiene fornendo più parametri di filtro, il che significa fornire un array di filtri nelle librerie client.

Combinazione di logiche AND e OR

È possibile combinare la logica AND e OR in un'unica espressione.

Nota: ogni filtro viene valutato singolarmente prima che tutti i filtri vengano combinati in un'espressione logica AND.

Passaggi successivi

• Scelta della dimensione giusta
• Eseguire report di grandi dimensioni
• Elenco di metriche e dimensioni