Wird gefiltert

Der Abfragestringparameter filters schränkt die zurückgegebenen Daten ein in einem Bericht der AdSense-Verwaltungs-API. Wenn Sie den Parameter filters verwenden, Dimension, nach der gefiltert werden soll, gefolgt vom Filterausdruck an.

Mit gefilterten Abfragen werden die Zeilen eingeschränkt, die im Ergebnis enthalten sind. Jede Zeile im Ergebnis wird anhand des Filters geprüft: Wenn der Filter übereinstimmt, wird die Zeile beibehalten. Wenn sie nicht übereinstimmt, wird die Zeile gelöscht.

  • URL-Codierung: Mit den Client-Bibliotheken wird die die Filteroperatoren. Wenn Sie jedoch direkte Anfragen an das Protokoll senden, müssen Sie Filteroperatoren explizit codieren, wie in der folgenden Tabelle angegeben.
  • Filterpriorität: Das Filtern wird vor der Dimensionen zusammengefasst werden, sodass die zurückgegebenen Messwerte den Gesamtwert nur für die relevanten Dimensionen.

Filtersyntax

Für einen einzelnen Filter wird das folgende Format verwendet:

name operator expression

In dieser Syntax gilt:

  • name – Der Name der Dimension, nach der gefiltert werden soll. Beispiel: AD_CLIENT_ID filtert nach der Ad-Client-ID.
  • operator – Hiermit wird der zu verwendende Typ der Filterübereinstimmung definiert.
  • expression – Hiermit werden die in den Ergebnissen enthaltenen Werte angegeben.

Alle Dimensionen, die die auf die Messwerte im Bericht zutreffen, können als Filter verwendet werden. mit Ausnahme der datumsbezogenen Dimensionen (DATE, WEEK, und MONTH). Um nach Datum zu filtern, geben Sie das Ereignis Zeitraum für den Bericht.

Operatoren filtern

Es gibt zwei Filteroperatoren. Die Operatoren müssen URL-codiert sein, um in URL-Abfragestrings enthalten sein.

Operator Beschreibung URL-codiertes Format Beispiel
== Genaue Übereinstimmung %3D%3D Zusammengefasste Messwerte, bei denen der Ländername Canada lautet:
filters=COUNTRY_NAME%3D%3DCanada
=@ Enthält Teilstring %3D@ Zusammengefasste Messwerte, bei denen der Ländername United enthält, also stimmt überein mit Deutschland und Vereinigtes Königreich. Beispiel:
filters=COUNTRY_NAME%3D@United

Filterausdrücke

Für Filterausdrücke gelten einige wichtige Regeln:

  • Zeichen mit URL-Reservierung – Zeichen wie & muss wie gewohnt URL-codiert werden. Clientbibliotheken dies für Sie erledigen. Sie müssen sich also nur um die Codierung kümmern, rufen Sie das Protokoll direkt auf.
  • Reservierte Zeichen – Komma und umgekehrter Schrägstrich müssen müssen mit Escape-Zeichen versehen sein, wenn sie in einem Ausdruck vorkommen.
    • umgekehrter Schrägstrich \\
    • Komma \,

Hinweis: Stellen Sie sicher, dass Sie vor umgekehrten Schrägstrichen Escape-Zeichen verwenden, Kommas zu setzen, um doppelte Escape-Zeichen zu vermeiden.

Kombinieren von Filtern

Filter können mit den booleschen Werten OR und AND kombiniert werden Logik.

ODER-Logik

Die OR-Logik wird durch ein Komma (,) im Filterausdruck.

Beispiel:(jeweils URL-Codierung erforderlich)

Ländercode ist entweder (US ODER UK):
COUNTRY_CODE==US,COUNTRY_CODE==UK

UND-Logik

Bei der AND-Logik werden mehrere Filterparameter angegeben. was zur Bereitstellung eines Arrays mit Filtern in den Clientbibliotheken führt.

Beispiel:

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 vereint werden.

Beispiel:

Ländercode ist (US OR UK) UND Produktcode ist AFC:
filters=COUNTRY_CODE%3D%3DUS,COUNTRY_CODE%3D%3DUK&filters=PRODUCT_CODE%3D%3DAFC

Nächste Schritte