מפרט OpenRTB ב-DV360

מומלץ לעיין במפרט OpenRTB 2.6 בזמן שקוראים את הדף הזה.

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

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

מפרט בקשות להצעות מחיר

בקשה להצעת מחיר היא בקשת HTTP Post עם גוף של אובייקט בקשה להצעת מחיר. הפורמט של הגוף מוגדר בכותרת Content-Type.

התגובה המתאימה היא HTTP 204 ללא תוכן אם לא הוגשה הצעת מחיר, או HTTP 200 עם תוכן של תגובה לבקשה להצעת מחיר.

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

פורמט התגובה נקבע על ידי הכותרת Accept.

פורמט JSON

הפורמט שמוגדר כברירת מחדל משמש כשלא מסופק סוג MIME מקובל.

בקשות ותגובות בפורמט JSON פועלות לפי המפרט של OpenRTB 2.6 של IAB. במסמכים הבאים מתוארים התוספים והתמיכה בשדות.

הכותרת Content-Type: application/json מציינת בקשת הצעת מחיר בפורמט JSON, והכותרת Accept: application/json מציינת שהתגובות להצעות המחיר צריכות להיות בפורמט JSON.

פורמט Protobuf

הערה: התמיכה ב-Protobuf היא בגרסת בטא. אם אתם מעוניינים, אתם יכולים לפנות ל-DV360.

בקשות ותשובות בפורמט JSON תואמות למפרט OpenRTB 2.6 Protobuf של IAB.

התמיכה בתוספים מוגבלת. אם אתם מעוניינים בכך, פנו לצוות של DV360.

שולחים את הכותרת Content-Type: application/x-protobuf כדי לציין בקשה להצעת מחיר ב-Protobuf, ומגדירים את הכותרת Accept: application/x-protobuf כדי לקבל תגובות להצעות מחיר ב-Protobuf.

אובייקט בקשה להצעת מחיר

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

בפודים של אודיו, יש תמיכה ביותר מאובייקט אחד (imp).
בתרחישי שימוש אחרים (למשל, כמה מיקומי מודעות עצמאיים בדף), נעשה שימוש באובייקט imp הראשון, והשאר מושמטים.
site אתר חובה לציין את כתובת האתר.
site ו-app הם בלעדיים.
app קידום אפליקציות נדרש לבקשות לאפליקציות.
app ו-site הם בלעדיים.
device מכשיר חובה.
user משתמש חובה.
test מספר שלם אין תמיכה.
at מספר שלם ‫1: מכרז מחיר ראשון שבו המפרסם מחויב בסכום הצעת המחיר שלו.
2 (ברירת מחדל): מכרז במודל 'מחיר שני' שבו המפרסם מחויב בסכום שהוא קצת מעל הצעת המחיר השנייה בגובהה.‫
3: מחיר המינימום מופיע בבקשה, ואין לו קשר להצעות מחיר מתחרות.
tmax מספר שלם אופציונלי, ברירת המחדל היא התאמה אישית לכל שילוב.
wseat מערך מחרוזות רשימה של מושבים מורשים לקונים.
מומלץ, אלא אם כל המפרסמים מורשים להגיש הצעות מחיר.
אם המדיניות לא מוגדרת, אין הגבלות.
bseat מערך מחרוזות רשימת מושבים של קונים שהצעות המחיר שלהם צריכות להיחסם. קונים שמופיעים ברשימה ייחסמו מלהגיש הצעות מחיר על עסקאות ומכרזים פתוחים.
allimps מספר שלם אין תמיכה.
cur מערך מחרוזות

אופציונלי, אבל מומלץ מאוד. ברירת המחדל היא לכל שילוב.

המטבע בבקשת ההצעה למחיר חייב להיות זהה לאחד המטבעות שנרשמו במהלך השילוב.

מומלץ מאוד לתמוך במטבע יחיד לכל בורסה.
wlang מערך מחרוזות אין תמיכה.
bcat מערך מחרוזות חסימה של קטגוריות מפרסמים באמצעות קטגוריות התוכן של IAB.
אם לא מוגדרות קטגוריות, לא נחסמות קטגוריות.
badv מערך מחרוזות מציינים את המפרסם החסום על סמך הדומיין שסופק על ידי המפרסם.
אם לא מגדירים את ההגדרה, לא נחסמים מפרסמים.
bapp מערך מחרוזות אין תמיכה.
source מקור חובה למדינות schain.
regs Regs אופציונלי.
ext תוספים לבקשות להצעות מחיר אופציונלי.

אובייקט של תוספים לבקשות להצעות מחיר

שדה סוג פרטים
schain שרשרת אספקה בשילובים חדשים צריך להשתמש בשדה BidRequest.source.schain במקור.
purch מספר שלם הפרמטר 'תנועה שנרכשה' הוא התנועה שמופנית מנכסים אחרים, שלא בבעלותכם, שלא רכשתם ושלא השיגו אותה בדרך אחרת באמצעות פעילות שמלווה בתמריצים.
ההגדרה הזו היא בהתאם למפרט IVT 2.0 החדש של MRC.

המאפיין הזה נקרא מקור תנועה של בעל האתר בדוחות שמוצגים לקונים, והוא מקבל אחד מהערכים הבאים :
0 (ברירת מחדל): לא מוגדר – הערך לא נשלח בבקשות להצעות מחיר. לא ניתן לתעד ערך;
1: נרכשה – תנועה שהופנתה מנכסים שאינם בבעלות (פעילות נרכשת או מתומרצת בדרך אחרת).
2: אורגני – הזנה ישירה של כתובת URL, חיפוש באתר או הורדה של אפליקציה.

gdemsignals מחרוזת בלוב של אותות SCAR API מ-GMA SDK.
מומלץ אם התנועה היא מ-GMA SDK, אחרת אסור.
disable_gma_format int אופציונלי אם מצוין הערך gdemsignals, אסור אחרת.‫
0 (ברירת מחדל): כשמאכלסים את gdemsignals, התגובה לבקשה להצעת מחיר adm היא אובייקט blob בפורמט JSON.
‫1: במקום ה-blob של ה-JSON, יינתן גם תג מודעה.

אובייקט המקור

שדה סוג פרטים
fd מספר שלם הגורם שאחראי להחלטה הסופית לגבי מכירת חשיפה
0 (ברירת מחדל): הבורסה מחליטה.‫
‫1: מקור במעלה הזרם מחליט.
tid מחרוזת אין תמיכה.
pchain מחרוזת אין תמיכה.
schain שרשרת אספקה חובה כמעט בכל המקרים.

מומלץ להשתמש בשדה הזה במקום לספק את schain באמצעות תוספים לבקשות להצעות מחיר או תוספים למקורות.

ext תוספי מקור אופציונלי.

אובייקט של תוספים למקור

מומלץ מאוד להשתמש בתוסף הזה, כי הוא משפיע על האופן שבו נתוני הנראות מדווחים ללקוח ב-DV3. אם שם השותף של OMID לא מופיע ברשימת האישורים של IAB, אנחנו מחויבים על ידי MRC לדווח על מדדי הניראות בנפרד מהמדדים שאושרו על ידי MRC. מידע נוסף

שדה סוג פרטים
omidpn מחרוזת מזהה של שילוב OM SDK. זהה לפרמטר name של אובייקט השותף של OMID.
omidpv מחרוזת הגרסה של שילוב OM SDK. זהה לפרמטר versionString של אובייקט השותף של OMID.
schain שרשרת אספקה בשילובים חדשים צריך להשתמש בשדה schain במקור.

אובייקט Regs

שדה סוג פרטים
coppa מספר שלם ‫0 (ברירת מחדל): חוק COPPA לא חל על הבקשה הזו.‫
1: הבקשה הזו רלוונטית ל-COPPA.
gdpr מחרוזת דגל שמציין אם הבקשה כפופה לתקנות GDPR. הערך 0 מציין שלא, הערך 1 מציין שכן, והשמטה מציינת שהסטטוס לא ידוע. פרטים נוספים מופיעים במסמכי התיעוד של DV360 בנושא GDPR. צפוי רק אחד מבין regs.gdpr ו-regs.ext.gdpr.
us_privacy מחרוזת העברת אותות בנוגע לפרטיות הצרכנים בהתאם לתקנות הפרטיות בארה"ב. מפרטים של מחרוזת הפרטיות בארה"ב כשמערכת Display & Video 360 מקבלת את המחרוזת us_privacy בבקשה להצעת מחיר, ואם המחרוזת של IAB מציינת שהמשתמש סירב, המערכת מחשיבה את הבקשה כלא כשירה להצעות מחיר מותאמות אישית. אנחנו לא מעבירים את האות של IAB לספקים אחרים.

