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

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

שדה	סוג	פרטים
`gdpr`	מספר שלם	מציינים אם הבקשה להצעת מחיר מגיעה מאזור EEA. `0` (ברירת מחדל): אזור שלא שייך ל-EEA. `1`: אזור EEA, פרטים נוספים זמינים במאמר פתרון ספק שקיבל הסכמה בהתאם ל-GDPR.
`us_privacy`	מחרוזת	כדי להטמיע את המחרוזת `us_privacy`, צריך לפעול בהתאם למפרט הטכני של IAB Tech Lab. כשמערכת Display & Video 360 מקבלת את המחרוזת `us_privacy` בבקשה להצעת מחיר, וכשמצוין במחרוזת של IAB שהמשתמש לא סירב לאיסוף נתונים, המערכת תגיש הצעת מחיר לבקשות כאלה. לא נעביר את האות של 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`	מערך פורמט	רשימה של פורמטים נתמכים.
`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`	מספר שלם	השהיית ההתחלה בשניות של מיקומי מודעות לפני הסרטון, מודעה באמצע סרטון (mid-roll) או מודעה בסוף הסרטון (post-roll).
`placement`	מספר שלם	מומלץ מאוד לציין את מיקום המודעה (plcmt) (או) את מיקום המודעה של הסרטון בבקשה להצעת מחיר. אם שני השדות חסרים, המיקום יסווג כמיקום לא ידוע. ‫`0` (ברירת מחדל): לא ידוע ‫`1`: בתוך סרטון ‫`2`: בבאנר ‫`3`: בתוך מאמר ‫`4`: בפיד ‫`5`: צף הערה: כדי שמיקומי מודעות או חשיפות של מודעות וידאו ייחשבו כ-In-stream (מיקום או סוג מיקום 1), צריך להגדיר אותם כ'הפעלה עם אודיו' ולסמן אותם בצורה נכונה בשיטת ההפעלה (ערכים 1, 3, 4 ו-5 עומדים בדרישות).
`plcmt`	מספר שלם	מומלץ מאוד לציין את מיקום המודעה (plcmt) (או) את מיקום המודעה של הסרטון בבקשה להצעת מחיר. אם שני השדות חסרים, המיקום יסווג כמיקום לא ידוע. ‫`0` (ברירת מחדל): לא ידוע ‫`1`: בתוך הזרם ‫`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`	מספר שלם	סוג פיד האודיו. ‫`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`	מערך אובייקט העסקה	העסקאות שרוצים לכלול.

אובייקט עסקה

שדה	סוג	פרטים
`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` במקום בשדה הזה.

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.

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

שדה	סוג	פרטים
`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.

אובייקט תוכן

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

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

אובייקט 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 מזהה דפדפן או רכיב תוכנה דומה.
`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

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

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

שדה סוג פרטים

complete מספר שלם ‫0 (ברירת מחדל): שרשרת האספקה לא מלאה.
‫1: שרשרת האספקה הושלמה עד לבעל האתר.

ver מחרוזת חובה.
הערך הוא בפורמט 'major.minor'. לדוגמה, גרסה 1.0 היא המחרוזת '1.0'.

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

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	קישור לדף הזה.

מאפיין

פרטי ההטמעה

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 (‫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>

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

שאלות נפוצות

האם DV360 תומך בתוספים מותאמים אישית של Exchange?

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

האם פלטפורמת DV360 תומכת במודעות מתגמלות?

כן, נשמח לקבל את התוסף של סרטון עם תמריץ.

חלק גדול מהמלאי שלי מופיע כנתונים דמוגרפיים לא ידועים. איך אפשר לשפר את הכיסוי הדמוגרפי?

מאכלסים את הפרמטרים user.yob ו-user.gender בבקשות להצעות מחיר ב-DV360 כדי להגדיל את הכיסוי.

האם ל-DV360 יש נקודות קצה לכל אזור?

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

מהן הדרישות לבקשות משרת לשרת (s2s)?

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

האם DV360 תומך ב-OMID?

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