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

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

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

ผู้เผยแพร่โฆษณาต้องใช้สิ่งต่อไปนี้

• บริการ Google Play 15.0.0 ขึ้นไปสำหรับ MRAID v3
• บริการ Google Play 7.8 ขึ้นไปสำหรับ 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.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.storePicture()

แอปต้องมีสิทธิ์ android.permission.WRITE_EXTERNAL_STORAGE จึงจะรองรับ mraid.storePicture() ได้