פתיחת המדידה ב-IMA SDK

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, חשוב לזכור את הנקודות הבאות:

  • כדי להשתמש ב-Open Measurement, צריך להתקין את IMA SDK ל-Android בגרסה 3.11.0 ואילך. עם זאת, הדוגמה במדריך הזה מיועדת לגרסה העדכנית ביותר של ה-SDK, וכוללת ממשקי API שהוצגו בגרסה 3.16.5.

  • אם משתמשים ב-VAST בגרסה 4.1 ואילך, צריך להגדיר את המודעות כך שיעבירו את <AdVerifications> בתג ה-VAST בהתאם למפרט VAST 4.1. אחרת, צריך להשתמש ב-<Extension type="AdVerifications">.

  • אין לכסות את AdDisplayContainer בשכבות-על (שקופות או אטומות), כי הן יסומנו כחסימות על ידי OM SDK ויפחיתו את החשיפה.

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

בדיקה

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

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

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

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

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

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

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

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

בעזרת התמיכה של IAB ו-MRC, ערכת IMA SDK כוללת ממשק 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);

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

displayContainer.unregisterAllFriendlyObstructions();