Bu sayfa, Cloud Translation API ile çevrilmiştir.

Filtreleniyor

filters sorgu dizesi parametresi, AdSense Management API raporunda döndürülen verileri kısıtlar. filters parametresini kullandığınızda, filtrelemek istediğiniz bir boyut ve ardından filtre ifadesini sağlarsınız.

Filtrelenen sorgular, sonuca dahil edilen satırları kısıtlar. Sonuçtaki her satır filtreye göre test edilir: Filtre eşleşirse satır korunur, eşleşmezse satır atlanır.

URL Kodlaması: İstemci kitaplıkları, filtre operatörlerini otomatik olarak kodlar. 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, tüm boyutlar toplanmadan önce gerçekleşir. Böylece döndürülen metrikler yalnızca alakalı boyutların toplamını gösterir.

Filtre Söz Dizimi

Tek bir filtrede şu biçim kullanılır:

name operator expression

Bu söz diziminde:

ad, filtre uygulanacak boyutun adı. Örneğin: AD_CLIENT_ID, reklam istemci kimliğini filtreler.
operator — Kullanılacak filtre eşleştirmesinin türünü tanımlar.
ifade, sonuçlara dahil edilen değerleri belirtir.

Tarihle ilgili boyutlar (DATE, WEEK ve MONTH) hariç olmak üzere, raporlanmakta olan metrikler için geçerli olan tüm boyutlar filtre olarak kullanılabilir. Tarihe göre filtrelemek için bunun yerine rapor için tarih aralığını belirtin.

Filtre Operatörleri

İki filtre operatörü vardır. Operatörlerin URL sorgu dizelerine eklenebilmesi için URL kodlamalı olmaları gerekir.

Operatör	Açıklama	URL Kodlu Form	Örnek
`==`	Tam eşleme	`%3D%3D`	Ülke adı Kanada olan toplu metrikler: `filters=COUNTRY_NAME%3D%3DCanada`
`=@`	Alt dize içerir	`%3D@`	Ülke adının United ifadesini içerdiği ve bu ülkenin Birleşik Krallık ve Birleşik Krallık ile eşleştiği metrikleri topluca görebilirsiniz. Örneğin: `filters=COUNTRY_NAME%3D@United`

İfadeleri Filtrele

Filtre ifadelerine ilişkin birkaç önemli kural vardır:

URL ile ayrılmış karakterler: & gibi karakterler her zamanki gibi URL olarak kodlanmalıdır. İstemci kitaplıkları bu işlemi sizin yerinize yapar. Böylece, yalnızca protokole doğrudan çağrı yapıyorsanız bu kodlamayla ilgili endişelenmenize gerek kalmaz.
Ayrılmış karakterler: Virgül ve ters eğik çizgi, bir ifadede göründüğünde ters eğik çizgiden kaçınılmalıdır.
- ters eğik çizgi \\
- virgül \,

Not: Çift çıkış yapılmasını önlemek için, virgüllerden önce ters eğik çizgilerden kaçındığınızdan emin olun.

Filtreleri Birleştirme

Filtreler, OR ve AND boole mantığı kullanılarak birleştirilebilir.

VEYA mantığı

OR mantığı, filtre ifadesi içinde bir virgül (,) kullanılarak tanımlanır.

Örnek: (her biri URL kodlamalı olmalıdır)

Ülke kodu şunlardan biridir: (ABD VEYA BK):
COUNTRY_CODE==US,COUNTRY_CODE==UK

VE mantığı

AND mantığı, birden fazla filtre parametresi sağlayarak gerçekleştirilir. Bu da istemci kitaplıklarında bir filtre dizisi sağlanması 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: Tüm filtreler bir AND mantıksal ifadesinde birleştirilmeden önce her filtre ayrı ayrı değerlendirilir.