Önceki Search Ads 360 Reporting API, 30 Haziran 2024'te kullanımdan kaldırılacak ve tamamen devre dışı bırakılacak. Search Ads 360 Conversion API'nin bu durumdan etkilenmediğini ve desteklenmeye devam edeceğini unutmayın. Tüm yeni raporlama geliştirmelerinde yeni Search Ads 360 Reporting API kullanılmalıdır.

Nisan 2024'ten itibaren, rapor istenirken desteklenmeyen birApiVersion hatası döndürülecektir. Ayrıntılı bilgiye buradan ulaşabilirsiniz.

Ayrıca, mevcut Search Ads 360 uygulamalarınızı yeni API'ye taşımanızı da önemle tavsiye ederiz. Daha fazla bilgi için yeni Search Ads 360 Reporting API Başlangıç ve Taşıma Rehberi'ne bakın.

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

Artımlı 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.

Her rapor isteğinde bulunduğunuzda tüm verilerin dökümünü almak yerine düzenli aralıklarla yalnızca son raporunuzdan bu yana değişen verileri isteyebilirsiniz. Bu artımlı raporlar, muhtemelen tam bir rapordan önemli ölçüde daha küçük olacaktır.

Ek raporlar isteğinde bulunursanız aşağıdakileri göz önünde bulundurmanız gerekir:

Yine de bazı ek değişikliklerin kaybolma olasılığına karşı, arada sırada eksiksiz bir rapor istemek iyi bir fikirdir. Örneğin, Ocak ayı boyunca haftalık ek raporlar isterseniz Şubat ayının sonunda, Ocak ayının tüm verilerini aldığınızdan emin olmak için Ocak ayına ait tam bir rapor talep etmeniz gerekir.
Bazı varlıkların değişip değişmediğini belirlemek her zaman mümkün olmadığından, Search Ads 360 varlığın değişeceğinden şüphelendiği bile olsa artımlı bir rapor bir varlık içerir. Diğer bir deyişle, artımlı raporlar değişmemiş veriler içerebilir.

Artımlı rapor istemek için aşağıdaki Reports.request.timeRange özelliklerinden birini belirtin:

changedMetricsSinceTimestamp=timestamp

Belirtilen zaman damgasından sonra değişen istek metrikleri. Metrikler günlük ayrıntı düzeyinde depolandığı ve bir gün değişebileceği için bir gün değişebileceği için bu tür istekler güne göre segmentlere ayrılmalıdır (date sütunu mevcut olmalıdır). Örneğin, clicks, actions ve date sütunlarını içeren bir keyword raporu, belirtilen zaman damgasından bu yana kaydedilen tıklama veya işlem sayısının değiştiği her bir anahtar kelime ve tarih için bir satır döndürür.

Zaman damgası, isteğin zamanından en fazla 8 gün önce olmalıdır. Değişen tüm metrikleri yakalamak için 7 günde bir en az bir kez changedMetricsSinceTimestamp isteğinde bulunduğunuzdan ve metrikler çözüldükten sonra her tarih için tam bir rapor oluşturduğunuzdan emin olun (en az 7 gün beklemek daha güvenlidir). Her gün iki rapor oluşturmak buna örnek olarak verilebilir: son 36 saat içinde değişen metrikler için artımlı bir rapor ve 8 gün önce gerçekleşmiş metrikler için tam bir rapor.

changedAttributesSinceTimestamp=timestamp

Belirtilen zaman damgasından sonra değişen istek özellikleri. changedAttributesSinceTimestamp isteği yalnızca özellik sütunlarını içerebilir (metrik veya segment sütunu içermez) ve conversion raporları gibi ham etkinlik raporları için çalışmaz. Örneğin, dailyBudget ve campaignStartDate sütunlarını içeren bir campaign raporu, belirtilen zaman damgasından sonra günlük bütçesi veya başlangıç tarihi değişen her kampanya için bir satır döndürür.

Üst özelliklerde yapılan değişikliklerin changedAttributesSinceTimestamp raporlarında yansıtılmadığını unutmayın. Örneğin, bir anahtar kelime, teklif stratejisini üst reklam grubundan devralabilir. Reklam grubuna yeni bir teklif stratejisi atansa bile bu anahtar kelime raporda görünmeyebilir. Değeri üst varlıklara bağlı olan (ve bu nedenle changedAttributesSinceTimestamp raporları tarafından alınmadan değişebilen) özellik sütunları genellikle effectiveLabelIds veya effectiveBidStartegy gibi "geçerli" ön ekine sahiptir.