Campaign Manager 360 API menyediakan beberapa cara untuk mengambil data iklan yang di-trafficking melalui Campaign Manager 360.
Layanan laporan
Membuat laporan menggunakan layanan Reports melibatkan alur kerja multi-langkah untuk mengonfigurasi, membuat, dan mengambil file laporan (seperti format CSV atau Excel). Ini adalah jalur pelaporan standar untuk
Campaign Manager 360 API dan cocok untuk set data besar, skrip terjadwal otomatis,
atau aplikasi hilir yang menggunakan file.
Alur kerja biasanya terdiri dari langkah-langkah berikut:
- Tentukan atau temukan resource
Report(dengan menentukan dimensi, metrik, rentang tanggal, dan filter) yang disimpan dengan ID laporan unik. Lihat Membuat dan Memperbarui Laporan. - Jalankan pembuatan laporan dengan memanggil metode
reports.run. Tindakan ini mengantrekan eksekusi laporan dan menampilkan resourceFileplaceholder. Lihat Menemukan dan Menjalankan Laporan. - Periksa status resource
Filesecara berkala. Karena proses ini berjalan secara asinkron, status file akan dimulai sebagaiPROCESSINGdan berubah menjadiREPORT_AVAILABLEsetelah selesai. Lihat Menemukan dan Menjalankan Laporan. - Ambil konten file (CSV atau Excel) setelah pembuatan laporan selesai. Lihat Mendownload Laporan.
Menjalankan laporan secara sinkron
Jika perlu membuat file laporan (CSV atau Excel) untuk sejumlah kecil data,
Anda dapat menjalankan laporan secara sinkron dengan memanggil metode
reports.run dengan parameter synchronous yang ditetapkan
ke true. API mencoba membuat laporan dalam periode waktu tunggu yang singkat. Jika eksekusi membutuhkan waktu lebih lama, laporan yang dijalankan akan otomatis beralih ke
antrean asinkron.
Untuk mengetahui detail selengkapnya, lihat Laporan Sinkron.
Data laporan kueri
Gunakan metode reportData.query untuk membuat kueri
data pelaporan secara langsung, bukan membuat file laporan.
- Daripada membuat dan menyimpan resource
Report, Anda menentukan dimensi, metrik, dan kriteria pemfilteran atau pengurutan lainnya langsung dalam permintaan. - Respons berisi data laporan terstruktur, sehingga tidak perlu melakukan polling dan mendownload file yang dihasilkan.
- Permintaan dijalankan secara sinkron dengan batas 60 detik.
Untuk mengetahui detail selengkapnya, lihat Membuat Kueri Data Laporan JSON.