Wird gefiltert

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 \,

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

Nächste Schritte