Filtrowane raporty

Dostępny jest już nowy interfejs Search Ads 360 Reporting API. Nowy interfejs API daje większą swobodę tworzenia raportów niestandardowych oraz integrowania danych z aplikacjami i procesami służącymi do raportowania. Dowiedz się więcej o przechodzeniu na nowy interfejs Search Ads 360 Reporting API i jego używaniu.

Domyślnie raport zawiera wszystkie dane z zakresu reportScope określone w żądaniu. Jeśli chcesz, aby raport zawierał tylko te dane, które spełniają określone kryteria, możesz dodać do niego 1 filtr lub więcej. Zwracane są tylko wiersze, które spełniają wszystkie filtry.

Możesz na przykład poprosić o raport dotyczący wszystkich słów kluczowych w agencji. Następnie możesz określić filtr, aby w raporcie pojawiały się tylko słowa kluczowe z adresami URL stron docelowych rozpoczynającymi się od www.example.com i www.inny-example.com.

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

Każdy filtr określa kolumnę do przefiltrowania, operator i listę wartości, które powinny się znajdować w określonej kolumnie:

"filters": [
  {
   "column" : column to filter on,
   "operator" : operator specifying the type of filter,
   "values" : list of values
  },
  { ... another filter can go here ... }
]
Uwaga: niektórych kolumn nie można filtrować. W opisie typów raportów każda kolumna wskazuje, czy należy do kategorii Filterable.

Filtruj operatory

We wszystkich filtrach rozróżniana jest wielkość liter. Oznacza to, że filtr z wartością „www.Sprockets.com” nie pasuje do kolumny zawierającej „www.sprockets.com”.

Operator Opis Liczba obsługiwanych wartości
equals Kolumna musi dokładnie odpowiadać określonej wartości. 1
notEquals Kolumna nie może odpowiadać określonej wartości. 1
in

Kolumna musi być dokładnie taka sama jak jedna z wartości na liście filtra.

Nie dotyczy typów danych list (takich jak String list).

zmienna
lessThan

Kolumna musi zawierać wartość mniejszą od określonej wartości.

Jeśli określisz ten filtr w kolumnie Boolean, interfejs API Search Ads 360 zmieni false na wartość liczbową 0 i true na 1. Jeśli określisz ten filtr w kolumnie String, interfejs API porówna kolejność leksykograficzną.

Nie dotyczy typów danych list (takich jak String list).

 1
greaterThan

Kolumna musi zawierać wartość większą niż jedną z wartości na liście filtra.

Jeśli określisz ten filtr w kolumnie Boolean, interfejs API konwertuje false na wartość liczbową 0 i true na 1. Jeśli określisz ten filtr w kolumnie String, interfejs API porówna kolejność leksykograficzną.

Nie dotyczy typów danych list (takich jak String list).

1
lessThanOrEqual

Kolumna musi zawierać wartość, która jest mniejsza lub równa jednej z wartości na liście filtra.

Jeśli określisz ten filtr w kolumnie Boolean, interfejs API konwertuje false na wartość liczbową 0 i true na 1. Jeśli określisz ten filtr w kolumnie String, interfejs API porówna kolejność leksykograficzną.

Nie dotyczy typów danych list (takich jak String list).

1
greaterThanOrEqual

Kolumna musi zawierać wartość równa jednej z wartości na liście filtra lub większa.

Jeśli określisz ten filtr w kolumnie Boolean, interfejs API konwertuje false na wartość liczbową 0 i true na 1. Jeśli określisz ten filtr w kolumnie String, interfejs API porówna kolejność leksykograficzną.

Nie dotyczy typów danych list (takich jak String list).

1
isNull Kolumna musi być pusta. Jeśli np. w kolumnie keywordMaxCpc w raporcie słów kluczowych podasz isNull, raport będzie zawierał tylko te słowa kluczowe, które nie mają określonego maksymalnego CPC. 0
isNotNull Kolumna musi zawierać wartość. 0
startsWith

Kolumna musi zaczynać się od jednego z ciągów znaków na liście filtra.

Dotyczy tylko kolumn String.

zmienna
containsSubstring

Kolumna musi zawierać całość lub część jednego z ciągów określonych na liście filtra.

Na przykład filtr containsSubstring z wartościami:
["ham", "cheese"]
zwróci wiersze o takiej wartości:
hamburger
cheeseburger

ale nie zwróci wierszy z tymi wartościami:
lobster roll
lettuce
high amplitude (high amplitude zawiera podłańcuch „h am”, ale filtr ocenia wszystkie znaki, w tym spacje)

Dotyczy tylko kolumn String.

zmienna
doesNotContainSubstring

Kolumna nie może zawierać żadnego z ciągów z listy filtra.

Na przykład filtr doesNotContainSubstring z wartościami:
["ham", "cheese"]
zwróci wiersze o takiej wartości:
lobster roll
lettuce

ale nie zwróci wierszy z tymi wartościami:
hamburger
serburger

Dotyczy tylko kolumn String.

zmienna
containsElement

Kolumna musi zawierać co najmniej 1 wartość z listy filtra. Dotyczy tylko kolumn z typami danych typu lista (np. String list).

Na przykład w raporcie campaign filtr containsElement z wartościami:
["foo", "bar"]
Filtrowanie w kolumnie effectiveLabels zwróci tylko kampanie z etykietą foo, bar lub z obydwiema tymi wartościami.

zmienna