מפרט OpenRTB ב-DV360

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

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

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

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

בקשה להצעת מחיר היא בקשת 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 אחד.
בתרחישי שימוש אחרים (למשל, כמה מיקומי מודעות עצמאיים בדף), נעשה שימוש באובייקט 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 מציין שכן, והשמטה מציינת שהסטטוס לא ידוע. פרטים נוספים מופיעים במאמרי העזרה בנושא GDPR ב-DV360. צפוי רק אחד מבין 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, קליפורניה ואחרים. ‫IAB Europe TCF sections are not accepted; use user.consent or user.ext.consent instead.
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 מודעות מותאמות נדרש להזדמנויות להצגת מודעות מותאמות.
pmp Pmp עסקאות בשוק פרטי שבתוקף לחשיפה הזו.
displaymanager מחרוזת שם השותף של תהליך בחירת רשת מודעות, טכנולוגיית ה-SDK או הנגן שאחראי על רינדור המודעה (בדרך כלל מודעת וידאו או מודעה לנייד). משמש חלק משרתי המודעות כדי להתאים אישית את קוד המודעה לפי השותף. מומלץ לסרטונים ו/או לאפליקציות.
displaymanagerver מחרוזת הגרסה של שותף התיווך, טכנולוגיית ה-SDK או הנגן שאחראים על הצגת המודעה (בדרך כלל מודעת וידאו או מודעה לנייד). משמש שרתים מסוימים של מודעות כדי להתאים אישית את קוד המודעה לפי שותף. מומלץ לסרטונים ו/או לאפליקציות.
instl מספר שלם ‫0 (ברירת מחדל): לא מדובר במודעה שמוצגת לפני או אחרי תוכן.
1: המודעה היא מודעת מעברון או מודעה במסך מלא.
tagid מחרוזת מזהה של מיקום מודעה ספציפי או תג מודעה ספציפי ששימש להפעלת המכרז. המידע הזה יכול להיות שימושי לניפוי באגים או לאופטימיזציה על ידי הקונה.
bidfloor מספר ממשי (float) הצעת המחיר המינימלית לחשיפה הזו, במונחים של עלות לאלף חשיפות.
bidfloorcur מחרוזת

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

clickbrowser מספר שלם

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

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

secure מספר שלם אם החשיפה הזו מחייבת כתובת URL מסוג HTTPS מאובטחת, או כתובת URL מסוג HTTP לא מאובטחת.
‫0 (ברירת מחדל):לא מאובטח
‫1: מאובטח
iframebuster מערך מחרוזות
exp מספר שלם תוקף הביד נקבע על ידי DV 360 בלי להתחשב בערך שנשלח על ידי שותף בשדה הזה. אירועי חשיפה שמתקבלים אחרי חלון הזמן של חשיפה לא עדכנית (בדרך כלל שעה אחת) נפסלים כלא עדכניים ולא נחשבים כאירועים שניתנים לחיוב ב-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: מודעה עם לחצן להפעלה או להשבתה של האודיו

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 מספר שלם השהיית ההתחלה בשניות של מיקומי מודעות לפני הסרטון (pre-roll), באמצע הסרטון (mid-roll) או בסוף הסרטון (post-roll).
placement מספר שלם מומלץ מאוד לציין את מיקום המודעה (plcmt) ו/או את מיקום הסרטון בבקשה להצעת מחיר. אם שני השדות חסרים, המיקום יסווג כמיקום לא ידוע.

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

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

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

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

