Campaign Manager 360 API มีหลายวิธีในการดึงข้อมูลสำหรับโฆษณาที่มีการดูแลการแสดงโฆษณา ผ่าน Campaign Manager 360
บริการรายงาน
การสร้างรายงานโดยใช้บริการ Reports
เกี่ยวข้องกับเวิร์กโฟลว์แบบหลายขั้นตอนในการกำหนดค่า สร้าง และเรียกไฟล์รายงาน
(เช่น รูปแบบ CSV หรือ Excel) นี่คือเส้นทางการรายงานมาตรฐานสำหรับ Campaign Manager 360 API และเหมาะสำหรับชุดข้อมูลขนาดใหญ่ สคริปต์ที่ตั้งเวลาไว้โดยอัตโนมัติ หรือแอปพลิเคชันดาวน์สตรีมที่ใช้ไฟล์
โดยปกติแล้ว เวิร์กโฟลว์จะมีขั้นตอนดังต่อไปนี้
- กําหนดหรือค้นหา
Reportแหล่งข้อมูล (ระบุเมตริก มิติข้อมูล ช่วงวันที่ และตัวกรอง) ซึ่งบันทึกไว้ด้วยรหัสรายงานที่ไม่ซ้ำกัน ดูหัวข้อสร้างและ อัปเดตรายงาน - เรียกใช้การสร้างรายงานโดยเรียกใช้เมธอด
reports.runซึ่งจะจัดคิวการเรียกใช้รายงานและแสดงผลFileทรัพยากรตัวยึดตำแหน่ง ดูค้นหาและเรียกใช้รายงาน - ตรวจสอบ
Fileสถานะของทรัพยากรเป็นระยะ เนื่องจากกระบวนการนี้ทำงานแบบอะซิงโครนัส สถานะของไฟล์จะเริ่มต้นเป็นPROCESSINGและเปลี่ยนเป็นREPORT_AVAILABLEเมื่อเสร็จสมบูรณ์ ดูค้นหาและเรียกใช้รายงาน - ดึงเนื้อหาไฟล์ (CSV หรือ Excel) เมื่อการสร้างรายงานเสร็จสมบูรณ์ ดูดาวน์โหลดรายงาน
เรียกใช้รายงานแบบซิงโครนัส
หากต้องการสร้างไฟล์รายงาน (CSV หรือ Excel) สำหรับข้อมูลจำนวนเล็กน้อย
คุณสามารถเรียกใช้รายงานพร้อมกันได้โดยเรียกใช้เมธอด
reports.run โดยตั้งค่าพารามิเตอร์ synchronous เป็น true API จะพยายามสร้างรายงานภายในระยะหมดเวลาสั้นๆ
หากการดำเนินการใช้เวลานานขึ้น การเรียกใช้รายงานโดยอัตโนมัติจะกลับไปใช้คิวแบบไม่พร้อมกัน
ดูรายละเอียดเพิ่มเติมได้ที่รายงานแบบซิงโครนัส
ข้อมูลรายงานการค้นหา
ใช้เมธอด reportData.query เพื่อค้นหาข้อมูลการรายงานโดยตรงแทนการสร้างไฟล์รายงาน
- แทนที่จะสร้างและบันทึก
Reportทรัพยากร คุณระบุเมตริก มิติข้อมูล และเกณฑ์การกรองหรือการจัดเรียงอื่นๆ ได้โดยตรงในคำขอ - การตอบกลับมีข้อมูลรายงานที่มีโครงสร้าง จึงไม่จำเป็นต้องสำรวจและดาวน์โหลดไฟล์ที่สร้างขึ้น
- คำขอจะดำเนินการแบบซิงโครนัสโดยมีขีดจำกัด 60 วินาที
ดูรายละเอียดเพิ่มเติมได้ที่ค้นหาข้อมูลรายงาน JSON