במדריך הזה מפורטות הדרישות לשילוב, ההגדרות והשדות הרלוונטיים בפרוטוקול OpenRTB שאפשר להשתמש בהם כשמגישים הצעות מחיר על מלאי שטחי פרסום של מודעות וידאו. פרוטוקול ה-RTB של Google הוצא משימוש, והוא לא יהיה מוקד ההדרכה הזו. מידע על מודעות וידאו בפרוטוקול Google RTB זמין במדריך בנושא מודעות וידאו ב-Google RTB.
Google תומכת במודעות וידאו In-stream, במודעות וידאו מותאמות ובמודעות מעברון. מידע נוסף על הפורמטים האלה זמין במדריכים בנושא מודעות מותאמות ובנושא מודעות מעברון.
הדרישות לקונים
פרוטוקול RTB
במדריך הזה נעסוק בעיקר בפורמט Protobuf, אבל שמות השדות והנתיבים זהים בפורמט Protobuf ובפורמט JSON, אלא אם צוין אחרת.
הפרוטו של OpenRTB ותוספי OpenRTB ספציפיים ל-Google מופיעים בדף Protos and reference data. למידע נוסף על פיתוח של בידינג, ראו עיבוד הבקשה ויצירת התגובה.
בדיקת קריאייטיב
Google ממליצה לשלוח קריאייטיבים לאישור לפני שמשתמשים בהם לבידינג. כדי להתחיל את תהליך הבדיקה, אפשר להשתמש במשאב הקריאייטיב של Real-time Bidding API.
הגדרת מיקוד מראש
כדי לקבל מלאי שטחי פרסום בסרטונים, צריך ליצור בחשבון Authorized Buyers הגדרה של טירגוט מראש שכוללת מלאי שטחי פרסום בסרטונים.
פקודות מאקרו
אפשר לציין מאקרו בקישור לכתובת ה-URL של הסרטון או ב-VAST XML שצוין ב-BidResponse.seatbid.bid.adm
. בנוסף, אם מציינים כתובת URL של סרטון, אפשר גם להוסיף מאקרו למסמך ה-XML המקושר של VAST. יש תמיכה בפקודות המאקרו הבאות בקריאייטיב וידאו:
%%CACHEBUSTER%%
%%WINNING_PRICE%%
%%SITE%%
אין תמיכה במאקרו-קליקים כמו CLICK_URL_ESC
כי מערכת Authorized Buyers כוללת את הכלים למעקב אחר קליקים שלה בתוך מעטפת VAST. למידע נוסף על המאקרוים הנתמכים, ראו ציון מאקרו.
פרטי היתרונות המרכזיים
אפשר להשתמש בשדה BidRequest.imp.video
ב-OpenRTB כדי לזהות אם בקשת הצעת המחיר הנכנסת היא על מלאי שטחי פרסום של מודעות וידאו In-stream או של מודעות וידאו מסוג אינטרסיטאל, ולמצוא מידע נוסף על הבקשה שספציפי לסרטון.
בנוסף, במלאי שטחי פרסום למודעות מותאמות אישית, אפשר להשתמש ב-BidRequest.imp.native.{request/request_native}.assets.video
כדי לספק מידע דומה ספציפי לסרטון.
BidRequest.{app/site}.content.producer.domain
-
כתובת ה-URL, ללא הפרמטרים, של הדף שמתאר את תוכן הסרטון. בעל התוכן הדיגיטלי שולח את כתובת ה-URL הזו ל-Google. לדוגמה:
http://www.publisher.com/watchpagelink
banner.vcm
-
אם ההגדרה היא
true
, אפשר לבחור שהמודעה הנלווית תוצג ככרטיס מידע (end cap) בחלון הסרטון אחרי שמודעת הווידאו תסתיים. אחרת, המודעה הנלווית לא תעבור עיבוד כמודעת קליפ סוף. BidRequest.imp.rwdd
-
אם הערך מוגדר כ-
true
, המשמעות היא שהמשתמש מקבל תמורה על צפייה במודעת הווידאו. דוגמאות לתגמולים אופייניים: קריאת מאמר נוסף בחינם, קבלת חיים נוספים במשחק או סשן מוזיקה ממומן ללא פרסומות. BidRequest.imp.video.maxduration
-
משך הזמן המקסימלי בשניות של המודעה שצריך להחזיר. אם לא מגדירים את הפרמטר, אין משך זמן מקסימלי. כשהערך של
BidRequest.imp.video.skip
הואtrue
, ההתנהגות יכולה להיות שונה. פרטים נוספים זמינים במאמר משך הסרטון המקסימלי שניתן לדלג עליו. BidRequest.imp.video.maxseq
-
המספר המקסימלי של מודעות ברצף המודעות בסרטון. אם לא מגדירים את הערך, מיקום המודעה לא נכלל ברצף סרטונים.
מספר המודעות הווידאו שיוצגו בפועל יכול להיות קטן מהערך הזה או שווה לו, אבל לא יכול להיות גבוה ממנו.
BidRequest.imp.video.minduration
- משך הזמן המינימלי בשניות של המודעה שצריך להחזיר. אם לא מגדירים את הערך, אין משך זמן מינימלי.
BidRequest.imp.video.plcmt
-
תיאור המיקום שבו יופעל הסרטון.
PLCMT_UNKNOWN
המיקום לא ידוע או לא ניתן לקבוע אותו. PLCMT_INSTREAM
מודעות לפני הסרטון, באמצע הסרטון ובסוף הסרטון שמופעלות לפני, במהלך או אחרי תוכן הסרטון בסטרימינג שהצרכן ביקש לצפות בו. הסרטון מסוג In-stream חייב להיות מוגדר כברירת מחדל כ'אודיו מופעל' כשנגן הווידאו מתחיל לפעול, או שצריכה להיות כוונה ברורה ומפורשת של המשתמש לצפות בתוכן הסרטון. יכול להיות שתוכלו להציג תוכן אחר מסביב לנגן, אבל תוכן הווידאו חייב להיות מוקד הביקור של המשתמש. הוא צריך להישאר התוכן הראשי בדף, והוא הנגן היחיד שמוצג במסך ויכול להפעיל אודיו בזמן ההפעלה. אם הנגן הופך לנגן צף או לנגן דביק, קריאות מודעות עתידיות אמורות להעביר במדויק את גודל הנגן המעודכן. PLCMT_ACCOMPANYING_CONTENT
מודעות Pre-roll, Mid-roll ו-Post-roll שמופעלות לפני, במהלך או אחרי תוכן וידאו בסטרימינג. נגן הווידאו נטען ומופעל לפני, בין או אחרי פסקאות של טקסט או תוכן גרפי, והוא מתחיל לפעול רק כשהוא נכנס לאזור התצוגה. ההפעלה של התוכן הנלווה צריכה להתחיל רק כשהוא נכנס לאזור התצוגה. יכול להיות שהוא יהפוך לנגן צף או לנגן במיקום קבוע כשהמשתמשים גוללים מחוץ לדף. PLCMT_INTERSTITIAL
מודעות וידאו שמופעלות ללא תוכן וידאו. במהלך ההפעלה, היא צריכה להיות המוקד העיקרי בדף ולתפוס את רוב אזור התצוגה, ואי אפשר לגלול אותה מחוץ לתצוגה. אפשר להציג את המודעות האלה במיקומי מודעות כמו סרטונים או גלריות תמונות באפליקציה. PLCMT_NO_CONTENT_STANDALONE
מודעות וידאו שמופעלות ללא תוכן וידאו בסטרימינג. המודעות האלה יכולות להופיע במיקומי מודעות כמו גלריות, פידים מותאמים, מודעות בתוכן או מודעות צפות/מוצמדות. BidRequest.imp.video.playbackmethod
-
תיאור של אופן ההפעלה של מודעת הווידאו.
שיטת ההפעלה נקבעת כ'הפעלה אוטומטית' או כ'קליק להפעלה' על סמך המדידה הטובה ביותר שזמינה.
AUTO_PLAY_SOUND_ON
הבדיקה מופעלת כשהדף נטען והצליל מופעל. AUTO_PLAY_SOUND_OFF
המודעות מתחילות לפעול כשהדף נטען והצליל מושבת. CLICK_TO_PLAY
ההפעלה מתבצעת בלחיצה עם צליל מופעל. MOUSE_OVER
ההפעלה מתבצעת כשמעבירים את העכבר מעל התמונה והסאונד מופעל. ENTER_SOUND_ON
האירוע מופעל כשהמשתמשים נכנסים לתחום התצוגה עם האודיו מופעל. ENTER_SOUND_OFF
המודעות מתחילות לפעול כשהצופה נכנס למסך הראייה, והצליל מושתק כברירת מחדל. BidRequest.imp.video.skip
- אם הערך הוא
true
, המשמעות היא שהנגן יאפשר לדלג על הסרטון או להציג מודעות שניתן לדלג עליהן. אחרת, המשמעות היא שאסור להציג מודעות שניתן לדלג עליהן. BidRequest.imp.video.startdelay
-
הערך 0 מציין מודעה לפני הסרטון (pre-roll), הערך -1 מציין מודעה באמצע הסרטון (mid-roll) והערך -2 מציין מודעה בסוף הסרטון (post-roll).
כל ערך חיובי אחר הוא הזמן בשניות מתחילת הסרטון ועד לנקודה שבה המודעה מוצגת.
האותות האלה לא ייחודיים לנכסי קריאייטיב מסוג וידאו, אבל הם חשובים במיוחד למגישי הצעות המחיר:
BidRequest.device.ifa
- השדה הזה הוא מזהה UUID בן 36 תווים שמוגדר רק כשמשתמשים ב-SSL, ולא עובר גיבוב. זוהי הגרסה ללא הצפנה של
BidRequest.device.dpidm5
. במכשירי iOS, הוא מכיל את המזהה למפרסמים (IDFA) בכל התווים הגדולים. במכשירי Android, הוא מכיל את המזהה של Android (ADID) בכל התווים הקטנים. במכשירי טלוויזיה מחוברת, הוא מכיל את המזהים הייחודיים שלהם (לדוגמה, RIDA של Roku). BidRequest.device.devicetype
- הגדרת סוג המכשיר.
MOBILE
כינוי לא תקף ל-HIGHEND_PHONE או ל-TABLET. PERSONAL_COMPUTER
כולל מחשבים נייחים ומחשבים ניידים. CONNECTED_TV
כוללת גם טלוויזיות מחוברות (כלומר טלוויזיות חכמות) וגם מכשירים מחוברים (כמו Roku, Apple TV וכו'). HIGHEND_PHONE
כולל מכשירי טלפון מתקדמים. TABLET
כולל מכשירים מסוג טאבלט. CONNECTED_DEVICE
כולל מכשירים ייעודיים למשחקים. SET_TOP_BOX
כולל ממירים. OOH_DEVICE
כולל מכשירים לפרסום מחוץ לבית, למשל, מודעות דיגיטליות. BidRequest.device.make
- הגדרת המותג (למשל Nokia או Samsung) של המכשיר.
BidRequest.device.model
- מציין את הדגם המדויק (כמו N70 או Galaxy) של המכשיר, אם הוא זמין. אחרת, המאפיין מכיל דגם כללי כמו 'iphone' או 'ipad'.
BidRequest.imp.metric
-
כשהערך של
Metric.type
מוגדר כ-completion_rate
,Metric.value
יהיה שבר בטווח [0.0, 1.0] שייצג את שיעור השלמת הצפייה ההיסטורי של מודעות הווידאו שהוצגו באותו ערך ברירת המחדל-1.0
מציין שנתוני היסטוריית שיעור השלמה לא זמינים. BidRequest.imp.video.poddur
- משך הזמן הכולל של ההפסקה למודעה, בשניות, כולל כל המיקומים שבהם מופיעות המודעות. הערך הזה מוגדר לפי הערך שצוין במטא-נתונים של הסרטון שסופקו על ידי בעל התוכן הדיגיטלי.
בקשת הצעת המחיר לסרטון מכילה גם מידע על מלאי שטחי הפרסום, כמו קטגוריית התוכן, הספקים המורשים ומידע על הערוץ. כל שאר השדות הקיימים בבקשת הצעת המחיר רלוונטיים גם לסרטונים.
השדות 'רוחב' ו'גובה' בהודעת AdSlot של בקשה להצגת וידאו תואמים לגודל של נגן מודעות הווידאו.
BidRequest.imp.ext.allowed_vendor_type
- הספקים המורשים. רשימה של המזהים מופיעה בקובץ vendors.txt במסמכי העזרה הטכניים. לדוגמה, 309 = יחידת וידאו ב-DFA.
BidRequest.imp.video.mimes
- רשימת ההיתרים שמתארת את סוגי ה-MIME הנתמכים של התוכן במודעות שמוצגות בתגובה לבקשת הצעת המחיר. לדוגמה, 'video/mp4'. בתגובה לבקשה להצעת מחיר צריכה להופיע תמיכה באחד מהם לפחות.
BidRequest.imp.video.protocols
-
תיאור הגרסאות הנתמכות של VAST באתר של בעל התוכן הדיגיטלי לבקשות להצגת מודעות וידאו.
מכיל מערך של ערכי enum מסוג
Protocol
, כולל:VAST_2_0
,VAST_3_0
,VAST_2_0_WRAPPER
,VAST_3_0_WRAPPER
,VAST_4_0
,VAST_4_0_WRAPPER
ועוד.
BidRequest.imp.video.companionad
-
השדה הזה כולל מערך של אובייקטים מסוג
Banner
שמייצגים מודעות נלוויות, אם הן זמינות. BidRequest.site.page
-
כתובת ה-URL של דף הצפייה בסרטון או כתובת ה-URL של הדף שאליו הטמעתם את הסרטון. לדוגמה:
http://www.publisher.com/watchpagelink
בתגובה לבקשה להצגת סרטון, המגיש הצעת המחיר צריך להחזיר כתובת URL להפניה אוטומטית של VAST או קובץ XML של VAST בשדה BidResponse.seatbid.bid.adm
. תגובת הצעת המחיר צריכה לכלול גם את ההצהרה המתאימה לגבי מודעת הווידאו. בהמשך מופיע קטע מתשובה תקינה לבידינג על סרטון:
id: "cRPF1960K8WH788KM8ZT5k" seatbid { bid { id: "99862J52T2r9f8n6hzY" impid: "1" price: 0.2873480215418293 adid: "test_creative_id_958969" adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%" adomain: "google.com" cid: "80831705186" crid: "test_creative_id_958969" w: 480 h: 854 } seat: "5731:4728:218110" } bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73" cur: "USD"
השדות החשובים בתשובה לבידינג על סרטון הם:
BidResponse.seatbid.bid.ext.attribute
-
מאפיינים של המודעות שעשויות להופיע מהקטע הזה. רשימת המזהים מופיעה בקובץ buyer-declarable-creative-attributes.txt. אנחנו בודקים שכל המאפיינים האלה לא תואמים למאפיינים שהוחרגו על ידי בעל התוכן הדיגיטלי בבקשת הצעת המחיר.
לדוגמה, אם אחד מהשדות יכלול את הערך
30
, המשמעות היא שהמודעה תצטרך תמיכה ב-VPAID כדי להציג. BidResponse.seatbid.bid.adm
-
במודעות וידאו, זוהי כתובת ה-URL להפניה אוטומטית של VAST של מודעת הווידאו. לדוגמה:
http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml
לחלופין, יכול להיות שמדובר ב-XML VAST גולמי.
דוגמאות לבקשות להצעות מחיר ולתגובות להן
פורמטי סרטונים
- איך קונים יכולים לכלול סרטון
- אותות מומלצים של OpenRTB לכל פורמט וידאו
- אותות מומלצים של proto של Authorized Buyers לכל פורמט וידאו
- איך בעלי תוכן דיגיטלי יכולים לאפשר או לאסור הצגת סרטונים
- מקרים קיצוניים
איך קונים יכולים לכלול סרטון
בטבלאות הבאות מפורטות הדרכים שבהן קונים יכולים לכלול וידאו בקריאייטיבים שלהם, והמיקומים שבהם המודעות יכולות להופיע באתרים ובאפליקציות לנייד, בהתאמה.
פיתוח אתרים
קריאייטיב וידאו | וידאו In-stream (הכול) | בגוף הפיד/במאמר | מודעות מותאמות בפיד או בגוף המאמר | מעברון | במודעת באנר |
---|---|---|---|---|---|
VPAID + VAST |
|
||||
VAST |
|
||||
MRAID + JS |
|
|
|
|
|
JS בהתאמה אישית |
|
||||
מודעות מותאמות + VAST |
|
אפליקציה לנייד
קריאייטיב וידאו | וידאו In-stream (הכול) | בגוף הפיד/במאמר | מודעות מותאמות בפיד או בגוף המאמר | מעברון | במודעת באנר |
---|---|---|---|---|---|
VPAID + VAST |
|
|
|
|
|
VAST |
|||||
MRAID + JS |
|||||
JS בהתאמה אישית |
|||||
מודעות מותאמות + VAST |
מפתח: | הפורמט או הטכנולוגיה לא זמינים | קריאייטיב וידאו אושר במיקום הזה, בכפוף לחסימות של בעלי תוכן דיגיטלי |
קריאייטיב הווידאו לא זמין במיקום המודעה הזה |
---|
אותות מומלצים של OpenRTB
בטבלאות הבאות מפורטים האותות המומלצים של OpenRTB לכל פורמט וידאו באינטרנט למחשב ולנייד ובאפליקציה לנייד.
דפדפני אינטרנט במחשב ובנייד
פורמט הווידאו | אותות מומלצים (אותות רלוונטיים לסרטונים בלבד) | אותות קשורים (אותות שקשורים לסרטון בלבד) |
---|---|---|
וידאו In-stream (VPAID) |
אובייקט VIDEO קיים & |
|
Instream (ללא VPAID) |
אובייקט VIDEO קיים & |
|
מודעת וידאו לא In-stream |
אובייקט VIDEO קיים
|
|
מודעות בגוף הפיד |
אובייקט VIDEO קיים & |
|
בגוף המאמר |
אובייקט VIDEO קיים & |
|
מותאם |
אובייקט NATIVE קיים וגם |
|
במודעת באנר |
אובייקט הווידאו לא נמצא & |
אפליקציה לנייד
פורמט הווידאו | פרטי הבקשה להצעת מחיר (רק הפרטים הרלוונטיים לסרטון) | |
---|---|---|
In-stream |
אובייקט VIDEO קיים & |
|
מודעת וידאו לא In-stream |
אובייקט VIDEO קיים
|
|
מודעות בגוף הפיד |
אובייקט VIDEO קיים & |
|
בגוף המאמר |
אובייקט VIDEO קיים & |
|
מותאם |
אובייקט NATIVE קיים וגם |
|
מודעות מעברון (VAST) |
אובייקט VIDEO קיים & |
|
מודעות מעברון (ללא VAST) |
אובייקט VIDEO קיים & |
מסוננת |
במודעת באנר (MRAID) |
אובייקט הווידאו לא נמצא & |
|
במודעת באנר (ללא MRAID) |
אובייקט הווידאו לא נמצא & |
איך בעלי תוכן דיגיטלי יכולים לאפשר או לאסור את הצגת הסרטונים
בטבלה הבאה מפורטות הדרכים שבהן בעלי תוכן דיגיטלי יכולים לאפשר או לאסור הצגת מודעות וידאו במיקומי המודעות שלהם.
אפשרות פאב | הפורמטים הרלוונטיים | התיאור בבקשה להצעת מחיר הוא |
---|---|---|
ציון יחידת מודעת וידאו In-stream |
וידאו In-stream (הכול) |
אובייקט וידאו נוכח & |
הבעת הסכמה לשימוש ב-VPAID |
In-stream לאינטרנט |
אובייקט וידאו נוכח & |
הצטרפות ל-IBV |
במודעת באנר מעברון |
|
הבעת הסכמה ל- (הוראות) |
מודעות בגוף הפיד בגוף המאמר |
אובייקט וידאו נוכח & |
מאשרים את השימוש במודעות וידאו לא In-stream (הוראות) |
מותאם |
אובייקט מקומי קיים |
חסימת סרטון במודעת מעברון |
מודעת מעברון באפליקציה |
אובייקט הווידאו לא קיים |
מקרי קצה
# | תיאור הפנייה | תגובות | בקשה להצעת מחיר |
---|---|---|---|
1 |
סגירה מותאמת אישית עם עיכוב באמצעות MRAID |
במודעות מעברון, סגירת המודעה יכולה לשלוח התראה לקונה באמצעות MRAID, גם אם הוא לא השתמש בסגירת מודעה בהתאמה אישית. האפשרות 'הקונים המורשים הפעילו X' תמיד תופיע מעל כל חלון סגירה מותאם אישית, גם אם חלון הסגירה המותאם אישית יופיע מתחתיו אחרי 5 שניות |
מילון מונחים
מילון מונחים בנושא סרטונים בתוכנית Authorized Buyers
שדות רלוונטיים לפורמטים של מודעות וידאו In-stream ושל מודעות וידאו שלא In-stream
BidRequest.Video. | |||||
---|---|---|---|---|---|
Placement
|
|
||||
linearity
|
מציין אם החשיפות צריכות להיות לינאריות, לא לינאריות וכו'. אם לא צוין אף סוג, ההנחה היא שכל הסוגים מותרים.
|
||||
videoad_start_delay
|
|
מקור הערך של בקשת הצעת המחיר
אובייקט של OpenRTB |
שדות | Authorized Buyers /Exchange בידינג לא In-stream |
ערכים לדוגמה | מי קובע את זה? /Where this value derives from? |
---|---|---|---|---|
אובייקט | ||||
וידאו | mimes | כן | ["application/javascript", "video/mp4"]", |
|
minduration | לא | מוגדרת בחשבון של בעל התוכן הדיגיטלי | ||
maxduration | כן | מוגדרת בחשבון של בעל התוכן הדיגיטלי | ||
playbackmet hod |
כן | [6] | בדרך כלל מוגדרת על ידי בעל התוכן הדיגיטלי |
|
API (MRAID) | כן | [1,2] | ||
פרוטוקולים | כן | [2,3,5,6,7,8] | ||
לינאריות | כן | [1] | ||
placement | כן | [1] | ||
רוחב הנגן | כן | 400,400,300 | ||
גובה השחקן | כן | 225,300,153 | ||
עיכוב לפני הפעלה | כן | 0 | Google, ברירת המחדל היא 5 שניות | |
דילוג | כן | 1 | בעלי התוכן הדיגיטלי/Google - למעברון => Google - למודעה וידאו In-stream => בעלי התוכן הדיגיטלי מחליטים אם לאפשר מודעות שניתן לדלג עליהן, מודעות שלא ניתן לדלג עליהן או את שתיהן. מודעות מתגמלות, תמיד מודעות שלא ניתן לדלג עליהן. |
|
קצב העברת נתונים מינימלי | לא | |||
קצב העברת נתונים מקסימלי | לא | |||
pos | כן | 1 | ||
מכשיר | ||||
יחס פיקסלים | כן | 1 | ||
חשיפה | ||||
מאובטח | כן | 1 | Google ברירת המחדל היא true כי ה-AdTag תמיד מאובטח |