פתיחת המדידה ב-IMA DAI 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 ב-VAST 2 ואילך, ובצומת Ad Verifications ב-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 שלמעלה, יחד עם תג של מודעת בדיקה.

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

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

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

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

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

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

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

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

רישום אין להירשם
  • שכבת-על שקופה לתיעוד הקשות של משתמשים
  • לחצנים זמניים
    • השהיה
    • הפעלה
    • מסך מלא
    • העברה (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();