ข้อผิดพลาดและคําเตือน

หน้านี้จะกล่าวถึงข้อผิดพลาดและคำเตือนประเภทต่างๆ ที่คุณอาจพบเมื่อใช้ Display & Video 360 API

ข้อผิดพลาดของ API

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

การตอบกลับข้อผิดพลาดจะใช้รูปแบบต่อไปนี้และมีรหัสตอบกลับ HTTP, ข้อความแสดงข้อผิดพลาด และสถานะรหัส RPC ของ Google

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

ด้านล่างนี้คือรายการข้อผิดพลาด API ที่พบบ่อยพร้อมกับการดำเนินการที่แนะนำหากแสดงผล

หมายเหตุ: หากข้อผิดพลาดยังคงอยู่แม้ว่าจะดำเนินการตามที่แนะนำแล้ว โปรดติดต่อทีมสนับสนุนเพื่อรายงานปัญหา

รหัส	RPC	การดำเนินการที่แนะนำ
400	INVALID_ARGUMENT	เกิดปัญหากับคำขอของคุณ ตรวจสอบช่องข้อความในการตอบกลับข้อผิดพลาดและแก้ไขคําขอตามที่ระบุ
401	UNAUTHENTICATED	ไม่สามารถตรวจสอบสิทธิ์คำขอของคุณได้อย่างเหมาะสม ยืนยันว่าคุณรวมข้อมูลเข้าสู่ระบบ OAuth ที่ถูกต้องในคำขอ หากต้องการข้อมูลเพิ่มเติม โปรดดูคู่มือเริ่มต้นใช้งานของเรา
403	PERMISSION_DENIED	คุณไม่มีสิทธิ์ที่จำเป็นในการทำตามคำขอ ตรวจสอบว่าบัญชีผู้ใช้มีสิทธิ์ ที่เหมาะสมสำหรับพาร์ทเนอร์หรือผู้ลงโฆษณาที่เกี่ยวข้อง
404	NOT_FOUND	ไม่พบทรัพยากรที่คุณพยายามเรียกข้อมูล ตรวจสอบว่ารหัสที่ใช้อยู่ถูกต้องและเป็นประเภททรัพยากรที่กำลังดึงข้อมูล
409	ABORTED	ทรัพยากรที่คุณพยายามแก้ไขมีการแก้ไขจากที่อื่นด้วย รอสักครู่แล้วลองส่งคำขออีกครั้ง
429	RESOURCE_EXHAUSTED	คุณมีขีดจำกัดของอัตราหรือโควต้าคำขอรายวันแล้ว ตรวจสอบการใช้งาน API โดยใช้คอนโซล Google API และแก้ไขเวิร์กโฟลว์ให้ทำงานภายในขีดจำกัดโควต้าที่มีอยู่ สำหรับข้อมูลเพิ่มเติม โปรดดูที่หน้าเกี่ยวกับการเพิ่มประสิทธิภาพโควต้า หากดำเนินงานภายในโควต้ารายวันที่ระบุไม่ได้ คุณอาจขอโควต้าเพิ่มเติมได้
500	INTERNAL	API พบข้อผิดพลาดภายใน โปรดรอสักครู่ แล้วลองส่งคำขออีกครั้ง หากข้อผิดพลาดยังคงอยู่ โปรดติดต่อทีมสนับสนุน
504	DEADLINE_EXCEEDED	API ใช้เวลาดำเนินการตามคำขอนานเกินไป โปรดรอสักครู่แล้วลองส่งคําขออีกครั้ง หากข้อผิดพลาดยังคงอยู่ ให้ติดต่อทีมสนับสนุน

ข้อผิดพลาดของ SDF

Display & Video 360 API ใช้เมธอดแบบไม่พร้อมกันสำหรับสร้างและดาวน์โหลดไฟล์ข้อมูลที่มีโครงสร้าง (SDF) ด้วยเหตุนี้ ระบบจะส่งข้อผิดพลาดที่เกิดขึ้นระหว่างการสร้าง SDF กลับมาในงานดาวน์โหลด SDF ที่เสร็จแล้ว งานดาวน์โหลด SDF ที่เสร็จสิ้นใน error จะถูกทำเครื่องหมายว่าเสร็จสิ้น แต่กลับมีช่องข้อผิดพลาดปรากฏขึ้นแทนชื่อทรัพยากรสื่อในช่อง response ตามที่เห็นในตัวอย่างที่ถูกตัดทอนนี้

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

