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

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

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

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

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

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

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

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

ข้อผิดพลาด SDF

Display & Video 360 API ใช้วิธีการแบบไม่พร้อมกันสําหรับการสร้างและการดาวน์โหลดไฟล์ Structured Data (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 ของรายการโฆษณา

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

การป้องกัน

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

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

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

การตรวจสอบ

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

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