מפרט 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.
ההגדרה Unset (לא מוגדר) פירושה שאין קטגוריות חסומות.
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.
ext תוספי תקנות אופציונלי.

אובייקט Regs extensions

שדה סוג פרטים
gdpr מספר שלם מציינים אם הבקשה להצעת מחיר מגיעה מאזור EEA.
0 (ברירת מחדל): אזור שלא שייך ל-EEA.
1: אזור EEA,
פרטים נוספים זמינים במאמר פתרון לספקי שירותים שקיבלו הסכמה בהתאם ל-GDPR.
us_privacy מחרוזת כדי להטמיע את המחרוזת us_privacy, צריך לפעול בהתאם למפרט הטכני של IAB Tech Lab.

כשנקבל את המחרוזת us_privacy בבקשה להצעת מחיר, וכשמחרוזת ה-IAB תציין שהמשתמש לא סירב, מערכת Display & Video 360 תגיש הצעת מחיר לבקשות כאלה. לא נעביר את האות של IAB לספקים אחרים. אם המחרוזת של IAB תציין שהמשתמש סירב לפרסום מותאם אישית, Google לא תגיש הצעת מחיר לבקשות כאלה.

אובייקט שד

שדה סוג פרטים
id מחרוזת מזהה ייחודי של החשיפה הזו בהקשר של בקשת הצעת המחיר (בדרך כלל, הערך מתחיל ב-1 ועולה עד n עבור n חשיפות).
metric אובייקט לא נתמך.
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 View Controller נחשב לדפדפן מקורי לצורך השדה הזה.

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

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

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

שדה סוג פרטים
bcrid מחרוזת רשימה של מזהי קריאייטיב שצריך לחסום.
שדה סוג פרטים
format מערך 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: סרטון במודעת באנר שהמשתמש הפעיל
‫: חלון קופץ(מעל/מתחת/ביציאה)
‫: פרובוקטיבי או בעל רמיזות מיניות
‫: 'מעצבנת', למשל: רועדת, מהבהבת, מרצדת, אנימציה קיצונית, סמיילים
‫: סקרים
‫: טקסט בלבד
‫: אינטראקטיבית עם המשתמש (משחקים)
‫: בסגנון של תיבת דו-שיח או התראה ב-Windows
‫: אפשר לדלג על המודעה
‫: פלאש
891011121314151617

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 עם אובייקט video.

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

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





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

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

הערה: כדי שמיקומי מודעות או חשיפות של מודעות וידאו ייחשבו כ-In-stream (סוג מיקום או סוג plcmt‏ 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 לתצוגה פעילה.
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 מספר שלם ההשהיה בהתחלה בשניות של מיקומי מודעות לפני הסרטון, באמצע הסרטון או בסוף הסרטון.

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

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

‫7: Omid V1

companiontype מערך של מספרים שלמים לא נתמך.
maxseq מערך של מספרים שלמים לא נתמך.
feed מספר שלם סוג פיד האודיו.

‫1: שירות מוזיקה
‫2: שידור
‫3: פודקאסט

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

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

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

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

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

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

אובייקט תוכן

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

שדה סוג פרטים
id מחרוזת מזהה ייחודי של התוכן.
episode מספר שלם מספר הפרק של התוכן (בדרך כלל לתוכן וידאו).
title מחרוזת מומלץ לבקשות של CTV, וידאו ואודיו.
series מחרוזת מומלץ לבקשות של CTV, וידאו ואודיו.
season מחרוזת תווית לעונה של התוכן.
artist מחרוזת האומן שקיבל קרדיט על התוכן.
genre מחרוזת הז'אנר שמתאר בצורה הטובה ביותר את התוכן. ב-DV360 מומלץ לספק את האות הזה לבקשות של CTV, סרטונים ואודיו.
‫DV360 תומך בכמה טקסונומיות של ערכי ז'אנר וידאו בשדה הזה:
  • רשימת הז'אנרים של 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 מספר שלם הדגל 'לא לעקוב' כפי שהוא מוגדר בכותרת של הדפדפן.

‫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
‫: Apple tvOS
‫msai: Xbox/Microsoft
‫dpid: מזהה פלטפורמת מכשיר כללי
‫ppid: מזהה שסופק על ידי בעל האתר
‫sspid: מזהה שסופק על ידי פלטפורמת SSP
‫sessionid: מזהה סשן לזמן קצר (לצורך הגבלת תדירות בלבד)idfa

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

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

שדה סוג פרטים
consent מחרוזת (Base64 בטוחה לאינטרנט) נתוני הסכמה בהתאם ל-IAB.

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

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

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

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

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

אובייקט מזהה מורחב של UID

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

אובייקט SupplyChain

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

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

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

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

שדה סוג פרטים
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 בנושא 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 Framework ‏ (Video.api=7 ל-OMSDK) לבקשות להצעות מחיר. הפעולה הזו נדרשת כדי ש-Active View יוכל למדוד את הניראות באמצעות OMID.
  • מומלץ: מומלץ מאוד להוסיף את omidpn ו-omidpv אל Source.Ext, כי זה ישפיע על אופן הדיווח של מדידות הנראות ב-DV360 ללקוח. אם שם השותף של OMID לא מופיע ברשימת האישורים של IAB, אנחנו מחויבים על ידי MRC לדווח על מדדי הניראות בנפרד מהמדדים שאושרו על ידי MRC. מידע נוסף

שאלות נפוצות

האם DV360 תומך בתוספים מותאמים אישית של Exchange?
כן, בנוסף לתוספים שמפורטים במפרט הזה, יכול להיות ש-Display & Video 360 יתמוך גם בתוספים מותאמים אישית על בסיס כל מקרה לגופו. מומלץ לציין ולבדוק את התוסף המותאם אישית במהלך תקופת השילוב.
האם יש תמיכה במודעות וידאו מתגמלות ב-DV360?
כן, שלח לנו את התוסף של סרטון עם תגמול.
חלק גדול מהמלאי שלי מופיע כנתונים דמוגרפיים לא ידועים. איך אפשר לשפר את הכיסוי הדמוגרפי?
מאכלסים את הפרמטרים user.yob ו-user.gender בבקשות להצעות מחיר ב-DV360 כדי להגדיל את הכיסוי.
האם ל-DV360 יש נקודות קצה לכל אזור?
לא, אנחנו משתמשים בנקודת קצה אחת באופן גלובלי ומנתבים אוטומטית בקשות למרכז הנתונים הקרוב ביותר, ולכן אין לנו נקודת קצה ספציפית לאזור שאנחנו יכולים לספק.
מהן הדרישות לבקשות משרת לשרת (s2s)?
פונים אלינו כדי לבקש להוסיף אתכם לרשימת ההיתרים שלנו. צריך להעביר את נתוני User Agent של הלקוח ולוודא שהקובצים מסוג Cookie מושבתים או מתעלמים מהם בתגובה לאחזור VAST מסוג s2s.
האם יש תמיכה ב-OMID ב-DV360?
אנחנו יכולים למדוד את שיעור הצפייה באמצעות OMID, כל עוד הוא מוצהר כ-OMID-enabled בזמן בקשת הבידינג. פרטים על כך מסוכמים בדפים 24-25.
באיזו גרסה של 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.