Rapor İste

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.

İstemci uygulamanızı İlk Uygulamam'da açıklandığı şekilde oluşturduktan sonra, rapor isteğinde bulunmak ve indirmek için Search Ads 360 API'yi kullanabilirsiniz. Aşağıdaki istek türlerinden birini gönderebilirsiniz:

Eşzamanlı

Yalnızca tek bir istek gerektirir ve raporu JSON biçimli bir yanıtta döndürür. Eşzamanlı istekler:

Büyük reklamveren veya arama motoru hesabı raporları istiyorsanız eşzamansız yaklaşımı öneririz.

Asenkron

Raporda bulunmasını istediğiniz verileri belirten bir ilk istek göndermenizi gerektirir. Ardından, Search Ads 360'ta anket yapmak için ek istekler gönderirsiniz. Search Ads 360 raporu oluşturmayı bitirdiğinde, raporu bir veya daha fazla dosya olarak indirme istekleri gönderirsiniz. Eşzamansız istekler:

  • Herhangi bir rapor türünü döndürebilir
  • Çok büyük raporları birden çok dosyaya ayırır
  • Raporları CSV veya TSV olarak biçimlendirir.

Veri modeli: satırlar ve sütunlar

Search Ads 360 bir rapordaki verileri satırlar ve sütunlar halinde düzenler. İstediğiniz rapor türü, döndürülen satırları belirler. Örneğin, bir anahtar kelime raporu isteğinde bulunuyorsanız her satırda tek bir anahtar kelimeyle ilgili veriler yer alır. Tüm rapor türlerinin listesi için Rapor Türleri referansına bakın. Raporda bulunmasını istediğiniz sütunları, rapor isteğinizdeki her bir sütunu adlandırarak belirtirsiniz. Her bir rapor türü için döndürülebilecek sütunların listesini Rapor Türleri referansına bakın.

Sütun davranışları

Bir sütunun davranışı, sütunun içerdiği veri türüne bağlıdır (Rapor Türleri referansı her sütunun davranışını görüntüler):

  • Özellik sütunları. Özellik sütunları, kampanya adı veya anahtar kelime teklifi gibi kampanyalardaki bir varlığı yapılandıran ya da tanımlayan verileri içerir. Search Ads 360 API, bir istekte belirtilen tarih veya tarih aralığından bağımsız olarak her zaman bir özellik sütununun geçerli değerini döndürür. Örneğin, bir anahtar kelimenin teklifini dün 2,00 değerinden 1,50 değerine değiştirdiyseniz ve ardından geçen ayın verileri için bir rapor isteğinde bulunursanız rapor, anahtar kelime teklifi için 1,50 değerini döndürür.

  • Metrik sütunları. Metrik sütunu, kampanyanızın performansıyla ilgili veriler (ör. bir reklamın aldığı tıklama sayısı, bir Floodlight etiketi tarafından kaydedildiği şekliyle ziyaret sayısı veya gelir) içerir. Tek bir güne ait bir zaman aralığı belirtmediğiniz sürece API, metrik sütunları için toplam değer döndürür. Örneğin, bir önceki ayın verileri için rapor isterseniz API, geçen ayın toplam tıklama sayısını döndürür.

  • Segment sütunları. Segment sütunu, verileri ayrı satırlara böler. Örneğin date, birçok rapor türü için belirtebileceğiniz bir segment sütunudur. Bir anahtar kelime raporunda date sütununu 01.01.2013 ile 07.01.2013 arasında bir tarih aralığıyla belirtirseniz API, her anahtar kelime için her biri bir güne karşılık gelen ve o güne ait metrikleri gösteren yedi satır döndürür. Segmentlere Ayrılmış Raporlar bölümünü inceleyin.

Para birimleri

Rapor isteğinizde parasal verilerin para birimini (dailyBudget gibi özellikler ve cost gibi metrikler) belirtmelisiniz. Aşağıdakilerden birini belirtebilirsiniz:

Para birimi belirtmek için Reports.request.statisticsCurrency istek özelliğini kullanın.

Para birimi, Reports.statisticsCurrencyCode özelliğinde gösterilir.

Saat dilimi

Search Ads 360 metrikleri, saat dilimi olmayan tarihlerde depolanır. Bu tarihler, motor metrikleri (tıklamalar, gösterimler ve ziyaretler gibi) için arama motoru hesabı saat dilimine ve dönüşüm metrikleri (eylemler, işlemler ve gelir gibi) için Campaign Manager ağı saat dilimine karşılık gelir. Bir rapordaki her metrik aynı saat diliminden geldiğinde, istekte söz konusu saat dilimi döndürülür. Aksi takdirde saat dilimi döndürülmez. İstekleriniz, Reports.request.verifySingleTimeZone: true özelliğini birden fazla saat dilimine ait metrik sunan raporları başarısız olacak şekilde ayarlayabilir.

Bir raporda bulunan tüm metrikler tek bir saat dilimindeyse bu saat dilimi, Reports.statisticsTimeZoneReports politikasında döndürülür.