Filtreleniyor

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 \,

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

Sonraki adımlar