Gefilterte Berichte

Die neue Search Ads 360 Reporting API ist jetzt verfügbar. Die neue API bietet Mehr Flexibilität bei der Erstellung benutzerdefinierter Berichte und Integration der Daten in Ihre Berichtsanwendungen und Prozesse. Weitere Informationen zur Migration zur neuen Search Ads 360-Berichterstellung und deren Verwendung API hinzu.

Standardmäßig enthält ein Bericht alle Daten im reportScope, die in Ihrer Anfrage angegeben sind. Wenn ein Bericht nur Daten enthalten soll, Kriterien, können Sie einem Bericht einen oder mehrere Filter hinzufügen. Nur Zeilen, die alle Filter erfüllen zurückgegeben.

Sie können beispielsweise einen Bericht über alle Keywords in einer Agentur anfordern. Dann können Sie einen Filter festlegen, sodass nur Keywords, deren Landingpage-URLs mit www.beispiel.de und www.andere-beispielurl.de werden im Bericht angezeigt.

"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 von Werten an, in der angegebenen Spalte enthalten sein müssen:

"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 den Berichtstypen gibt jede Spalte wenn Filterable.

Operatoren filtern

Bei allen Filtern wird zwischen Groß- und Kleinschreibung unterschieden. Das heißt, ein Filter mit „www.Sprockets.com“ stimmt nicht überein mit eine Spalte, die „www.sprockets.com“ enthält.

Operator 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 Filterliste übereinstimmen.

Nicht gültig für Listendatentypen (z. B. String list).

variabel
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 einen numerischen Wert von 0 und true auf 1. Wenn diesen Filter für eine String-Spalte angeben, vergleicht die API die der lexikografischen Ordnung.

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 in der Filterliste.

Wenn Sie diesen Filter für eine Boolean-Spalte angeben, konvertiert die API false in einen numerischen Wert von 0 und true auf 1. Wenn diesen Filter für eine String-Spalte angeben, vergleicht die API die der lexikografischen Ordnung.

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 anzeigen.

Wenn Sie diesen Filter für eine Boolean-Spalte angeben, konvertiert die API false in einen numerischen Wert von 0 und true auf 1. Wenn diesen Filter für eine String-Spalte angeben, vergleicht die API die der lexikografischen Ordnung.

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 Filterliste anzeigen.

Wenn Sie diesen Filter für eine Boolean-Spalte angeben, konvertiert die API false in einen numerischen Wert von 0 und true auf 1. Wenn diesen Filter für eine String-Spalte angeben, vergleicht die API die der lexikografischen Ordnung.

Nicht gültig für Listendatentypen (z. B. String list).

1
isNull Die Spalte muss leer sein. Wenn Sie beispielsweise isNull angeben, für die Spalte keywordMaxCpc in einem Keyword-Bericht wird der Bericht enthält 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.

variabel
containsSubstring

Die Spalte muss eine der Zeichenfolgen, die in der Filterliste.

Beispielsweise ein containsSubstring-Filter mit den folgenden Werten:
["ham", "cheese"]
würde Zeilen mit folgendem Wert zurückgeben:
hamburger
cheeseburger

würde jedoch keine Zeilen mit diesen Werten zurückgeben:
lobster roll
lettuce
high amplitude (high amplitude umfasst der Teilstring „h am“, aber alle Zeichen – einschließlich Leerzeichen – werden vom Filter ausgewertet)

Nur gültig für String Spalten.

variabel
doesNotContainSubstring

Die Spalte darf keinen String in der Liste des Filters enthalten.

Beispielsweise ein doesNotContainSubstring-Filter mit den Werten:
["ham", "cheese"]
würde Zeilen mit folgendem 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.

variabel
containsElement

Die Spalte muss mindestens einen der Werte in der Filterliste enthalten. Nur gültig für Spalten mit Listendatentypen (z. B. String list).

Beispiel: In einem campaign-Bericht Einen containsElement-Filter mit den folgenden Werten:

["foo", "bar"] Nach der Spalte effectiveLabels filtern nur Kampagnen mit dem Label foo, bar oder beidem zurückgegeben.

variabel