Il parametro della stringa di query filters limita i dati restituiti
in un report dell'API AdSense Management. Quando utilizzi il parametro filters, fornisci 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 testata rispetto al filtro: se il filtro corrisponde, la riga viene conservata e, in caso contrario, viene eliminata.
- Codifica URL: le librerie client codificano automaticamente gli operatori di filtro. Tuttavia, se invii richieste direttamente al protocollo, devi codificare in modo esplicito gli operatori di filtro, come indicato nella tabella seguente.
- Priorità di filtro: l'applicazione di filtri viene eseguita prima di aggregare le dimensioni, in modo che le metriche restituite rappresentino il totale solo per le dimensioni pertinenti.
Sintassi dei filtri
Un singolo filtro utilizza il seguente modulo:
name operator expression
In questa sintassi:
- name: il nome della dimensione in base alla quale filtrare.
Ad esempio:
AD_CLIENT_IDfiltrerà in base all'ID cliente dell'annuncio. - operator: definisce il tipo di corrispondenza del filtro da utilizzare.
- expression: indica i valori inclusi nei risultati.
Tutte le dimensioni che si applicano alle metriche di cui viene generato il report possono essere utilizzate come filtri, ad eccezione delle dimensioni relative alla data (DATE, WEEK e MONTH). Per filtrare in base alla data, specifica invece l'intervallo di date 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 URL codificato | Esempio |
|---|---|---|---|
== |
Corrispondenza esatta | %3D%3D |
Metriche aggregate in cui il nome del paese è Canada:
filters=COUNTRY_NAME%3D%3DCanada |
=@ |
Contiene sottostringa | %3D@ |
Metriche aggregate in cui il nome del paese contiene Stati Uniti, che 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: i caratteri come
&devono essere codificati nell'URL normalmente. Le librerie client si occupano automaticamente di questo aspetto, quindi devi preoccuparti della codifica solo se effettui chiamate dirette al protocollo. - Caratteri riservati: la virgola e la barra rovesciata devono essere precedute da una barra rovesciata quando appaiono in un'espressione.
- barra rovesciata
\\ - virgola
\,
- barra rovesciata
Nota: assicurati di eseguire l'escape delle barre rovesciate prima delle virgole, per evitare doppi escape.
Combinazione di filtri
I filtri possono essere combinati utilizzando la logica booleana
OR e AND.
Logica OR
La logica di OR viene definita utilizzando una virgola (,) all'interno dell'espressione di filtro.
Esempio: (ciascuno deve essere codificato come URL)
Il codice paese è (US O UK):
COUNTRY_CODE==US,COUNTRY_CODE==UK
Logica AND
La logica di AND si ottiene fornendo più parametri di filtro,
il che significa fornire un array di filtri nelle librerie client.
Esempio:
Il codice paese è US E il codice prodotto è AFC:
filters=COUNTRY_CODE%3D%3DUS&filters=PRODUCT_CODE%3D%3DAFC
Combinare le logiche AND e OR
È possibile combinare la logica AND e OR in un'unica espressione.
Nota: ogni filtro viene valutato singolarmente prima di combinare tutti i filtri in un'espressione logica AND.
Esempio:
Il codice paese è (US O UK) E il codice prodotto è AFC:
filters=COUNTRY_CODE%3D%3DUS,COUNTRY_CODE%3D%3DUK&filters=PRODUCT_CODE%3D%3DAFC