צפוי רק אחד מהערכים regs.us_privacy, user.us_privacy ו-user.ext.us_privacy.
gpp מחרוזת מכיל את מחרוזת ההסכמה של Global Privacy Protocol‏ (GPP). פלטפורמת DV360 מקבלת רק חלק מהקטעים של GPP, כולל US National, קליפורניה ואחרים. לא מתקבלים קטעים של TCF של IAB Europe. במקומם צריך להשתמש ב-user.consent או ב-user.ext.consent.
gpp_sid מערך של מספרים שלמים מערך של החלקים של מחרוזת ההסכמה של Global Privacy Protocol שצריך להחיל על העסקה הזו.
ext תוספי תקנות אופציונלי.

אובייקט של תוספי תקנות

שדה סוג פרטים
gdpr מספר שלם דגל שמציין אם הבקשה כפופה לתקנות GDPR, כפי שמתואר בקטע regs.gdpr למעלה. צפוי רק אחד מהערכים regs.gdpr ו-regs.ext.gdpr.
us_privacy מחרוזת regs.us_privacy לעיון במסמכי התיעוד צפוי רק אחד מהערכים regs.us_privacy, regs.ext.us_privacy ו-user.ext.us_privacy.

אובייקט שד

שדה סוג פרטים
id מחרוזת מזהה ייחודי של החשיפה הזו בהקשר של בקשת הצעת המחיר (בדרך כלל, הערך מתחיל ב-1 ועולה עד n עבור n חשיפות).
metric אובייקט אין תמיכה.
banner Banner חובה להשתמש בפורמט הזה כשמציגים מודעות באנר.
video סרטון חובה כדי להציג מודעות וידאו.
audio אודיו חובה לציין את הערך הזה כדי להציג מודעות אודיו.
native Native נדרש להזדמנויות להצגת מודעות מותאמות.
pmp Pmp עסקאות בשוק פרטי שבתוקף לחשיפה הזו.
displaymanager מחרוזת שם השותף של תהליך בחירת הרשת, טכנולוגיית ה-SDK או הנגן שאחראי על הצגת המודעה (בדרך כלל מודעת וידאו או מודעה לנייד). חלק משרתי המודעות משתמשים בו כדי להתאים אישית את קוד המודעה לפי שותף. מומלץ לסרטונים ו/או לאפליקציות.
displaymanagerver מחרוזת הגרסה של שותף הגישור בין רשתות המודעות, טכנולוגיית ה-SDK או הנגן שאחראי על הצגת המודעה (בדרך כלל מודעת וידאו או מודעה לנייד). חלק משרתי המודעות משתמשים בו כדי להתאים אישית את קוד המודעה לפי שותף. מומלץ לסרטונים ו/או לאפליקציות.
instl מספר שלם ‫0 (ברירת מחדל): לא מודעה מעברית.
1: המודעה היא מודעת מעברון או מודעה במסך מלא.
tagid מחרוזת מזהה של מיקום מודעה ספציפי או תג מודעה ששימשו להפעלת המכרז. המידע הזה יכול להיות שימושי לניפוי באגים או לאופטימיזציה על ידי הקונה.
bidfloor מספר ממשי (float) הצעת המחיר המינימלית לחשיפה הזו, במונחים של עלות לאלף חשיפות.
bidfloorcur מחרוזת

המטבע שצוין באמצעות קודי אלפא בתקן ISO-4217.

clickbrowser מספר שלם

מציין את סוג הדפדפן שנפתח כשלוחצים על הקריאייטיב באפליקציה.
0 (ברירת מחדל): מוטמע
1: מקורי

שימו לב: בגרסה iOS 9.x, בקר התצוגה של Safari נחשב לדפדפן מקורי לצורך השדה הזה.

secure מספר שלם אם החשיפה הזו מחייבת כתובת URL מאובטחת מסוג HTTPS או כתובת URL לא מאובטחת מסוג HTTP.
‫0 (ברירת מחדל):לא מאובטח
‫1: מאובטח
iframebuster מערך מחרוזות
exp מספר שלם תוקף הצעת המחיר מוגדר על ידי DV360 בלי קשר לערך שנשלח על ידי שותף בשדה הזה. אירועי חשיפה שמתקבלים אחרי חלון הזמן של חשיפה לא עדכנית (בדרך כלל שעה אחת) נפסלים כלא עדכניים ולא נחשבים כאירועים שניתנים לחיוב ב-DV360.
rwdd מספר שלם מציין אם המשתמש מקבל תגמול על צפייה במודעה.
‫0 (ברירת מחדל): לא מתוגמל
‫1: מתוגמל

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

אובייקט של נכס אימפקט

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

הערכים h ו-w מוזגו בשדה format.

מומלץ להשתמש במקום זאת ב-format.
h מספר שלם

הערכים h ו-w מוזגו בשדה format.

מומלץ להשתמש במקום זאת ב-format.
wmax מספר שלם אין תמיכה.
hmax מספר שלם אין תמיכה.
wmin מספר שלם אין תמיכה.
hmin מספר שלם אין תמיכה.
btype מערך של מספרים שלמים רשימה של סוגי מודעות באנר שנכללים ברשימת החסימה:

‫1: מודעות טקסט ב-HTML
‫2: מודעות באנר ב-HTML
‫3: מודעות Javascript
‫4: מודעות IFrame

battr מערך של מספרים שלמים יש תמיכה בערכים הבאים:

‫1: הפעלה אוטומטית של אודיו
‫2: אודיו בהפעלת המשתמש
‫3: אוטומטית להרחבה
‫4: להרחבה בהפעלת המשתמש
‫5: להרחבה בהעברת העכבר
‫6: הפעלה אוטומטית של סרטון במודעת באנר
‫7: הפעלה של סרטון במודעת באנר בהפעלת המשתמש
‫8: חלון קופץ(מעל, מתחת או ביציאה)
‫9: פרובוקטיבי או בעל רמיזות מיניות
‫10: 'מעצבן', למשל: רועד, מהבהב, מרצד, אנימציה קיצונית, סמיילים
‫11: סקרים
‫12: טקסט בלבד
‫13: אינטראקטיביות עם המשתמש (משחקים)
‫14: בסגנון של תיבת דו-שיח או התראה ב-Windows
‫15: כוללת לחצן להפעלה או להשבתה של אודיו
‫16: אפשר לדלג על המודעה
‫17: Flash

pos מספר שלם המיקום של המודעה:

‫0 (ברירת מחדל): לא ידוע
‫1: בחלק העליון והקבוע
‫2: לא אפשרי: כנראה בחלק הנגלל
‫3: בחלק הנגלל
‫4: כותרת עליונה
‫5: כותרת תחתונה
‫6: סרגל צד
‫7: מסך מלא
mimes מערך מחרוזות אין תמיכה.

מערכת DV360 תשתמש ב-text/html לכל הקריאייטיבים של מודעות הבאנר.

topframe מספר שלם ‫0 (ברירת מחדל): הבאנר מוצג ב-iframe.
‫1: לא נתמך: הבאנר מוצג בפריים העליון.
expdir מערך של מספרים שלמים ‫1: שמאלה
2: ימינה
3: למעלה
4: למטה
5: מסך מלא ניתן להרחבה
api מערך של מספרים שלמים מסגרות API נתמכות

‫1: שמאלה
‫2: ימינה
‫3: למעלה
‫4: למטה
‫5: מסך מלא ניתן להרחבה

id מחרוזת מזהה של אובייקט הבאנר, שצריך להיות ייחודי בחשיפה.

מומלץ כשמשתמשים באובייקטים banner עם אובייקט וידאו.

vcm מספר שלם

רלוונטי רק ל-banner שמשמש עם אובייקט מסוג סרטון.

‫0: הבאנר מוצג בו-זמנית עם קריאייטיב וידאו.
1: הבאנר הוא שקופית סיום אחרי הסרטון.

