Raporlamaya Genel Bakış

Campaign Manager 360 API, Campaign Manager 360 üzerinden trafiğe eklenen reklamlarla ilgili verileri almak için çeşitli yöntemler sunar.

Rapor hizmeti

Reports hizmetini kullanarak rapor oluşturma, rapor dosyalarını (ör. CSV veya Excel biçiminde) yapılandırma, oluşturma ve alma için çok adımlı bir iş akışı içerir. Bu, Campaign Manager 360 API'nin standart raporlama yoludur ve büyük veri kümeleri, otomatikleştirilmiş planlanmış komut dosyaları veya dosyaları kullanan aşağı akış uygulamaları için uygundur.

İş akışı genellikle aşağıdaki adımlardan oluşur:

  1. Benzersiz bir rapor kimliğiyle kaydedilen bir Report kaynağı (boyutları, metrikleri, tarih aralıklarını ve filtreleri belirterek) tanımlayın veya bulun. Rapor oluşturma ve güncelleme başlıklı makaleyi inceleyin.
  2. reports.run yöntemini çağırarak rapor oluşturma işlemini çalıştırın. Bu işlem, rapor çalıştırmayı sıraya alır ve yer tutucu File kaynağını döndürür. Raporları bulma ve çalıştırma başlıklı makaleyi inceleyin.
  3. File kaynağının durumunu düzenli olarak kontrol edin. Bu işlem eşzamansız olarak çalıştığından, bir dosyanın durumu PROCESSING olarak başlar ve tamamlandığında REPORT_AVAILABLE olarak değişir. Raporları bulma ve çalıştırma başlıklı makaleyi inceleyin.
  4. Rapor oluşturma işlemi tamamlandıktan sonra dosya içeriğini (CSV veya Excel) getirin. Raporları İndirme başlıklı makaleyi inceleyin.

Raporları eşzamanlı olarak çalıştırma

Az miktarda veri için rapor dosyası (CSV veya Excel) oluşturmanız gerekiyorsa eşzamanlı olarak raporu çalıştırabilirsiniz. Bunun için reports.run yöntemini synchronous parametresi true olarak ayarlanmış şekilde çağırın. API, kısa bir zaman aşımı süresi içinde rapor oluşturmaya çalışır. Yürütme daha uzun sürerse rapor çalıştırma işlemi otomatik olarak eşzamansız kuyruğa geri döner.

Daha fazla bilgi için Senkron Raporlar başlıklı makaleye göz atın.

Rapor verilerini sorgulama

Rapor dosyası oluşturmak yerine doğrudan raporlama verilerini sorgulamak için reportData.query yöntemini kullanın.

  • Report kaynağı oluşturup kaydetmek yerine, boyutları, metrikleri ve diğer filtreleme veya sıralama ölçütlerini doğrudan istekte belirtirsiniz.
  • Yanıtta yapılandırılmış rapor verileri bulunur. Bu sayede, oluşturulan bir dosyanın yoklanması ve indirilmesi gerekmez.
  • İstek, 60 saniyelik bir sınırla senkron olarak yürütülür.

Daha fazla bilgi için JSON rapor verilerini sorgulama başlıklı makaleyi inceleyin.