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 ... } ]
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 |
zmienna |
lessThan |
Kolumna musi zawierać wartość mniejszą od określonej wartości.
Jeśli określisz ten filtr w kolumnie Nie dotyczy typów danych list (takich jak |
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
Nie dotyczy typów danych list (takich jak |
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
Nie dotyczy typów danych list (takich jak |
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
Nie dotyczy typów danych list (takich jak |
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 |
zmienna |
containsSubstring |
Kolumna musi zawierać całość lub część jednego z ciągów określonych na liście filtra.
Na przykład filtr
ale nie zwróci wierszy z tymi wartościami:
Dotyczy tylko kolumn |
zmienna |
doesNotContainSubstring |
Kolumna nie może zawierać żadnego z ciągów z listy filtra.
Na przykład filtr ale nie zwróci wierszy z tymi wartościami:
Dotyczy tylko kolumn |
zmienna |
containsElement |
Kolumna musi zawierać co najmniej 1 wartość z listy filtra.
Dotyczy tylko kolumn z typami danych typu lista (np.
Na przykład w raporcie |
zmienna |