הפעלת Open Measurement

בחירת פלטפורמה: HTML5 Android iOS

‫IMA SDK ל-HTML5 כולל את Open Measurement (OM) SDK, שהוא תקן בתחום שפותח על ידי Interactive Advertising Bureau (IAB) כדי לאפשר מדידה של ניראות ואימות על ידי צד שלישי. כשמשתמשים ב-IMA SDK ל-HTML5, ‏ OM SDK שכלול מנתח באופן אוטומטי את התג <AdVerifications> בתגי מודעות VAST ושולח נתוני ניראות לספקי המדידה שצוינו באמצעות OMID API. אפשר גם להגדיר כללים למצב גישה לכל בקשה כדי לקבוע לאיזה תוכן סקריפט האימות יכול לגשת.

‫IMA SDK תומך ב-OM SDK בגרסה 1.6.

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

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

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

מצבי גישה

‫OM SDK תומך בהרצת סקריפטים לאימות בארבעה מצבי גישה שונים, שקובעים את היקף הגישה של הסקריפט לאימות:

  • ‫FULL: לסקריפט האימות יש גישה ישירה לקריאייטיב ולדף של בעל התוכן הדיגיטלי.

  • ‫CREATIVE: סקריפט האימות והקריאייטיב מופעלים בארגז חול מחוץ לדף של בעל התוכן הדיגיטלי. עם זאת, לסקריפט יש גישה ישירה לנכס הקריאייטיב.

  • ‫LIMITED: סקריפט האימות נמצא בארגז חול ואין לו גישה לנכס הקריאייטיב או לדף של בעל התוכן הדיגיטלי, ואין לו אפשרות לאשר באופן ישיר באיזה דומיין של בעל תוכן דיגיטלי הוא נמצא.

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

הגדרת כללים למצב הגישה של בקשה

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

בדוגמה הבאה, הערך של GOOGLE מוגדר כ-google.ima.dai.api.OmidAccessMode.FULL. כל הספקים האחרים, כולל אלה שמפורטים ב-OmidVerificationVendor, מוגדרים כברירת מחדל בהתאם להגדרה של OmidVerificationVendor.OTHER.

request.omidAccessModeRules = {};
request.omidAccessModeRules[google.ima.dai.api.OmidVerificationVendor.GOOGLE]
    = google.ima.dai.api.OmidAccessMode.FULL;
request.omidAccessModeRules[google.ima.dai.api.OmidVerificationVendor.OTHER]
    = google.ima.dai.api.OmidAccessMode.LIMITED;

כדי להטמיע את CREATIVE מצב הגישה, צריך לבצע את שני השלבים הבאים:

  1. הכניסו את נגן הווידאו לארגז חול ב-iframe מאובטח, מבודד משאר האתר.

  2. מגדירים את OmidAccessMode עבור השותף למדידת הניראות לערך FULL.