หากได้รับข้อความแสดงข้อผิดพลาดที่ดำเนินการได้เมื่อพยายามสร้าง SDF คุณควรปฏิบัติตามข้อความนั้น หากข้อความแสดงข้อผิดพลาดไม่สามารถแก้ไขได้ชัดเจน ขอแนะนำให้ดำเนินการต่อไปนี้

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

หากยังพบข้อผิดพลาด โปรดติดต่อทีมสนับสนุนเพื่อรายงานปัญหา

คำเตือนที่ไม่บล็อก

คำเตือนที่ยังสามารถดำเนินการต่อได้สำหรับรายการโฆษณาเพื่อระบุปัญหาที่อาจส่งผลต่อการแสดงรายการโฆษณา ระบบจะส่งคำเตือนที่คล้ายกัน ใน UI ผ่านแบนเนอร์การแจ้งเตือน คำเตือนเหล่านี้เป็นแบบไม่ต้องดำเนินการใดๆ และจะแสดงในช่อง warningMessages ของรายการโฆษณา

แม้จะเป็นแบบแพสซีฟ แต่ปัญหาที่ทำให้เกิดคำเตือนเหล่านี้อาจส่งผลกระทบต่อการแสดงรายการโฆษณาจนถึงจุดที่ป้องกันการแสดงผลโดยสมบูรณ์ได้

การป้องกัน

ปัญหาหลายอย่างที่ทำให้เกิดคำเตือนที่ไม่บล็อกสามารถหลีกเลี่ยงได้ผ่านการกำหนดการตั้งค่ารายการโฆษณาที่เหมาะสม ซึ่งรวมถึงการตั้งค่าต่อไปนี้

• ช่วงเวลาแสดงโฆษณา: หากช่วงเวลาแสดงโฆษณาของรายการโฆษณาไม่ถูกต้องหรือการแสดงโฆษณาของใบสั่งซื้อการใส่โฆษณาหลักหมดอายุ รายการโฆษณาจะสร้างคำเตือนและจะไม่แสดง เพื่อหลีกเลี่ยงไม่ให้เกิดปัญหาหลัง ให้ตรวจสอบว่าการแสดงโฆษณาของรายการโฆษณาไม่ได้สิ้นสุดช้ากว่าการแสดงโฆษณาของใบสั่งซื้อการใส่โฆษณาระดับบนสุด
• ครีเอทีฟโฆษณาที่มอบหมาย: หากไม่มีการกำหนดครีเอทีฟโฆษณาที่ถูกต้องให้กับรายการโฆษณา รายการโฆษณาจะสร้างคำเตือนและจะไม่แสดง
• การกำหนดเป้าหมาย: หากไม่ได้กำหนดการกำหนดเป้าหมายของรายการโฆษณาอย่างถูกต้อง รายการโฆษณาอาจสร้างคำเตือน การแสดงโฆษณาอาจ ได้รับผลกระทบหรือถูกป้องกันไม่ให้เกิดขึ้นเลย

หากคุณจำลองการกำหนดค่าจากรายการโฆษณาที่มีอยู่ โปรดตรวจสอบว่ารายการโฆษณาที่มีอยู่ไม่ได้สร้างคำเตือนที่ไม่คาดคิด

Monitoring

ปัญหาที่ทําให้เกิดคําเตือนที่ไม่บล็อกอาจปรากฏขึ้นขณะที่รายการโฆษณาทํางานอยู่ เพื่อให้มั่นใจว่ารายการโฆษณาแสดงอย่างถูกต้อง ให้คอยตรวจสอบรายการโฆษณาที่ใช้งานอยู่เพื่อหาคำเตือนที่เพิ่งสร้างใหม่ คุณดึงข้อมูลรายการโฆษณาจำนวนมากได้โดยใช้ฟังก์ชัน advertisers.lineItems.list หากรายการโฆษณาสร้างคำเตือนที่ไม่คาดคิด คุณควรแก้ไขปัญหาทันทีเพื่อลดผลกระทบต่อการแสดงโฆษณา

ปัญหาอาจเกิดขึ้นได้แม้ว่าการตั้งค่าหรือการกำหนดเป้าหมายของรายการโฆษณาจะไม่มีการเปลี่ยนแปลง เช่น การหยุดชั่วคราวหรือการหมดอายุของใบสั่งซื้อการใส่โฆษณาระดับบนสุด และการเลิกใช้งานรายชื่อผู้ใช้หรือการกำหนดเป้าหมายอื่นๆ