Ta strona została przetłumaczona przez Cloud Translation API.

Filtrowanie

Parametr ciągu zapytania filters ogranicza dane zwracane w raporcie interfejsu AdSense Management API. Gdy używasz parametru filters, musisz podać wymiar, według którego chcesz filtrować, a po nim wyrażenie filtra.

Odfiltrowane zapytania ograniczają liczbę wierszy uwzględnianych w wyniku. Każdy wiersz w wyniku jest sprawdzany pod kątem filtra: jeśli filtr pasuje, wiersz zostaje zachowany, a jeśli nie pasuje, wiersz jest usuwany.

Kodowanie adresów URL: biblioteki klienta automatycznie kodują operatory filtrów. Jeśli jednak wysyłasz żądania bezpośrednio do protokołu, musisz wyraźnie zakodować operatory filtra zgodnie z tabelą poniżej.
Priorytet filtrowania: filtrowanie odbywa się przed agregacją wymiarów. Dzięki temu zwracane dane reprezentują sumę tylko w przypadku odpowiednich wymiarów.

Składnia filtra

Pojedynczy filtr ma postać:

name operator expression

Według tej składni:

nazwa – nazwa wymiaru, według którego ma być filtrowany. Na przykład: AD_CLIENT_ID będzie filtrować wyniki według identyfikatora klienta reklamy.
operator – określa typ dopasowania filtra, którego należy użyć.
wyrażenie – wartości uwzględnione w wynikach.

Jako filtry możesz używać wszystkich wymiarów, które mają zastosowanie do danych w raportach, z wyjątkiem wymiarów związanych z datą (DATE, WEEK i MONTH). Aby filtrować według daty, określ zakres dat raportu.

Filtruj operatory

Dostępne są 2 operatory filtra. Aby operatory zostały uwzględnione w ciągach zapytań adresu URL, muszą być zakodowane na potrzeby adresu URL.

Operator	Opis	Formularz zakodowany w adresie URL	Przykład
`==`	Dopasowanie ścisłe	`%3D%3D`	Wskaźniki zbiorcze, dla których nazwa kraju to Kanada: `filters=COUNTRY_NAME%3D%3DCanada`
`=@`	Zawiera podłańcuch	`%3D@`	Wskaźniki zbiorcze, których nazwa kraju zawiera słowo Stany Zjednoczone, pasują do Stanów Zjednoczonych i Wielkiej Brytanii, na przykład: `filters=COUNTRY_NAME%3D@United`

Filtruj wyrażenia

Jest kilka ważnych reguł dotyczących wyrażeń filtra:

Znaki zarezerwowane w adresie URL – znaki takie jak & muszą być zakodowane w zwykły sposób. Biblioteki klienta zajmują się tym za Ciebie, więc musisz martwić się o kodowanie tylko wtedy, gdy wykonujesz bezpośrednie wywołania protokołu.
Znaki zarezerwowane – gdy występują w wyrażeniu, należy zastąpić ich znakiem zmiany znaczenia przecinek i ukośnik lewy.
- ukośnik lewy \\
- przecinek \,

Uwaga: aby uniknąć podwójnego stosowania zmiany znaczenia, przed przecinkiem należy usunąć ukośnik lewy przed przecinkiem.

Łączenie filtrów

Filtry można łączyć za pomocą wartości logicznych OR i AND.

Operator logiczny LUB

Logika OR jest definiowana za pomocą przecinka (,) w wyrażeniu filtra.

Przykład: (każdy musi być zakodowany na potrzeby adresu URL)

Kod kraju to (USA LUB Wielka Brytania):
COUNTRY_CODE==US,COUNTRY_CODE==UK

ORAZ logika

Logika AND jest osiągana przez podanie wielu parametrów filtrów, co przekłada się na udostępnienie tablicy filtrów w bibliotekach klienta.

Przykład:

Kod kraju to USA ORAZ kod produktu to AFC:
filters=COUNTRY_CODE%3D%3DUS&filters=PRODUCT_CODE%3D%3DAFC

Łączenie operatorów logicznych ORAZ i LUB

Operatory logiczne ORAZ i LUB można łączyć w jedno wyrażenie.

Uwaga: każdy filtr jest oceniany indywidualnie, zanim wszystkie filtry zostaną połączone w wyrażenie logiczne ORAZ.