แนวทางปฏิบัติแนะนําในการรายงาน

สร้างรายงานใหม่ใน UI ก่อน

รายงานอยู่ภายใต้ข้อจํากัดและข้อกําหนดจํานวนมากที่เกี่ยวข้องกับประเภทการรายงาน ตัวกรอง มิติข้อมูล และเมตริก ข้อจํากัดเหล่านี้บังคับใช้ใน API ซึ่งทําให้เกิดข้อผิดพลาด HTTP 400 เพื่อหลีกเลี่ยงข้อผิดพลาดในขณะที่สร้างรายงาน เราขอแนะนําให้คุณสร้างรายงานใหม่ใน UI ของ Display &Video 360 ก่อน

หลังจากสร้างรายงานแล้ว ให้คลิก"ลองใช้ API นี้&ฟีเจอร์; ในหน้าเอกสารอ้างอิงเพื่อดําเนินการ queries.get ของทรัพยากร Query คุณสามารถใช้ JSON ที่แสดงผลเพื่อสร้างรายงานในอนาคต

บันทึกและใช้รายงานซ้ํา

เราขอแนะนําให้คุณสร้างและบันทึกรายงานสําหรับคําค้นหาที่คุณเรียกใช้เป็นประจํา เนื่องจากการแทรกและลบรายงานเดียวกันหลายครั้งจะทําให้สิ้นเปลืองทรัพยากร การใช้ค่า Range ที่ตั้งค่าไว้ เช่น PREVIOUS_DAY หรือ LAST_7_DAYS ในช่อง dataRange จะทําให้รายงานใช้ซ้ําได้มากขึ้น

ตั้งเวลารายงาน

รายงานเฉพาะกิจหรือแบบครั้งเดียวอาจเสียทรัพยากรเพราะต้องเรียกใช้ทีละรายการและอาจดําเนินการกับชุดข้อมูลที่ไม่สมบูรณ์ รายงานที่ตั้งเวลาไว้ใช้ทรัพยากรการรายงานให้เกิดประโยชน์สูงสุดเนื่องจากทํางานพร้อมกันหลายรายการและรับประกันว่าจะทํางานไม่ได้จนกว่าข้อมูลของวันก่อนหน้าจะประมวลผลเสร็จ โปรดดูรายละเอียดในช่องการนัดหมายที่ใช้ได้

รวมรายงานที่คล้ายกัน

หากคุณสร้างรายงานที่มีเมตริกและช่วงวันที่ที่เหมือนกันสําหรับผู้ลงโฆษณาหรือพาร์ทเนอร์แต่ละรายเป็นประจํา เราขอแนะนําให้คุณรวมรายงานเข้าด้วยกันเพื่อเพิ่มประสิทธิภาพปริมาณรายงาน

คุณรวมรายงานที่คล้ายกันได้โดยการผนวกตัวกรองของรายงานทั้งหมดเข้าด้วยกันและเพิ่มตัวกรองทุกประเภทเป็นมิติข้อมูล หลังการสร้าง คุณสามารถแบ่งแถวของรายงานที่เกิดขึ้นตามค่าตัวกรองเดิมเพื่อสร้างรายงานต้นฉบับ

พิจารณาโควต้าการรายงาน

การใช้ฟีเจอร์การรายงาน Display &AMP อย่างมีความรับผิดชอบจะบังคับใช้ผ่านโควต้าการใช้งานของทั้งผลิตภัณฑ์ต่อไปนี้

การดําเนินการในรายงานเฉพาะกิจต่อวัน

จํากัดจํานวนรายงานเฉพาะกิจที่ผู้ใช้สามารถทําได้ในระยะเวลา 24 ชั่วโมง หากต้องการให้อยู่ในโควต้านี้ ให้ทําตามขั้นตอนต่อไปนี้

รายงานที่ตั้งเวลาไว้ที่ใช้งานอยู่

จํากัดจํานวนรายงานที่ผู้ใช้กําหนดได้ในช่วงเวลาหนึ่งๆ หากต้องการให้อยู่ในโควต้านี้ ให้ทําตามขั้นตอนต่อไปนี้

รายงานหลายรายการพร้อมกัน

จํากัดจํานวนรายงานที่ผู้ใช้ทําได้พร้อมกัน หากต้องการให้อยู่ในโควต้านี้ ให้ทําตามขั้นตอนต่อไปนี้

  • ตั้งเวลารายงานที่เรียกใช้เป็นประจํา
  • ปิดใช้งานสคริปต์ API ที่ไม่จําเป็น
  • ติดตามว่ารายงานของคุณเสร็จแล้วเมื่อใด โดยทําการสํารวจโดยใช้ตรรกะ Backoffential

หากคุณเพิ่มประสิทธิภาพการใช้งานการรายงานแล้วโดยยังพบว่าคุณใช้งานเกินโควต้าที่ระบุ โปรดติดต่อ Display & การสนับสนุน Video 360 โดยใช้แบบฟอร์มติดต่อ

