filters
sorgu dizesi parametresi, döndürülen verileri kısıtlar
AdSense Management API raporunda yer alır. filters
parametresini kullandığınızda
ve ardından filtre ifadesini içeren bir boyut girin.
Filtrelenen sorgular, sonuca dahil edilen satırları kısıtlar. Her satır değeri filtreye göre test edilir: Filtre eşleşirse satır eşleşmiyorsa satır atlanır.
- URL Kodlama: İstemci kitaplıkları otomatik olarak kodlama yapar. ve filtre operatörlerini kullanabilirsiniz. Ancak doğrudan protokole istek gönderirseniz filtre operatörlerini aşağıdaki tabloda gösterildiği gibi açık bir şekilde kodlamanız gerekir.
- Filtreleme önceliği: Filtreleme, herhangi bir işlemden önce gerçekleşir. boyut toplandığından, döndürülen metrikler toplam karşılaştırma yapabilirsiniz.
Filtre Söz Dizimi
Tek bir filtre aşağıdaki formu kullanır:
name operator expression
Şu söz diziminde:
- ad — filtrelenecek boyutun adı.
Örneğin:
AD_CLIENT_ID
, reklam istemci kimliğini filtreler. - operator, kullanılacak filtre eşleşmesi türünü tanımlar.
- expression (ifade) — sonuçlara dahil edilen değerleri belirtir.
Şu boyuta sahip tüm boyutlar:
Rapordaki metrikler için geçerli olanlar filtre olarak kullanılabilir,
(DATE
, WEEK
,
ve MONTH
). Tarihe göre filtrelemek için
rapor tarih aralığını kullanın.
Filtre Operatörleri
İki filtre operatörü vardır. Operatörlerin şunları yapmak için URL kodlamalı olması gerekir: dahil edilmemelidir.
Operatör | Açıklama | URL Kodlanmış Form | Örnek |
---|---|---|---|
== |
Tam eşleme | %3D%3D |
Ülke adının Kanada olduğu toplu metrikler:
filters=COUNTRY_NAME%3D%3DCanada |
=@ |
Alt dize içerir | %3D@ |
Ülke adının United (Birleşik Krallık) içerdiği yerleri içeren toplu metrikler
ABD ve İngiltere'yle eşleşir, örneğin:
filters=COUNTRY_NAME%3D@United |
İfadeleri Filtrele
Filtre ifadeleri için birkaç önemli kural vardır:
- URL ile ayrılmış karakterler:
&
her zamanki gibi URL olarak kodlanmalıdır. İstemci kitaplıkları gerekeni yapın. Dolayısıyla bu kodlamayla yalnızca protokolüne doğrudan çağrı yapıyorsunuz. - Ayrılmış karakterler: Virgül ve ters eğik çizgi
bir ifadede göründüğünde ters eğik çizgi ile kodlanmamalıdır.
- ters eğik çizgi
\\
- virgül
\,
- ters eğik çizgi
Not: Önce ters eğik çizgilerden kurtulduğunuzdan emin olun kullanmamanız gerekir.
Filtreleri Birleştirme
Filtreler, OR
ve AND
boole değerleri kullanılarak birleştirilebilir
mantığıyla başlayalım.
VEYA mantığı
OR
mantığı,,
Filtre ifadesini kullanın.
Örnek: (her biri URL kodlamalı olmalıdır)
Ülke kodu (ABD VEYA Birleşik Krallık):
COUNTRY_CODE==US,COUNTRY_CODE==UK
VE mantığı
AND
mantığı, birden fazla filtre parametresi sağlanarak elde edilir.
Bu da istemci kitaplıklarında bir dizi filtre oluşturmak anlamına gelir.
Örnek:
Ülke kodu ABD VE ürün kodu AFC:
filters=COUNTRY_CODE%3D%3DUS&filters=PRODUCT_CODE%3D%3DAFC
VE ve VEYA mantığını birleştirme
VE ve VEYA mantığını tek bir ifadede birleştirmek mümkündür.
Not: Her filtre ayrı ayrı değerlendirilir .
Örnek:
Ülke kodu (ABD VEYA Birleşik Krallık) VE ürün kodu AFC'dir:
filters=COUNTRY_CODE%3D%3DUS,COUNTRY_CODE%3D%3DUK&filters=PRODUCT_CODE%3D%3DAFC