โฆษณาแบบริชมีเดียบนมือถือ

ขณะนี้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google มีการรองรับ 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 คุณยังสามารถดาวน์โหลดเอกสาร 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.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() ได้