ตอนนี้ Google Mobile Ads SDK รองรับ MRAID v3 เวอร์ชันเบต้า ซึ่งสร้างขึ้นจากการรองรับ MRAID v2 ที่มีอยู่แล้ว เพื่อให้ผู้ลงโฆษณาสามารถแสดงครีเอทีฟโฆษณา MRAID v3 ต่อผู้เผยแพร่โฆษณา Ad Manager ได้ คำแนะนำนี้จะชี้แจงรายละเอียดการติดตั้งใช้งาน MRAID ที่ไม่ชัดเจนและตีความได้หลายแบบในข้อกำหนด MRAID v3 กลุ่มเป้าหมายที่ต้องการคือผู้เขียนครีเอทีฟโฆษณา MRAID v3
ข้อกำหนดเบื้องต้น
ผู้เผยแพร่โฆษณาต้องดำเนินการดังนี้
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ iOS 7.30.0 ขึ้นไปสำหรับ MRAID v3
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ iOS 7.4.0 ขึ้นไปสำหรับ MRAID v2
ข้อมูลเบื้องต้นที่เป็นประโยชน์
หากไม่คุ้นเคยกับ MRAID คุณสามารถดูข้อมูลเพิ่มเติมได้ที่หน้า MRAID ของ IAB นอกจากนี้ คุณยังดาวน์โหลดเอกสารคำจำกัดความของ MRAID v3 ซึ่งให้รายละเอียดเกี่ยวกับพารามิเตอร์ทั้งหมดที่กล่าวถึงด้านล่าง รวมถึงบล็อกโพสต์ของ IAB เกี่ยวกับ MRAID v3 ได้ด้วย
รายละเอียดการใช้งาน MRAID v3 (เบต้า)
การมองเห็นโฆษณา - เหตุการณ์ exposureChange
ระบบรองรับเหตุการณ์นี้ และเราขอแนะนำให้ใช้ Listener สำหรับเหตุการณ์ exposureChange ใหม่แทนเหตุการณ์ viewableChange ที่เลิกใช้งานแล้ว
นอกจากนี้ เรายังเลิกใช้งานเมธอด mraid.isViewable() ด้วย อย่างไรก็ตาม เราจะยังคงรองรับเมธอดที่เลิกใช้งานแล้วเหล่านี้
ต่อไปเพื่อให้มีความเข้ากันได้แบบย้อนหลัง
ระบบจะส่งคำจำกัดความเหตุการณ์ exposureChange ทุกครั้งที่มุมมองโฆษณา
เปลี่ยนแปลง SDK มีกลไกการสำรวจเพื่อหลีกเลี่ยงการสร้างเหตุการณ์มากเกินไป
ระบบจะส่งสถานะเริ่มต้นแบบไม่พร้อมกันหลังจากที่โฆษณาลองรับผู้ฟัง
Callback มีพารามิเตอร์ exposed_percentage ซึ่งเป็นตัวเลขทศนิยม
ระหว่าง 0.0 ถึง 100.0
ดูตัวอย่างการใช้งานได้ในข้อกำหนด MRAID v3
การตรวจหาและการเริ่มต้น MRAID และแอตทริบิวต์ MRAID_ENV
SDK เป็นไปตามโปรโตคอลการเริ่มต้นตามที่กำหนดไว้ในข้อกำหนด MRAID v3
ในออบเจ็กต์ MRAID_ENV SDK จะไม่ส่ง IDFA, limitAdTracking,
รหัสแอป หรือ COPPA (ซึ่งไม่บังคับ) โดยจะระบุตัวแปรที่จำเป็นทั้งหมด
ในออบเจ็กต์ MRAID_ENV ซึ่งรวมถึงเวอร์ชัน MRAID, ชื่อ SDK และเวอร์ชัน SDK
การวัดการได้ยิน
เราได้เปิดตัวเหตุการณ์ใหม่ (audioVolumeChange) เพื่อระบุว่าได้ยินเสียงหรือไม่
และเมื่อใดที่ระดับเสียงเปลี่ยนแปลง
เหตุการณ์ audioVolumeChange มีพารามิเตอร์เดียวคือ volume_percentage
ค่านี้คือเปอร์เซ็นต์ของระดับเสียงสูงสุดในการเล่นเสียง เป็นจำนวนทศนิยมระหว่าง 0.0 ถึง 100.0 (0.0 เมื่อไม่อนุญาตให้เล่น) หรือ null หากระบุระดับเสียงไม่ได้
ดูตัวอย่างการใช้งานได้ในข้อกำหนด MRAID v3
mraid.getLocation()
เนื่องจากไม่รองรับ mraid.getLocation() จึงจะแสดงผล -1 เสมอ
mraid.unload()
เรียกใช้เมธอดนี้ได้ทุกเมื่อ และ SDK จะตอบสนองด้วยการปิดโฆษณา ยกเลิกการจัดสรรทรัพยากร แล้วนำ WebView ออก หรือแทนที่ด้วยเอกสารอื่นหรือโฆษณาใหม่
เมื่อครีเอทีฟโฆษณาเรียกใช้ unload() เลเยอร์เนทีฟจะตอบสนองดังนี้
สำหรับครีเอทีฟโฆษณาประเภทต่างๆ
| ประเภท | ลักษณะการทำงานของ unload() |
|---|---|
| แบนเนอร์ | ส่งคำขอโฆษณาใหม่โดยใช้พารามิเตอร์คำขอเดียวกันกับโฆษณาปัจจุบัน |
| โฆษณาคั่นระหว่างหน้า | ปิดโฆษณาคั่น |
VPAID (Video Player Ad Interface Definition หรือคำนิยามของอินเทอร์เฟซโฆษณาของโปรแกรมเล่นวิดีโอ)
Google Mobile Ads SDK ไม่รองรับ VPAID mraid.supports('vpaid')
จะแสดงผลเป็นเท็จ
mraid.useCustomClose()
mraid.useCustomClose() อาจไม่รองรับ ทั้งนี้ขึ้นอยู่กับรูปแบบและ
ประเภทครีเอทีฟโฆษณา
รายละเอียดการใช้งาน MRAID v2
mraid.getVersion()
mraid.getVersion() จะไม่แสดงผล 2.0 จนกว่าครีเอทีฟโฆษณาจะโหลดเสร็จ ไม่ต้อง
ตรวจสอบเวอร์ชัน MRAID ขณะที่ mraid.getState() แสดงผล loading
mraid.resize()
เมื่อเรียกใช้ mraid.resize() ระบบจะแทนที่แบนเนอร์เดิมด้วย
รูปภาพหน้าจอของแบนเนอร์ คุณจะสังเกตเห็นได้หากโฆษณาที่ปรับขนาด
ไม่ครอบคลุมพื้นที่โฆษณาเดิม
นอกจากนี้ โฆษณาที่ปรับขนาดแล้วจะไม่เป็นไปตามกรอบแบนเนอร์เดิม หากวางแบนเนอร์ในมุมมองแบบเลื่อน โฆษณาที่ปรับขนาดแล้วจะไม่เลื่อนไปพร้อมกับแบนเนอร์
mraid.setResizeProperties()
การเรียกใช้ mraid.setResizeProperties() ทั้งหมดควรมีรายการพร็อพเพอร์ตี้ที่จำเป็นทั้งหมด
หากพร็อพเพอร์ตี้การปรับขนาดไม่ถูกต้อง ระบบจะตั้งค่ากลับ
เป็นค่าเริ่มต้น และการเรียก mraid.resize() ทั้งหมดหลังจากนั้นจะล้มเหลวจนกว่าจะมีการเรียก mraid.setResizeProperties() อีกครั้งด้วยพารามิเตอร์ที่ถูกต้อง
mraid.getMaxSize()
mraid.getMaxSize() ควรใช้เพื่อกำหนดขนาดสูงสุดสำหรับโฆษณาที่ปรับขนาดแล้วเท่านั้น หากต้องการกำหนดขนาดของโฆษณาที่ขยายได้ ให้ใช้ mraid.getScreenSize()
mraid.setOrientationProperties()
เมื่อเรียกใช้ mraid.setOrientationProperties() โดยตั้งค่าพร็อพเพอร์ตี้ allowOrientationChange
เป็น true การตั้งค่าพร็อพเพอร์ตี้ forceOrientation จะไม่มีผลใดๆ
ครีเอทีฟโฆษณาที่ต้องการบังคับการวางแนวควรตั้งค่า allowOrientationChange เป็น
false
mraid.isViewable()
หากมุมมองครอบคลุมโฆษณาที่มองเห็นได้ mraid.isViewable()จะยังคงแสดงผล
true เนื้อหาแอปไม่ควรบังโฆษณาที่มองเห็นได้
mraid.getCurrentPosition()
ขณะที่โฆษณาที่ขยายได้ 2 ชิ้นอยู่ในสถานะขยาย การเรียกไปยัง
mraid.getCurrentPosition() ในชิ้นแรกจะแสดงผลขนาดของ
หน้าจอ
mraid.supports()
ตั้งแต่ SDK เวอร์ชัน 7.11.0 เป็นต้นไป mraid.supports("storePicture") และ
mraid.supports("calendar") จะส่งคืน false เสมอ ตามข้อกำหนด MRAID v2
ครีเอทีฟโฆษณาควรจัดการกรณีที่ไม่มีเมธอดเหล่านี้ได้
mraid.storePicture()
แอปจะขอสิทธิ์บันทึกรูปภาพโดยอัตโนมัติ
เมื่อครีเอทีฟโฆษณา MRAID เรียกใช้ mraid.storePicture()