เครื่องมือตรวจสอบโฆษณา

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

คุณสามารถใช้เครื่องมือตรวจสอบโฆษณาเพื่อดำเนินการต่อไปนี้

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

คู่มือนี้แสดงวิธีเปิดตัวและใช้ฟีเจอร์ต่างๆ ในเครื่องมือตรวจสอบโฆษณา

สิ่งที่ต้องดำเนินการก่อน

คุณต้องมีคุณสมบัติต่อไปนี้จึงจะใช้เครื่องมือตรวจสอบโฆษณาได้

  • ใช้ปลั๊กอินโฆษณาในอุปกรณ์เคลื่อนที่ Flutter เวอร์ชัน1.3.0 ขึ้นไป

เปิดตัวเครื่องมือตรวจสอบโฆษณา

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

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

เปิดโดยใช้เมนูแก้ไขข้อบกพร่อง

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

หากคุณไม่ได้ลิงก์อุปกรณ์ ระบบอาจขอให้คุณลงชื่อเข้าใช้บัญชี Ad Manager

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

เปิดตัวแบบเป็นโปรแกรม

คุณเปิดใช้เครื่องมือตรวจสอบโฆษณาแบบเป็นโปรแกรมได้ด้วย โดยทำดังนี้

MobileAds.instance.openAdInspector(
  (AdInspectorError? error) {
    // Error will be non-null if ad inspector closed due to an error.
  });

API นี้ใช้งานได้กับอุปกรณ์ทดสอบ ที่ลงทะเบียน แบบเป็นโปรแกรม

ดูและแก้ปัญหาหน่วยโฆษณา

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

เราขอแนะนำให้เริ่มต้นใช้งาน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ก่อนใช้เครื่องมือตรวจสอบโฆษณา

ดูรายละเอียด Waterfall ของสื่อกลางสำหรับหน่วยโฆษณา

แตะหน่วยโฆษณาเพื่อดูบันทึกคำขอ SDK ซึ่งให้รายละเอียดเกี่ยวกับ Waterfall สื่อกลางจนถึงจุดที่มีการส่งโฆษณา (หรือ Waterfall สิ้นสุดลงโดยไม่มีการส่งโฆษณา) สำหรับคำขอโฆษณาล่าสุด

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

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

ดูรายละเอียดการเสนอราคาของหน่วยโฆษณา

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

ในบันทึกคำขอ SDK คุณจะเห็น bidding แหล่งที่มาของโฆษณาซึ่งมีการเรียกในคำขอโฆษณา แตะหน่วยโฆษณาในบันทึกคำขอ SDK เพื่อดูรายละเอียดของแหล่งที่มาของโฆษณาแต่ละแหล่งใน bidding การประมูล

ผลลัพธ์ bidding จะจัดเรียงเพื่อให้รายการที่ดำเนินการได้อยู่ใกล้ด้านบนสุดของรายการมากขึ้น

  • เครือข่ายโฆษณาที่ชนะการประมูลที่ด้านบน

  • ต่อไปคือเครือข่ายโฆษณาที่มีปัญหา คุณสามารถทําตาม ขั้นตอนการแก้ปัญหาสำหรับปัญหา ตอนท้ายของ bidding คำถามที่พบบ่อย

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

  • สุดท้าย ที่ด้านล่างของรายการคือเครือข่ายโฆษณาที่แพ้การประมูลbidding

Waterfall ของสื่อกลางสามารถวางแหล่งที่มาของโฆษณาที่ชนะการประมูล bidding ตามค่า eCPM

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

การแก้ไขข้อบกพร่องหน่วยโฆษณาขั้นสูง

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

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

Android
iOS

ดูอะแดปเตอร์ที่ใช้ได้

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

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

Android
iOS

หรือไม่

ทดสอบหน่วยโฆษณาของคุณ

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

การทดสอบโฆษณา

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

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

ดูวิธีใช้เครื่องมือตรวจสอบโฆษณาในแอป

การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว

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

หากต้องการเปิดใช้ฟีเจอร์นี้ ให้สลับสวิตช์การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียวที่ด้านล่างของหน้าจอ วิธีนี้จะแสดงกล่องโต้ตอบการเลือกแหล่งที่มาของโฆษณาต่อไปนี้

คุณต้องเริ่มต้น SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ก่อนจึงจะใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียวได้

จากนั้นคุณจะเลือกแหล่งที่มาของโฆษณา 1 แห่งเพื่อทดสอบได้ เมื่อเลือกแหล่งที่มาของโฆษณาแล้ว หน้าจอต่อไปนี้จะปรากฏขึ้น

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

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

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

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

หากคุณเพิ่มอินสแตนซ์หลายรายการของแหล่งที่มาของโฆษณาที่เลือกลงใน Waterfall ของสื่อกลาง คุณจะเห็นการเรียกแต่ละอินสแตนซ์ไปยังแหล่งที่มาของโฆษณาใน Waterfall จนกระทั่งมีการส่งโฆษณาหรือ Waterfall สิ้นสุดลงโดยไม่มีการส่งโฆษณา

หยุดการทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว

หากต้องการหยุดการทดสอบ ให้สลับสวิตช์ดังนี้

ข้อความยืนยันจะปรากฏขึ้นบนหน้าจอรีสตาร์ทต่อไปนี้

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

คัดลอกเอาต์พุตสำหรับการแก้ไขข้อบกพร่องทั้งหมด

เครื่องมือตรวจสอบโฆษณารองรับการคัดลอกสตริง JSON ที่มีเอาต์พุตของการแก้ไขข้อบกพร่องทั้งหมดจากเครื่องมือ ซึ่งรวมถึงรายละเอียดAd Manager แอป สถานะการเริ่มต้นของอะแดปเตอร์ และผลการทดสอบของหน่วยโฆษณาทั้งหมด

โดยให้แตะไอคอนแอป 7 ครั้งจนกว่าจะเห็นข้อความคัดลอกเครื่องมือตรวจสอบโฆษณา JSON ไปยังคลิปบอร์ดแล้ว