הערה: אם תציינו גם את plcmt וגם את placement, המערכת תיתן עדיפות ל-plcmt. מידע נוסף על מעבר ל-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 לתכונה 'תצוגה פעילה'.
‫8: SIMID 1
companiontype מערך של מספרים שלמים אין תמיכה.
maxseq מספר שלם המספר המקסימלי של מודעות שיוחזרו בבלוק דינמי של מודעות וידאו.
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 מספר שלם השהיית ההתחלה בשניות של מיקומי מודעות לפני סרטון (pre-roll), באמצע סרטון (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 מערך Deal object המבצעים שרוצים לכלול.

אובייקט העסקה

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

חובה אם at=3.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

אם בבורסה שלכם נעשה כרגע שימוש במנגנון אחר כדי לסמן עסקאות מובטחות ב-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. אפשר לעיין בהסבר על תוסף ה-CTV של IAB.

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

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

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

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

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

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

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

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

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

אובייקט תוכן

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

שדה סוג פרטים
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 מערך של אובייקטי נתונים נתונים נוספים.

אובייקט Producer

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

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

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

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

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

אובייקט פלח

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

אובייקט של בעל תוכן דיגיטלי

שדה סוג פרטים
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 תוספים למכשירים תוספים לאובייקט המכשיר.

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

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

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

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

ברירת המחדל היא לא לחתוך את כתובת ה-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.

אובייקט 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 של מזהה מורחב

שדה סוג פרטים
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 מחרוזת ה-RequestId של הבקשה ב-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 תומכת בהחזרת XML של VAST בשדה adm או בתגובה של הודעת הזכייה, בהתאם לדרישות של שותפי הבורסה.

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

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

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

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

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

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

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

חשוב גם לפעול בהתאם להנחיות שפורסמו לאחרונה בנושא מזהה שהוקצה על ידי חנות אפליקציות ל-OTT/CTV. ההנחיות האלה מגדירות איך צריך להעביר את 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 או גילוי נאות לגבי 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)?
פונים אלינו כדי לבקש להוסיף אתכם לרשימת ההיתרים שלנו. צריך להעביר את סוכן המשתמש של הלקוח ולוודא שהקובצים הקוקי מושבתים או מתעלמים מהם בתגובה לאחזור VAST מסוג s2s.
האם DV360 תומך ב-OMID?
אנחנו יכולים למדוד את שיעור הצפייה באמצעות OMID כל עוד הוא מוצהר כ-OMID-enabled בזמן בקשת הצעת המחיר. פרטים על כך מסוכמים בדפים 24-25.
איזו גרסה של Native אתם תומכים? יש לך דרישות לגבי מודעות Native?
אנחנו תומכים רק בגרסה 1.2 של Native. מפרט מודעות מותאמות
.
האם DV360 תומך בבקשות להצעות מחיר שנשלחות כ-GZIP?
‫
DV360 יכול לקבל בקשות להצעות מחיר שנדחסו באמצעות gzip, ויגיב בתגובות שנדחסו באמצעות gzip אם כותרת Accept-Encoding מציינת שהדחיסה נתמכת.
האם DV360 תומך ב-DBURL?
בשלב הזה, לא.
האם DV360 תומך בהתראה על אובדן?
כן, מערכת DV360 מאכלסת את השדה bid.lurl בתגובות לבקשות להצעות מחיר. אם הביד מפסיד, יכול להיות שהבורסה תשלח פינג לכתובת ה-URL הזו עם סיבה, והסיבה הזו תוצג למפרסמים. הסיבות האלה יכולות לעזור למפרסמים להימנע מהפסדים בעתיד.
האם ב-DV360 נדרש App.name לטירגוט?
לא, DV360 משתמש ב-App.name לצורך הפניה, אבל הוא לא נדרש לטירגוט, App.bundle משמש לטירגוט.
האם DV360 יכול לתמוך בכמה גדלים של מודעות שנשלחים בבקשת בידינג אחת?
כן, נביא בחשבון את כל הגדלים המתאימים של קריאייטיבים ב-banner.format.
האם DV360 תומך במספר פורמטים באותה בקשת בידינג?
התמיכה שלנו בבקשות להצעות מחיר במגוון פורמטים מוגבלת, אבל אנחנו פועלים כדי לשפר אותה. אנחנו תומכים בפורמטים של מודעות לרשת המדיה ומודעות וידאו למודעות מעברון, אבל כרגע לא תומכים במודעות לרשת המדיה ובמודעות מותאמות. אם אתם שולחים בקשות להצעות מחיר בכמה פורמטים, אתם יכולים לפנות אלינו כדי לבקש בדיקה.
האם DV360 תומך בסוגים מעורבים של חשיפות באותה בקשה?
בשלב הזה אנחנו תומכים רק במודעות וידאו או באנר מסוג interstitial. אנחנו עובדים על מודעות מותאמות/באנר ומודעות וידאו/באנר. אם יש שילובים אחרים, אפשר לפנות לצוות שלנו.
האם כמה מושבים יכולים לשלוח כל אחד כמה הצעות מחיר על הזדמנות חשיפה אחת או יותר באותה בקשה?
כן.
האם ל-DV360 יש פתרון או צורך ספציפי לגבי הגבלת מספר החשיפות או הצגת אותו מפרסם לכמה הזדמנויות לחשיפה באותה בקשה?
ב-DV360 יש אכיפה של הכלל שלפיו כל מפרסם יכול להגיש הצעת מחיר רק על הזדמנות אחת להצגת מודעה לכל בקשה. אנחנו מצפים מ-SSP לקבץ אובייקטים של imp בצורה משמעותית, למשל, את כל האובייקטים באותו דף, את כל האובייקטים באותה אפליקציה וכו'.
האם 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.