פתיחת המדידה ב-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, צריכה להיות לכם גרסה 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 ויפחיתו את החשיפה.

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

בדיקה

כדי לבדוק את 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();