Mit dem Abfragestringparameter filters
werden die in einem Bericht der AdSense Management API zurückgegebenen Daten eingeschränkt. Mit dem Parameter filters
geben Sie eine Dimension, nach der gefiltert werden soll, gefolgt vom Filterausdruck an.
Gefilterte Abfragen schränken die Zeilen ein, die in das Ergebnis einbezogen werden. Jede Zeile im Ergebnis wird anhand des Filters geprüft: Wenn der Filter übereinstimmt, wird die Zeile beibehalten, und falls sie nicht übereinstimmt, wird die Zeile gelöscht.
- URL-Codierung: Mit den Client-Bibliotheken werden die Filteroperatoren automatisch codiert. Wenn Sie jedoch Anfragen direkt an das Protokoll senden, müssen Sie Filteroperatoren explizit codieren, wie in der folgenden Tabelle angegeben.
- Filterpriorität: Die Filterung wird vor der Zusammenfassung von Dimensionen durchgeführt. Die zurückgegebenen Messwerte stellen also nur die Gesamtsumme für die relevanten Dimensionen dar.
Filtersyntax
Für einen einzelnen Filter wird folgendes Format verwendet:
name operator expression
In dieser Syntax gilt:
- name – Der Name der Dimension, nach der gefiltert werden soll.
Beispiel: Mit
AD_CLIENT_ID
wird nach der Ad-Client-ID gefiltert. - operator – Hiermit wird der zu verwendende Typ der Filterübereinstimmung definiert.
- expression – gibt die in den Ergebnissen enthaltenen Werte an.
Alle Dimensionen, die für die Messwerte gelten, können als Filter verwendet werden, mit Ausnahme der datumsbezogenen Dimensionen DATE
, WEEK
und MONTH
. Wenn Sie nach Datum filtern möchten, geben Sie stattdessen den Zeitraum für den Bericht an.
Filteroperatoren
Es gibt zwei Filteroperatoren. Die Operatoren müssen URL-codiert sein, um in URL-Abfragestrings eingefügt zu werden.
Betreiber | Beschreibung | URL-codiertes Formular | Beispiel |
---|---|---|---|
== |
Genaue Übereinstimmung | %3D%3D |
Zusammengefasste Messwerte, bei denen der Ländername Kanada ist:
filters=COUNTRY_NAME%3D%3DCanada |
=@ |
Enthält Teilstring | %3D@ |
Zusammengefasste Messwerte, bei denen der Ländername United enthält. Dies entspricht den USA und „Vereinigtes Königreich“, z. B.:
filters=COUNTRY_NAME%3D@United |
Filterausdrücke
Für Filterausdrücke gibt es einige wichtige Regeln:
- Zeichen mit URL-Reservierung: Zeichen wie
&
müssen wie gewohnt URL-codiert werden. Clientbibliotheken übernehmen dies für Sie. Sie müssen sich also nur um die Codierung kümmern, wenn Sie direkte Aufrufe an das Protokoll senden. - Reservierte Zeichen: Komma und umgekehrter Schrägstrich müssen mit Escape-Zeichen versehen sein, wenn sie in einem Ausdruck verwendet werden.
- Umgekehrter Schrägstrich
\\
- Komma
\,
- Umgekehrter Schrägstrich
Hinweis : Backslashes vor Kommas müssen mit Escape-Zeichen versehen werden, um doppelte Escape-Zeichen zu vermeiden.
Filter kombinieren
Filter können mithilfe der booleschen Operatoren OR
und AND
kombiniert werden.
ODER-Logik
OR
-Logik wird durch ein Komma (,
) im Filterausdruck definiert.
Beispiel: (jeweils URL-Codierung erforderlich)
Ländercode ist entweder (USA ODER Vereinigtes Königreich):
COUNTRY_CODE==US,COUNTRY_CODE==UK
AND-Logik
Bei der AND
-Logik werden mehrere Filterparameter angegeben. Dies entspricht der Angabe eines Arrays mit Filtern in den Clientbibliotheken.
Example:
Ländercode ist US UND Produktcode ist AFC:
filters=COUNTRY_CODE%3D%3DUS&filters=PRODUCT_CODE%3D%3DAFC
UND- und ODER-Logik kombinieren
Es ist möglich, AND- und OR-Logik in einem einzigen Ausdruck zu kombinieren.
Hinweis : Jeder Filter wird einzeln beurteilt, bevor alle Filter zu einem Ausdruck mit AND-Logik kombiniert werden.
Example:
Ländercode ist (US ODER UK) UND Produktcode ist AFC:
filters=COUNTRY_CODE%3D%3DUS,COUNTRY_CODE%3D%3DUK&filters=PRODUCT_CODE%3D%3DAFC