Filtrowane raporty

Nowy interfejs Search Ads 360 Reporting API jest już dostępny. Nowy interfejs API zapewnia większa elastyczność tworzenia raportów niestandardowych i integrowania danych z aplikacjami służącymi do raportowania. i procesach. Więcej informacji o przechodzeniu do nowej wersji Search Ads 360 Raportowanie i korzystaniu z niej API.

Domyślnie raport będzie zawierał wszystkie dane z zakresu reportScope, które które określa żądanie. Jeśli chcesz, aby raport zawierał tylko dane pasujące do zbioru kryteria, możesz dodać do raportu jeden lub więcej filtrów. Tylko wiersze pasujące do wszystkich filtrów .

Możesz na przykład poprosić o raport obejmujący wszystkie słowa kluczowe w agencji. Potem możesz zastosować filtr, tak by tylko słowa kluczowe, których adresy URL stron docelowych zaczynają się od W raporcie pojawią się www.example.com i www.another-example.com.

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

Każdy filtr zawiera kolumnę do filtrowania, operator i listę wartości, powinny znajdować się 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 sekcji Typy raportów każda kolumna wskazuje jeśli jest to Filterable.

Filtruj operatory

We wszystkich filtrach rozróżniana jest wielkość liter. Oznacza to, że filtr z adresem „www.Sprockets.com” nie pasuje kolumnę zawierającą „www.sprockets.com”.

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

Kolumna musi dokładnie odpowiadać jednej z wartości na liście filtra.

Nie dotyczy typów danych list (np. String list).

zmienna
lessThan

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

Jeśli określisz ten filtr dla kolumny Boolean, interfejs Search Ads 360 API zmieni wartość false. na wartość liczbową 0 i od true do 1. Jeśli określisz ten filtr dla kolumny String, interfejs API porówna porządek leksykograficzny.

Nie dotyczy typów danych list (np. String list).

 1
greaterThan

Kolumna musi zawierać wartość, która jest większa niż jedna z wartości na liście filtru.

Jeśli określisz ten filtr dla kolumny Boolean, interfejs API przekonwertuje wartość false na wartość liczbową 0 i od true do 1. Jeśli określisz ten filtr dla kolumny String, interfejs API porówna porządek leksykograficzny.

Nie dotyczy typów danych list (np. String list).

1
lessThanOrEqual

Kolumna musi zawierać wartość mniejszą lub równą jednej z na liście filtra.

Jeśli określisz ten filtr dla kolumny Boolean, interfejs API przekonwertuje wartość false na wartość liczbową 0 i od true do 1. Jeśli określisz ten filtr dla kolumny String, interfejs API porówna porządek leksykograficzny.

Nie dotyczy typów danych list (np. String list).

1
greaterThanOrEqual

Kolumna musi zawierać wartość większą lub równą jednej z na liście filtra.

Jeśli określisz ten filtr dla kolumny Boolean, interfejs API przekonwertuje wartość false na wartość liczbową 0 i od true do 1. Jeśli określisz ten filtr dla kolumny String, interfejs API porówna porządek leksykograficzny.

Nie dotyczy typów danych list (np. String list).

1
isNull Kolumna musi być pusta. Jeśli na przykład wpiszesz isNull dla kolumny keywordMaxCpc w raporcie słów kluczowych, będzie zawierać tylko słowa kluczowe, dla których nie określono maks. 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.

Prawidłowy tylko dla String kolumn.

zmienna
containsSubstring

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

Na przykład filtr containsSubstring z wartościami:
["ham", "cheese"]
zwróci wiersze z tą 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 wszystkie znaki – w tym spacje – są oceniane przez filtr).

Prawidłowy tylko dla String kolumn.

zmienna
doesNotContainSubstring

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

Na przykład filtr doesNotContainSubstring z wartościami:
["ham", "cheese"]
zwróci wiersze z tą wartością:

lobster roll lettuce

, ale nie zwróci wierszy z tymi wartościami:
hamburger
burger ser

Prawidłowy tylko dla String kolumn.

zmienna
containsElement

Kolumna musi zawierać co najmniej jedną wartość z listy filtra. Prawidłowy tylko w przypadku 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 oznaczone etykietą foo, bar lub obie.

zmienna