เมื่อใช้เครื่องมือตรวจสอบโฆษณาใน Mobile Ads SDK เวอร์ชันที่ต่ำกว่า 8.5.0 คุณจะทำสิ่งต่อไปนี้ได้
- ตรวจสอบหน่วยโฆษณา
- ตรวจสอบอะแดปเตอร์ของบุคคลที่สาม
- ตรวจสอบว่ามีการแสดงโฆษณาตามที่คาดไว้หรือไม่
- ระบุข้อผิดพลาดและดูรายละเอียดวิธีการแก้ไข
- ดูรายละเอียดสื่อกลางของเครือข่ายโฆษณาแต่ละเครือข่ายตามคำขอ
- ทดสอบแหล่งที่มาของโฆษณาสื่อกลางของบุคคลที่สามแต่ละแหล่ง
- ยืนยันว่าคุณได้กําหนดค่าหน่วยโฆษณาแต่ละหน่วยสําหรับสื่อกลาง Waterfall อย่างถูกต้อง
- ทดสอบการผสานรวมเหตุการณ์ที่กําหนดเอง
สําหรับ Mobile Ads SDK เวอร์ชัน 8.5.0 ขึ้นไป คุณยังทําสิ่งต่อไปนี้ได้ด้วย
- ดูรายละเอียดการเสนอราคาสําหรับเครือข่ายโฆษณาแต่ละเครือข่ายตามคําขอ
- ดูรายละเอียดการเสนอราคาและการแสดงโฆษณาสื่อกลางตามลำดับขั้นร่วมกันสําหรับเครือข่ายโฆษณาแต่ละเครือข่ายตามคําขอ
- ทดสอบแหล่งที่มาของโฆษณาสื่อกลางตามลำดับขั้นหรือการเสนอราคาของบุคคลที่สามแต่ละแหล่ง
ยืนยันว่าคุณได้กําหนดค่าหน่วยโฆษณาแต่ละหน่วยสําหรับการเสนอราคาและสื่อกลาง Waterfall อย่างถูกต้อง
คู่มือนี้สาธิตวิธีเปิดใช้และใช้ฟีเจอร์ต่างๆ ในเครื่องมือตรวจสอบโฆษณา
ข้อกำหนดเบื้องต้น
หากต้องการใช้เครื่องมือตรวจสอบโฆษณา คุณต้องดำเนินการดังนี้
- ทำตามคู่มือเริ่มต้นใช้งานให้เสร็จสิ้น
- ใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.68.0 ขึ้นไป
- เพิ่มอุปกรณ์เป็นอุปกรณ์ทดสอบ เครื่องมือตรวจสอบโฆษณาจะเปิดใช้งานในอุปกรณ์ทดสอบเท่านั้น
เปิดเครื่องมือตรวจสอบโฆษณา
คุณสามารถเปิดเครื่องมือตรวจสอบโฆษณาได้จากทุกที่ในแอปด้วยวิธีต่อไปนี้
- ใช้ท่าทางสัมผัสที่เลือกไว้ใน UI ของ AdMob เมื่อลงทะเบียนอุปกรณ์ทดสอบ
- ใช้ API ที่ระบุแบบเป็นโปรแกรม
- ใช้ปุ่มเปิดจากเมนูแก้ไขข้อบกพร่อง
เปิดใช้ด้วยท่าทางสัมผัส
คุณไม่จําเป็นต้องทําการเปลี่ยนแปลงแอปเพื่อเปิดเครื่องมือตรวจสอบโฆษณาด้วยท่าทางสัมผัส เพียงใช้ท่าทางสัมผัส (สะบัดหรือแตะสองครั้ง) ที่คุณกําหนดค่าไว้ใน AdMob สําหรับอุปกรณ์ทดสอบเครื่องนั้น ดูข้อมูลเพิ่มเติม
หลังจากตั้งค่าท่าทางสัมผัสใน UI ของ AdMob (และรอ 15 นาทีเพื่อให้การตั้งค่ามีผล) แอปของคุณจะต้องส่งคําขอโฆษณาเพื่อให้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ทราบเกี่ยวกับการตั้งค่าท่าทางสัมผัส หากท่าทางสัมผัสที่ระบุไม่ทำงาน ให้ลองโหลดโฆษณา รีสตาร์ทแอป แล้วทดสอบท่าทางสัมผัสอีกครั้ง
เปิดใช้งานแบบเป็นโปรแกรม
นอกจากนี้ คุณยังเปิดเครื่องมือตรวจสอบโฆษณาแบบเป็นโปรแกรมได้ด้วย โดยทำดังนี้
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 นี้ใช้ได้กับอุปกรณ์ทดสอบที่ลงทะเบียนแล้วไม่ว่าจะแบบเป็นโปรแกรมหรือใน UI ของ AdMob
ตรวจสอบว่าตัวควบคุมมุมมองที่ส่งไปยัง API นี้ปรากฏบนหน้าจออย่างสมบูรณ์แล้ว (มีการเรียก viewDidAppear:
) หากตัวควบคุมมุมมองที่ส่งผ่านอยู่ระหว่างกระบวนการแสดง เช่น เมื่อมีการเรียก API ในฟังก์ชัน viewDidLoad
ของตัวควบคุมมุมมอง การแสดงเครื่องมือตรวจสอบโฆษณาก็จะไม่สำเร็จ
ดูและแก้ปัญหาเกี่ยวกับหน่วยโฆษณา
เมื่อเปิดแล้ว หน้าจอเครื่องมือตรวจสอบโฆษณาหลักจะปรากฏขึ้นพร้อมรายการหน่วยโฆษณาทั้งหมดใน UI ของ AdMob ที่เชื่อมโยงกับรหัสแอป AdMob ของคุณซึ่งมีการกำหนดค่าการเสนอราคาหรือสื่อกลาง ดังนี้
เราขอแนะนําให้เริ่มต้นใช้งาน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ก่อนใช้เครื่องมือตรวจสอบโฆษณา
ดูรายละเอียดการแสดงโฆษณาสื่อกลางตามลำดับขั้นสําหรับหน่วยโฆษณา
แตะหน่วยโฆษณาเพื่อดูบันทึกคําขอ SDK ซึ่งแสดงรายละเอียดเกี่ยวกับการแสดงโฆษณาสื่อกลางตามลําดับขั้นจนถึงจุดที่มีการส่งโฆษณา (หรือจนกระทั่งการแสดงโฆษณาสื่อกลางตามลําดับขั้นสิ้นสุดลงโดยไม่มีการส่งโฆษณา) สําหรับคําขอโฆษณาล่าสุด
คุณขยายคำขอแต่ละรายการได้โดยใช้ตัวบ่งชี้การเปิดเผยเพื่อแสดงผลลัพธ์ของการแสดงโฆษณาสื่อกลางตามลำดับขั้นสําหรับคําขอนั้น พร้อมกับข้อผิดพลาดและเวลาในการตอบสนองที่เกี่ยวข้อง
สำหรับแหล่งที่มาของโฆษณาบุคคลที่สาม ระบบจะส่งข้อความแสดงข้อผิดพลาดจากแหล่งที่มาโดยตรง หากต้องการข้อมูลเพิ่มเติม โปรดปรึกษาแหล่งที่มาของโฆษณาบุคคลที่สาม
ดูรายละเอียดการเสนอราคาสําหรับหน่วยโฆษณา
ข้อกําหนดเบื้องต้น: SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 8.5.0 ขึ้นไป
หากคุณเพิ่งเริ่มใช้การเสนอราคา โปรดอ่านภาพรวม
ในบันทึกคําขอ SDK คุณจะเห็นแหล่งที่มาของโฆษณาซึ่งใช้การเสนอราคาที่เรียกใช้ในคําขอโฆษณา แตะหน่วยโฆษณาในบันทึกคําขอ SDK เพื่อดูรายละเอียดของแหล่งที่มาของโฆษณาแต่ละแหล่งในการประมูลการเสนอราคา
ผลลัพธ์การเสนอราคาจะจัดเรียงเพื่อแสดงรายการที่นําไปใช้ได้ใกล้กับด้านบนของรายการ
เครือข่ายโฆษณาที่ชนะการประมูลจะแสดงที่ด้านบน
ถัดไปคือเครือข่ายโฆษณาที่มีปัญหา คุณสามารถทำตามขั้นตอนการแก้ปัญหา
จากนั้นคือเครือข่ายโฆษณาที่ไม่มีการแสดงโฆษณาหรือไม่ได้เสนอราคา ข้อมูลนี้อาจบ่งบอกถึงปัญหาต่างๆ ที่เกิดขึ้นกับแหล่งที่มาของโฆษณา เนื่องจากอาจไม่ได้เสนอราคาเนื่องจากการตั้งค่าหรือการตัดสินใจ โปรดดูคู่มือการตั้งค่าของแหล่งที่มาของโฆษณา หรือติดต่อแหล่งที่มาของโฆษณาโดยตรงเพื่อขอรับการสนับสนุน
สุดท้ายที่ด้านล่างของรายการคือเครือข่ายโฆษณาที่แพ้การประมูลเสนอราคา
การแสดงโฆษณาสื่อกลางตามลำดับขั้นสามารถวางแหล่งที่มาของโฆษณาที่ชนะการประมูลเสนอราคาตามค่า eCPM
เมื่อมีการเรียกแหล่งที่มาของโฆษณาในการแสดงโฆษณาสื่อกลางตามลำดับขั้น แหล่งที่มาดังกล่าวจะแสดงโฆษณาได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการทํางานของการเสนอราคากับการแสดงโฆษณาสื่อกลางตามลำดับขั้นได้ที่ตัวอย่างที่ 2 และตัวอย่างที่ 3 ของการเสนอราคาและแหล่งที่มาของโฆษณา Waterfall ในกลุ่มสื่อกลาง
การแก้ไขข้อบกพร่องหน่วยโฆษณาขั้นสูง
เมื่อแก้ปัญหาเกี่ยวกับหน่วยโฆษณา คุณอาจต้องตรวจสอบคำขอโฆษณาและการตอบกลับเพื่อหาจุดที่มีปัญหา หรือแชร์กับทีมสนับสนุนของ Google เพื่อช่วยแก้ไขข้อบกพร่อง แตะไอคอนเมนูที่ด้านบนของเชนการแสดงโฆษณาตามลำดับขั้น แล้วเลือกแชร์คําขอโฆษณาและการตอบกลับเพื่อส่งออกคําขอโฆษณาและการตอบกลับแบบเต็ม ซึ่งจะช่วยคุณประหยัดปัญหาในการเรียกใช้การติดตามเครือข่ายในแอปของคุณเอง
นอกจากนี้ คุณยังดูพารามิเตอร์การเสนอราคาของบุคคลที่สามที่ถอดรหัสแล้วได้โดยแตะตัวเลือกพารามิเตอร์การเสนอราคาของบุคคลที่สามในเมนูเดียวกับสตริงคําขอ ข้อมูลนี้แสดงรายละเอียดเกี่ยวกับพารามิเตอร์การเสนอราคาของบุคคลที่สามที่อาจมีปัญหา ซึ่งจะช่วยให้คุณแก้ไขข้อบกพร่องของแอปหรือตรวจสอบว่าเครือข่ายรวบรวมสัญญาณได้สําเร็จ
ดูอะแดปเตอร์ที่พร้อมใช้งาน
คลิกแท็บอะแดปเตอร์เพื่อดูรายการอะแดปเตอร์ของบุคคลที่สามทั้งหมดที่เชื่อมโยงกับแหล่งที่มาของโฆษณาในการกําหนดค่าการเสนอราคาหรือสื่อกลางในแอป จากนั้นขยายการ์ดเพื่อดูสถานะการเริ่มต้นและเวอร์ชัน SDK นอกจากอะแดปเตอร์ของบุคคลที่สามที่รองรับแล้ว คุณยังดูอะแดปเตอร์เหตุการณ์ที่กําหนดเองได้ด้วย เหตุการณ์ที่กําหนดเองช่วยให้ผู้เผยแพร่โฆษณาใช้เครือข่ายโฆษณาที่ AdMob ไม่รองรับได้ เหตุการณ์ที่กําหนดเองจะแยกความแตกต่างจากอะแดปเตอร์มาตรฐานของบุคคลที่สามในรายการอะแดปเตอร์ได้ด้วยชื่อคลาสที่ไม่ซ้ำกัน นอกจากระบุชื่อคลาสและข้อมูลสถานะแล้ว ผู้ตรวจสอบโฆษณายังแสดงป้ายกำกับที่กำหนดให้กับเหตุการณ์ที่กําหนดเองเหล่านั้นในเว็บอินเทอร์เฟซของ AdMob ด้วย
ในกรณีที่ไม่พบอะแดปเตอร์หรือเริ่มต้นไม่สําเร็จ โปรดดูข้อมูลเพิ่มเติมที่หัวข้อแก้ปัญหาที่พบโดยใช้เครื่องมือตรวจสอบโฆษณา
ทดสอบหน่วยโฆษณา
หากต้องการทดสอบหน่วยโฆษณาโดยไม่ต้องไปยังส่วนนั้นใน UI ของแอป เครื่องมือตรวจสอบโฆษณารองรับการทดสอบนี้โดยตรงจากหน้าจอรายละเอียดหน่วยโฆษณา นอกจากนี้ คุณยังทดสอบหน่วยโฆษณาหลายรายการพร้อมกัน โหลดแบบไม่สอดคล้องกันและดูคําขอโฆษณาทดสอบ รวมถึงทำการทดสอบแหล่งที่มาของโฆษณาแหล่งเดียวได้ด้วย
การทดสอบโฆษณา
การทดสอบโฆษณาด้วยเครื่องมือตรวจสอบโฆษณาที่ระบุไว้ในส่วนนี้เป็นเครื่องมือที่ยอดเยี่ยมในการยืนยันประสบการณ์การใช้งานโฆษณาพื้นฐานและเพื่อตรวจสอบการกำหนดค่าสื่อกลางเมื่อใช้กับการทดสอบแหล่งที่มาของโฆษณาเดียว
เมื่อพร้อมทดสอบหน่วยโฆษณาแล้ว ให้แตะปุ่มขอโฆษณาทดสอบที่ด้านบนของหน้าจอเครื่องมือตรวจสอบโฆษณาเพื่อเรียกใช้การทดสอบโฆษณาของเครื่องมือตรวจสอบโฆษณา จากนั้นผลการทดสอบจะปรากฏในบันทึกคําขอ SDK ใต้ส่วนหัวขอจากเครื่องมือตรวจสอบโฆษณา
ดูวิธีใช้เครื่องมือตรวจสอบโฆษณาในแอปการทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว
เครื่องมือตรวจสอบโฆษณามีฟีเจอร์ในการจํากัดคําขอโฆษณาในแอปให้แสดงเฉพาะโฆษณาจากแหล่งที่มาของโฆษณาสื่อกลางตามลำดับขั้นหรือการเสนอราคาแหล่งเดียว วิธีนี้ช่วยให้ยืนยันได้ว่าคุณใช้อะแดปเตอร์ของบุคคลที่สามอย่างถูกต้อง และแหล่งที่มาได้แสดงโฆษณาตามที่คาดไว้
หากต้องการเปิดใช้ฟีเจอร์นี้ ให้เปิด/ปิดสวิตช์การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียวที่ด้านล่างของหน้าจอ ซึ่งจะแสดงกล่องโต้ตอบการเลือกแหล่งที่มาของโฆษณาต่อไปนี้
คุณต้องเริ่มต้นใช้งาน Google Mobile Ads SDK ก่อนจึงจะใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียวได้
จากนั้นเลือกแหล่งที่มาของโฆษณาแหล่งเดียวเพื่อทดสอบ เมื่อเลือกแหล่งที่มาของโฆษณาแล้ว หน้าจอต่อไปนี้จะปรากฏขึ้น
การตั้งค่าการทดสอบแหล่งที่มาของโฆษณาแหล่งเดียวจะมีผลกับคําขอโฆษณาในอนาคตที่คุณส่งในเซสชันเดียวกัน แต่จะไม่มีผลกับโฆษณาที่แคชไว้ก่อนหน้านี้ในเซสชันนั้นซึ่งยังไม่ได้แสดง เราขอแนะนําให้บังคับให้แอปรีสตาร์ทเมื่อใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว เพื่อทำให้โฆษณาที่แคชไว้ซึ่งอาจแสดงแทนที่แหล่งที่มาของโฆษณาที่เลือกไว้นั้นใช้งานไม่ได้
หลังจากรีสตาร์ทแอปแล้ว ตำแหน่งหน่วยโฆษณาทั้งหมดจะพยายามแสดงโฆษณาจากเครือข่ายที่เลือกเท่านั้น การเปิดตัวเครื่องมือตรวจสอบโฆษณาเมื่อการทดสอบแหล่งที่มาของโฆษณาแหล่งเดียวทํางานอยู่จะแสดงแหล่งที่มาของโฆษณาทดสอบที่ใช้งานอยู่
ในโหมดการทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว คำขอโฆษณาทั้งหมดจะพยายามส่งโฆษณาจากแหล่งที่มาที่เลือก ไม่ว่าแหล่งที่มานั้นจะกําหนดค่าไว้สําหรับการเสนอราคาหรือการแสดงโฆษณาสื่อกลางสําหรับหน่วยโฆษณาที่ขอหรือไม่ก็ตาม หากแหล่งที่มาที่คุณกำลังทดสอบไม่ได้อยู่ในการแสดงโฆษณาสื่อกลางตามลำดับขั้นสําหรับหน่วยโฆษณา คุณจะได้รับข้อความแสดงข้อผิดพลาด "ไม่สามารถแสดงโฆษณาได้"
ในการทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว คุณจะแตะหน่วยโฆษณาเพื่อดูบันทึกคําขอ SDK ของหน่วยโฆษณานั้นได้ วิธีนี้ช่วยให้คุณทราบว่าแหล่งที่มาได้ส่งโฆษณาตามคำขอที่เกิดขึ้นหลังเปิดใช้การทดสอบหรือไม่ หากแหล่งที่มาของโฆษณาโหลดโฆษณาไม่สําเร็จ ข้อความแสดงข้อผิดพลาดจะปรากฏขึ้นพร้อมอธิบายข้อผิดพลาด
หากคุณเพิ่มอินสแตนซ์หลายรายการของแหล่งที่มาที่เลือกลงในการแสดงโฆษณาสื่อกลางตามลำดับขั้น คุณจะเห็นการเรียกแต่ละอินสแตนซ์ไปยังแหล่งที่มาในการแสดงวิดีโอตามลำดับขั้นจนกระทั่งมีการส่งโฆษณา หรือการแสดงวิดีโอตามลำดับขั้นสิ้นสุดลงโดยไม่มีการส่งโฆษณา
หยุดการทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว
หากต้องการหยุดการทดสอบ ให้ปิดสวิตช์ดังนี้
จากนั้นข้อความยืนยันจะปรากฏขึ้นบนหน้าจอการรีสตาร์ทต่อไปนี้
เราขอแนะนำให้บังคับให้แอปรีสตาร์ทหลังจากหยุดการทดสอบเพื่อทำให้โฆษณาที่แคชไว้สำหรับแหล่งที่มาของโฆษณาที่ทดสอบเป็นโมฆะ
คัดลอกเอาต์พุตการแก้ไขข้อบกพร่องทั้งหมด
ผู้ตรวจสอบโฆษณารองรับการคัดลอกสตริง JSON ที่มีเอาต์พุตการแก้ไขข้อบกพร่องทั้งหมดจากเครื่องมือ ซึ่งรวมถึงรายละเอียดของแอป AdMob, สถานะการเริ่มต้นอะแดปเตอร์ และผลการทดสอบของหน่วยโฆษณาทั้งหมด
โดยแตะไอคอนแอป 7 ครั้งจนกว่าจะเห็นข้อความคัดลอก JSON ของเครื่องมือตรวจสอบโฆษณาไปยังคลิปบอร์ดแล้ว