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

ตอนนี้ 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 โปรดดูข้อมูลเพิ่มเติมที่หน้า 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.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()

หากต้องการให้แอปรองรับ mraid.storePicture() แอปจะต้องมีสิทธิ์ android.permission.WRITE_EXTERNAL_STORAGE