Filtrelenen Raporlar

Yeni Search Ads 360 Reporting API kullanıma sunuldu. Yeni API, özel raporlar oluşturmak ve raporlama uygulamalarınız ile süreçlerinize verileri entegre etmek için daha fazla esneklik sağlar. Yeni Search Ads 360 Reporting API'ye geçme ve bu API'yi kullanma hakkında daha fazla bilgi edinin.

Varsayılan olarak raporunuz, isteğinizin reportScope bölümünde belirtilen tüm verileri içerir. Bir raporun yalnızca bir ölçüt grubuyla eşleşen verileri içermesini isterseniz rapora bir veya daha fazla filtre ekleyebilirsiniz. Yalnızca tüm filtreleri karşılayan satırlar döndürülür.

Örneğin, bir ajanstaki tüm anahtar kelimelerin raporunu isteyebilirsiniz. Ardından, yalnızca açılış sayfası URL'leri www.example.com ve www.another-example.com ile başlayan anahtar kelimelerin raporda görünmesi için bir filtre belirtebilirsiniz.

"filters": [
  {
    "column" : { "columnName": "keywordLandingPage" },
    "operator" : "startsWith",
    "values" : [
      "http://www.example.com",
      "http://www.another-example.com"
    ]
  }
]

Her filtre, filtrelenecek bir sütun, bir operatör ve belirtilen sütunda olması beklenen bir değerler listesi belirtir:

"filters": [
  {
   "column" : column to filter on,
   "operator" : operator specifying the type of filter,
   "values" : list of values
  },
  { ... another filter can go here ... }
]

Not: Bazı sütunlar filtrelenemez. Rapor Türleri referansında her sütunda bu değerin Filterable olup olmadığı belirtilir.

Filtre operatörleri

Tüm filtreler büyük/küçük harfe duyarlıdır. Yani "www.Sprockets.com" içeren bir filtre, "www.sprockets.com" değerini içeren bir sütunla eşleşmez.

Operatör	Açıklama	Desteklenen değer sayısı
equals	Sütun, belirtilen değerle tam olarak eşleşmelidir.	1
notEquals	Sütun belirtilen değerle eşleşmemelidir.	1
in	Sütun, filtrenin listesindeki değerlerden biriyle tam olarak eşleşmelidir. Liste veri türleri (String list gibi) için geçerli değildir.	değişken
lessThan	Sütun, belirtilen değerden küçük bir değer içermelidir. Bir Boolean sütunu için bu filtreyi belirtirseniz Search Ads 360 API, false değerini 0, true değerini de 1 olarak dönüştürür. Bir String sütunu için bu filtreyi belirtirseniz API sözlüğe göre sıralamayı karşılaştırır. Liste veri türleri (String list gibi) için geçerli değildir.	1
greaterThan	Sütun, filtrenin listesindeki değerlerin birinden büyük bir değer içermelidir. Bir Boolean sütunu için bu filtreyi belirtirseniz API, false değerini 0, true değerini ise 1 olarak dönüştürür. Bir String sütunu için bu filtreyi belirtirseniz API sözlüğe göre sıralamayı karşılaştırır. Liste veri türleri (String list gibi) için geçerli değildir.	1
lessThanOrEqual	Sütun, filtrenin listesindeki değerlerden birine eşit veya daha küçük bir değer içermelidir. Bir Boolean sütunu için bu filtreyi belirtirseniz API, false değerini 0, true değerini ise 1 olarak dönüştürür. Bir String sütunu için bu filtreyi belirtirseniz API sözlüğe göre sıralamayı karşılaştırır. Liste veri türleri (String list gibi) için geçerli değildir.	1
greaterThanOrEqual	Sütun, filtrenin listesindeki değerlerden birine eşit veya daha büyük bir değer içermelidir. Bir Boolean sütunu için bu filtreyi belirtirseniz API, false değerini 0, true değerini ise 1 olarak dönüştürür. Bir String sütunu için bu filtreyi belirtirseniz API sözlüğe göre sıralamayı karşılaştırır. Liste veri türleri (String list gibi) için geçerli değildir.	1
isNull	Sütun boş olmalıdır. Örneğin, bir anahtar kelime raporundaki keywordMaxCpc sütunu için isNull değerini belirtirseniz rapor yalnızca Maks. TBM belirtmeyen anahtar kelimeleri içerir.	0
isNotNull	Sütun bir değer içermelidir.	0
startsWith	Sütun, filtre listesindeki dizelerden biriyle başlamalıdır. Yalnızca String sütun için geçerlidir.	değişken
containsSubstring	Sütun, filtre listesinde belirtilen dizelerden birinin tamamını veya bir kısmını içermelidir. Örneğin, ["ham", "cheese"] değerlerine sahip bir containsSubstring filtresi, şu değere sahip satırları döndürür: hamburger cheeseburger ancak şu değerlere sahip satırları döndürmez: lobster roll lettuce high amplitude (high amplitude, "h am" alt dizesini içerir ancak boşluklar dahil tüm karakterler filtre tarafından değerlendirilir) Yalnızca String sütun için geçerlidir.	değişken
doesNotContainSubstring	Sütun, filtre listesindeki dizelerin hiçbirini içermemelidir. Örneğin, ["ham", "cheese"] değerlerine sahip bir doesNotContainSubstring filtresi, şu değere sahip satırları döndürür: lobster roll lettuce ancak şu değerlere sahip satırlar döndürülmez: hamburger cheeseburger Yalnızca String sütun için geçerlidir.	değişken
containsElement	Sütun, filtre listesindeki değerlerden en az birini içermelidir. Yalnızca liste veri türlerini (String list gibi) içeren sütunlar için geçerlidir. Örneğin bir campaign raporunda, ["foo", "bar"] değerlerine sahip bir containsElement filtresi effectiveLabels sütununda filtrelendiğinde yalnızca foo, bar veya her ikisi ile etiketlenmiş kampanyalar döndürülür.	değişken