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

Filtrowanie

Parametr ciągu zapytania filters ogranicza zwracane dane w raporcie interfejsu API do zarządzania AdSense. Gdy używasz parametru filters, podaj wymiar, według którego chcesz filtrować, a następnie wyrażenie filtra.

Zapytania filtrowane ograniczają liczbę wierszy uwzględnianych w wynikach. Każdy wiersz w wyniku jest sprawdzany pod kątem filtra: jeśli filtr zostanie dopasowany, wiersz zostanie a w razie niezgodności 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 jawnie zakodować operatory filtra, jak podano w tabeli poniżej.
Priorytet filtrowania: filtrowanie ma miejsce przed wymiary są agregowane, tak aby zwrócone dane odzwierciedlały sumę tylko w przypadku odpowiednich wymiarów.

Składnia filtra

Jeden filtr ma taki format:

name operator expression

W tej składni:

nazwa – nazwa wymiaru, według którego ma być filtrowany element. Na przykład: AD_CLIENT_ID zastosuje filtrowanie według identyfikatora klienta wyświetlania reklam.
operator – określa typ dopasowania filtra, którego chcesz użyć.
wyrażenie – określa wartości zawarte w wynikach.

Wszystkie wymiary, które do raportowanych danych mogą być używane jako filtry, z wyjątkiem wymiarów związanych z datą (DATE, WEEK, i MONTH). Aby filtrować według daty, określ zakres dat raportu.

Operatory filtrowania

Dostępne są 2 operatory filtrowania. Operatory muszą być zakodowane w adresie URL, aby można było być uwzględnione w ciągach zapytań z adresu URL.

Operator	Opis	Formularz zakodowany w adresie URL	Przykład
`==`	Dopasowanie ścisłe	`%3D%3D`	Zbieraj dane, gdzie nazwa kraju to Kanada: `filters=COUNTRY_NAME%3D%3DCanada`
`=@`	Zawiera podłańcuch	`%3D@`	Zbiorcze dane, gdy nazwa kraju zawiera słowo Stany Zjednoczone, ten dopasowuje Stany Zjednoczone i Wielka Brytania, na przykład: `filters=COUNTRY_NAME%3D@United`

Filtruj wyrażenia

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

Znaki zarezerwowane w adresie URL – znaki takie jak Tag & musi być zakodowany w zwykły sposób. Biblioteki klienta zajmie się tym za Ciebie, więc musisz się martwić o kodowanie tylko wtedy, wykonujesz bezpośrednie wywołania protokołu.
Zastrzeżone znaki – przecinek i ukośnik lewy muszą po ukośniku odwróconym, jeśli występują w wyrażeniu.
- ukośnik lewy \\
- przecinek \,

Uwaga: pamiętaj o zmianie ukośnika lewego przed ukośnikiem przecinków, by uniknąć podwójnego stosowania zmiany znaczenia.

Łączenie filtrów

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

operator logiczny LUB

Logika OR jest definiowana za pomocą przecinka (,) w elemencie wyrażenie 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

operator logiczny ORAZ

Działanie logiczne AND jest możliwe dzięki podaniu wielu parametrów filtra, co przekłada się na udostępnienie tablicy filtrów w bibliotekach klienta.

Przykład:

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

Łączenie operatorów logicznych ORAZ i LUB

W jednym wyrażeniu możesz połączyć operatory logiczne I i LUB.

Uwaga: każdy filtr jest oceniany indywidualnie przed połączeniem wszystkich filtrów w wyrażenie logiczne ORAZ.