IMA SDK ל-Android כולל את Open Measurement (OM) SDK, שהוא תקן בתחום שפותח על ידי Interactive Advertising Bureau (IAB) כדי לאפשר מדידה של ניראות ואימות על ידי צד שלישי. כשמשתמשים ב-IMA SDK ל-Android, ה-OM SDK שכלול בו מנתח באופן אוטומטי את התג <AdVerifications> בתגי מודעות VAST ושולח נתוני ניראות לספקי המדידה שצוינו באמצעות OMID API. ערכת IMA SDK תומכת ב-OM SDK גרסה 1.4, בתוספים של GAM AdVerifications ב-VAST 2 ומעלה, ובצומת AdVerifications ב-VAST 4 ומעלה.כדי להשתמש במדידה פתוחה, חשוב לזכור את הנקודות הבאות:
כדי להשתמש ב-Open Measurement, צריך להשתמש בגרסה 3.11.0 ואילך של IMA SDK ל-Android. עם זאת, הדוגמה במדריך הזה מיועדת לגרסה החדשה ביותר של ה-SDK וכוללת ממשקי API שהוצגו בגרסה 3.16.5.
אם משתמשים ב-VAST 4.1 ומעלה, צריך להגדיר את המודעות כך שהתנועה תועבר
<AdVerifications>בתג VAST שלהן בהתאם למפרט VAST 4.1. אחרת, צריך להשתמש ב-<Extension type="AdVerifications">.חשוב להימנע מכיסוי של
AdDisplayContainerבשכבות-על (שקופות או אטומות), כי הן יסומנו כהפרעות על ידי OM SDK ויפחיתו את שיעור הצפייה.
דרישות מוקדמות
- אם המודעות שלכם מנוהלות באמצעות Ad Manager, צריך להגדיר ספק מדידת נראות לרשת Ad Manager ולהקצות את ספק מדידת הנראות הזה לפריט.
בדיקה
כדי לבדוק את Open Measurement באמצעות IMA SDK, צריך להשתמש בגרסה של IMA שתומכת ב-OM SDK, יחד עם תג בדיקה של מודעה.
התגובה של VAST אמורה להכיל את הערך <AdVerifications>.
רישום של חסימות בשכבת-העל של כפתורי השליטה בסרטון
אמצעי בקרה של סרטונים, כמו לחצני השהיה או סרגלי התקדמות, מספקים למשתמשים מידע חיוני על ההפעלה ופעולות חשובות. בנייד, נהוג להציג אמצעי בקרה גדולים שנוחים למגע מעל רכיב המדיה, בגלל הקשה לא מדויקת וציפיות המשתמשים. אמצעי הבקרה האלה בדרך כלל מופיעים ונעלמים בהקשה של המשתמש, והם לא מוצגים ברוב הזמן של ההפעלה.
דוגמה להצגת אמצעי בקרה של סרטון בשכבת-על מופיעה בתמונה הבאה במאמר בנושא אמצעי בקרה של רינדור באפליקציית YouTube:
כשמשתמשים ב-IMA SDK, רוב בעלי התוכן הדיגיטלי מטמיעים את אמצעי הבקרה האלה על ידי הוספת תצוגה מעל מאגר המודעות, שהיא שקופה ברובה. בדרך כלל, אמצעי הבקרה הם רכיבי צאצא של התצוגה הזו, שמסתירים לחלוטין את נגן הווידאו שמתחתיהם. השכבה השקופה הזו משמשת לתיעוד אירועי הקשה, ואז להצגת אמצעי הבקרה למשתמשים כשהם מקישים.
כשמחשבים את הניראות של מודעות באמצעות Open Measurement SDK, כל הצפיות שמוצגות על גבי רכיב המדיה נחשבות להפרעות ומקטינות את שיעור הניראות. במקרה ששכבת-על שקופה של הקשה נמצאת מעל מאגר התצוגה של המודעה כולה, יכול להיות שמלאי שטחי הפרסום יוגדר כלא ניתן לצפייה.
ה-SDK של Open Measurement מספק אפשרויות לשליטה בסרטונים, כך שהם ייחשבו כהפרעות 'ידידותיות' שחיוניות לחוויית המשתמש. אחרי שמקורות התנועה נרשמים כמקורות ידידותיים, הם לא נכללים במדידת הנראות של המודעות.
ערכת IMA SDK כוללת תמיכה ב-IAB וב-MRC, ומציגה API לרישום שכבות-על כאלה ב-Open Measurement SDK. אמצעי הבקרה האלה צריכים להיות שכבות-על שקופות לחלוטין או לחצנים קטנים. אסור לרשום צפיות אחרות שלא קשורות לאמצעי הבקרה של הסרטון.
| כן, לרשום | לא לרשום |
|---|---|
|
|
בדוגמת הקוד הבאה אפשר לראות איך רושמים שכבות-על של אמצעי בקרה של סרטונים בקונטיינר של הצגת המודעות:
private void registerFriendlyObstructions(
AdDisplayContainer adDisplayContainer, View transparentTapOverlay, View pauseButton) {
ImaSdkFactory imaSdkFactory = ImaSdkFactory.getInstance();
// Make sure to register all friendly obstructions before ad playback starts.
FriendlyObstruction overlayObstruction =
imaSdkFactory.createFriendlyObstruction(
transparentTapOverlay,
FriendlyObstructionPurpose.NOT_VISIBLE,
"This overlay is transparent");
FriendlyObstruction pauseButtonObstruction =
imaSdkFactory.createFriendlyObstruction(
pauseButton,
FriendlyObstructionPurpose.VIDEO_CONTROLS,
"This is the video player pause button");
adDisplayContainer.registerFriendlyObstruction(overlayObstruction);
adDisplayContainer.registerFriendlyObstruction(pauseButtonObstruction);
}
כשמסיימים להשתמש בהם, אפשר להסיר את ההפרעות האלה באמצעות הקריאה לשיטה הבאה:
private void unregisterFriendlyObstructions(AdDisplayContainer adDisplayContainer) {
adDisplayContainer.unregisterAllFriendlyObstructions();
}