הפעלת Open Measurement ב-IMA

‫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 ויפחיתו את שיעור הנראות.

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

בדיקה

כדי לבדוק את התכונה 'מדידה פתוחה' באמצעות IMA SDK, צריך להשתמש באחת מגרסאות ה-SDK הנדרשות שצוינו למעלה, יחד עם תג בדיקה של מודעה.

התגובה של VAST אמורה להכיל את הערך <AdVerifications>.

רישום של חסימות בשכבת-העל של אמצעי הבקרה של הסרטון

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

דוגמה לפקדי וידאו שמוצגים באפליקציית YouTube:

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

כשמחשבים את הניראות של מודעה באמצעות Open Measurement SDK, כל הצפיות שמוצגות על גבי רכיב המדיה נחשבות להפרעות ומפחיתות את שיעור הניראות. במקרה ששכבת-על שקופה של הקשה נמצאת מעל מאגר התצוגה של המודעה כולה, יכול להיות שמלאי שטחי הפרסום יוגדר כלא ניתן לצפייה.

ה-SDK של Open Measurement מספק אמצעים לשליטה בסרטונים, כך שהם ייחשבו כהפרעות 'ידידותיות' שחיוניות לחוויית המשתמש. אחרי שמסמנים את אמצעי הבקרה האלה כ'ידידותיים', הם לא נכללים במדידת מידת הצפייה במודעות.

ערכת IMA SDK כוללת תמיכה ב-IAB וב-MRC, ומציגה API לרישום שכבות-על כאלה ב-Open Measurement SDK. אמצעי הבקרה האלה צריכים להיות שכבות-על שקופות לחלוטין או לחצנים קטנים. אין לרשום צפיות אחרות שלא קשורות לאמצעי הבקרה של הסרטון.

הרשמה ל-DO לא לרשום
  • שכבת-על שקופה לתיעוד הקשות של המשתמשים
  • כפתורים זמניים
    • השהיה
    • הפעלה
    • מסך מלא
    • Cast/AirPlay
    • כיווץ
    • התקדמות/חיפוש
    • פעולות רלוונטיות אחרות להפעלה
  • סימני מים
  • חלונות קופצים
  • תיבות דו-שיח
  • לחצנים לא זמניים
  • תצוגות אחרות של הסתרה

קוד לדוגמה שמראה איך לרשום שכבות-על של אמצעי בקרה של סרטונים בקונטיינר של הצגת המודעות: 

myTransparentTapOverlay = (ViewGroup) rootView.findViewById(R.id.overlay);
myPauseButton = (ImageButton) rootView.findViewById(R.id.pauseButton);
// Substitute "myTransparentTapOverlay" and "myPauseButton" with the
// elements you want to register as video controls overlays.
// Make sure to register before ad playback starts.
overlayObstruction = ImaSdkFactory.createFriendlyObstruction(
  myTransparentTapOverlay,
  FriendlyObstructionPurpose.NOT_VISIBLE,
  "This overlay is transparent"
);
pauseButtonObstruction = ImaSdkFactory.createFriendlyObstruction(
  myPauseButton,
  FriendlyObstructionPurpose.VIDEO_CONTROLS,
  "This is the video player pause button"
);

displayContainer.registerFriendlyObstruction(overlayObstruction);
displayContainer.registerFriendlyObstruction(pauseButtonObstruction);

אחרי שמסיימים להשתמש בהם, אפשר להסיר את ההפרעות האלה באמצעות הקריאה לשיטה הבאה: 

displayContainer.unregisterAllFriendlyObstructions();