โฆษณาแบบริชมีเดียบนอุปกรณ์เคลื่อนที่

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

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

ผู้เผยแพร่โฆษณาต้องใช้ SDK เวอร์ชันต่อไปนี้

  • Google Mobile Ads SDK สำหรับ iOS เวอร์ชัน 7.30.0 ขึ้นไปสำหรับ MRAID v3
  • Google Mobile Ads SDK สำหรับ iOS เวอร์ชัน 7.4.0 ขึ้นไปสำหรับ MRAID v2

ข้อมูลเบื้องต้นที่เป็นประโยชน์

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

รายละเอียดการใช้งาน MRAID v3 (เบต้า)

การมองเห็นโฆษณา - เหตุการณ์ exposureChange

ระบบรองรับเหตุการณ์นี้ และเราขอแนะนำให้ใช้ 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() เลเยอร์เนทีฟจะตอบสนองดังนี้สำหรับครีเอทีฟโฆษณาประเภทต่างๆ

ประเภท ลักษณะการทำงานของ 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()