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
: סקריפט האימות והקריאייטיב מועברים לארגז חול מדף בעל התוכן הדיגיטלי. עם זאת, לסקריפט יש גישה ישירה לנכס הקריאייטיב.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
, צריך לבצע את שני השלבים הבאים:
בודקים את נגן הווידאו בסביבת חול (sandbox) ב-iframe מאובטח, מבודד משאר האתר.
מגדירים את הערך של
OmidAccessMode
לשותף שלכם למדידת הניראות כ-FULL
.