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

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

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

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

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

ข้อกำหนดเบื้องต้น

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

  • ใช้ Google Mobile Ads SDK เวอร์ชัน 8.10.0 ขึ้นไป

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

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

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

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

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

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

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

เปิดใช้งานแบบเป็นโปรแกรม

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

Swift

GADMobileAds.sharedInstance().presentAdInspector(from: viewController) { error in
  // Error will be non-nil if there was an issue and the inspector was not displayed.
}

Objective-C

[GADMobileAds.sharedInstance presentAdInspectorFromViewController:viewController
  completionHandler:^(NSError *error) {
    // Error will be non-nil if there was an issue and the inspector was not displayed.
}];

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

ตรวจสอบว่าตัวควบคุมมุมมองที่ส่งไปยัง API นี้ปรากฏบนหน้าจออย่างสมบูรณ์แล้ว (มีการเรียก viewDidAppear:) หากตัวควบคุมมุมมองที่ส่งผ่านอยู่ระหว่างแสดง เช่น เมื่อมีการเรียก API ในฟังก์ชัน viewDidLoad ของตัวควบคุมมุมมอง การแสดงเครื่องมือตรวจสอบโฆษณาก็จะไม่สำเร็จ

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

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

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

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

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

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

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

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

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

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

ผลลัพธ์การเสนอราคาจะจัดเรียงเพื่อให้รายการที่นําไปใช้ได้อยู่ใกล้กับด้านบนของรายการ

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

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

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

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

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

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

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

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

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

ดูอะแดปเตอร์ที่พร้อมใช้งาน

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

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

ทดสอบหน่วยโฆษณา

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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