Open Measurement

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.4.

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

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

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

מצבי גישה

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

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

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

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

  • 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.DOMAIN;

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

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

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