מודעות מדיה עשירה לנייד

ב-Google Mobile Ads SDK יש עכשיו תמיכה בגרסת בטא ב-MRAID v3, שמבוססת על התמיכה הקיימת ב-MRAID v2, ומאפשרת למפרסמים להציג קריאייטיבים של MRAID v3 לבעלי תוכן דיגיטלי ב-Ad Manager. המדריך הזה מבהיר את הפרטים של הטמעת MRAID שהיו לא ברורים וניתנים לפרשנות במפרט של MRAID v3. קהל היעד שלו הוא מחברי קריאייטיב בגרסה 3 של MRAID.

דרישות מוקדמות

בעלי תוכן דיגיטלי צריכים להפעיל:

• Google Play Services מגרסה 15.0.0 ואילך ל-MRAID v3
• Google Play Services מגרסה 7.8 ואילך ל-MRAID v2

פריימרים שימושיים

לא יודעים איך משתמשים ב-MRAID? מידע נוסף זמין בדף של IAB MRAID. תוכלו גם להוריד את המסמך הגדרות MRAID v3, שכולל פרטים על כל הפרמטרים שמוזכרים בהמשך, וגם את הפוסט בבלוג של IAB ב-MRAID v3.

פרטי ההטמעה של MRAID v3 (בטא)

נראות המודעה - אירוע חשיפה שינוי

האירוע הזה נתמך, ומומלץ להשתמש ב-listener עבור האירוע החדש exposureChange במקום האירוע viewableChange שהוצא משימוש. גם השיטה mraid.isViewable() הוצאה משימוש. עם זאת, השיטות האלה שהוצאו משימוש עדיין נתמכות כדי לשמור על תאימות לאחור.

הגדרת האירוע exposureChange נשלחת בכל פעם שהתצוגה של המודעה משתנה. ל-SDK יש מנגנון תשאול כדי למנוע יצירה של יותר מדי אירועים. המצב הראשוני נשלח באופן אסינכרוני לאחר שבמודעה מתבצע רישום של מאזין. הקריאה החוזרת כוללת את הפרמטר exposed_percentage, שהוא מספר נקודה צפה (floating-point) בין 0.0 ל-100.0.

תוכלו להיעזר במפרט של MRAID v3.

זיהוי ואתחול של MRAID ומאפייני MRAID_ENV

ה-SDK תואם לפרוטוקול האתחול כפי שמוגדר במפרט של גרסה 3 של MRAID.

באובייקט MRAID_ENV, ה-SDK לא שולח את הערכים IDFA, limitAdTracking, מזהה אפליקציה או COPPA (אופציונלי). הוא מספק את כל המשתנים הנדרשים באובייקט MRAID_ENV, כולל גרסת MRAID, שם ה-SDK וגרסת ה-SDK.

מדידת יכולת ההשמעה

נוסף אירוע חדש (audioVolumeChange) כדי לזהות אם אפשר לשמוע את האודיו ומתי עוצמת הקול משתנה.

האירוע audioVolumeChange מכיל פרמטר אחד בלבד: volume_percentage. הערך הוא האחוז מעוצמת הקול המקסימלית של הפעלת אודיו. זהו מספר נקודה צפה (floating-point) בין 0.0 ל-100.0 (0.0 כשההפעלה אסורה) או null אם לא ניתן לקבוע את עוצמת הקול.

תוכלו להיעזר במפרט של MRAID v3.

mraid.getLocation()

מכיוון שאין תמיכה ב-mraid.getLocation(), הוא תמיד מחזיר -1.

mraid.unload()

אפשר לקרוא לשיטה הזו בכל שלב, וה-SDK מגיב על ידי סגירת המודעה, איתור המשאבים ואז הסרת ה-WebView או החלפתו במסמך אחר או במודעה חדשה.

כשהקריאייטיב מבצע קריאה ל-unload(), שכבת המודעה המותאמת מגיבה באופן הבא לסוגי הקריאייטיב השונים:

סוג	ההתנהגות של unload()
מודעות באנר	צור בקשה חדשה למודעה עם אותם פרמטרים של בקשה כמו המודעה הנוכחית.
מודעות מעברון	סוגרים את מודעת המעברון.

VPAID (הגדרת ממשק מודעה של נגן וידאו)

SDK של מודעות Google לנייד לא תומך ב-VPAID. mraid.supports('vpaid') מחזירה false.

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()

כשמודעה ניתנת להרחבה בשני חלקים נמצאת במצב המורחב, קריאה ל-mraid.getCurrentPosition() בחלק הראשון תחזיר את גודל המסך.

mraid.storePicture()

כדי שאפליקציה תתמוך ב-mraid.storePicture(), היא צריכה לכלול את ההרשאה android.permission.WRITE_EXTERNAL_STORAGE.