ใช้ Exponential Backoff เมื่อสํารวจสถานะของรายงาน

คุณไม่สามารถคาดการณ์ได้ว่ารายงานจะใช้เวลานานเท่าใด ระยะเวลาอาจมีตั้งแต่ไม่กี่วินาทีไปจนถึงชั่วโมง ขึ้นอยู่กับหลายปัจจัย รวมถึงช่วงวันที่และจํานวนข้อมูลที่ระบบจะประมวลผล นอกจากนี้ ความสัมพันธ์ระหว่างเวลาที่รายงานกับจํานวนแถวที่แสดงในรายงานไม่มีความสัมพันธ์กัน ดังนั้นคุณจะต้องดึงทรัพยากรของรายงานเป็นประจําโดยใช้เมธอด queries.reports.get และตรวจสอบว่าช่องทรัพยากรของ metadata.status.state ได้รับการอัปเดตเป็น DONE หรือ FAILED หรือไม่เพื่อดูว่าทรัพยากรทํางานเสร็จแล้วหรือไม่ กระบวนการนี้เรียกว่า&"การสํารวจความคิดเห็น"

แม้ว่าโพลจะเป็นสิ่งที่จําเป็น แต่การติดตั้งใช้งานที่ไม่มีประสิทธิภาพอาจทําให้โควต้าของคุณหมดอย่างรวดเร็วเมื่อพบรายงานที่ใช้เวลานาน ดังนั้น เราขอแนะนําให้ใช้การยกเว้นแบบทวีคูณเพื่อจํากัดการลองใหม่และประหยัดโควต้า

Exponential Backoff

Exponential Backoff เป็นกลยุทธ์การจัดการข้อผิดพลาดมาตรฐานสําหรับแอปพลิเคชันเครือข่าย ที่ไคลเอ็นต์จะพยายามส่งคําขอซ้ําเมื่อเวลาผ่านไป ใช้ Exponential Backoff อย่างเหมาะสมเพื่อเพิ่มประสิทธิภาพของการใช้งานแบนด์วิดท์ ลดจํานวนคําขอที่จําเป็นเพื่อให้ได้รับการตอบกลับสําเร็จ และเพิ่มอัตราการส่งข้อมูลของคําขอในสภาพแวดล้อมที่ใช้งานพร้อมกันให้ได้มากที่สุด

ขั้นตอนสําหรับการนํา Exponential Backoff แบบง่ายไปใช้มีดังต่อไปนี้

  1. ส่งคําขอ queries.reports.get ไปยัง API
  2. เรียกดูออบเจ็กต์รายงาน หากช่อง metadata.status.state ไม่ใช่ DONE หรือ FAILED แสดงว่ารายงานยังไม่ทํางานเสร็จควรทําแบบสํารวจต่อ
  3. รอ 5 วินาที + จํานวนมิลลิวินาทีแบบสุ่ม แล้วลองส่งคําขออีกครั้ง
  4. เรียกดูออบเจ็กต์รายงาน หากช่อง metadata.status.state ไม่ใช่ DONE หรือ FAILED แสดงว่ารายงานยังไม่ทํางานเสร็จควรทําแบบสํารวจต่อ
  5. รอ 10 วินาที + จํานวนมิลลิวินาทีแบบสุ่ม แล้วลองส่งคําขออีกครั้ง
  6. เรียกดูออบเจ็กต์รายงาน หากช่อง metadata.status.state ไม่ใช่ DONE หรือ FAILED แสดงว่ารายงานยังไม่ทํางานเสร็จควรทําแบบสํารวจต่อ
  7. รอ 20 วินาที + จํานวนมิลลิวินาทีแบบสุ่ม แล้วลองส่งคําขออีกครั้ง
  8. เรียกดูออบเจ็กต์รายงาน หากช่อง metadata.status.state ไม่ใช่ DONE หรือ FAILED แสดงว่ารายงานยังไม่ทํางานเสร็จควรทําแบบสํารวจต่อ
  9. รอ 40 วินาที + จํานวนมิลลิวินาทีแบบสุ่ม แล้วลองส่งคําขออีกครั้ง
  10. เรียกดูออบเจ็กต์รายงาน หากช่อง metadata.status.state ไม่ใช่ DONE หรือ FAILED แสดงว่ารายงานยังไม่ทํางานเสร็จควรทําแบบสํารวจต่อ
  11. รอ 80 วินาที + จํานวนมิลลิวินาทีแบบสุ่ม แล้วลองส่งคําขออีกครั้ง
  12. ใช้รูปแบบนี้ต่อจนกว่าออบเจ็กต์รายงานจะได้รับการอัปเดตหรือเมื่อครบเวลาสูงสุดแล้ว

หากรายงานทํางานเสร็จแล้วและลงท้ายด้วยสถานะ DONE คุณจะดึงข้อมูลไฟล์รายงานที่สร้างขึ้นจาก Google Cloud Storage ที่เส้นทางที่ระบุในช่อง metadata.googleCloudStoragePath ได้