ขณะนี้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google มีการรองรับ 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 ดูข้อมูลเพิ่มเติมได้ที่หน้า IAB MRAID คุณยังสามารถดาวน์โหลดเอกสาร MRAID v3 คำจำกัดความ ซึ่งให้รายละเอียดเกี่ยวกับพารามิเตอร์ทั้งหมดที่กล่าวถึงด้านล่าง รวมถึงบล็อกโพสต์ของ IAB เกี่ยวกับ MRAID v3
รายละเอียดการใช้งาน MRAID v3 (เบต้า)
การมองเห็นโฆษณา - เหตุการณ์การเปลี่ยนแปลงจำนวนผู้ที่เห็น
ระบบรองรับเหตุการณ์นี้และขอแนะนำให้ใช้ Listener สำหรับเหตุการณ์ exposureChange ใหม่แทนเหตุการณ์ viewableChange ที่เลิกใช้งานแล้ว
วิธี mraid.isViewable() ก็เลิกใช้งานแล้วเช่นกัน อย่างไรก็ตาม ระบบจะยังรองรับวิธีการที่เลิกใช้งานแล้วต่อไปเพื่อรักษาความเข้ากันได้แบบย้อนหลัง
ระบบจะส่งคําจํากัดความเหตุการณ์ exposureChange ไปเมื่อใดก็ตามที่การดูโฆษณาเปลี่ยนแปลง SDK มีกลไกการสำรวจเพื่อหลีกเลี่ยงการสร้างเหตุการณ์มากเกินไป
สถานะเริ่มต้นจะส่งแบบไม่พร้อมกันหลังจากที่โฆษณาลงทะเบียน Listener
โค้ดเรียกกลับจะมีพารามิเตอร์ 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() เลเยอร์เนทีฟจะตอบกลับสำหรับครีเอทีฟโฆษณาประเภทต่างๆ ดังนี้
| ประเภท | พฤติกรรมยกเลิกการโหลด() |
|---|---|
| แบนเนอร์ | สร้างคำขอโฆษณาใหม่ที่มีพารามิเตอร์คำขอเดียวกันกับโฆษณาปัจจุบัน |
| โฆษณาคั่นระหว่างหน้า | ปิดโฆษณาคั่นระหว่างหน้า |
VPAID (ข้อกำหนดอินเทอร์เฟซการแสดงโฆษณาบนโปรแกรมเล่นวิดีโอ)
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()