עיצוב אובייקט

שדה סוג פרטים
w מספר שלם הרוחב בפיקסלים בלתי תלויים במכשיר (DIPS).
h מספר שלם הגובה בפיקסלים בלתי תלויים במכשיר (DIPS).
wratio מספר שלם אין תמיכה.
hratio מספר שלם אין תמיכה.
wmin מספר שלם אין תמיכה.

אובייקט וידאו

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

שדה סוג פרטים
mimes מערך מחרוזות צריך לציין לפחות סוג MIME אחד.

‫video/flv או video/x-f4v
video/mp4, video/x-mp4 או application/mp4
video/webm או video/x-webm
video/x-ms-wmv
video/3gpp
video/ogg או application/ogg
application/javascript או application/x-javascript

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

‫1: VAST 1.0
2: VAST 2.0
3: VAST 3.0
4: VAST 1.0 Wrapper
5: VAST 2.0 Wrapper
6: VAST 3.0 Wrapper
7: VAST 4.0
8: VAST 4.0 Wrapper
9: DAAST 1.0
10: DAAST 1.0 Wrapper

w מספר שלם רוחב נגן הווידאו בפיקסלים עצמאיים ממכשיר (DIP).
h מספר שלם הגובה של נגן הווידאו בפיקסלים עצמאיים ממכשיר (DIP).
startdelay מספר שלם השהיית ההתחלה בשניות של מיקומי מודעות לפני הסרטון, מודעה באמצע סרטון (mid-roll) או מודעה בסוף הסרטון (post-roll).
placement מספר שלם מומלץ מאוד לציין את מיקום המודעה (plcmt) (או) את מיקום הסרטון בבקשה להצעת מחיר. אם שני השדות חסרים, המיקום יסווג כמיקום לא ידוע.

‫0 (ברירת מחדל): לא ידוע
‫1: בתוך הסטרימינג
‫2: בבאנר
‫3: בתוך מאמר
‫4: בפיד
‫5: צף

הערה: כדי שמיקומי מודעות או חשיפות של מודעות וידאו ייחשבו כ-In-stream (מיקום או סוג מיקום 1), צריך להגדיר אותם כ'הפעלה עם קול' ולסמן אותם בצורה נכונה בשיטת ההפעלה (ערכים של 1, 3, 4 ו-5 עומדים בדרישות).
plcmt מספר שלם מומלץ מאוד לציין את מיקום המודעה (plcmt) (או) את מיקום הסרטון בבקשה להצעת מחיר. אם שני השדות חסרים, המיקום יסווג כמיקום לא ידוע.

‫0 (ברירת מחדל): לא ידוע
‫1: מודעת וידאו In-stream
‫2: תוכן נלווה
‫3: מעברון
‫4: ללא תוכן/מודעה עצמאית

הערה: כדי שמיקומי מודעות או חשיפות של מודעות וידאו ייחשבו כ-In-stream (מיקום או סוג מיקום 1), צריך להגדיר אותם כ'הפעלה עם קול' ולסמן אותם בצורה נכונה בשיטת ההפעלה (ערכים של 1, 3, 4 ו-5 עומדים בדרישות).

הערה: אם מציינים גם את plcmt וגם את placement, ל-plcmt תהיה עדיפות. מידע נוסף על מעבר למיקום מודעה זמין במדריך של IAB.

הערה: המאפיין plcmt: Accompanying Content (2) נחשב לplacement: In Article (3)
המאפיין plcmt: No Content/Standalone (4) נחשב לplacement: In feed (4)
למאפיין placement: In Banner אין מיפוי ב-plcmt
linearity מספר שלם אין תמיכה.
skip מספר שלם אם נגן הווידאו יאפשר דילוג על המודעה.

‫0 (ברירת מחדל): לא ניתן לדילוג
‫1: ניתן לדילוג
skipmin מספר שלם אין תמיכה.
skipafter מספר שלם אין תמיכה.
sequence מספר שלם אם מוצעות כמה חשיפות של מודעות באותה בקשה להצעת מחיר, מספר הרצף יאפשר הצגה מתואמת של כמה קריאייטיבים.
battr מערך של מספרים שלמים מאפייני קריאייטיב חסומים.
maxextended מספר שלם משך מקסימלי של מודעת וידאו מורחבת, אם ההרחבה מותרת.

‫0 (ברירת מחדל): התוסף לא מורשה
‫-1: התוסף מורשה, ואין הגבלת זמן
‫>0: מספר השניות של הפעלה מורחבת שנתמכות מעבר לערך maxduration.

minbitrate מספר שלם קצב העברת נתונים מינימלי ב-Kbps.
maxbitrate מספר שלם קצב העברת נתונים מקסימלי ב-Kbps.
boxingallowed מספר שלם מציין אם מותר להוסיף פסי שחור בצדדים לתוכן בפורמט 4:3 כדי להתאים אותו לחלון בפורמט 16:9

‫0: לא מותר
‫1 (ברירת מחדל): מותר
playbackmethod מערך של מספרים שלמים שיטות הפעלה שעשויות להיות בשימוש. אם לא מציינים שיטה, אפשר להשתמש בכל שיטה.

‫0 (ברירת מחדל): לא ידוע
‫1: הפעלה אוטומטית, צליל מופעל
‫2: הפעלה אוטומטית, צליל מושבת
‫3: לחיצה להפעלה
‫4: העברת העכבר מעל
‫5: הפעלה כשנכנסים לאזור התצוגה, צליל מופעל
‫6: הפעלה כשנכנסים לאזור התצוגה, צליל מושבת

הערה: כל החשיפות עם הגדרת ברירת מחדל של השמע מושבת (שיטת הפעלה 2, 6 או 0) חייבות לסמן מיקום מחוץ לסטרימינג מסוג 2, 3, 4 או 5 (oRTB 2.5) או סוג משנה של מיקום 2, 3 או 4.
playbackend מספר שלם האירוע שגורם להפעלה להסתיים.

‫1: השלמת צפייה בסרטון או סיום על ידי המשתמש
‫2: יציאה מאזור התצוגה או סיום על ידי המשתמש
‫3: ביציאה מאזור התצוגה, הסרטון ממשיך כחלון צף עד להשלמת הצפייה או לסיום על ידי המשתמש
delivery מערך של מספרים שלמים שיטות הצגת המודעות שנתמכות. אם לא מציינים אף אחת, מניחים שכולן נתמכות.

‫1: סטרימינג
2: פרוגרסיבי
pos מספר שלם מיקום המודעה במסך.

‫0 (ברירת מחדל): לא ידוע
‫1: בחלק העליון והקבוע
‫2: לא אפשרי: כנראה בחלק הנגלל
‫3: בחלק הנגלל
‫4: כותרת עליונה
‫5: כותרת תחתונה
‫6: סרגל צד
‫7: מסך מלא
companionad מערך Banner מודעות נלוות, אם הן זמינות.
api מערך של מספרים שלמים

‫0 (ברירת מחדל): לא ידוע
‫1: VPAID 1
‫2: VPAID 2
‫3: MRAID 1
‫4: ORMMA
‫5: MRAID 2
‫6: MRAID 3
‫7: OMID 1 – נדרש להפעלה של מדידה באמצעות OMID עבור Active View.
8: SIMID 1
companiontype מערך של מספרים שלמים אין תמיכה.
maxseq מספר שלם המספר המקסימלי של מודעות שיוחזרו ב-pod דינמי של סרטונים.
poddur מערך של מספרים שלמים האורך המקסימלי של בלוק דינמי של סרטונים בשניות.

תוסף נתמך לאובייקט וידאו

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

‫0 (ברירת מחדל): לא מקבלים פרס
‫1: מקבלים פרס

אובייקט אודיו

שדה סוג פרטים
mimes מערך מחרוזות צריך לציין לפחות סוג MIME אחד.

‫audio/m4a,‏ audio/mp4 או audio/x-m4a
audio/mpeg או audio/mp3
audio/ogg או audio/x-ogg

minduration מספר שלם משך המודעה המינימלי בשניות.
maxduration מספר שלם משך המודעה המקסימלי בשניות.
protocols מערך של מספרים שלמים

