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

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

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

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

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

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

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

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

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

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