google.
คลาสนี้แสดงถึงคอนเทนเนอร์สําหรับการแสดงโฆษณา SDK จะสร้างโครงสร้างภายในพารามิเตอร์คอนเทนเนอร์องค์ประกอบโดยอัตโนมัติเพื่อสร้างโฆษณาวิดีโอและโฆษณาซ้อนทับ
เมื่อมีการสร้างอินสแตนซ์ของคลาสนี้ ระบบจะสร้าง iframe ในคอนเทนเนอร์องค์ประกอบและโหลดแกน SDK คุณต้องเก็บรักษา iframe นี้เพื่อให้ SDK ทํางานได้อย่างถูกต้อง เมื่อโฆษณาทั้งหมดเล่นแล้วและไม่จําเป็นต้องใช้ SDK อีกต่อไป ให้ใช้เมธอด destroy() เพื่อยกเลิกการโหลด SDK
พารามิเตอร์คอนเทนเนอร์องค์ประกอบต้องเป็นองค์ประกอบที่เป็นส่วนหนึ่งของ DOM ต้องจัดตําแหน่งคอนเทนเนอร์องค์ประกอบอย่างถูกต้องเพื่อให้แสดงโฆษณาได้อย่างถูกต้อง เราขอแนะนําให้คุณวางตําแหน่งไว้เหนือโปรแกรมเล่นวิดีโอเนื้อหาและปรับขนาดให้ครอบคลุมโปรแกรมเล่นวิดีโอทั้งช่อง โปรดดูรายละเอียดการใช้งานที่แนะนําในเอกสารประกอบของ SDK
หมายเหตุ: จําเป็นต้องเรียกใช้เมธอด initialize() ในโค้ดที่เรียกใช้จากการดําเนินการของผู้ใช้โดยตรงเสมอ (เช่น การคลิกหรือแตะ)
ผู้ผลิต
คอนเทนเนอร์สําหรับโฆษณาแบบดิสเพลย์
AdDisplayContainer(containerElement, videoElement, clickTrackingElement)
พารามิเตอร์ |
|
|---|---|
|
องค์ประกอบคอนเทนเนอร์ |
องค์ประกอบที่จะแสดงโฆษณา คุณต้องแทรกองค์ประกอบใน DOM ก่อนที่จะสร้าง AdDisplayContainer ค่าต้องไม่เป็นค่าว่าง |
|
องค์ประกอบวิดีโอ |
ไม่บังคับ ระบุองค์ประกอบการเล่นโฆษณาวิดีโอทางเลือก เราขอแนะนําให้ส่งในโปรแกรมเล่นวิดีโอของเนื้อหาทุกครั้ง ค่าต้องไม่เป็นค่าว่าง |
|
องค์ประกอบติดตามการคลิก |
ไม่บังคับ ระบุองค์ประกอบการคลิกโฆษณาวิดีโอทางเลือก ปล่อยว่างไว้เพื่อให้ SDK จัดการการคลิก SDK จะใช้องค์ประกอบการติดตามการคลิกที่กําหนดเองเมื่อแสดงครีเอทีฟโฆษณาที่ไม่ใช่ AdSense/AdX ในสภาพแวดล้อมที่ไม่รองรับ UI ที่วางซ้อนโปรแกรมเล่นวิดีโอเท่านั้น (เช่น iPhone หรือ Android ก่อน 4.0) แม้ว่าจะมีการระบุไว้ก็ตาม องค์ประกอบการติดตามการคลิกที่กําหนดเองไม่ควรแสดงผลผ่านโปรแกรมเล่นวิดีโอเนื่องจากอาจสกัดกั้นการคลิกไปยังองค์ประกอบ UI ที่ SDK แสดงผลได้ และโปรดทราบว่า SDK จะไม่แก้ไขการแสดงองค์ประกอบการติดตามการคลิกที่กําหนดเอง ซึ่งหมายความว่าหากมีการให้องค์ประกอบการติดตามการคลิกที่กําหนดเอง องค์ประกอบนั้นจะต้องแสดงอย่างถูกต้องเมื่อมีการเล่นโฆษณาเชิงเส้น คุณตรวจสอบ ima.AdsManager.isCustomClickTrackingUsed เมื่อเหตุการณ์ ima.AdEvent.Type.STARTED เริ่มทํางานเพื่อตัดสินว่าจะแสดงองค์ประกอบการติดตามที่กําหนดเองของคุณหรือไม่ หากเหมาะสมกับ UI ของคุณ คุณควรซ่อนองค์ประกอบการติดตามการคลิกเมื่อเหตุการณ์ ima.AdEvent.Type.CONTENT_RESUME_REQUESTED เริ่มทํางาน ค่าต้องไม่เป็นค่าว่าง |
วิธีการ
ทำลาย
ทําลาย()
ทําลายสถานะภายในและองค์ประกอบ DOM ที่สร้างขึ้นก่อนหน้านี้ ระบบจะยกเลิกการโหลด IMA SDK และไม่ควรเรียกใช้ API ใดๆ อีก
เริ่มต้น
เริ่มต้น()
เริ่มต้นองค์ประกอบวิดีโอภายในสําหรับการเล่น คุณต้องเรียกใช้เมธอดนี้เป็นผลลัพธ์โดยตรงของการดําเนินการของผู้ใช้ เพื่อให้เบราว์เซอร์ทําเครื่องหมายองค์ประกอบวิดีโอเมื่อผู้ใช้เริ่มต้นได้
บางเบราว์เซอร์จะอนุญาตการเล่นวิดีโอโดยไม่มีการโต้ตอบของผู้ใช้หากปิดเสียงวิดีโอไว้ สําหรับลักษณะการทํางานนี้ ให้ใช้ AdsRequest.setAdWillPlayMuted(true) และเรียกเมธอดนี้ก่อน AdsManager.start()