‫3: VAST 3.0
‫6: VAST 3.0 Wrapper
‫7: VAST 4.0
‫8: VAST 4.0 Wrapper
startdelay מספר שלם ההשהיה בהתחלה בשניות של מיקומי מודעות לפני הסרטון, מודעה באמצע סרטון (mid-roll) או מודעה בסוף הסרטון (post-roll).

‫-2: מודעה בסוף סרטון (post-roll)
‫-1: מודעה באמצע סרטון (mid-roll)
‫0: מודעה לפני סרטון (pre-roll)
‫>0: מודעה באמצע סרטון (mid-roll)

sequence מספר שלם אין תמיכה.
battr מערך של מספרים שלמים אין תמיכה.
maxextended מספר שלם אין תמיכה.
minbitrate מספר שלם קצב העברת הנתונים המינימלי ב-Kbps.
maxbitrate מספר שלם קצב העברת הנתונים המקסימלי ב-Kbps.
delivery מערך של מספרים שלמים אין תמיכה.
companionad מערך Banner object כל משבצת של קריאייטיב נלווה מסוג באנר.
api מערך של מספרים שלמים רשימה של מסגרות API נתמכות לחשיפה הזו.

‫7: Omid V1

companiontype מערך של מספרים שלמים אין תמיכה.
maxseq מערך של מספרים שלמים אין תמיכה.
feed מספר שלם סוג פיד האודיו. אפשר לעיין ברשימה: סוגי פידים ב-AdCOM 1.0.

‫1: שירות סטרימינג של מוזיקה
‫2: שידור FM/AM (שידור חי של תוכן שזמין גם באמצעות סטרימינג באינטרנט)
‫3: פודקאסט (תוכן מקורי שהוקלט מראש ומופץ כפרקים בסדרה)
‫4: רדיו בשידור חוזר (קטע מוקלט של תוכנית רדיו ששודרה במקור בשידור חי)
‫5: רדיו אינטרנטי (תוכן חי שזמין רק באמצעות סטרימינג באינטרנט, ולא כשידור AM/FM)
‫6: משחק וידאו (אודיו ברקע במשחקי וידאו)
‫7: המרת טקסט לדיבור (ספרי אודיו, פלאגין לאתר שיכול לקרוא מאמר)

stitched מספר שלם אין תמיכה.
nvol מספר שלם אין תמיכה.

אובייקט מותאם

לפרטים נוספים, אפשר לעיין במפרט של מודעות מותאמות ב-DV360.

שדה סוג פרטים
request מחרוזת מחרוזת שמקודדת אובייקט JSON מקורי.
ver מחרוזת ‫1.0: לא אפשרי
1.1: לא אפשרי
1.2
api מערך של מספרים שלמים רשימה של מסגרות API נתמכות לחשיפה הזו.

‫7: Omid V1

battr מערך של מספרים שלמים אין תמיכה.

אובייקט PMP

שדה סוג פרטים
private_auction מספר שלם ‫0 (ברירת מחדל): כל הצעות המחיר מותרות
‫1: עסקאות בלבד
deals מערך אובייקט העסקה המבצעים שרוצים לכלול.

אובייקט עסקה

שדה סוג פרטים
id מחרוזת אובייקט PMP לא יכול להכיל יותר מאובייקט עסקה אחד לכל מזהה.
bidfloor כפול הצעת המחיר המינימלית לחשיפה הזו בעלות לאלף חשיפות.

חובה אם at=3.

bidfloorcur מחרוזת המטבע שצוין באמצעות קודי אלפא בתקן ISO-4217.

אם לא מציינים ערך, ברירת המחדל היא המטבע של הבקשה להצעת מחיר.

at מספר שלם אם לא מציינים ערך, ברירת המחדל היא bid_request.at.

‫1: מחיר ראשון
‫2: מחיר שני
‫3: מחיר קבוע

wseat מערך מחרוזות מזהי השותפים שעומדים בדרישות להשתתפות בעסקה.

אם לא מצוין מספר מושבים, אין הגבלות על המושבים.

wadomain מערך מחרוזות הדומיינים של המפרסמים שמורשים להגיש הצעות מחיר על העסקה הזו.

אם אין מושבים, אין הגבלות על הדומיין.

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

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

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

‫0 (ברירת מחדל): לא מובטח
‫1: מובטח

ext תוספי מבצעים אופציונלי.

תוסף נתמך לאובייקט העסקה

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

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

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

‫0 (ברירת מחדל): לא מובטח
‫1: מובטח

מומלץ להשתמש ב-deal.guar במקום בשדה הזה.

אובייקט האתר

שדה סוג פרטים
id מחרוזת המזהה של האתר בבורסת הפרסום.
name מחרוזת אין תמיכה.
domain מחרוזת הדומיין של האתר.

מומלץ לשלוח כתובת URL מלאה ב-site.page במקום למלא רק את site.domain.

cat מערך מחרוזות אין תמיכה.
sectioncat מערך מחרוזות אין תמיכה.
pagecat מערך מחרוזות אין תמיכה.
page מחרוזת כתובת ה-URL המלאה שבה יוצג החשיפה.

מומלץ לשלוח את כתובת ה-URL המלאה למטרות טירגוט.

ref מחרוזת כתובת ה-URL של המפנה שגרמה לניווט לדף הנוכחי.
search מחרוזת אין תמיכה.
mobile מספר שלם אין תמיכה.
privacypolicy מספר שלם אין תמיכה.
publisher אובייקט Publisher פרטים על בעל האתר.
content אובייקט תוכן פרטים על התוכן באתר.
keywords מחרוזת (פורמט CSV) אין תמיכה.
ext תוספי אתר תוספים לאובייקט האתר.

אובייקט של תוסף לאתר

שדה סוג פרטים
inventorypartnerdomain מחרוזת השימוש הוא לשיתוף מלאי שטחי פרסום ב-CTV. אפשר לקרוא מידע נוסף במאמר IAB CTV app adds explainer.

אובייקט אפליקציה

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

בעלי תוכן דיגיטלי יכולים לציין את שמות האפליקציות בבקשות ללא SDK (בעיקר בטלוויזיות חכמות) ישירות בבקשה.

bundle מחרוזת חובה.

ב-iOS, חובה להזין את מזהה חנות האפליקציות המספרי. אנחנו לא מקבלים מזהה חבילה בסגנון DNS הפוך.

באפליקציות ל-CTV, מומלץ להעביר את מזהה האפליקציה שמוגדר בחנות. עליך לפעול בהתאם להנחיות של IAB בנושא מזהה שהוקצה לחנות OTT/CTV שפורסמו לאחרונה.

domain מחרוזת הדומיין, לדוגמה mygame.foo.com
storeurl מחרוזת נדרש לאימות של קובץ app-ads.txt ולאימות של חנות אפליקציות לטלוויזיות חכמות.
cat מערך מחרוזות אין תמיכה.
sectioncat מערך מחרוזות אין תמיכה.
pagecat מערך מחרוזות אין תמיכה.
ver מחרוזת אין תמיכה.
privacypolicy מספר שלם אין תמיכה.
paid מספר שלם אין תמיכה.
publisher אובייקט Publisher מידע על מפתח האפליקציה.
content אובייקט תוכן מידע על תוכן האפליקציה.
keywords מחרוזת (פורמט CSV) אין תמיכה.
ext תוספי אפליקציה תוספים לאובייקט האפליקציה.

אובייקט של תוסף אפליקציה

שדה סוג פרטים
inventorypartnerdomain מחרוזת השימוש הוא לשיתוף מלאי שטחי פרסום ב-CTV. אפשר לקרוא מידע נוסף במאמר IAB CTV app adds explainer.

אובייקט תוכן

מומלץ להעביר את המאפיינים האלה אם הם זמינים.

שדה סוג פרטים
id מחרוזת מזהה ייחודי של התוכן.
episode מספר שלם מספר הפרק של התוכן (בדרך כלל לתוכן וידאו).
title מחרוזת מומלץ לשימוש בבקשות של CTV, וידאו ואודיו.
series מחרוזת מומלץ לשימוש בבקשות של CTV, וידאו ואודיו.
season מחרוזת תווית לעונה של התוכן.
artist מחרוזת האומן שקיבל קרדיט על התוכן.
genre מחרוזת הז'אנר שמתאר את התוכן בצורה הטובה ביותר. ב-DV360 מומלץ לספק את האות הזה לבקשות של מודעות ב-CTV, מודעות וידאו ומודעות אודיו.
‫DV360 תומך בכמה טקסונומיות של ערכי ז'אנר וידאו בשדה הזה:
  • רשימת הז'אנרים של Google (הורדה)
  • רשימת ז'אנרים של אודיו ב-Google (הורדה)
  • קטגוריות של IAB TV/Movie/Sports (טלוויזיה/סרטים/ספורט) (הורדה)
  • טקסונומיית הז'אנרים של סרטוני Gracenote של Nielsen
