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

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

เมื่อใช้เครื่องมือตรวจสอบโฆษณาใน SDK โฆษณาในอุปกรณ์เคลื่อนที่เวอร์ชันที่ต่ำกว่า20.2.0คุณจะทําสิ่งต่อไปนี้ได้

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

สำหรับ SDK โฆษณาในอุปกรณ์เคลื่อนที่เวอร์ชัน 20.2.0 ขึ้นไป คุณสามารถทำดังนี้

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

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

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

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

  • ใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 20.0.0 ขึ้นไป

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

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

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

เปิดโดยใช้ท่าทางสัมผัส

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

หลังจากตั้งค่าท่าทางสัมผัสใน UI ของ AdMob (และรอ 15 นาทีเพื่อให้เผยแพร่) แอปของคุณต้องส่งคำขอโฆษณาสำหรับ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อเรียนรู้เกี่ยวกับการตั้งค่าท่าทางสัมผัส หากท่าทางสัมผัสที่ระบุไว้ไม่ทำงาน ให้ลองโหลดโฆษณา รีสตาร์ทแอป และทดสอบท่าทางสัมผัสอีกครั้ง

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

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

Java

MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
  public void onAdInspectorClosed(@Nullable AdInspectorError error) {
    // Error will be non-null if ad inspector closed due to an error.
  }
});

Kotlin

MobileAds.openAdInspector(context) { error ->
  // Error will be non-null if ad inspector closed due to an error.
}

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

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

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

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

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

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

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

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

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

ข้อกำหนดเบื้องต้น: SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google 20.2.0 ขึ้นไป

ถ้าคุณยังใหม่กับการเสนอราคา โปรดอ่านภาพรวม

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

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

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

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

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

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

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

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

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

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

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

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

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

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

หรือไม่

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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