מודעות וידאו מסוג OpenRTB

במדריך הזה מפורטות דרישות השילוב של קנייה ב-RTB באמצעות פרוטוקול OpenRTB. כדאי להשתמש במדריך הזה בשילוב עם המדריך OpenRTB Integration (שילוב OpenRTB), שבו השדות שמוזכרים כאן מתוארים בפירוט.

כשמבצעים רכישה באפליקציות ל-iOS עם קטעי קוד HTML שכוללים תגי <video>, צריך לכלול את המאפיין playsinline בתג הווידאו. אחרת, חוויית המשתמש של המשתמשים נפגעת, במקרים שבהם מודעות הווידאו שאמורות לפעול בתוך הקריאייטיב מופיעות כחלון קופץ במסך מלא. מודעות שלא מכבדות את המדיניות הזו ייחסמו.

דרישות לקונים

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

פקודות מאקרו נתמכות

פקודות המאקרו הבאות נתמכות בקריאייטיבים של וידאו In-stream:

  • %%CACHEBUSTER%%
  • %%WINNING_PRICE%%

חשוב לזכור שהחלפת המאקרו מותרת בכתובת ה-URL של הסרטון, אבל לא בתוך ה-XML של VAST בפועל.

אין צורך בפקודות מאקרו של קליק (כמו CLICK_URL_ESC) כי Authorized Buyers כוללים את כלי המעקב אחר הקליקים ב-wrapper של VAST. לכן, פקודות מאקרו של קליקים אינן נתמכות במודעות וידאו In-stream. למידע נוסף על פקודות מאקרו נתמכות, קראו את הקטע ציון פקודות מאקרו בקטע יצירת התגובה.

פרטי האובייקט של הסרטון

הפרוטוקול OpenRTB משתמש בהודעת Video, שמוגדרת בקובץ openrtb-proto.txt כדי לזהות בקשות להצגת סרטונים ולספק מידע נוסף ספציפי על הסרטונים בבקשה.

ברשימת השדות של הודעות הווידאו תוכלו למצוא תיאורים מפורטים ודוגמאות שבמדריך השילוב של OpenRTB.

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

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

שדות של אובייקט Imp

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

banner אובייקט של מודעת באנר. נדרש אם החשיפה מוצעת כהזדמנות למודעת באנר.
video מציין את סוג החשיפה שמוצעת, במקרה זה סרטון. לתשומת ליבך, מותר להשתמש בסרטון להצגה במודעת באנר אם האובייקט imp כולל גם אובייקטים מסוג banner וגם video.
tagid מזהה של מיקום מודעה ספציפי או של תג מודעה ספציפי ששימש להפעלת המכרז. הדבר יכול להיות שימושי לניפוי באגים בבעיות, או לאופטימיזציה על ידי הקונה.
bidfloor הצעת המחיר המינימלית לחשיפה הזו מבוטאת בעלות לאלף חשיפות.
bidfloorcur מטבע יחיד שהתקבל מה-billing_id. הכלול

לפרטים נוספים, יש לעיין בקטע אובייקט Imp במדריך OpenRTB.

שדות אובייקטים במכשיר

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

ua מחרוזת סוכן המשתמש של הדפדפן.
ip כתובת ה-IPv4 הקרובה ביותר למכשיר.
geo מיקום המכשיר נחשב כמיקום הנוכחי של המשתמש, כפי שהוגדר על ידי אובייקט Geo.
devicetype הסוג הכללי של המכשיר.
ifa מזהה שהוטלו עליו סנקציות על שימוש של המפרסם באופן ברור (לדוגמה, לא מגובב). ifa נתמך במכשירי טלוויזיה מחוברים כמו Roku, Apple TV, Fire TV ו-Xbox.

לפרטים נוספים, עיינו בקטע אובייקט מכשיר במדריך OpenRTB.

אובייקט אתר

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

page כתובת ה-URL של הדף שבו תוצג החשיפה.
publisher פרטים לגבי האובייקט Publisher של האתר.
content פרטים על Content באתר.

לפרטים נוספים, עיינו בקטע האובייקטים אתר במדריך OpenRTB.

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

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

id מזהה ספציפי ל-Exchange של המשתמש. מומלץ להזין לפחות אחד מהמאפיינים id או buyerid.
data פרטים לגבי האובייקט Publisher של האתר.

לפרטים נוספים, עיינו בקטע UserObject במדריך OpenRTB.

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

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

mimes
רשימת ההיתרים של סוגי MIME הנתמכים.
companionad
מערך של אובייקטים של באנר אם יש מודעות נלוות.

השדות של תגובה להצעת מחיר

השדות העיקריים בתגובה להצעת מחיר לסרטון כוללים:

id
המזהה של הבקשה להצעת מחיר שתגובה אליה נשלחה.
seatbid
מערך של אובייקטים מסוג Seatbid; נדרש אחד או יותר אם יש הצעת מחיר.
seat
אובייקט Seatbid; המזהה של מושב הקונה (לדוגמה, מפרסם או סוכנות) שבשמו הצעת המחיר הזו מוגשת.
bid
מערך של אובייקט Bid אחד או יותר שקשור לחשיפה.

טירגוט מראש

כדי שקונים ב-OpenRTB יוכלו לקבל מלאי סרטונים, הם צריכים להגדיר טירגוט מראש שכולל מלאי סרטונים.

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

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

תגובה להצעת מחיר

מילון מונחים

תוכלו לעיין במילון המונחים של Authorized Buyers.