album מחרוזת האלבום שאליו התוכן שייך, בדרך כלל לאודיו.
isrc מחרוזת קוד ISRC (International Standard Recording Code) בהתאם לתקן ISO-3901.
producer אובייקט Producer פרטים על יוצר התוכן.
url מחרוזת כתובת ה-URL של התוכן.
cat מערך מחרוזות קטגוריות תוכן של IAB שמתארות את התוכן.
prodq מספר שלם איכות ההפקה:

‫0 (ברירת מחדל): לא ידוע
‫1: מקצועי
‫2: חובבני
‫3: תוכן שנוצר על ידי משתמשים

videoquality מספר שלם אין תמיכה.
context מספר שלם סוג התוכן:

‫1: סרטון
‫2: משחק
‫3: מוזיקה
‫4: אפליקציה
‫5: טקסט
‫6: אחר
‫7: לא ידוע

contentrating מחרוזת מומלץ להשתמש במאפיין הזה בתוכן אודיו ובסרטונים ב-CTV, כי נתחיל לקבל החלטות לגביו.
userrating מחרוזת מספר הכוכבים, הלייקים וכו'...
qagmediarating מספר שלם סיווג מדיה בהתאם [להנחיות של QAG](http://www.iab.net/ne_guidelines).

‫1: כל הקהלים
2: מגיל 12 ומעלה
3: למבוגרים בלבד

keywords מחרוזת (פורמט CSV) אין תמיכה.
livestream מספר שלם אם התוכן הוא תוכן בשידור חי.

‫0: לא בשידור חי
‫1: התוכן בשידור חי

sourcerelationship מספר שלם

‫0: עקיף
1: ישיר

len מספר שלם אורך התוכן בשניות.

מומלץ לשימוש בבקשות של CTV/וידאו ואודיו.

language מחרוזת (ISO-639-1-alpha-2) השפה של התוכן.
embeddable מספר שלם אינדיקטור שמציין אם אפשר להטמיע את התוכן (למשל, נגן וידאו שאפשר להטמיע)

0: אי אפשר להטמיע
1: אפשר להטמיע

data מערך של אובייקטים של נתונים נתונים נוספים.

אובייקט של מפיק

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

אובייקט נתונים

שדה סוג פרטים
id מחרוזת מזהה של ספק הנתונים.
name מחרוזת שם הבורסה של ספק הנתונים.
segment מערך של אובייקטים של פלחים ערכי הנתונים בפועל.
ext תוספי נתונים תוספים לאובייקט Data.

תוספים נתמכים לאובייקט נתונים

שדה סוג פרטים
segtax מספר שלם מזהה הטקסונומיה. פרטים נוספים זמינים במאמר טקסונומיות של פלחים.
segclass מחרוזת הגרסה של המסווג שיצרה את מזהי הפלחים בטקסונומיה.

אובייקט פלח

שדה סוג פרטים
id מחרוזת מזהה של פלח נתונים שספציפי לספק הנתונים.
name מחרוזת השם של פלח הנתונים.
value מחרוזת הערך של פלח הנתונים.

אובייקט Publisher

שדה סוג פרטים
id מחרוזת חובה.
name מחרוזת אין תמיכה.
cat מערך מחרוזות אין תמיכה.
domain מחרוזת אין תמיכה.

אובייקט המכשיר

שדה סוג פרטים
ua מחרוזת חובה.
sua אובייקט UserAgent מידע מובנה על סוכן המשתמש.
geo אובייקט גיאוגרפי המיקום של המכשיר.
dnt מספר שלם הדגל 'Do Not Track' מוגדר בכותרת של הדפדפן.

‫0: מעקב ללא הגבלה
1: לא לעקוב

lmt מספר שלם האות 'הגבלת מעקב אחרי ביצועים של מודעות' אושר מסחרית.

‫0: המעקב לא מוגבל
‫1: המעקב חייב להיות מוגבל בהתאם להנחיות המסחריות

ip מחרוזת חובה אם משתמשים ב-IPv4.

אם כתובת ה-IP קוצצת, צריך להצהיר על כך בdevice.ext.truncated_ip.

ipv6 מחרוזת חובה אם משתמשים ב-IPv6.

אם כתובת ה-IP קוצצת, צריך להצהיר על כך בdevice.ext.truncated_ip.

devicetype מספר שלם מומלץ מאוד לכל הסוגים של מלאי שטחי הפרסום. משמש לשיפור הזיהוי של סוג המכשיר.
make מחרוזת
model מחרוזת
os מחרוזת מערכת ההפעלה שמותקנת במכשיר.

‫ios: בבקשה של אפליקציה, הפרמטר הזה מזהה תנועה ב-iOS.‫
android: מזהה מכשיר Android אם ua או sua לא מזהים את המכשיר.
‫[anything else]: משמש באבחון לבידוד בעיות.

השדה הזה לא תלוי באותיות רישיות.

osv מחרוזת אין תמיכה.
hwv מחרוזת גרסת החומרה של המכשיר.
h מספר שלם הגובה הפיזי של המסך בפיקסלים.
w מספר שלם הרוחב הפיזי של המסך בפיקסלים.
ppi מספר שלם אין תמיכה.
pxratio כפול היחס בין הפיקסלים הפיזיים לבין הפיקסלים הבלתי תלויים במכשיר.
js מספר שלם אין תמיכה.
geofetch מספר שלם אין תמיכה.
flashver מחרוזת אין תמיכה.
language מחרוזת (ISO-639-1-alpha-2) השפה במכשיר.
carrier מחרוזת אין תמיכה.
mccmnc מחרוזת אין תמיכה.
connectiontype מספר שלם סוג החיבור לרשת
ifa מחרוזת מזהה שאושר למפרסם לשימוש בשידור גלוי.
didsha1 מחרוזת אין תמיכה.
didmd5 מחרוזת אין תמיכה.
dpidsha1 מחרוזת אין תמיכה.
dpidmd5 מחרוזת אין תמיכה.
macsha1 מחרוזת אין תמיכה.
macmd5 מחרוזת אין תמיכה.
ext תוספי מכשירים תוספים לאובייקט המכשיר.

תוסף נתמך לאובייקט המכשיר

אם הערך של ip משתנה או נחתך, מומלץ מאוד לשלוח את התוספים הבאים כדי למנוע מצב שבו התנועה תוגדר כתנועה פסולה.

שדה סוג פרטים
truncated_ip מספר שלם מציינים אם כתובת ה-IP בשדה device.ip של בקשת הצעת המחיר נחתכה.

0: לא חתוך
1: חתוך

ברירת המחדל היא לא לחתוך את כתובת ה-IP, והיא נדרשת אם כתובת ה-IP נחתכת.

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

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

‫aaid: Android TV
‫rida: Roku
‫afai: Amazon Fire
‫idfa: Apple tvOS
‫msai: Xbox/Microsoft
‫dpid: מזהה פלטפורמת מכשיר כללי
‫ppid: מזהה שסופק על ידי בעל האתר
‫sspid: מזהה שסופק על ידי פלטפורמת SSP
‫sessionid: מזהה סשן לזמן קצר (רק לסינון תדירות הצגת מודעות)
attestation_token מחרוזת (קידוד Base64) אסימון אימות מבוסס-מכשיר להחלפות שתומכות ברמה הזו של אימות המכשיר.
atts מספר שלם (iOS בלבד) מספר שלם שמועבר כדי לייצג את סטטוס ההרשאה של האפליקציה למעקב אחר אפליקציות.

‫0: לא נקבע
1: מוגבל
2: נדחה
3: אושרה גישה

cdep מחרוזת תווית הוצאה משימוש של קובצי Cookie של צד שלישי ב-Chrome.

מידע נוסף זמין במאמרים בדיקות שמתבצעות באמצעות Chrome ו מפרט הקהילה של IAB.

אובייקט UserAgent

שדה סוג פרטים
browsers מערך של אובייקטים מסוג BrandVersion כל אובייקט BrandVersion מזהה דפדפן או רכיב תוכנה דומה.
platform אובייקט BrandVersion מזהה את הפלטפורמה.
mobile מספר שלם ‫0 (ברירת מחדל): הסוכן מעדיף את התוכן 'למחשב' או 'מלא'.
1: הסוכן מעדיף תוכן לנייד.
architecture מחרוזת ארכיטקטורת המכשיר, לדוגמה, x86 או arm.
bitness מחרוזת הארכיטקטורה של המכשיר, למשל, '64' לארכיטקטורה של 64 ביט.
model מחרוזת דגם המכשיר.
source מספר שלם מקור הנתונים ששימש ליצירת האובייקט הזה. ראו רשימה: מקור User-Agent. מומלץ להשתמש בו כשמעבירים UserAgent object.

אובייקט BrandVersion

שדה סוג פרטים
brand מחרוזת מזהה המותג, לדוגמה, 'Chrome' או 'Windows'. חובה.
version מערך מחרוזות רצף של רכיבי גרסה, בסדר היררכי יורד (גרסה ראשית, גרסה משנית, גרסה מיקרו וכן הלאה).

אובייקט גיאוגרפי

שדה סוג פרטים
lat כפול אין תמיכה.
lon כפול אין תמיכה.
type מספר שלם אין תמיכה.
accuracy מספר שלם אין תמיכה.
lastfix מספר שלם אין תמיכה.
ipservice מספר שלם אין תמיכה.
country מחרוזת אין תמיכה.
region מחרוזת אין תמיכה.
regionfips104 מחרוזת אין תמיכה.
metro מחרוזת אין תמיכה.
city מחרוזת אין תמיכה.
zip מחרוזת אין תמיכה.
utcoffset מספר שלם אין תמיכה.

אובייקט משתמש

שדה סוג פרטים
id מחרוזת יש תמיכה אם Google מארחת את טבלת התאמת המזהים.
buyeruid מחרוזת התמיכה קיימת אם פלטפורמת ה-SSP מארחת את טבלת ההתאמה של המזהים.
yob מספר שלם מומלץ לטירגוט דמוגרפי.
gender מחרוזת מומלץ לטירגוט דמוגרפי.
keywords מחרוזת (CSV) אין תמיכה.
customdata מחרוזת אין תמיכה.
geo אובייקט גיאוגרפי אין תמיכה.
data מערך של אובייקטים של נתונים נתונים נוספים.
eids מערך של אובייקטים של מזהים מורחבים מופעים של מזהה מורחב שסופקו על ידי הבורסה.
ext תוספים למשתמשים תוספים לאובייקט המשתמש.

תוספים נתמכים לאובייקט משתמש

שדה סוג פרטים
eids מערך של אובייקטים של מזהים מורחבים מופעים של מזהה מורחב שסופקו על ידי הבורסה.
consented_providers_settings.consented_providers אובייקט חיצוני (consented_providers_settings) שעוטף מערך פנימי של מספרים שלמים (consented_providers). כשאישורי הסכמה בהתאם ל-GDPR נאספים באמצעות TCF, בשדה הזה מפורטים ספקים של טכנולוגיית פרסום שהמשתמשים הביעו הסכמה לגביהם, אבל הם לא משתתפים ב-TCF. מידע נוסף זמין במאמר בנושא המפרט הטכני של Google בנושא הסכמה נוספת.
us_privacy מחרוזת regs.us_privacy לעיון במסמכי התיעוד צפוי רק אחד מהערכים regs.us_privacy, regs.ext.us_privacy ו-user.ext.us_privacy.

אובייקט מזהה מורחב

שדה סוג פרטים
source מחרוזת הספק של המזהה
uids מערך של אובייקטים של מזהה מורחב המזהים בפועל

אובייקט מזהה משתמש (UID) של Extended ID

שדה סוג פרטים
id מחרוזת המזהה עצמו.
atype מספר שלם סוג סוכן המשתמש שמשויך למזהה הזה.

אובייקט שרשרת אספקה

שדה סוג פרטים
complete מספר שלם ‫0 (ברירת מחדל): שרשרת האספקה לא מלאה.
‫1: שרשרת האספקה הושלמה עד לבעל האתר.
ver מחרוזת חובה.
הערך הוא בפורמט 'major.minor'. לדוגמה, גרסה 1.0 היא המחרוזת '1.0'.
nodes מערך צומת שרשרת אספקה חובה.

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

בשרשרת אספקה לא מלאה, הוא מייצג את הצומת הראשון הידוע. הצומת האחרון מייצג את הישות ששולחת את הבקשה להצעת המחיר.

אובייקט צומת בשרשרת האספקה

שדה סוג פרטים
asi מחרוזת שם הדומיין הקנוני של מערכת ה-SSP, הבורסה, Header Wrapper וכו' שאליהן מתחברים המשתתפים במכרז. הוא יכול להיות הדומיין התפעולי של המערכת, אם הוא שונה מדומיין האב של התאגיד, שנועד לסייע לפרוטוקול WHOIS ולחיפושי IP הפוכים לבסס בעלות ברורה על המערכת המוקצית.

הערך הזה צריך להיות זהה לערך שמשמש לזיהוי מוכרים בקובץ ads.txt, אם קיים קובץ כזה.

sid מחרוזת המזהה שמשויך לחשבון של בית העסק או המפיץ במערכת הפרסום. המזהה הזה חייב להיות זהה למזהה שמשמש בטרנזקציות (למשל בקשות להצעת מחיר מ-OpenRTB) בשדה שצוין על ידי פלטפורמת ה-SSP או הבורסה.

ב-OpenRTB זה בדרך כלל publisher.id. ב-OpenDirect, זה בדרך כלל מזהה הארגון של בעל האתר.

האורך צריך להיות מוגבל ל-64 תווים.

rid מחרוזת מזהה הבקשה OpenRTB של הבקשה כפי שהונפקה על ידי המוכר הזה.
name מחרוזת שם החברה (הישות המשפטית) שמקבלת תשלום על מלאי שמתבצעות בו עסקאות באמצעות המזהה seller_id שצוין.

הערך הזה הוא אופציונלי ואין לכלול אותו אם הוא קיים בקובץ sellers.json של מערכת הפרסום.

domain מחרוזת שם הדומיין העסקי של הישות שמיוצגת על ידי הצומת הזו.

הערך הזה הוא אופציונלי ואין לכלול אותו אם הוא קיים בקובץ sellers.json של מערכת הפרסום.

hp מספר שלם השדה מציין אם הצומת הזה יהיה מעורב בתהליך התשלום על מלאי שטחי הפרסום.

‫1: מערכת הפרסום בשדה asi משלמת למוכר בשדה sid, שבאחריותו לשלם לצומת הקודם בשרשרת.
0: הצומת הזה לא מעורב בתהליך התשלום על מלאי שטחי הפרסום.

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

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

מפרט התגובה לבקשה להצעת מחיר

אובייקט BidResponse

מאפיין כן פרטי ההטמעה תמיד עבר
id [מזהה] אם מתרחשת שגיאת ניתוח, יכול להיות שהערך יהיה '0' במקום מזהה הבקשה להצעת מחיר. כן
seatbid
bidid
cur אם מתרחשת שגיאת ניתוח, היא לא מועברת. במקרה של תנועה של בקשות להצעות מחיר תקינות הפרמטר cur תמיד מסופק. כן
customdata
nbr הערך הזה נכלל רק אם נמצאה בעיה בבקשה להצעת מחיר. הערכים האפשריים כוללים:
2: בקשה לא חוקית
12: הפרת הרשאה של ads.txt
16: SupplyChain לא מלא
17: צומת SupplyChain חסום
הערה: כשמזוהה הפרה ספציפית של (app-)ads.txt או SupplyChain, אחד מהקודים 12,‏ 16 או 17 יאוכלס בחלק (1%) מהתגובות. הקוד 2 יאוכלס עבור כל שאר הבקשות הלא תקינות.
בקשות שכוללות NBR ייראו כך: 
{
  "id": "0",
  "nbr": 2,
  "ext": {
    "err": "Bid request body was empty.",
    "errHelp": "https://.../ortb-spec"
  }
}
ext אם יש בעיה בבקשה להצעת מחיר, יכול להיות שהפרמטר ext יכיל מידע שיעזור לאבחן את השגיאה, אם האפשרות הזו נתמכת.

תוספים נתמכים לאובייקט BidResponse

מאפיין פרטי ההטמעה
err

תיאור קריא של השגיאה בבקשה להצעת מחיר. דוגמאות למקרים שבהם נדרשת תגובה:

  • גוף הבקשה להצעת מחיר היה ריק.
  • בקשת הצעת המחיר לא הייתה במטבע שמופיע ברשימת המטבעות המותרים לשימוש בבורסת הפרסום הספציפית.
  • הבקשה להצעת מחיר לא הכילה סוג MIME מקובל.
errHelp קישור לדף הזה.

אובייקט Seatbid

מאפיין כן פרטי ההטמעה תמיד עבר
הגש הצעת מחיר כן
מושב כן
קבוצה

אובייקט של הצעת מחיר

מאפיין כן פרטי ההטמעה תמיד עבר
id [מזהה] כן
impid כן
price כן
nurl
גידול מעוות בעץ
lurl
adm
adid
adomain
חבילה
iurl
cid כן
crid כן
טקטיקה
cat
מאפיין
api
פרוטוקול
qagmediarating
language
מזהה מבצע [dealid]
שבוע
שע'
wratio
hratio
exp

תוספים נתמכים לאובייקט bid

מאפיין פרטי ההטמעה
apis פלטפורמת DV360 תשלח את הערך seatbid.bid.apis אם יש תמיכה ב-OMID וב-MRAID. מערכת DV360 תגדיר את OMID_1 ואת MRAID כמערך של מספרים שלמים.

אפשרויות להצגת מודעות

בקטע 4.3 של מפרט OpenRTB, יש שתי אפשרויות שונות להצגת מודעות:

  • תגי עיצוב שמוצגים בהודעה על הזכייה
  • תגי העיצוב הוצגו בהצעת המחיר

ב-DV360 יש תמיכה בשתי האפשרויות.

  • במקרה של מודעת באנר, מערכת DV360 תמיד מחזירה תגי עיצוב בשדה adm. תגי העיצוב שמוצגים בהודעת הזכייה הם אופציונליים.
  • במקרה של מודעות וידאו או אודיו שמשתמשות בפרוטוקול VAST, מערכת DV360 תומכת בהחזרת VAST XML בשדה adm או בתגובה של הודעת הזכייה, בהתאם לדרישות של שותפי הבורסה.

כדי להבין את היתרונות והחסרונות של שתי האפשרויות האלה, אפשר לעיין במפרט OpenRTB.

שיטות מומלצות

מומלץ מאוד להשתמש במזהה השותף ב-Display and Video 360 כמזהה החשבון הצאצא. לא מומלץ להשתמש במזהה מושב ספציפי לבורסת פרסום.

צריך לוודא שלבעלי האתרים יש קובצי ads.txt או אפליקציות עם קובצי app-ads.txt משויכים, ושהם מופיעים בקובץ כמוכרים מורשים או כמפיצים מורשים. מידע נוסף

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

טלוויזיה מחוברת

צריך לפעול בהתאם להנחיות של IAB OTT IFA כדי להעביר את הערכים device.ifa ו-device.lmt. כדי לעמוד בהנחיות, צריך להטמיע גם את התג device.ext.ifa_type. כל היכולות שלנו בנושא מכסת תדירות ב-CTV וטירגוט לפי קהל ידרשו נוכחות של מזהה פרסום.

בנוסף, צריך לפעול בהתאם להנחיות שפורסמו לאחרונה בנושא מזהה שהוקצה על ידי חנות OTT/CTV של IAB. ההנחיות האלה מגדירות איך צריך להעביר את app.bundle באפליקציות ל-CTV – בעיקר באמצעות המזהה שהוגדר בחנות האפליקציות.

מדידה ב-Active View

‫Active View היא טכנולוגיה של Google שמשמשת למדידה של חשיפה ניתנת לצפייה ולמשך הזמן שלה. ‫Active View משתמש ב-OMID גם במודעות לרשת המדיה וגם במודעות וידאו. כדי להפעיל מדידה באמצעות OMID, בורסות צריכות להוסיף את השדות הבאים לבקשות OpenRTB כדי שמערכת DV360 תדע שהלקוח תומך ב-OMID.

  • חובה: מוסיפים מסגרת API (‫Video.api=7 ל-Web Video OMSDK,‏ Native.api=7 ל-Native App OMSDK,‏ Banner.api=7 או Audio.api=7) לבקשות להצעות מחיר. הפעולה הזו נדרשת כדי ש-Active View יוכל למדוד את הניראות באמצעות OMID.
  • מומלץ: מומלץ מאוד להוסיף את omidpn ואת omidpv אל Source.Ext כי זה ישפיע על אופן הדיווח של מדידות הנראות ב-DV360 ללקוח. אם שם השותף של OMID לא מופיע ברשימת האישורים של IAB, אנחנו מחויבים על ידי MRC לדווח על מדדי הניראות בנפרד ממדדים שאושרו על ידי MRC. מידע נוסף
מדידה ב-Active View של מודעות מותאמות

כדי להפעיל את מדידת הניראות באמצעות Active View במודעות מותאמות, בעלי אתרים ובורסות פרסום ב-DV360 צריכים לבצע שלבים נוספים.

  • מודעות מותאמות לרשת המדיה: מערכת DV360 מוסיפה את הערכים הבאים eventtrackers בתגובה לבקשה להצעת מחיר, מתחת לאובייקט adm.native:

    "eventtrackers": [
  {
    "event": 555,
    "method": 2,
    "url": "https://pagead2.googlesyndication.com/pagead/managed/js/activeview/current/rx_omid.js",
    "ext": {
      "vendorKey": "doubleclickbygoogle.com-omid-dsp",
      "verification_parameters": ""
    }
  }
]

    בורסות צריכות להעביר לבעלי האתרים עוד כלי מעקב אחרי אירועים, ובעלי האתרים צריכים לבצע את השלבים הבאים:

    1. מתקינים את OMSDK.
    2. טוענים את OMSDK כשמעבדים מודעות מותאמות.
    3. מריצים את JavaScript ב-eventtrackers.url עם הפרמטרים שצוינו.

  • מודעות וידאו מותאמות: מערכת DV360 מאפשרת מדידת ניראות על ידי הוספת התוסף AdVerifications הרגיל ב-XML של VAST:

    <Extension type="AdVerifications">
  <AdVerifications>
    <Verification vendor="doubleclickbygoogle.com-omid-video">
      <JavaScriptResource apiFramework="omid" browserOptional="true">
        <![CDATA[ https://www.googletagservices.com/activeview/js/current/rx_omid_video.js ]]>
      </JavaScriptResource>
      <VerificationParameters>
        <![CDATA[ {"activeview_flags":"...","activeview_metadata":"...", ...} ]]>
      </VerificationParameters>
      <TrackingEvents>
        <Tracking event="verificationNotExecuted">
          <![CDATA[ https://ade.googlesyndication.com/ddm/activity/... ]]>
        </Tracking>
      </TrackingEvents>
    </Verification>
  </AdVerifications>
</Extension>

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

תקנות בנושא AI באיחוד האירופי לגבי מודעות מובנות ב-3PE

כדי לאפשר למפרסמים לפעול בהתאם לתקנות חדשות בנושא שקיפות. התקנות בנושא AI באיחוד האירופי, בהודו ובמדינת ניו יורק מחייבות שמודעות עם נכסים מסוימים שנוצרו או נערכו באמצעות AI יכללו גילוי נאות שמיידע את הצרכנים שהמודעות נוצרו על ידי AI. כדי לעזור למפרסמים לעמוד בדרישות של תקנות חדשות בנושא שקיפות לגבי שימוש ב-AI, החל מיולי 2026, מערכת Display & Video 360 (DV360) תאפשר למפרסמים להוסיף תוויות שמציינות שנכסי הקריאייטיב נוצרו או שונו באמצעות AI.

מפרסמים יכולים להוסיף את התוויות האלה ישירות לנכסי הקריאייטיב שלהם או להשתמש בהגדרת תוויות ה-AI דרך ממשק המשתמש וה-API של Display & Video 360. איך משתמשים בהגדרות של תוויות תוכן שנוצר על ידי AI כדי להוסיף תגים למודעות

במקרה של מודעות שמוצגות על ידי Google, אסטרטגיית התאימות שבחרנו כוללת תווית AI מינימלית לפני הקליק וגילוי נאות אחרי הקליק בחלונית About This Ad (ATA).

בפורמטים של מודעות מותאמות ב-3PE, ‏ Google לא שולטת בעיבוד הסופי של המודעה. במקרים כאלה, אות האישור הזה יועבר כחלק מהתגובה לבקשה להצגת מודעה, כדי שבורסות או בעלי תוכן דיגיטלי יוכלו להציג את המודעה הסופית כולל תווית ה-AI או הגילוי הנאות. האות יהיה חלק מהשדה adm.native.ext של התגובה לבקשה להצגת מודעה מקורית. השדה החדש adm.native.ext הוא בפורמט הבא:

  "ext" {
     "should_disclose_ai": "true",
     "ai_disclosure_url": ""
  }
  • ‫should_disclosure_ai (true או false) מציין אם במודעה הסופית צריך לכלול תווית AI.
  • יכול להיות שהשדה ai_disclosure_url יופיע ויכול להיות שלא. השדה הזה יופיע רק אם should_disclosure_ai מוגדר כ-true ושדה כתובת ה-URL של native.privacy ריק. במקרה כזה, לחיצה על תווית ה-AI אמורה להעביר את המשתמש לכתובת ה-URL שצוינה בשדה הזה. אחרת, לחיצה על התווית של ה-AI אמורה להוביל את המשתמש לשדה הרגיל של כתובת ה-URLnative.privacy.

האותות האלה צריכים להיות מועברים לבעלי תוכן דיגיטלי, כדי שהם יוכלו להציג את המודעה עם תווית ה-AI.

שאלות נפוצות

האם DV360 תומך בתוספים מותאמים אישית של Exchange?
כן, בנוסף לתוספים שמפורטים במפרט הזה, יכול להיות ש-Display and Video 360 יתמוך גם בתוספים בהתאמה אישית, בהתאם למקרה. מומלץ לציין ולבדוק את התוסף המותאם אישית במהלך תקופת השילוב.
האם יש תמיכה במודעות מתגמלות ב-DV360?
כן, נשמח לקבל את תוסף הסרטונים עם התגמול.
חלק גדול מהמלאי שלי מופיע כנתונים דמוגרפיים לא ידועים. איך אפשר לשפר את הכיסוי הדמוגרפי?
מאכלסים את הפרמטרים user.yob ו-user.gender בבקשות להצעות מחיר ב-DV360 כדי להגדיל את הכיסוי.
האם ל-DV360 יש נקודות קצה לכל אזור?
לא, אנחנו משתמשים בנקודת קצה אחת באופן גלובלי ומנתבים אוטומטית בקשות למרכז הנתונים הקרוב ביותר, כך שאין נקודת קצה ספציפית לאזור שאנחנו יכולים לספק.
מהן הדרישות לבקשות משרת לשרת (s2s)?
פונים אלינו כדי לבקש להוסיף אתכם לרשימת ההיתרים שלנו. צריך להעביר את סוכן המשתמש של הלקוח ולוודא שקובצי ה-Cookie מושבתים או מתעלמים מהם בתגובה לאחזור VAST מסוג s2s.
האם יש תמיכה ב-OMID ב-DV360?
אנחנו יכולים למדוד את שיעור החשיפות שניתנות לצפייה באמצעות OMID, כל עוד הוא מוצהר כ-OMID-enabled בזמן בקשה להצעת מחיר. פרטים על כך מסוכמים בדפים 24-25.
באיזו גרסה של Native אתם תומכים? האם יש לך דרישות לגבי מודעות Native?
אנחנו תומכים רק בגרסה Native Ver1.2. מפרט של מודעות מותאמות.
האם יש תמיכה ב-DV360 בבקשות להצעות מחיר שנשלחות כ-GZIP?
‫
DV360 יכול לקבל בקשות להצעות מחיר שנדחסו ב-gzip, ויגיב בתגובות שנדחסו ב-gzip אם כותרת Accept-Encoding מציינת שהדחיסה נתמכת.
האם יש תמיכה ב-DBURL ב-DV360?
בשלב הזה, לא.
האם DV360 תומך בהתראה על ניצחון או הפסד במכרז?
בשלב הזה, לא. אם לדעתך כדאי לנו לתמוך בזה, אפשר
לפנות אלינו עם פרטים נוספים.
האם ב-DV360 נדרש App.name לטירגוט?
לא, מערכת DV360 משתמשת ב-App.name לצורך הפניה, אבל היא לא נדרשת לטירגוט, App.bundle משמשת לטירגוט.
האם מערכת DV360 תומכת בכמה גדלים של מודעות שנשלחים בבקשה להצעת מחיר אחת?
כן, נביא בחשבון את כל הגדלים המתאימים של קריאייטיבים ב-banner.format.
האם DV360 תומך בכמה פורמטים באותה בקשה להצעת מחיר?
התמיכה שלנו בבקשות להצעות מחיר במגוון פורמטים מוגבלת, אבל אנחנו פועלים כדי לשפר אותה. אנחנו תומכים בפורמטים של מודעות לרשת המדיה ומודעות וידאו למודעות מעברון, אבל כרגע אנחנו לא תומכים במודעות לרשת המדיה ובמודעות מותאמות. אם אתם שולחים בקשות להצעות מחיר בכמה פורמטים, אתם יכולים לפנות אלינו כדי לבקש בדיקה.
האם DV360 תומך בסוגים שונים של חשיפות באותה בקשה?
בשלב הזה אנחנו תומכים רק במודעות מעברון מסוג וידאו או באנר. אנחנו פועלים להוספת מודעות באנר מותאמות/מודעות באנר ומודעות וידאו/מודעות באנר. אם יש שילובים אחרים, אפשר לפנות לצוות שלנו.
האם כל אחד מכמה מושבים יכול לשלוח כמה הצעות מחיר על הזדמנויות חשיפה כאלה בבקשה אחת?
כן.
האם ל-DV360 יש פתרון או צורך ספציפי לגבי הגבלת מספר החשיפות או הצגת אותו מפרסם לכמה הזדמנויות כאלה לחשיפה באותה בקשה?
‫
DV360 אוכף את הכלל שכל מפרסם יכול להגיש הצעת מחיר רק על הזדמנות אחת להצגת מודעה לכל בקשה. אנחנו מצפים מแพלטפורמות SSP לקבץ אובייקטים של בקשות להצגת מודעות בצורה משמעותית, למשל, את כל האובייקטים באותו הדף, את כל האובייקטים באותה האפליקציה וכו'.
האם ב-DV360 יש תמיכה בכמה חשיפות באותה בקשת הצעת מחיר?
ב-DV360 יש כרגע תמיכה באובייקטים של אודיו עם כמה חשיפות. עם זאת, נצטרך לבדוק ולהפעיל כל בורסה שרוצה להשתמש בתכונה הזו. מידע נוסף זמין במאמר מפרט בקשות להצעות מחיר. אנחנו פועלים להרחבת התכונה הזו לפורמטים נוספים: 
{
id: "2bbdc94f-7289-4fe2-9a5f-e2a530e06b38",
seatbid {
bid {
  id: "0",
  impid: "234232",
  price: 41.373926619828261,
  adid: "123",
  adm: "...",
  adomain: "xxx.com",
  cid: "0",
  crid: "123",
  dealid: "sample-deal-id-1",
  language: "xx",
},
bid {
  id: "1",
  impid: "234255",
  price: 2.34192037470726,
  adid: "234",
  adm: "...",
  adomain: "xyz.com",
  cid: "0",
  crid: "234",
  dealid: "sample-deal-id-2",
  language: "xx",
},
seat: "123456"
},
cur: "EUR"
}

יצירת קשר

אם יש לכם שאלות או בעיות, אתם יכולים לפנות לצוות התמיכה של Ad Manager Exchange.