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