Gefilterte Berichte

Die neue Search Ads 360 Reporting API ist jetzt verfügbar. Die neue API bietet mehr Flexibilität, um benutzerdefinierte Berichte zu erstellen und die Daten in Ihre Berichtsanwendungen und -prozesse zu integrieren. Weitere Informationen zur Migration zur neuen Search Ads 360 Reporting API und zu ihrer Verwendung

Standardmäßig enthält der Bericht alle Daten innerhalb des reportScope, den Sie in Ihrer Anfrage angeben. Wenn ein Bericht nur die Daten enthalten soll, die bestimmten Kriterien entsprechen, können Sie ihm einen oder mehrere Filter hinzufügen. Es werden nur Zeilen zurückgegeben, die alle Filter erfüllen.

Sie können beispielsweise einen Bericht zu allen Keywords in einer Agentur anfordern. Anschließend können Sie einen Filter angeben, sodass nur Keywords im Bericht erscheinen, deren Landingpage-URLs mit www.beispiel.de und www.andere-beispiel.de beginnen.

"filters": [
  {
    "column" : { "columnName": "keywordLandingPage" },
    "operator" : "startsWith",
    "values" : [
      "http://www.example.com",
      "http://www.another-example.com"
    ]
  }
]

Jeder Filter gibt eine zu filternde Spalte, einen Operator und eine Liste der Werte an, die in der angegebenen Spalte enthalten sein sollen:

"filters": [
  {
   "column" : column to filter on,
   "operator" : operator specifying the type of filter,
   "values" : list of values
  },
  { ... another filter can go here ... }
]

Hinweis: Einige Spalten können nicht gefiltert werden. In der Referenz zu Berichtstypen gibt jede Spalte an, ob sie Filterable ist.

Filteroperatoren

Bei allen Filtern wird zwischen Groß- und Kleinschreibung unterschieden. Ein Filter mit „www.Sprockets.com“ stimmt also nicht mit einer Spalte überein, die „www.sprockets.com“ enthält.

Betreiber	Beschreibung	Anzahl der unterstützten Werte
equals	Die Spalte muss genau mit dem angegebenen Wert übereinstimmen.	1
notEquals	Die Spalte darf nicht mit dem angegebenen Wert übereinstimmen.	1
in	Die Spalte muss genau mit einem der Werte in der Liste des Filters übereinstimmen. Nicht gültig für Listendatentypen (z. B. String list).	Variable
lessThan	Die Spalte muss einen Wert enthalten, der kleiner als der angegebene Wert ist. Wenn Sie diesen Filter für eine Boolean-Spalte angeben, konvertiert die Search Ads 360 API false in den numerischen Wert 0 und true in 1. Wenn Sie diesen Filter für eine String-Spalte angeben, vergleicht die API die lexikografische Reihenfolge. Nicht gültig für Listendatentypen (z. B. String list).	1
greaterThan	Die Spalte muss einen Wert enthalten, der größer als einer der Werte in der Liste des Filters ist. Wenn Sie diesen Filter für eine Boolean-Spalte angeben, konvertiert die API false in den numerischen Wert 0 und true in 1. Wenn Sie diesen Filter für eine String-Spalte angeben, vergleicht die API die lexikografische Reihenfolge. Nicht gültig für Listendatentypen (z. B. String list).	1
lessThanOrEqual	Die Spalte muss einen Wert enthalten, der kleiner oder gleich einem der Werte in der Filterliste ist. Wenn Sie diesen Filter für eine Boolean-Spalte angeben, konvertiert die API false in den numerischen Wert 0 und true in 1. Wenn Sie diesen Filter für eine String-Spalte angeben, vergleicht die API die lexikografische Reihenfolge. Nicht gültig für Listendatentypen (z. B. String list).	1
greaterThanOrEqual	Die Spalte muss einen Wert enthalten, der größer oder gleich einem der Werte in der Liste des Filters ist. Wenn Sie diesen Filter für eine Boolean-Spalte angeben, konvertiert die API false in den numerischen Wert 0 und true in 1. Wenn Sie diesen Filter für eine String-Spalte angeben, vergleicht die API die lexikografische Reihenfolge. Nicht gültig für Listendatentypen (z. B. String list).	1
isNull	Die Spalte muss leer sein. Wenn Sie beispielsweise isNull für die Spalte keywordMaxCpc in einem Keyword-Bericht angeben, enthält der Bericht nur Keywords, für die kein max. CPC angegeben ist.	0
isNotNull	Die Spalte muss einen Wert enthalten.	0
startsWith	Die Spalte muss mit einem der Strings in der Liste des Filters beginnen. Nur gültig für String Spalten.	Variable
containsSubstring	Die Spalte muss einen der in der Filterliste angegebenen Strings vollständig oder teilweise enthalten. Ein containsSubstring-Filter mit den Werten: ["ham", "cheese"] würde Zeilen mit diesem Wert zurückgeben: hamburger cheeseburger würde jedoch keine Zeilen mit diesen Werten zurückgeben: lobster roll lettuce high amplitude (high amplitude enthält den Teilstring „h am“, aber alle Zeichen – einschließlich Leerzeichen – werden vom Filter ausgewertet.) Nur gültig für String Spalten.	Variable
doesNotContainSubstring	Die Spalte darf keinen String enthalten, der in der Liste des Filters enthalten ist. Ein doesNotContainSubstring-Filter mit den Werten ["ham", "cheese"] würde beispielsweise Zeilen mit diesem Wert zurückgeben: lobster roll lettuce würde jedoch keine Zeilen mit diesen Werten zurückgeben: hamburger cheeseburger Nur gültig für String Spalten.	Variable
containsElement	Die Spalte muss mindestens einen der Werte in der Liste des Filters enthalten. Nur gültig für Spalten mit Listendatentypen (z. B. String list). In einem campaign-Bericht werden beispielsweise mit einem containsElement-Filter mit den folgenden Werten: ["foo", "bar"] nach der Spalte effectiveLabels nur Kampagnen zurückgegeben, die mit foo, bar oder beidem gekennzeichnet sind.	Variable