שילוב OpenRTB

המדריך הזה עוסק בשילוב של OpenRTB 2.5 (כולל פקודות מאקרו) ו מודעות מותאמות עם Authorized Buyers. הוא גם מתאר כל שדה בפרוטוקול ה-OpenRTB של תוספי Authorized Buyers.

מידע נוסף על קובצי proto של OpenRTB זמין בקובץ ה-OpenRTB proto. לתוספים של Authorized Buyers, עיינו בקובץ Protocol Buffer של תוספי OpenRTB.

הטמעת OpenRTB ב-Authorized Buyers זמינה בשני פורמטים דומים.

• JSON
• Protobuf: ניתן להפנות לקובץ הגדרה מסוג .proto לצורך פענוח הודעה.

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

שיקולים בשילוב

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

המבנה של המסמך הזה

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

כמו כן, חשוב לזכור:

• השדה cid מייצג את מזהה החיוב שצוין בהגדרות הטירגוט מראש. השדה הזה משמש לקישור הצעת המחיר אל billing_id שנשלחה בבקשה להצעת מחיר. אם הבקשה כוללת יותר מ-cid הודעת billing_id אחת, או אם יש לך מושבים פעילים לילדים, עליך לציין בתשובה את היעד cid. אם יש בקשה אחת בלבד ואין לך מושבים פעילים לילדים, זה הערך שהמערכת תניח בתשובה.
• כדי לפשט את מתן השמות, בהמשך יש קרדיט לסעיפים הבאים של OpenRTB.
• כל השדות יאוכלסו בבקשה, אם היא זמינה. לעולם לא נעביר ערכי null או מחרוזות ריקות.
• סוגים ותיאורים מ-OpenRTB לא נכללים בטבלאות שבהמשך. אפשר לעיין בקובץ OpenRTB pro.
• בבקשות להצעות מחיר בפורמט JSON, כל השדות שמוקלדים int64 או קבועים64 יישלחו כמחרוזות כדי למנוע אובדן דיוק בערכי אינטגרל של 64 ביט.
• פרוטוקול OpenRTB JSON מייצג את כל השדות bool כמספרים שלמים בבקשה, כאשר 0 מייצג את false ו-1 מייצג את true. כל הדרישות האלה מפורטות במפרט OpenRTB.

ספירת חשיפות ושימוש בפקודות מאקרו

כדי לצמצם את הפערים, מומלץ להשתמש בשדה BidResponse.seatbid[].bid[].ext.impression_tracking_url לכל המלאי, כולל בשדה 'מקור'.

במקום זאת, הקונים צריכים להסיר פיקסלים מהמעקב אחר הופעות מהקריאייטיב (תגי העיצוב של המודעות), ולכלול במקום זאת את השדה impression_tracking_url (מערך מחרוזות) בתגובה להצעת המחיר. ב-OpenRTB 2.5 אפשר להשתמש גם ב-BidResponse.seatbid[].bid[].burl. הערך impression_tracking_url מופעל כשהחשיפה נחשבת כניתנת לחיוב. כך מתקבלת רמת דיוק גבוהה יותר מאשר פיקסלים למעקב, שיכולים לעקוב אחר חשיפות שנשלפו על ידי האפליקציה לפני השליפה, אבל מעולם לא עובדו. צריך להשתמש במאקרו %%WINNING_PRICE%% מוצפן בשדה הזה או במאקרו ${AUCTION_PRICE}.

כאן מופיעה רשימת רכיבי המאקרו שנתמכים על ידי impression_tracking_url וגם burl:

• ${AUCTION_ID} – מזהה הבקשה להצעת מחיר; מהמאפיין BidRequest.id.
• ${AUCTION_BID_ID} – המזהה של הצעת המחיר. ממאפיין BidResponse.bidid.
• ${AUCTION_IMP_ID} – המזהה של החשיפה שניצבת, ממאפיין BidRequest.imp[].id.
• ${AUCTION_SEAT_ID} – המזהה של המושב של מגיש הצעת המחיר שהגשתם עבורו את הצעת המחיר. לפי המאפיין BidResponse.seatbid[].seat.
• ${AUCTION_AD_ID} - המזהה של תגי העיצוב של המודעות שמגיש הצעת המחיר רוצה להציג, ממאפיין BidResponse.seatbid[].bid[].adid.
• ${AUCTION_PRICE} – מחיקת המחיר באמצעות אותו מטבע ויחידות זהות בהצעת המחיר. לידיעתך, בשלב זה אין תמיכה במאקרו הזה במודעות AMP.

הטמעת ה-OpenRTB של Google מצפינה את AUCTION_PRICE למאקרו WINNING_PRICE של פרוטוקול Authorized Buyers. למידע נוסף על פענוח המחיר, עיינו במדריך לאישורי מחירים.

העברה לפרוטוקול

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

כשעוברים מ-JSON אל Protobuf, חשוב לוודא שהשדה cid מוגדר כמחרוזת בתגובה של הצעת המחיר. השדה הזה משמש לקישור הצעת המחיר ל-billing_id בתוך המיקוד מראש שלך. אם הוא לא קריא, לא נקבל את הצעת המחיר.

תמיכה ב-VAST ו-VAST

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

הערה: ב-OpenRTB 2.4 ואילך, אם video.skip=1, הקונים יכולים להגיש הצעות מחיר באמצעות קריאייטיבים של וידאו שלא ניתן לדלג עליהם או שניתן לדלג עליהם. אנחנו ממליצים להצטרף לדילוג על התיקון במהלך הגדרת החשבון, מאחר שב-OpenRTB לא מתבצעת הבחנה בין ALLOW_SKIPPABLE לבין REQUIRE_SKIPPABLE.

שדות שאינם נתמכים

בשלב זה אין תמיכה בשדה Nurl, אבל יש תמיכה ב-impression_tracking_url וגם Bid.burl ב-OpenRTB 2.5: אפשר לעיין בתגובות שלמעלה.

אין הצעת מחיר

אם הלקוח לא רוצה להגיש הצעת מחיר, הוא צריך לשלוח את הקוד 204.

טיפוסים בני מנייה (enum)

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

הערה: MRAID-1 היא קבוצת משנה של MRAID-2. ב-OpenRTB 2.1 ובגרסאות מוקדמות יותר, הערך 3 היה MRAID. עם זאת, לא כל ממשקי ה-API שתומכים ב-MRAID מבינים את התכונות של MRAID-2, ולכן הפרשנות הבטוחה היחידה של הערך 3 היא MRAID-1. בגרסה 2.2 של OpenRTB זה צוין מפורשות ו-MRAID-2 התווסף כערך 5.

בדיקת גרסת OpenRTB

OpenRTB/JSON

x-openrtb-version קיים. הוא מכיל 2.2, 2.3, 2.4 או 2.5. Content-Type הוא application/json. charset=utf-8.

OpenRTB/Protobuf

x-openrtb-version קיים. הוא מכיל 2.3, 2.4 או 2.5. Content-Type הוא application/octet-stream.

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

יש לעיין במדריך המפרט של OpenRTB 2.5 הזמין בדף הזה. המפרט כולל מידע וניואנסים שספציפיים להטמעה של Authorized Buyers. כמו כן, עליכם לפעול לפי ההנחיות שמופיעות ב-OpenRTB ללא שינוי.

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

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

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

הערה: פרוטוקול OpenRTB JSON מייצג את כל השדות bool כמספרים שלמים בבקשה, כאשר 0 מייצג את false ו-1 מייצג את true. כל הדרישות האלה מפורטות במפרט OpenRTB.

מאפיין	תמיד עבר	Type	מקבילה קונה שווה ערך	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
id	כן	מחרוזת	BidRequest.id	2.3 2.4 2.5		המזהה הייחודי של הבקשה להצעת המחיר שסופק על ידי הבורסה לניירות ערך. ה-OpenRTB הוא websafe base64 (ללא מרווח פנימי).
imp	כן	מערך של Imp אובייקטים	BidRequest.AdSlot	2.3 2.4 2.5		ייצוג החשיפות המוצעות. יש להזין לפחות אובייקט Imp אחד.
site	לא	אובייקט Site	הצעת מחיר	2.3 2.4 2.5		פרטים על האתר של המוציא לאור. רלוונטי ומומלץ רק לאתרים. שירות חד-פעמי עם app.
app	לא	אובייקט App	הצעת מחיר הצעת מחיר לנייד	2.3 2.4 2.5		פרטים על האפליקציה של בעל התוכן הדיגיטלי. (אפליקציות שאינן דפדפן). רלוונטי ומומלץ רק לאפליקציות. שירות חד-פעמי עם site.
device	לא	אובייקט Device	BidRequest.Mobile, BidRequest.Device	2.3 2.4 2.5		פרטים על המכשיר של המשתמש שאליו תוצג החשיפה.
regs	לא	אובייקט Regs		2.3 2.4 2.5		המדיניות הזאת מגדירה תקנות, חוקים משפטיים או תקנות ממשלתיות שחלים על הבקשה הזו.
user	לא	אובייקט User	הצעת מחיר	2.3 2.4 2.5		פרטים על המשתמש האנושי במכשיר, על קהל הפרסום.
at	לא	אובייקט AuctionType	BidRequest.auction_type	2.3 2.4 2.5		כאשר 1 = מחיר ראשון, 2 = מחיר שני ועוד. אפשר להגדיר סוגים ספציפיים של מכרזים לפי ערכים מעל 500. ברירת מחדל = GROUP_PRICE.
tmax	לא	int32	80 עד 1,000 אלפיות השנייה	2.3 2.4 2.5		הזמן המקסימלי באלפיות שנייה לשליחת הצעת מחיר כדי להימנע מזמן קצוב לתפוגה. לרוב אפשר להעביר את הערך הזה אופליין.
wseat	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		רשימת היתרים של מושבי קונים (לדוגמה, מפרסמים, סוכנויות) שיכולים להגיש הצעת מחיר על החשיפה הזו. מזהים של המושבים והידע של הלקוחות של הקונה שאליהם הם מתייחסים, צריכים להיות מתואמים בין מגישי הצעות המחיר לבין נציגי Exchange. השמטה לא מצביעה על מגבלות מקום.
allimps	לא	בוליאני	אין תמיכה	2.3 2.4 2.5		הגדרה שמציינת אם מערכת Exchange יכולה לאמת שהחשיפות המוצעות מייצגות את כל החשיפות הזמינות בהקשר מסוים (לדוגמה, בכולן, בדף האינטרנט, כל מיקומי הווידאו כמו לפני/אמצע או בסוף הסרטון) כדי לתמוך בחסימת כבישים. 0 = לא או לא ידוע, 1 = כן, החשיפות שמוצעות מייצגות את כל הזמינות.
cur	לא	מערך מחרוזות	אין תמיכה	2.3 2.4 2.5		מערך של מטבעות מותרים להצעות מחיר עבור הבקשה הזו להצעת מחיר באמצעות קודי אלפא של ISO-4217. מומלץ רק אם הבורסה מקבלת כמה מטבעות.
bcat	לא	מערך מחרוזות	BidRequest.AdSlot. excluded_sensitive _category, BidRequest.AdSlot. excluded_product _category	2.3 2.4 2.5		קטגוריות מפרסמים חסומות שמשתמשות בקטגוריות התוכן של IAB. צריך לעיין ב-enum ContentCategory.
badv	לא	מערך מחרוזות	אין תמיכה	2.3 2.4 2.5		חסימת רשימה של מפרסמים לפי הדומיינים שלהם (לדוגמה, "addomain.com")
bapp	לא	מערך מחרוזות	BidRequest.AdSlot.excluded_app_id	2.4 2.5		חסימה של רשימת אפליקציות לפי מזהי האפליקציות שלהן שלא תלויות בפלטפורמה. ב-Android, השמות האלה צריכים להיות שמות של חבילות או חבילות (לדוגמה, com.foo.mygames). ב-iOS אלה מזהים מספריים.
test	לא	בוליאני	הצעת מחיר.is_test	2.3 2.4 2.5		אינדיקטור של מצב בדיקה שבו מכרזים לא ניתנים לחיוב, כאשר 0 = מצב פעיל, 1 = מצב בדיקה. ברירת מחדל : 1
bseat	לא	מחרוזת	אין תמיכה	2.5		חסימה של רשימת המושבים של הקונים (לדוגמה, מפרסמים, סוכנויות) שמוגבלת בבידינג על החשיפה הזו. מזהי המושבים והידע של הלקוחות של הקונה שאליהם הם מתייחסים צריכים להיות מתואמים בין מגישי הצעות המחיר לבין בורסות משנה. ניתן להשתמש רק בבקשה אחת מתוך wseat וב-bseat באותה בקשה. אם משמיטים את שניהם, אין הגבלות על המושבים.
wlang	לא	מחרוזת	הצעת מחיר .AdSlot .allowed _languages	2.5		רשימת היתרים של שפות לקריאייטיבים באמצעות ISO-639-1-alpha-2. המשמעות של השמטה היא שאין הגבלות ספציפיות, אבל מומלץ למשתמשים לשקול את מאפיין השפה באובייקטים של המכשיר או של התוכן, אם הם זמינים.
source	לא	אובייקט Source	משמש רק לתוספים	2.5		אובייקט Source שמספק נתונים לגבי מקור המלאי ואיזו ישות מקבלת את ההחלטה הסופית.
ext	לא	אובייקט BidRequestExt	אין תמיכה	2.3 2.4 2.5		עבור OpenRTB/Protobuf, אפשר לגשת לאובייקט הזה באמצעות מפתח התוסף של [com.google.doubleclick.bid_request] (הנתיב המדויק משתנה בהתאם לשפה המשמשת ליצירת ספריית Proto). עבור OpenRTB/JSON, צריך לגשת עם השדה ext בהודעה BidRequest.

BidRequestExt

למידע נוסף, עיינו במשוב בזמן אמת.

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
bid_feedback	לא	מערך של BidFeedback אובייקטים	BidRequest.bid_response_feedback	משוב על הצעות מחיר שנשלחו בתגובות קודמות. האפשרות הזו מוגדרת רק אם משוב בזמן אמת מופעל עבור מגיש הצעות המחיר שלך. צריך ליצור קשר עם מנהל החשבון כדי להפעיל את המשוב בזמן אמת.
google_query_id	לא	מחרוזת	BidRequest.google_query_id	זהו מזהה ייחודי לשאילתה הכוללת. אם יש כמה תוספי יתרונות מרכזיים של שאילתה מסוימת, כל בקשות היתרונות המרכזיים לשאילתה הזו יכללו את אותו google_query_id.
fcap_scope	כן	טיפוסים בני FrequencyCappingScope	BidRequest.AdSlot.FrequencyCappingScope	תכונה ניסיונית עשויה להשתנות. למידע נוסף, אפשר לקרוא את המאמר הגדרת מכסות תדירות שמתארחות ב-Google להצעות מחיר ב-RTB . תיאור היקף האכיפה של מכסת תדירות בבקשה הזו. אפשר להגדיר מכסות תדירות לאכיפה של הצעת מחיר בשדה Bid.ext.fcap. FREQUENCY_CAPPING_SCOPE_UNKNOWN = 0; ערך ברירת המחדל שאין להשתמש בו – יכול להיות שאי אפשר לקבוע באופן מהימן את היקף מכסת התדירות. FREQUENCY_CAPPING_SCOPE_NONE = 1; מכסת תדירות שמבוססת על מפרטים של הצעות מחיר לא זמינה בבקשה הזו. לפני המכרז, המערכת תסנן הצעות מחיר עם מכסת תדירות לבקשה להצעת מחיר בלי זמינות של מכסת תדירות. FREQUENCY_CAPPING_SCOPE_BROWSER = 2; האכיפה של מכסת התדירות זמינה במספר אתרים באותו דפדפן. FREQUENCY_CAPPING_SCOPE_DEVICE = 3; אכיפת מכסת התדירות זמינה במספר אתרים במכשיר, למעט דפדפנים. FREQUENCY_CAPPING_SCOPE_APP = 4; אכיפה של מכסת תדירות זמינה באפליקציה יחידה. FREQUENCY_CAPPING_SCOPE_SITE = 5; האכיפה של מכסת התדירות זמינה באתר אחד.
privacy_treatments	לא	אובייקט PrivacyTreatments	BidRequest.privacy_cares	טיפולים לשמירה על פרטיות. כדי להגן על פרטיות המשתמשים, חלק מהשדות בבקשה להצעת מחיר יכולים להיות מובנים או מצונזרים. בהודעה הזו מפורט מידע על טיפולי הפרטיות שחלים על הזדמנויות להצגת מודעות דרך הבקשה הזו.

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

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
request_id	לא	מחרוזת	BidRequest.BidResponseמשוב.request_id.	המזהה הייחודי מ-BidRequest.id.
creative_status_code	לא	int32	הצעת מחיר.BidResponsefeedback.creative_status_code	קוד הסטטוס של המודעה. רשימת מזהים זמינה בדף Proto & Reference Data לקבלת רשימה של מזהים.
price	לא	כפולה	הצעת מחיר.BidResponse feedback.CPM_micros	אם הצעת המחיר ניצחה במכרז, זהו המחיר ששולם במטבע של החשבון שלך. אם הצעת המחיר משתתפת במכרז, אבל הצעת המחיר שלה הייתה גבוהה יותר, מדובר בעלות לאלף חשיפות שאמורה להיות גבוהה כדי לזכות. הערך הזה לא מוגדר אם הצעת המחיר סוננה לפני המכרז, אם בעל התוכן הדיגיטלי או מגיש הצעות המחיר שזכו במכרז ביטלו את ההסכמה למשוב על מחירים או אם החשבון שלך ביטל את ההסכמה לשיתוף מחירים זוכים עם מגישי הצעות מחיר אחרים. במכרזים במודל "מחיר ראשון", min_bid_to_win מאוכלס במקום בשדה הזה.
minimum_bid_to_win	לא	כפולה	הצעת מחיר.BidResponse feedback.minimum_bid_to_win	הערך המינימלי של הצעת המחיר הנחוץ כדי לזכות במכרז, במטבע של החשבון. אם הצעת המחיר שלך זכתה במכרז, זוהי הצעת המחיר השנייה בגובהה שלא סוננה (כולל מחיר המינימום). אם הצעת המחיר שלך לא זכתה במכרז, זוהי הצעת המחיר הזוכה. השדה הזה יאוכלס רק אם הצעת המחיר שלך השתתפה במכרז של מחיר ראשון, ולא יאוכלס אם הצעת המחיר שלך סוננה לפני המכרז.
sampled_mediation_cpm_ahead_of_auction_winner	לא	כפולה	BidRequest.BidResponsefeedback.sampled_mediation_cpm_ahead_of_auction_winner	כשבעל תוכן דיגיטלי משתמש במכרז של בידינג בזמן אמת (RTB) ובתהליך בחירת הרשת (Mediation) ב-SDK שמבוסס על Waterfall על אותה שאילתה, הזוכה במכרז במכרז בזמן אמת צריך גם להתחרות ב-Waterfall של תהליך בחירת הרשת (שמבוצר לפי מחיר) כדי לזכות בחשיפה. אם הצעת המחיר השתתף במכרז ולא הייתה מפל מים, הערך של השדה הזה הוא 0. אם הצעת המחיר השתתף במכרז והייתה Waterfall, הערך של השדה הזה הוא מחיר שמייצג הצעת מחיר לדוגמה, מהרשתות הכשירות לבחירת רשת שגבוהות מזו של הזוכה במכרז, בשקלול לפי שיעור המילוי הצפוי. אפשר להשתמש בשדה הזה בשילוב עם המאפיין min_bid_to_win כדי לאמן מודלים של בידינג. העלות לאלף חשיפות מוצגת במטבע שמוגדר בחשבון.
event_notification_token	לא	אובייקט EventNotificationToken	הצעת מחיר.BidResponsefeedback.event_notification_token	האסימון שכלול בהצעת המחיר התואמת.
buyer_creative_id	לא	מחרוזת	הצעת מחיר.BidResponsefeedback.buyer_creative_id	מזהה הקריאייטיב שכלול בהצעת המחיר התואמת.

אסימון האירוע

האסימון שכלול בהצעת המחיר התואמת.

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

אובייקטים של PrivacyTreatments

הורה

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
non_personalized_ads_reason	לא	טיפוסים בני NonPersonalizedAdsReason	BidRequest.privacy_cares.non_personalized_ads_reason	ציון הסיבות לכך שמודעות הוחזרו בתגובה לבקשה זו אינו מותאם אישית. UNKNOWN = 0; הסיבה לא ידועה. PUBLISHER_DECLARED_NPA = 1; בעל התוכן הדיגיטלי הצהיר שהבקשה הזו צריכה להציג מודעות ללא התאמה אישית ללא קשר לאותות אחרים. RESTRICT_DATA_PROCESSING= 2; בעל האפליקציה ביקש עיבוד נתונים מוגבל בבקשה הזו. USER_OPT_OUT = 3; המשתמש ביטל את ההסכמה להתאמה אישית של מודעות.
allow_user_data_collection	לא	בוליאני	BidRequest.privacy_cares.allow_user_data_collection	הערך הוא True אם בעל התוכן הדיגיטלי מעניק הרשאה לאפשר למגיש הצעות המחיר להשתמש בנתונים של בקשות להצעות מחיר כדי לבנות פרופילים של משתמשים לשימושים כמו מודעות המבוססות על תחומי עניין ורימרקטינג. כדי להשתמש בנתונים האלה לבניית פרופילים של משתמשים, מגיש הצעות המחיר צריך גם לזכות בחשיפה מסוימת. למידע נוסף: מידע על אמצעי הבקרה לאיסוף נתונים.

מקור

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

מאפיין	תמיד עבר	Type	מקבילה קונה שווה ערך	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
fd	לא	בוליאני	אין תמיכה	2.5		הישות שאחראית להחלטה הסופית לגבי מספר החשיפות, כאשר 0 = החלפה, 1 = מקור במעלה. מומלץ לפי המפרט של OpenRTB.
tid	לא	מחרוזת	אין תמיכה	2.5		מזהה העסקה שחייב להיות משותף לכל המשתתפים בבקשה להצעת מחיר (לדוגמה, מספר חילופי הודעות). מומלץ לפי המפרט של OpenRTB.
pchain	לא	מחרוזת	אין תמיכה	2.5		מחרוזת שרשרת של מזהה תשלום שמכילה תחביר מוטמע שמתואר בפרוטוקול TAG של מזהה התשלום בגרסה 1.0. מומלץ לפי המפרט של OpenRTB.
ext	לא	אובייקט SourceExt	אין תמיכה	2.3 2.4 2.5		עבור OpenRTB/Protobuf, אפשר לגשת לאובייקט הזה באמצעות מפתח התוסף של [com.google.doubleclick.source] (הנתיב המדויק משתנה בהתאם לשפה המשמשת ליצירת ספריית Proto). עבור OpenRTB/JSON, נכנסים אל השדה ext בהודעה 'מקור'.
schain	לא	אובייקט SupplyChain	BidRequest.supply_chain	2.3 2.4 2.5		אובייקט OpenRTB SupplyChain. מידע נוסף זמין במאמר הזה.

מקור חיצוני

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
omidpn	לא	מחרוזת	BidRequest.AdSlot.omidpn	מזהה השילוב של OM SDK. למידע נוסף, ניתן לעיין בייעוץ בנושא OpenRTB ל-Open Measurement SDK.
omidpv	לא	מחרוזת	BidRequest.AdSlot.omidpv	גרסה של שילוב ה-OM SDK. למידע נוסף, ניתן לעיין בייעוץ בנושא OpenRTB ל-Open Measurement SDK.
schain	לא	אובייקט SupplyChain	BidRequest.supply_chain	השדה הזה הוצא משימוש ונועד לשפר את BidRequest.source.schain. הוא יוסר בדצמבר 2023. השדה הזה מכיל את האובייקט OpenRTB SupplyChain. אפשר לקרוא מידע נוסף במאמר הזה.

שרשרת אספקה

אובייקט OpenRTB SupplyChain. מידע נוסף זמין במאמר הזה.

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
complete	לא	int32	BidRequest.supply_chain.complete	האפשרות מציינת אם השרשרת מכילה את כל הצמתים המעורבים בעסקה שמובילה בחזרה אל הבעלים של האתר, האפליקציה או אמצעי הגעה לאתר אחר של המלאי, כאשר 0 = לא, 1 = כן.
nodes	לא	מערך של SupplyChainNode אובייקטים	BidRequest.supply_chain.nodes	מערך של אובייקטי SupplyChainNode לפי סדר השרשרת. בשרשרת אספקה מלאה, הצומת הראשון מייצג את מערכת הפרסום הראשונית ואת מזהה בית העסק שמעורבים בעסקה, למשל הבעלים של האתר, האפליקציה או אמצעי הגעה לאתר אחר. בשרשרת אספקה חלקית, הוא מייצג את הצומת הידוע הראשון. הצומת האחרון מייצג את היישות ששולחת את בקשת הצעת המחיר הזו.
ver	לא	מחרוזת	BidRequest.supply_chain.version	גרסה של המפרט של שרשרת האספקה בשימוש, בפורמט "major.minor". לדוגמה, בגרסה 1.0 של המפרט, משתמשים במחרוזת 1.0.

מניעת אספקה

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
asi	לא	מחרוזת	BidRequest.supply_chain.nodes.Advertising_system_identifier	שם הדומיין הקנוני של מערכות SSP , Exchange , Header Wrapper וכו' שמגישי הצעות המחיר מתחברים אליו. הוא יכול להיות הדומיין התפעולי של המערכת, אם הוא שונה מדומיין התאגיד הראשי, שנועד לסייע ל-WHOIS ולחיפושי IP הפוכים ליצור בעלות ברורה על המערכת של בעל הגישה. הערך צריך להיות זהה לזה שמשמש לזיהוי מפיצים בקובץ ads.txt, אם כבר קיים קובץ כזה.
sid	לא	מחרוזת	BidRequest.supply_chain.nodes.seller_identifier	המזהה שמשויך לחשבון של אתר המכירה או המפיץ במערכת הפרסום. הקובץ צריך לכלול את אותו ערך שבו השתמשת בעסקאות (לדוגמה, בקשות להצעות מחיר ב-OpenRTB) בשדה שצוין על ידי ה-SSP או Exchange. בדרך כלל הערך הזה הוא ב-OpenRTB, כמו Publisher.id. ב-OpenDirect, זהו בדרך כלל מזהה הארגון של בעל התוכן הדיגיטלי. יש להגביל ל-64 תווים.
rid	לא	מחרוזת	אין תמיכה	מזהה OpenRTB RequestId כפי שהונפק על ידי אתר המכירה.
name	לא	מחרוזת	אין תמיכה	שם החברה (הישות המשפטית) שמקבלת תשלום על מלאי שטחי פרסום שכפופה ל-seller_id הנתון. הערך הזה הוא אופציונלי ואין לכלול אותו אם הוא קיים בקובץ sellers.json של מערכת הפרסום.
domain	לא	מחרוזת	אין תמיכה	שם הדומיין העסקי של הישות שמיוצגת על ידי הצומת הזה. הערך הזה הוא אופציונלי ואין לכלול אותו אם הוא קיים בקובץ sellers.json של מערכת הפרסום.
hp	לא	int32	BidRequest.supply_chain.nodes.handles_payment	האפשרות מציינת אם הצומת הזה יהיה מעורב בתהליך התשלום של מלאי שטחי הפרסום. כשמגדירים את הערך של 1, מערכת הפרסום בשדה asi משלמת למפיץ בשדה ה-sid, אחראי לשלם את הצומת הקודם בשרשרת. אם הערך שנקבע הוא 0, הצומת הזה לא מעורב בתהליך התשלום על המלאי. בגרסה 1.0 של SupplyChain, הנכס הזה תמיד צריך להיות 1. חובה לכלול את המדד הזה באופן צפוי, כי גרסאות עתידיות של המפרט יגרמו להצגת צמתים שלא משמשים לתשלום תשלומים. ההטמעות צריכות לוודא שהן תומכות בשדה הזה ומפיצות אותו הלאה בזמן בניית אובייקטי SupplyChain בבקשות להצעות מחיר שנשלחות למערכת פרסום ב-downstream.

שד

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

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

מאפיין	תמיד עבר	Type	שווה ערךלקוניםשווי ערך	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
id	כן	מחרוזת	BidRequest .Adslot.id	2.3 2.4 2.5		מזהה ייחודי של החשיפה הזו בהקשר של הבקשה להצעת המחיר (בדרך כלל הערך מתחיל ב-1, וההגדלה היא עד n ב-n חשיפות).
banner	לא	אובייקט Banner	הצעת מחיר .AdSlot	2.3 2.4 2.5		אובייקט Banner. דרוש אם החשיפה הזו מוצעת כהזדמנות של מודעת באנר.
video	לא	אובייקט Video	הצעת מחיר .AdSlot BidRequest .Video	2.3 2.4 2.5		חובה אם החשיפה הזו מוצעת כהזדמנות של מודעת וידאו.
audio	לא	אובייקט Audio	הצעת מחיר .AdSlot BidRequest .Video	2.3 2.4 2.5		חובה אם החשיפה הזו מוצעת כהזדמנות של מודעת אודיו.
displaymanager	לא	מחרוזת	BidRequest .AdSlot .renderer	2.3 2.4 2.5		השם של שותף בתהליך בחירת הרשת (Mediation), טכנולוגיית ה-SDK או הנגן שאחראים להצגת המודעה (בדרך כלל וידאו או נייד). השירות משמש חלק משרתי המודעות להתאמה אישית של קוד המודעות לפי שותף. מומלץ עבור סרטונים ו/או אפליקציות. מחרוזות לדוגמה: UNKNOWN_RENDERER GOOGLE PUBLISHER
displaymanagerver	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		גרסה של שותף לבחירת רשת (Mediation), טכנולוגיית SDK או נגן שאחראי על עיבוד המודעה (בדרך כלל וידאו או נייד). השירות משמש חלק משרתי המודעות להתאמה אישית של קוד המודעות לפי שותף. מומלץ עבור סרטונים ו/או אפליקציות.
instl	לא	בוליאני	הצעת מחיר .AdSlot .Mobile. is_interstitial _request	2.3 2.4 2.5		1 = המודעה מעברון או מסך מלא, 0 = לא מודעת מעברון.
tagid	לא	מחרוזת	הצעת מחיר .AdSlot .ad_block_key	2.3 2.4 2.5		מזהה עבור מיקום מודעה ספציפי או תג מודעה ספציפי ששימש להפעלת המכרז. פעולה זו יכולה להיות שימושית לניפוי באגים בכל בעיה, או לאופטימיזציה על ידי הקונה.
bidfloor	לא	כפולה	min(BidRequest .AdSlot. matching _ad_data .minimum_cpm _micros) * 1,000,000	2.3 2.4 2.5		הצעת המחיר המינימלית לחשיפה הזו מוצגת בעלות לאלף חשיפות.
bidfloorcur	לא	מחרוזת	נתמך התקבל מ-billing_id	2.3 2.4 2.5		מטבע שצוין באמצעות קודי ISO 4217 אלפא. זה עשוי להיות שונה ממטבע הצעת המחיר שהוחזר על ידי מגיש הצעת המחיר, אם הדבר מותר על ידי הבורסה. מטבע אחד, שמתקבל מ-billing_id שנכלל.
clickbrowser	לא	בוליאני	אין תמיכה	2.4 2.5		מציין את סוג הדפדפן שנפתח לאחר לחיצה על הקריאייטיב באפליקציה, כאשר 0 = מוטמע, 1 = מקורי. חשוב לשים לב ששולט התצוגה של Safari במכשירי iOS 9.x נחשב לדפדפן מקומי למטרות המאפיין הזה.
secure	לא	בוליאני	BidRequest .ad_slot .excluded_attribute 48:richMedia CapabilityNonSSL	2.3 2.4 2.5		אפשר לציין אם החשיפה דורשת נכסים מאובטחים של כתובת URL מסוג HTTPS ותגי עיצוב, כאשר 0 = לא מאובטח, 1 = מאובטח. אם לא מגדירים אותו, מצב האבטחה לא ידוע, אבל אפשר להניח שהתמיכה ב-HTTP לא מאובטחת.
iframebuster	לא	מערך מחרוזות	לא	2.3 2.4 2.5		מערך של שמות ספציפיים לבורסה של מפרטי iframe נתמכים.
pmp	לא	אובייקט Pmp	הצעת מחיר .AdSlot .MatchingAdData	2.3 2.4 2.5		אובייקט Pmp שמכיל עסקאות של זירת מסחר פרטית שנכנסו לתוקף בחשיפה הזו.
native	לא	מותאמת	הצעת מחיר .AdSlot .NativeAdTemplate	2.3 2.4 2.5		אובייקט Native; נדרש אם החשיפה הזו מוצעת כהזדמנות במודעה מותאמת.
exp	לא	int32	הצעת מחיר .AdSlot .impression_expiration _seconds	2.4 2.5		ייעוץ בנוגע למספר השניות שעשויות לחלוף בין המכירה הפומבית לבין החשיפה בפועל.
metric	לא	מערך של Metric אובייקטים	הצעת המחיר .AdSlot .viewability BidRequest .AdSlot .click_through _rate BidRequest .AdSlot .video_complete _rate BidRequest .AdSlot .session_depth	2.5		מערך של Metric אובייקטים. AdX מספקת את הערכים הבאים עבור השדה הזה: click_through_rate, viewability, completion_rate ו-session_depth. המדד viewability הוא שבר מ-0.00 ל-1.00 במדד OpenRTB, אבל הוא מבוטא כאחוז [0-100] בפרוטוקול AdX. לקבלת מידע על המדדים האלה, ניתן לעיין בטבלת האובייקטים של AdSlot במדריך לבידינג בזמן אמת. הערה session_depth הוא מספר שלם.
ext	לא	אובייקט ImpExt	אין תמיכה	2.3 2.4 2.5		עבור OpenRTB/Protobuf, אפשר לגשת לאובייקט הזה באמצעות מפתח התוסף של [com.google.doubleclick.imp] (הנתיב המדויק משתנה בהתאם לשפה המשמשת ליצירת ספריית Proto). עבור OpenRTB/JSON, נכנסים עם השדה ext בהודעת ה- Imp.
rwdd	לא	בוליאני	BidRequest.AdSlot.is_rewarded	2.6		מציין אם המשתמש מקבל תגמול על צפייה במודעה. כשמדובר במודעות וידאו, הטמעות טיפוסיות מאפשרות למשתמשים לקרוא כתבה חדשותית נוספת בחינם, לקבל תוספת חיים במשחק או להשיג סשן מוזיקה ממומן ללא פרסומות. התגמול בדרך כלל מופץ אחרי שמודעת הווידאו מסתיימת.

טווח

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
billing_id	כן	מערך של int64	BidRequest.AdSlot.MatchingAdData.billing_id	מזהי החיוב שתואמים להגדרות המיקוד מראש שהתאימו.
publisher_settings_list_id	כן	מערך של קבועים64	BidRequest.publisher_settings_list_id BidRequest.AdSlot.publisher_settings_list_id	מזהה הרשימה של הגדרות בעל האתר שרלוונטי לדף הזה. לפרטים נוספים, אפשר לעיין במדריך לבעלי אתרים ב-RTB.
allowed_vendor_type	לא	מערך של int32	BidRequest.AdSlot.allowed_vendor_type	סוגי הספקים המורשים. רשימה של מזהים זמינה בקובץ vendors.txt.
excluded_creatives	לא	מערך של ExcludedCreative אובייקטים	BidRequest.AdSlot.excluded_creatives	קריאייטיבים שאסורים להופיע בחשיפה. אם תשלח הצעת מחיר עם אחד מהקריאייטיבים שברשימה, הצעת המחיר הזו תסונן לפני המכרז. צריך ליצור קשר עם מנהל החשבון כדי להפעיל את התכונה הזו.
publisher_parameter	לא	מערך מחרוזות	BidRequest.AdSlot.ExchangeBidding.publisher_parameter	מחרוזות UTF8 שמסופקות על ידי בעל התוכן הדיגיטלי כחלק מההגדרות התואמות של קבוצות תפוקה בממשק המשתמש של Ad Manager. הפורמט הוא שרירותי וצריך להוסכם בין בעל התוכן הדיגיטלי לבין מגיש הצעות המחיר של Authorized Buyers.
dfp_ad_unit_code	לא	מחרוזת	BidRequest.AdSlot.dfp_ad_unit_code	הקוד של יחידת המודעות של Ad Manager. כרגע, האפשרות הזו מוגדרת רק לבקשות של Open Bidding.
is_rewarded_inventory	לא	בוליאני	BidRequest.AdSlot.is_reward	השדה הזה הוצא משימוש והוצע לטובת BidRequest.imp.rwdd. הוא יוסר ביולי 2023. בשדה הזה מצוין אם המשתמש מקבל תגמול על צפייה במודעה. כשמדובר במודעות וידאו, הטמעות טיפוסיות מאפשרות למשתמשים לקרוא כתבה חדשותית נוספת בחינם, לקבל תוספת חיים במשחק או להשיג סשן מוזיקה ממומן ללא פרסומות. התגמול בדרך כלל מופץ אחרי שמודעת הווידאו מסתיימת.
is_app_open_ad	לא	בוליאני	BidRequest.Mobile.is_app_open_ad	מציין אם בקשה להצעת מחיר לאפליקציה לנייד מיועדת למודעה בפתיחת אפליקציה. למידע נוסף, אפשר לעיין בהנחיות בנושא מודעות בפתיחת אפליקציה.
ampad	לא	סוג EnumAdmpRequestment	BidRequest.AdSlot.amp_ad_request_type	סוגים אפשריים של דרישות למודעות AMP. UNKNOWN_AMP_AD_REQUIREMENT_TYPE = 1; (ברירת המחדל) הדרישות לגבי מודעות AMP לא ידועות. AMP_AD_NOT_ALLOWED = 2. מודעות AMP אינן מותרות. AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED = 3; מודעות AMP או מודעות שאינן AMP מותרות, מודעות AMP לא עוברות עיבוד מוקדם. AMP_AD_ALLOWED_AND_EARLY_RENDERED = 4. מותר להציג מודעות AMP או מודעות שאינן AMP, מודעות AMP מוצגות קודם. AMP_AD_REQUIRED = 5; חובה להוסיף מודעות AMP. בעל האתר עשוי לדחות מודעות שאינן AMP.
buyer_generated_request_data	לא	מערך של BuyerGeneratedRequestData אובייקטים	BidRequest.AdSlot.secure_signals	האותות המאובטחים הועברו על ידי בעל התוכן הדיגיטלי.
billable_event_rate_adjustment	לא	כפולה	BidRequest.AdSlot.billable_event_rate_adjustment	לגבי מודעות המוצגות באמצעות SDK מותאם אישית בלבד: המכפיל הוחל על הצעת המחיר במכרז. ההתאמה משקפת את הסבירות שהצעת המחיר שלך תניב אירוע לחיוב (לדוגמה, המודעה תוצג בהצלחה) אם היא זכתה במכרז, ביחס להסתברות שהצעות מחיר אחרות ייצרו אירוע לחיוב אם היא זכתה במכרז. ההתאמה הזו יכולה להיות גדולה או קטנה מ-1. זה משפיע על הדירוג הסופי במכרז בלבד, ובפרט, המכפיל הזה לא משפיע על התשלום. ברירת מחדל = 1.0.
open_bidding	לא	אובייקט OpenBidding	BidRequest.AdSlot.open_bidding	פרמטרים שקשורים ל-Open Bidding.
ad_unit_mapping	לא	אובייקט AdUnitMapping	BidRequest.AdSlot.ad_unit_mapping	מיפויים של יחידות מודעות שתואמים למיקום המודעה הנתון.
allowed_restricted_category	לא	int32	BidRequest.AdSlot.allowed_restricted_category	הקטגוריות המותרות של מודעות מוגבלות. רשימה של מזהים זמינה במאמר ad-restricted-categories.txt.
skadn	לא	אובייקט SKAdNetworkRequest	להגיש הצעות מחיר לנייד.	פרטי SKAdNetwork של בעל התוכן הדיגיטלי שתומכים בשיוך של התקנת אפליקציות ל-iOS 14 ואילך. ממשק ה-API של SKAdNetwork של Apple מסייע למפרסמים למדוד התקנות של אפליקציות שמקורן במודעות, על ידי שליחת דיווח חוזר על המרה (PostBack) לרשת המודעות לאחר התקנה מוצלחת. בעלי תוכן דיגיטלי יצטרכו להגדיר את רשתות המודעות הנתמכות ברשימת הנכסים של האפליקציה (Info.plist) כדי שאפשר יהיה לשייך התקנה להתקנה לחשיפה של המודעה. למידע נוסף, עיינו במסמכי התיעוד של Apple.
קריאייטיב לא נכלל
buyer_creative_id	לא	מחרוזת	BidRequest.AdSlot.excludedCreative.buyer_creative_id	מזהה הקריאייטיב של הקונה של הקריאייטיב האסור.
פרטי הקונה שנוצר
data	לא	מחרוזת	הצעת מחיר.AdSlot.SecureSignal.data	האות המאובטח.
source_app	לא	אפליקציית המקור	הצעת מחיר.AdSlot.SecureSignal.source	מקור הנתונים.
אפליקציית המקור
id	לא	מחרוזת	הצעת מחיר.AdSlot.SecureSignal.source	המזהה של ה-SDK שיצר את הנתונים האלה. היא תתאים למזהה ב-BidRequest.AppExt.InstalledSdk.id.
OpenBidding
is_open_bidding	לא	בוליאני	BidRequest.AdSlot.OpenOpen Bidding.is_open_bidding	השדה הזה מוגדר כ-true אם בעל התוכן הדיגיטלי הגדיר קבוצת תפוקה או קבוצה לבחירת רשת שמטרגטת את משבצת המודעה הזו ואת מגיש הצעות המחיר הזה. ניתן להיכנס למרכז העזרה כדי לקבל מידע על שימוש ב-Open Bidding ועל ההשפעות שלו על תהליך הבידינג.
מיפוי יחידות של מודעות
Keyval	לא	אובייקט Keyval	BidRequest.AdSlot.AdUnitmapping. keyval	צמד מפתח/ערך המשמש לציון יחידת המלאי במרחב השמות של מגיש הצעות המחיר.
FormatType	לא	טיפוסים בני מנייה (enum)	BidRequest.AdSlot.AdUnitMapsping.format_type	פורמטים אפשריים של יחידות מודעות המשמשים למיפוי. תואם למתאם שישמש ב-SDK. ערכים אפשריים: FORMAT_UNKNOWN = 0; מציגים מודעות באנר לאפליקציות לאינטרנט או לנייד. לדוגמה, משבצת 320x50 לידרבורד. האיסור חל גם על מודעות וידאו Outstream. FORMAT_BANNER = 1; מודעה במסך מלא שמוצגת בתוך אפליקציה לנייד. FORMAT_INTERSTITIAL = 2; מודעות וידאו או מודעות לרשת המדיה בהתאמה אישית באפליקציות לאינטרנט או לנייד שמתאימות לחוויית המשתמש באתר או באפליקציה שבהן הן מוצגות. FORMAT_NATIVE = 3; מודעות וידאו שמוצגות לפני שידור הווידאו, במהלכו או אחריו. FORMAT_VIDEO_VAST = 4; מודעות וידאו לקידום אפליקציות לנייד שמאפשרות למשתמשים לצפות במודעה בתמורה לתגמול באפליקציה. FORMAT_REWARDED = 5; מודעות מעברון שמאפשרות למשתמשים לצפות במודעה בתמורה לקבלת תגמול בתוך האפליקציה. לא נדרשת הסכמה. https://support.google.com/admanager/answer/7386053 FORMAT_REWARDED_INTERSTITIAL = 6; מודעות בפתיחת אפליקציה מוצגות במסכי הטעינה של האפליקציה. אפשר לסגור מודעות בפתיחת האפליקציה בכל שלב, והן אמורות להופיע כשהמשתמשים מעבירים את האפליקציה לחזית. FORMAT_APP_OPEN = 7;
בקשת SKAdNetwork
versions	לא	מערך מחרוזות	BidRequest.Mobile.skadn.versions	רשימה של כל גרסאות SKAdNetwork שנתמכות בבקשה, בהתאם לגרסת ה-OS ולגרסת ה-SDK.
sourceapp	לא	מחרוזת	BidRequest.Mobile.skadn.sourceapp	מזהה האפליקציה של בעל האפליקציה ב-App Store של Apple.
skadnetids	לא	מערך מחרוזות	BidRequest.Mobile.skadn.skadnetids	רשומות SKAdNetworkIdentifier בקובץ ה-Info.plist של האפליקציה של בעל התוכן הדיגיטלי.
fidelities	לא	מערך של SKAdNetworkFidelityType אובייקטים	BidRequest.Mobile.skadn.supported_Trustelity_types	רשימת הסוגים של האיכות הנתמכת, בהתאם לגרסת SKAdNetwork API שנתמכת על ידי מערכת ההפעלה וה-SDK, וגם נכסי מיקום מודעה.
skoverlay	לא	בוליאני	BidRequest.Mobile.skadn.skoverlay	מציין אם הבקשה תומכת ב-SKLayer של מודעות וידאו.

אובייקט Keyval

הורה

אפשר לציין כמה צמדי מפתח/ערך כדי לתמוך במגישי הצעות מחיר שיחידת המלאי שלהם היא היררכית ויש להם מספר מזהים. צמדים של מפתח/ערך של AdUnitMapsping צריכים להישלח חזרה בתגובה להצעת המחיר, כ-BidResponse.seatbid.bid.ext.sdk_rendered_ad.sdk_params. הפרטים האלה מועברים ל-SDK של מגיש הצעות המחיר.

מאפיין	Type	תמיד עבר	שווה ערך לקונים מורשים	פרטי ההטמעה
key	מחרוזת	לא	BidRequest.AdSlot.AdUnitMapsping.keyval.key	המפתח הוא השם של מזהה יחידת המלאי של מגיש הצעות המחיר עבור ה-SDK.
value	מחרוזת	לא	BidRequest.AdSlot.AdUnitMapsping.keyval.value	הערך של מזהה יחידת המלאי של מגיש הצעות המחיר בפורמט הנתון.

המדד

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

מאפיין	תמיד עבר	Type	מקבילה קונה שווה ערך	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
type	לא	מחרוזת	אחת מהאפשרויות הבאות: BidRequest .AdSlot .viewability BidRequest .AdSlot .click_ through_rate BidRequest .AdSlot .video_ complete_rate BidRequest .AdSlot .session_depth	2.5		סוג המדד שמוצג באמצעות שמות של אוספים שנאספו ב-Exchange שאותם יש לפרסם למגישי הצעות המחיר בעבר. נדרש על ידי המפרט של OpenRTB. הסוגים הנתמכים הם: click_through_rate, viewability, completion_rate ו-session_depth.
value	לא	כפולה	הערך הוא בין 0 ל-1.	2.5		מספר שמייצג את ערך המדד. ההסתברות חייבת להיות בטווח שבין 0.00 ל-1.00. נדרש על ידי המפרט של OpenRTB. המדד viewability הוא שבר מ-0.00 ל-1.00 במדד OpenRTB, אבל הוא מבוטא כאחוז [0-100] בפרוטוקול AdX.
vendor	לא	מחרוזת	החלפה	2.5		מקור הערך תוך שימוש בשמות של קובצי אוסף שנאספו מ-Exchange שצריכים להתפרסם במגישי הצעות המחיר בתחילת השנה. אם הבורסה עצמה היא המקור לעומת צד שלישי, מומלץ להשתמש ב-"EXCHANGE". מומלץ לפי המפרט של OpenRTB.

באנר

האובייקט הזה מייצג את סוג החשיפה הכללי ביותר. בהקשר הזה, למונח "באנר" יכול להיות משמעות מאוד ספציפית בהקשרים אחרים, אבל הוא יכול לכלול הרבה דברים כמו תמונה סטטית פשוטה, יחידת מודעות שניתנת להרחבה או אפילו וידאו להצגה במודעת באנר (כדאי לעיין באובייקט Video כדי לראות את יחידות מודעות הווידאו הכלליות והמלאות יותר). מערך של אובייקטים מסוג Banner יכול גם להופיע בסרטון כדי לתאר מודעות נלוות אופציונליות המוגדרות במפרט של VAST.

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
w	לא	int32	הצעת מחיר.AdSlot.width[0]	2.3 2.4 2.5		הרוחב בפיקסלים הבלתי תלויים במכשיר (DIPS). אם לא צוינו אובייקטים מסוג Format, זוהי דרישת רוחב מדויקת. אחרת, זהו הרוחב המועדף.
h	לא	int32	הצעת מחיר.AdSlot.height[0]	2.3 2.4 2.5		הגובה בפיקסלים הבלתי תלויים של המכשיר (DIPS). אם לא צוינו אובייקטים מסוג Format, זוהי דרישת גובה מדויקת. אחרת, זהו הגובה המועדף.
format	לא	מערך של Format אובייקטים	אין תמיכה	2.4 2.5		מערך של Format אובייקטים שמייצג את גודלי הבאנר. אם לא מציינים מאפיינים כאלה, מומלץ מאוד להשתמש במאפיינים h ו-w.
id	לא	מחרוזת	הצעת מחיר.AdSlot.id	2.3 2.4 2.5		מזהה ייחודי לאובייקט Banner הזה. מומלץ להשתמש באובייקטים של Banner עם אובייקט Video כדי לייצג מערך של מודעות נלוות. בדרך כלל הערכים מתחילים ב-1 וגדלים בכל אובייקט, וצריכים להיות ייחודיים בחשיפה.
pos	לא	מיקום מודעה ב-Enum	הצעת מחיר.AdSlot.slot_visible הצעת מחיר.StickySettings	2.3 2.4 2.5		הטבלה OpenRTB הזו מכילה ערכים שנגזרים מהנחיות אבטחת האיכות של IAB (QAG). בעלי המקצוע צריכים להסתנכרן עם העדכונים של ערכי ה-QAG כפי שהם מפורסמים ב-IAB.net. הערכים 4 עד 7 רלוונטיים לאפליקציות בהתאם לנספח לנייד של QAG בגרסה 1.5. במשתנה Banner.pos יש תמיכה רק בערך אחד. אם הערך של is_sticky הוא Banner.pos, הוא מאוכלס בנאמנות. אם נעשה שימוש ב-unknown_stickiness, slot_visibility. דביקות מציינת שהבאנר תמיד מופיע במסך, והחשיפה בחלק העליון והקבוע או בחלק הנגלל יכולה להשתנות כשהמשתמש גולל. יכול להיות אחד מהערכים האלה: ABOVE_THE_FOLD = 1; BELOW_THE_FOLD = 3; HEADER = 4; שווה ערך ל-sticky_settings.top_horizontal_stickiness בפרוטוקול RTB של Authorized Buyers. FOOTER = 5; שווה ערך ל-sticky_settings.bottom_horizontal_stickiness בפרוטוקול RTB של Authorized Buyers. SIDEBAR = 6; שווה ערך ל-sticky_settings.vertical_stickiness בפרוטוקול RTB של Authorized Buyers.
btype	לא	מערך מודעות באנר מסוג enumType	אין תמיכה	2.5		סוגים חסומים של מודעות באנר דוגמאות: XHTML_TEXT_AD = 1; // "Usuual mobile". XHTML_BANNER_AD = 2; // "Usuual mobile". JAVASCRIPT_AD = 3; // JavaScript חייב להיות xhtml חוקי IFRAME = 4; // Iframe.
battr	לא	מערך טיפוסים של קריאייטיב	BidRequest.AdSlot.excluded_attribute	2.3 2.4 2.5		מאפייני קריאייטיב חסומים. דוגמאות: AUDIO_AUTO_PLAY = 1; AUDIO_USER_INITIATED = 2;
mimes	לא	מערך מחרוזות	ממופה רק עבור BidRequest.Video.companionad: BidRequest.Video.companionad.creative_format BidRequest.AdSlot.excluded_attribute / VPAID	2.3 2.4 2.5		רשימת היתרים של סוגי MIME נתמכים. סוגי MIME נפוצים כוללים, בין היתר, את המאפיינים "image/jpg", "image/gif" ו-"application/x-shockwave-Flash".
topframe	לא	בוליאני	BidRequest.AdSlot.iframe_state NO_IFRAME: false SAME_DOMAIN_IFRAME, CROSS_DOMAIN_IFRAME: true	2.3 2.4 2.5		תוכלו לציין אם הבאנר מוצג במסגרת העליונה (True) או ב-iframe (לא נכון).
expdir	לא	מערך טיפוסים של ExpandableDirection	BidRequest.AdSlot.excluded_attribute / EXPANDING_*	2.3 2.4 2.5		הנחיות שבהן מודעת הבאנר עשויה להתרחב.
api	לא	מערך של APIFramework אובייקטים	BidRequest.AdSlot.excluded_attribute / MRAID_1_0	2.3 2.4 2.5		רשימת מסגרות API נתמכות עבור החשיפה הזו. אם ממשק API לא מצוין במפורש, ההנחה היא שהוא אינו נתמך.
vcm	לא	בוליאני	BidRequest.Video.end_cap_support	2.5		האפשרות הזו רלוונטית רק לאובייקטים של מודעות באנר שנעשה בהם שימוש עם אובייקט וידאו במערך של מודעות נלוות. מציין את מצב העיבוד של מודעת באנר נלווית ביחס לסרטון המשויך, כאשר 0 = בו-זמנית, 1 = כרטיס סיום. בשלב זה, אנחנו תומכים בכרטיסי סיום רק במודעות מעברון באפליקציות של mApp.
wmax	לא	int32	BidRequest.AdSlot.flexible_ad_slot_settings.max_width	2.3 2.4 2.5		רוחב מקסימלי של החשיפה בפיקסלים.
hmax	לא	int32	BidRequest.AdSlot.flexible_ad_slot_settings.max_height	2.3 2.4 2.5		הגובה המקסימלי של החשיפה בפיקסלים.
wmin	לא	int32	BidRequest.AdSlot.flexible_ad_slot_settings.min_width	2.3 2.4 2.5		רוחב מינימלי של החשיפה בפיקסלים.
hmin	לא	int32	BidRequest.AdSlot.flexible_ad_slot_settings.min_height	2.3 2.4 2.5		הגובה המינימלי של החשיפה בפיקסלים.

פורמט

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
w	לא	int32	BidRequest.AdSlot.width	2.4 2.5		הרוחב בפיקסלים הבלתי תלויים במכשיר (DIPS).
h	לא	int32	הצעת מחיר.AdSlot.height	2.4 2.5		הגובה בפיקסלים הבלתי תלויים של המכשיר (DIPS).
wratio	לא	int32	אין תמיכה	2.5		הרוחב היחסי שבו מציינים את הגודל כיחס.
hratio	לא	int32	אין תמיכה	2.5		גובה יחסי בעת ביטוי גודל כיחס.
wmin	לא	int32	אין תמיכה	2.5		הרוחב המינימלי בפיקסלים בלתי תלויים במכשיר (DIPS) שבהם המודעה תוצג כשהגודל מתבטא ביחס גובה-רוחב.

וידאו

האובייקט הזה מייצג חשיפה של מודעת וידאו In-stream. הרבה מהשדות לא חיוניים לעסקאות מינימליות, אבל הם כלולים כדי להעניק שליטה טובה כשצריך. סרטונים ב-OpenRTB בדרך כלל מניחים שהם תואמים לתקני VAST. כתוצאה מכך, הרעיון של מודעות נלוות נתמך על ידי הכללת מערך של אובייקטים מסוג Banner שמגדירים את המודעות הנלוות.

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

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	גרסה	תמיכה ב-Google	פרטי ההטמעה
mimes	כן	מערך מחרוזות	BidRequest.video.allowed_video_formats, BidRequest.AdSlot.excluded_attribute / VPAID	2.3 2.4 2.5		רשימת היתרים של סוגי MIME נתמכים. סוגי MIME פופולריים כוללים, בין היתר, את המאפיינים "image/jpg", "image/gif" ו-"application/x-shockwave-Flash". נדרש על ידי מפרט OpenRTB: לפחות רכיב אחד.
linearity	לא	int32		2.3 2.4 2.5		מציין אם החשיפה צריכה להיות לינארית, לא לינארית וכו'. אם לא צוין ערך, ההנחה היא שכולם מותרים. LINEAR = 1: לינארי/מודעת וידאו In-stream NON_LINEAR = 2: לא לינארי/שכבת-על
minduration	לא	int32	BidRequest.Video.min_ad_duration	2.3 2.4 2.5		משך מודעת וידאו מינימלי בשניות. מומלץ לפי המפרט של OpenRTB.
maxduration	לא	int32	BidRequest.Video.max_ad_duration	2.3 2.4 2.5		משך הזמן המקסימלי של מודעת וידאו בשניות. מומלץ לפי המפרט של OpenRTB.
protocols	לא	מערך של Protocol אובייקטים	BidRequest.Video.פרוטוקולים	2.3 2.4 2.5		מגוון פרוטוקולים נתמכים של הצעות מחיר לווידאו יש לציין לפחות פרוטוקול נתמך אחד. דוגמאות: VAST_1_0 = 1; VAST_2_0 = 2; VAST_3_0 = 3;
w	לא	int32	הצעת מחיר.AdSlot.width[0]	2.3 2.4 2.5		רוחב נגן הווידאו בפיקסלים בלתי תלויים במכשיר (DIPS). מומלץ לפי המפרט של OpenRTB.
h	לא	int32	הצעת מחיר.AdSlot.height[0]	2.3 2.4 2.5		גובה נגן הווידאו בפיקסלים בלתי תלויים במכשיר (DIPS). מומלץ לפי המפרט של OpenRTB.
startdelay	לא	int32	הצעת מחיר.video.videoad_start_delay >0: start delay in seconds 0: PRE_ROLL -1: GENERIC_MID_ROLL -2: GENERIC_POST_ROLL ערכים אחרים: videoad_start_delay / 1,000	2.3 2.4 2.5		מציין את השהיית ההתחלה בשניות עבור מיקומי מודעות לפני סרטון, באמצע סרטון או בסוף סרטון. הערכים הגנריים מופיעים בקטע StartDelay. מומלץ לפי המפרט של OpenRTB.
skip	לא	בוליאני	הצעת מחיר.video.video_ad_Skip	2.4 2.5		ההערה מציינת אם הנגן ידלג על הסרטון / אם 0 = לא, 1 = כן. אם מגיש הצעות המחיר שולח את תגי העיצוב/הקריאייטיב שאפשר לדלג עליהם, האובייקט Bid צריך לכלול את מערך האמנות עם רכיב של 16 שמציין שהמודעה ניתנת לדילוג.
skipmin	לא	int32	אין תמיכה	2.4 2.5		ניתן לדלג על סרטונים שאורכם הכולל גדול ממספר השניות הזה; האפשרות רלוונטית רק אם ניתן לדלג על המודעה.
skipafter	לא	int32	אין תמיכה	2.4 2.5		מספר השניות שהסרטון צריך לפעול לפני שמפעילים את הדילוג. הוא רלוונטי רק אם המודעה ניתנת לדילוג.
sequence	לא	int32	אין תמיכה	2.3 2.4 2.5		אם מוצעת כמה חשיפות של מודעות באותה בקשה להצעת מחיר, מספר הרצף יאפשר הצגה של מודעות מתואמת של כמה נכסי קריאייטיב.[default = 1];
battr	לא	מערך קריאייטיבמאפיין	BidRequest.AdSlot.excluded_attribute	2.3 2.4 2.5		מאפייני קריאייטיב חסומים.
maxextended	לא	int32	אין תמיכה	2.3 2.4 2.5		משך זמן מרבי של מודעת וידאו, אם מותר. אם התוסף ריק או 0, התוסף לא יאושר. אם הערך הוא -1, התוסף מותר ואין הגבלת זמן. אם הערך גדול מ-0, הערך מייצג את מספר השניות של ההפעלה המורחבת שנתמכות מעבר לערך המקסימלי.
minbitrate	לא	int32	אין תמיכה	2.3 2.4 2.5		קצב העברת הנתונים המינימלי Kbps.
maxbitrate	לא	int32	אין תמיכה	2.3 2.4 2.5		קצב העברת הנתונים המקסימלי בקילובייט לשנייה.
boxingallowed	לא	בוליאני	אין תמיכה	2.3 2.4 2.5		התנאי מציין אם מותר לאגרוף אותיות של 4:3 בחלון 16:9, כאשר 0 = לא, 1 = כן. default = true
playbackmethod	לא	מערך הפעלהשיטה	הצעת מחיר.video.playback_method AdX: TheVideoPlaybackMethod.AUTO_PLAY_SOUND_ON VideoVideoMethod .AUTO_PLAY_SOUND_OFF שיטת VideoPlayback.Click_TO_PLAY VideoPlaybackMethod .MOUSE_OVER שיטת הפעלת וידאו.ENTER_SOUND_ON שיטת וידאו להפעלה.ENTER	2.3 2.4 2.5		שיטות הפעלה שעשויות להיות בשימוש. אם לא מציינים שום הגדרה, אפשר להשתמש בכל שיטה. בדרך כלל משתמשים רק בשיטה אחת. כתוצאה מכך, ייתכן שהמערך הזה יומר למספר שלם בגרסה העתידית של המפרט. מומלץ מאוד להשתמש רק ברכיב הראשון של המערך הזה בהכנה לשינוי. AUTO_PLAY_SOUND_ON = 1: הפעלה של טעינת דף עם צליל. AUTO_PLAY_SOUND_OFF = 2: ברירת המחדל היא טעינת דף עם צליל כבוי. CLICK_TO_PLAY = 3: התכונה מופעלת ברגע שהצליל מופעל. MOUSE_OVER = 4: הפעלה באמצעות העברת העכבר עם צליל מופעל. ENTER_SOUND_ON = 5: מתחיל תהליך כניסה לאזור התצוגה עם צליל מופעל. ENTER_SOUND_OFF = 6: מופעלת כניסה לאזור התצוגה עם צליל מושבתת כברירת מחדל.
delivery	לא	מערך של ContentDelivery Method	אין תמיכה	2.3 2.4 2.5		שיטות שליחה נתמכות (לדוגמה, סטרימינג, Progressive). אם לא צוין ערך, ההנחה היא שכולם נתמכים. סטרימינג = 1; התקדמות = 2;
pos	לא	AdPosition	BidRequest.AdSlot.slot_visible	2.3 2.4 2.5		מיקום המודעה במסך.
companionad	לא	מערך של Banner אובייקטים	BidRequest.Video.companion_slot	2.3 2.4 2.5		מערך של Banner אובייקטים אם מודעות נלוות זמינות.
api	לא	מערך של APIFramework אובייקטים	BidRequest.AdSlot.excluded_attribute / MRAID_1_0	2.3 2.4 2.5		רשימת מסגרות API נתמכות עבור החשיפה הזו. אם API לא רשום במפורש, ההנחה היא שהוא לא נתמך.
companiontype	לא	מערך של CompanionType אובייקטים	BidRequest.Video.companion_slot.creative_format	2.3 2.4 2.5		סוגי מודעות נלוות VAST נתמכות. מומלץ אם יש אובייקטים נלווים של Banner דרך מערך companionad.
placement	לא	VideoPlacementType	הצעת מחיר.Video.מיקום INSTREAM -> IN_STREAM_PLACEMENT INTERSTITIAL -> FLOATING_PLACEMENT IN_FEED -> IN_FEED_PLACEMENT IN_ARTICLE -> IN_ARTICLE_PLACEMENT UNKNOWN_PLACEMENT -> UNDEFINED_VIDEO_PLACEMENT AUDIO -> UNDEFINED_VIDEO_PLACEMENT (לא מוגדר) -> IN_BANNER_PLACEMENT	2.5		סוג המיקום של החשיפה. UNDEFINED_VIDEO_PLACEMENT: מיקום הסרטון לא מוגדר. ערך ברירת המחדל. IN_STREAM_PLACEMENT: הופעל לפני, במהלך או אחרי תוכן הווידאו בסטרימינג שהצרכן ביקש. לדוגמה, מודעה לפני סרטון, באמצע סרטון, בסוף סרטון. IN_BANNER_PLACEMENT: קיים בבאנר של אתר שמשתמש בשטח הבאנר כדי לספק חוויית וידאו בניגוד לפורמט מדיה אחר או סטטי. הפורמט מסתמך על קיומו של מלאי שטחי הפרסום ברשת המדיה בדף כדי להציג אותו. IN_ARTICLE_PLACEMENT: נטען ומופעל באופן דינמי בין פסקאות של תוכן מערכתי. הן קיימות כהודעה ממותגת עצמאית. IN_FEED_PLACEMENT: בגוף הפיד – נמצאו בפידים של תוכן, רשתות חברתיות או מוצרים. FLOATING_PLACEMENT: מעברון/פס הזזה/צף. כולל את כל האזור של המסך, או חלק ממנו, אבל הוא תמיד מוצג במסך בזמן שהוא מוצג (לדוגמה, לא ניתן לגלול מחוץ לתצוגה). חשוב לזכור שאפשר להבחין בין מודעת מעברון במסך מלא (למשל בנייד) לבין יחידה צפה/פס הזזה לפי השדה imp.instl.
playbackend	לא	PlaybackCessationMode	אין תמיכה	2.5		האירוע שגורם לסיום ההפעלה.

אודיו

האובייקט הזה מייצג חשיפה של סוג אודיו. הרבה מהשדות לא חיוניים לעסקאות מינימליות, אבל הם כלולים כדי להעניק שליטה טובה כשצריך. אודיו ב-OpenRTB בדרך כלל מתבסס על תאימות לתקן DAAST. מסיבה זו, הרעיון של מודעות נלוות נתמך על ידי הכללת מערך של אובייקטים מסוג Banner שמגדירים את המודעות הנלוות האלה. אם יש אובייקט Audio כאובייקט משנה של האובייקט Imp, החשיפה הזו מוצעת כחשיפה מסוג אודיו. לפי שיקול הדעת של בעלי התוכן הדיגיטלי, אותה חשיפה עשויה להיות מוצעת גם כמודעת באנר, כסרטון או כמקור, על ידי הכללת אובייקטים מהסוגים האלה כ-Imp. עם זאת, כל הצעת מחיר נתונה לחשיפה צריכה לעמוד באחד מהסוגים המוצעים.

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
mimes	לא	מערך מחרוזות	BidRequest.video.allowed_video_formats, BidRequest.AdSlot.excluded_attribute / VPAID	2.4 2.5		סוגי MIME נתמכים (לדוגמה, "audio/mp4") נדרש על ידי מפרט OpenRTB: לפחות רכיב אחד.
minduration	לא	int32	BidRequest.Video.min_ad_duration	2.4 2.5		משך מודעת וידאו מינימלי בשניות. מומלץ לפי המפרט של OpenRTB.
maxduration	לא	int32	BidRequest.Video.max_ad_duration	2.4 2.5		משך הזמן המקסימלי של מודעת וידאו בשניות. מומלץ לפי המפרט של OpenRTB.
protocols	לא	מערך של Protocol אובייקטים	BidRequest.Video.פרוטוקולים	2.4 2.5		מגוון פרוטוקולים נתמכים של הצעות מחיר לווידאו יש לציין לפחות פרוטוקול נתמך אחד. דוגמאות: DAAST_1_0 = 9; DAAST_1_0_WRAPPER = 10;
startdelay	לא	int32	הצעת מחיר.video.videoad_start_delay >0: start delay in seconds 0: PRE_ROLL -1: GENERIC_MID_ROLL -2: GENERIC_POST_ROLL ערכים אחרים: videoad_start_delay / 1,000	2.4 2.5		מציין את השהיית ההתחלה בשניות עבור מיקומי מודעות לפני סרטון, באמצע סרטון או בסוף סרטון. הערכים הכלליים מופיעים ב-StartDelay. מומלץ לפי המפרט של OpenRTB.
sequence	לא	int32	אין תמיכה	2.4 2.5		אם מוצעת כמה חשיפות של מודעות באותה בקשה להצעת מחיר, מספר הרצף יאפשר הצגה של מודעות מתואמת של כמה נכסי קריאייטיב.[default = 1];
battr	לא	מערך של CreativeAttribute אובייקטים	BidRequest.AdSlot.excluded_attribute	2.4 2.5		מאפייני קריאייטיב חסומים.
maxextended	לא	int32	אין תמיכה	2.4 2.5		משך זמן מרבי של מודעת וידאו, אם מותר. אם התוסף ריק או 0, התוסף לא יאושר. אם הערך הוא -1, התוסף מותר ואין הגבלת זמן. אם הערך גדול מ-0, הערך מייצג את מספר השניות של ההפעלה המורחבת שנתמכת מעבר לערך maxduration.
minbitrate	לא	int32	אין תמיכה	2.4 2.5		קצב העברת הנתונים המינימלי Kbps.
maxbitrate	לא	int32	אין תמיכה	2.4 2.5		קצב העברת הנתונים המקסימלי בקילובייט לשנייה.
delivery	לא	מערך של ContentDeliveryMethod אובייקטים	אין תמיכה	2.4 2.5		שיטות שליחה נתמכות (לדוגמה, סטרימינג, Progressive). אם לא צוין ערך, ההנחה היא שכולם נתמכים. STREAMING = 1; PROGRESSIVE = 2;
companionad	לא	מערך של Banner אובייקטים	BidRequest.Video.companion_slot	2.4 2.5		מערך של Banner אובייקטים אם מודעות נלוות זמינות.
api	לא	מערך של APIFramework אובייקטים	BidRequest.AdSlot.excluded_attribute / MRAID_1_0	2.4 2.5		רשימת מסגרות API נתמכות עבור החשיפה הזו. אם API לא רשום במפורש, ההנחה היא שהוא לא נתמך.
companiontype	לא	מערך של CompanionType אובייקטים	BidRequest.video.companion_slot.creative_format	2.4 2.5		סוגים נתמכים של מודעות נלוות ב-DAAST.
maxseq	לא	int32	אין תמיכה	2.4 2.5		המספר המקסימלי של מודעות שאפשר להפעיל ברצף המודעות.
feed	לא	סוג הפיד	אין תמיכה	2.4 2.5		סוג פיד האודיו.
stitched	לא	בוליאני	אין תמיכה	2.4 2.5		מציין אם המודעה עובדת עם תוכן אודיו או נשלחת בנפרד, כאשר 0 = לא, 1 = כן.
nvol	לא	VolumeNormalizationMode	אין תמיכה	2.4 2.5		מצב נורמליזציה של עוצמת הקול.

מותאמת

אובייקט זה מייצג חשיפה מסוג מקורי. המטרה של יחידות של מודעות מותאמות היא להשתלב בצורה חלקה בתוכן שמסביב (לדוגמה, פוסט ממומן ב-Twitter או ב-Facebook). לכן, התשובה צריכה להיות מובנית מספיק כדי לאפשר לבעל התוכן הדיגיטלי שליטה פרטנית בעיבוד.

לידיעתכם, גרסת Native 1.1 נתמכת בגרסאות OpenRTB 2.4 ו-OpenRTB 2.5.

נציבות המשנה המותאמת פיתחה מפרט נלווה ל-OpenRTB שנקרא מפרט מודעות מותאמות. היא מגדירה את הפרמטרים של הבקשה ואת המבנה של תגי התגובה לתגובות של יחידות המודעות המותאמות.

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
request	לא	מחרוזת	BidRequest.AdSlot.NativeAdתבנית	2.3 2.4 2.5		יש לבקש מטען ייעודי (payload) שתואם למפרט של מודעות מותאמות. יש להשתמש באפשרות אחת בדיוק של {request, request_native}.
request_native	לא	מודעה מותאמת	BidRequest.AdSlot.NativeAdתבנית	2.3 2.4 2.5		יש לבקש מטען ייעודי (payload) שתואם למפרט של מודעות מותאמות. יש להשתמש בשדה אחד בדיוק מתוך {request, request_native}. זהו שדה חלופי המועדף לסדרה של Protobuf.
ver	לא	מחרוזת	מומלץ לפי המפרט של OpenRTB.	2.3 2.4 2.5		גרסת מפרט המודעות המותאמות שעליה הבקשה תואמת. מומלץ לפי המפרט של OpenRTB.
api		מערך של APIFramework אובייקטים	BidRequest.AdSlot.excluded_attribute / MRAID_1_0	2.3 2.4 2.5		רשימת מסגרות API נתמכות עבור החשיפה הזו. אם API לא רשום במפורש, ההנחה היא שהוא לא נתמך.
battr		מערך של CreativeAttribute אובייקטים	BidRequest.AdSlot.excluded_attribute	2.3 2.4 2.5		מאפייני קריאייטיב חסומים.

mpp

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
private_auction	לא	בוליאני	BidRequest.AdSlot.only_deal_bids_Accepted	2.3 2.4 2.5		אינדיקטור להשתתפות במכרז של מושבים בשם אובייקטים עם עסקאות ישירות, שבו 0 = כל הצעות המחיר מאושרות, 1 = הצעות מחיר מוגבלות לעסקאות והתנאים שלהן.
deals	לא	מערך של Deal אובייקטים	הצעת מחיר.AdSlot.התאמהAdData.DirectDeal	2.3 2.4 2.5		מערך של Deal אובייקטים שדרכם מועברים המבצעים הספציפיים שקשורים לחשיפה הזו.

מבצע

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
id	כן	מחרוזת	הצעת מחיר.AdSlot.התאמהAdData.DirectDeal.direct_deal_id	2.3 2.4 2.5		מזהה ייחודי עבור העסקה הישירה. נדרש על ידי המפרט של OpenRTB.
bidfloor	לא	כפולה	הצעת מחיר.AdSlot.התאמותAdData.DirectDeal.fixed_cpm _micros *1,000,000	2.3 2.4 2.5		הצעת המחיר המינימלית לחשיפה הזו מוצגת בעלות לאלף חשיפות.
bidfloorcur	לא	מחרוזת	מטבע יחיד, שמתקבל מה-billing_id הכלולים	2.3 2.4 2.5		מטבע שצוין באמצעות קודי ISO 4217 אלפא. זה עשוי להיות שונה ממטבע הצעת המחיר שהוחזר על ידי מגיש הצעת המחיר, אם הדבר מותר על ידי exchange.default = "USD"
wseat	לא	מערך מחרוזות	אין תמיכה	2.3 2.4 2.5		רשימת היתרים של מושבי קונים (לדוגמה, מפרסמים, סוכנויות) שיכולים להגיש הצעת מחיר על העסקה הזו. מזהים של מושבים והידע שלהם לגבי הלקוחות צריכים לפנות לתאום בין מגישי הצעות המחיר לבין נציגי חילופי התשלומים. השמטה לא מצביעה על מגבלות מקום.
wadomain	לא	מערך מחרוזות	אין תמיכה	2.3 2.4 2.5		מערך של דומיינים של מפרסמים (לדוגמה, מפרסם.com) יכול להגיש הצעת מחיר על העסקה הזו. המשמעות של השמטה היא שאין הגבלות על המפרסמים.
at	לא	סוג המכרז	BidRequest.auction_type	2.3 2.4 2.5		ביטול אופציונלי של סוג המכרז הכולל של הבקשה להצעת מחיר, כאשר 1 = מחיר ראשון, 2 = מחיר שני נוסף, 3 = הערך שמועבר בהצעת המחיר הוא מחיר העסקה שהוסכם עליו. אפשר להגדיר סוגים נוספים של מכרזים לפי ההחלפה.
ext	לא	אובייקט DealExt	אין תמיכה	2.3 2.4 2.5		עבור OpenRTB/Protobuf, אפשר לגשת לאובייקט הזה באמצעות מפתח התוסף של [com.google.doubleclick.deal] (הנתיב המדויק משתנה בהתאם לשפה המשמשת ליצירת ספריית Proto). עבור OpenRTB/JSON, נכנסים עם השדה ext בהודעה Deals (מבצעים).

DealExt

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
deal_type	לא	סוג עסקה של Enum	BidRequest.AdSlot.MatchingAdData.DirectDeal.deal_type	סוג העסקה. חשוב לשים לב ששינויים במדיניות Authorized Buyers חלים על כל הצעות המחיר המובטחות והפרוגרמטיות המובטחות, ולא חלים על הצעות מחיר לסוגי עסקאות אחרים. UNKNOWN_DEAL_TYPE = 0; ברירת מחדל. PREFERRED_DEAL = 1; הצעות המחיר הן במחיר קבוע ומתבצעת הערכה לפני המכרז הפתוח. מגישי הצעות המחיר לא נדרשים להגיש הצעות מחיר עם דילים בלעדיים אם הם נמצאים בבקשה להצעת מחיר. אפשר לקרוא מידע נוסף במאמר הזה. private_AUCTION = 2. הצעות המחיר משתתפות במכרז פרטי לעומת רשימת קונים עם קומות ספציפיות. אפשר לקרוא מידע נוסף במאמר הזה. programMATIC_GUARANTEED = 3. הצעות המחיר הן מחיר קבוע ומתבצעת הערכה לפני המכרז. מגישי הצעות המחיר צפויים להגיש הצעות מחיר עם עסקאות פרוגרמטיות מובטחות, בכל פעם שהן מופיעות בבקשת הצעת מחיר, והשדה חייבים להיות נכונים כדי להבטיח שמספר החשיפות שסוכמו בעסקה מסוימת מוצג. אפשר לקרוא מידע נוסף במאמר הזה. AUCTION_PACKAGE = 4, מזהה המבצע הוא מזהה של אוסף מלאי מכרז פתוח שתואם לקבוצה נתונה של קריטריונים של טירגוט. אפשר לקרוא מידע נוסף במאמר הזה. MARKETPLACE_PACKAGE = 5; מזהה העסקה עבור חבילות של מלאי שטחי פרסום שנאספו על ידי בעלי התוכן הדיגיטלי. מזהי המבצעים האלה נשלחים באופן אוטומטי לכל קונה שעומד בדרישות לקבלת החבילה. אפשר לקרוא מידע נוסף במאמר הזה.
must_bid	לא	בוליאני	BidRequest.AdSlot.MatchingAdData.DirectDeal.Must_bid	השדה הזה רלוונטי רק לדילים פרוגרמטיים מובטחים. הקונה רשאי לדלג על הבידינג בחשיפה אם השדה הוא false. אם הדבר מתקיים, הקונה נדרש להגיש הצעת מחיר על העסקה הזו כדי לקבל את ההזדמנות הזו לחשיפה. השדה הזה תמיד יאוכלס באופן מפורש בפורמט ה-JSON. ברירת מחדל = נכון.
publisher_blocks_overridden	לא	בוליאני	BidRequest.AdSlot.MatchingAdData.DirectDeal.publisher_blocks_Override	האם בעל התוכן הדיגיטלי פטר עסקה זו מחסימות מוגדרות. ההגדרה הזו לא מבטלת את המדיניות של Authorized Buyers או את ההחלטות של מרכז בקרת המודעות. אפשר לקרוא מידע נוסף במאמר הזה.
creative_source	לא	סוג Enum CreativeSourceType	BidRequest.AdSlot.MatchingAdData.DirectDeal.creative_source	שדה ניסיוני. בכפוף לשינויים. טיפוסים בניהולך עם המארח של הקריאייטיב, שיאוכלס רק בעסקאות פרוגרמטיות מובטחות. כרגע, השדה הזה צריך להיות מוגדר תמיד כ-RIC_SOURCE_ADVERTISER. creative_SOURCE_UNKNOWN = 0; creative_SOURCE_ADVERTISER = 1; (ברירת מחדל) הקריאייטיב מתארח במפרסם, כלומר מגיש הצעת המחיר נדרש לספק קריאייטיב בתגובה להצעת המחיר. creative_SOURCE_PUBLISHER = 2; הקריאייטיב מתארח אצל בעל התוכן הדיגיטלי, כלומר, מגיש הצעות המחיר לא צריך לכלול קריאייטיב בתגובה להצעת המחיר. מידע נוסף על נכסי קריאייטיב שמתארחים באתר החדשות זמין בכתובת https://support.google.com/admanager/answer/9243220. התכונה הזו לא נתמכת כרגע על ידי מגישי הצעות מחיר ב-RTB.

אתר

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
id	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		מזהה אתר בבורסה לניירות ערך. מומלץ לפי המפרט של OpenRTB.
name	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		שם האתר (ייתכן שיתבצע אנונימיזציה לבקשתו של בעל האתר)
domain	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		הדומיין של האתר, המשמש לחסימה בצד המפרסם. לדוגמה, "foo.com".
cat	לא	מערך מחרוזות	אין תמיכה	2.3 2.4 2.5		מערך של קטגוריות תוכן ב-IAB של האתר. צריך הסברים ב-ContentCategory.
sectioncat	לא	מערך מחרוזות	אין תמיכה	2.3 2.4 2.5		מערך של קטגוריות תוכן ב-IAB שמתארות את הקטע הנוכחי של האתר. צריך הסברים ב-ContentCategory.
pagecat	לא	מערך מחרוזות	אין תמיכה	2.3 2.4 2.5		מערך של קטגוריות תוכן ב-IAB שמתארות את הדף הנוכחי או את התצוגה של האתר. צריך הסברים ב-ContentCategory.
page	לא	מחרוזת	הצעת מחיר.url	2.3 2.4 2.5		כתובת ה-URL של הדף שבו תוצג החשיפה
privacypolicy	לא	בוליאני	אין תמיכה	2.3 2.4 2.5		מציין אם לאתר יש מדיניות פרטיות, כאשר 0 = לא, 1 = כן.
ref	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		כתובת URL של גורם מפנה שגרמה לניווט לדף הנוכחי.
search	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		מחרוזת חיפוש שגרמה לניווט לדף הנוכחי.
publisher	לא	אובייקט Publisher	הצעת מחיר	2.3 2.4 2.5		פרטים על האובייקט Publisher של האתר.
content	לא	אובייקט Content	הצעת מחיר	2.3 2.4 2.5		פרטים על Content באתר.
keywords	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		רשימה של מילות מפתח המופרדות באמצעות פסיקים, לגבי אתר זה. הערה: OpenRTB 2.2 אפשרה מערך של מחרוזות כהטמעה חלופית, אבל היא תוקנה ב-2.3+, וסביר להניח שזו שוב מחרוזת אחת עם תוכן CSV. תאימות לחלק מהבורסות של OpenRTB 2.2 שאימצו את הייצוג החלופי עשויה לחייב טיפול מותאם אישית ב-JSON.
mobile	לא	בוליאני	BidRequest.Mobile.is_mobile_web_optimized	2.3 2.4 2.5		מציין אם האתר תוכנת כדי לבצע אופטימיזציה לפריסה בזמן הצפייה במכשירים ניידים, כאשר 0 = לא, 1 = כן.
ext	לא	אובייקט SiteExt	אין תמיכה	2.3 2.4 2.5		עבור OpenRTB/Protobuf, אפשר לגשת לאובייקט הזה באמצעות מפתח התוסף של [com.google.doubleclick.site] (הנתיב המדויק משתנה בהתאם לשפה המשמשת ליצירת ספריית Proto). עבור OpenRTB/JSON, נכנסים עם השדה ext בהודעה של האתר.

תוסף אתר

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
amp	לא	דף טיפוס AMP	BidRequest.AdSlot .is_amp_page	גם אם מדובר בדף AMP וגם אם לא. השמטה אם היא לא ידועה. DIALECT_HTML = 0; זה אינו דף AMP. DIALECT_HTML_AMP = 1; זהו דף AMP.
page_visibility	לא	מצב Enum חשיפה	BidRequest.page_visible	מצב החשיפה של דף האינטרנט המכיל את משבצת המודעה. למידע נוסף: www.w3.org/TR/page-visible/. VISIBILITY_STATE_UNKNOWN = 0 VISIBILITY_STATE_VISIBLE = 1; הדף גלוי לפחות באופן חלקי. לדוגמה, בכרטיסייה בחזית של חלון ללא מינימום. VISIBILITY_STATE_HIDDEN = 2. הדף לא גלוי למשתמשים. לדוגמה, כשהדף נמצא בכרטיסייה של דפדפן ברקע או בחלון ממוזער.
is_semi_transparent_request	לא	בוליאני	BidRequest.is_semi_transparent_request	מציין שהבקשה משתמשת במיתוג שקוף למחצה - כלומר, רק גרסה חתוכה של כתובת ה-URL תסופק. ההחלטה הזו התקבלה על ידי בעל התוכן הדיגיטלי בכתובת support.google.com/admanager/answer/4584891.
inventorypartnerdomain	לא	מחרוזת	BidRequest.inventorypartnerdomain	הדומיין של השותף (של הבעלים של האפליקציה) עם בעלות על חלק מהמלאי של המודעות באפליקציה. קובץ ads.txt או הקובץ app-ads.txt של השותף יתארח כאן. מידע נוסף זמין בכתובת http://iabtechlab.com/wp-content/uploads/2021/03/ctv-app-ads-explainer-guide.pdf

אפליקציה

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
id	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		מזהה האפליקציה בבורסה לניירות ערך. מומלץ לפי המפרט של OpenRTB.
name	לא	מחרוזת	BidRequest.Mobile.app_name	2.3 2.4 2.5		שם האפליקציה (יכול להיות ככינוי לבקשת בעל התוכן הדיגיטלי)
domain	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		הדומיין של האפליקציה, המשמש לחסימה בצד המפרסם. לדוגמה: "myplay.foo.com".
cat	לא	מערך מחרוזות	BidRequest.Mobile.app_category_ids	2.3 2.4 2.5		הערה: הערכים בשדה הזה מצונזרים עכשיו. מערך של קטגוריות תוכן ב-IAB של האפליקציה. למידע נוסף: ContentCategory
sectioncat	לא	מערך מחרוזות	אין תמיכה	2.3 2.4 2.5		מערך של קטגוריות תוכן ב-IAB שמתארות את הקטע הנוכחי באפליקציה. מידע נוסף זמין בסעיף ContentCategory.
pagecat	לא	מערך מחרוזות	אין תמיכה	2.3 2.4 2.5		מערך של קטגוריות תוכן ב-IAB שמתארות את הדף הנוכחי או את התצוגה המפורטת של האפליקציה. צריך לעבור לקטע enum ContentCategory.
ver	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		גרסת האפליקציה.
bundle	לא	מחרוזת	BidRequest.Mobile.app_id	2.3 2.4 2.5		מזהה אפליקציה ספציפי לפלטפורמה שנועד להיות ייחודי לאפליקציה ואינו תלוי בבורסה לניירות ערך. ב-Android, השם צריך להיות חבילה או שם חבילה (לדוגמה, com.foo.mygames). ב-iOS, זהו מזהה מספרי.
privacypolicy	לא	בוליאני	אין תמיכה	2.3 2.4 2.5		מציין אם לאתר יש מדיניות פרטיות, כאשר 0 = לא, 1 = כן.
paid	לא	בוליאני	אין תמיכה	2.3 2.4 2.5		0 = האפליקציה בחינם, 1 = האפליקציה היא אפליקציה בתשלום.
publisher	לא	אובייקט Publisher	הצעת מחיר	2.3 2.4 2.5		פרטים על האובייקט Publisher של האפליקציה.
content	לא	אובייקט Content	הצעת מחיר	2.3 2.4 2.5		פרטים על Content באפליקציה.
keywords	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		רשימה של מילות מפתח מופרדת בפסיקים של האפליקציה הזו. הערה: OpenRTB 2.2 אפשרה מערך של מחרוזות כהטמעה חלופית, אבל היא תוקנה בגרסה 2.3 ואילך, שבה בטוח שזו מחרוזת יחידה עם תוכן CSV. תאימות לחלק מהבורסות של OpenRTB 2.2 שאימצו את הייצוג החלופי עשויה לחייב טיפול מותאם אישית ב-JSON.
storeurl	לא	מחרוזת	הצעת מחיר.url	2.3 2.4 2.5		כתובת ה-URL מחנות האפליקציות.
ext	לא	אובייקט AppExt	אין תמיכה	2.3 2.4 2.5		עבור OpenRTB/Protobuf, אפשר לגשת לאובייקט הזה באמצעות מפתח התוסף של [com.google.doubleclick.app] (הנתיב המדויק משתנה בהתאם לשפה המשמשת ליצירת ספריית Proto). עבור OpenRTB/JSON, נכנסים אל השדה ext בהודעה של האפליקציה.

אפליקציה

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
installed_sdk	לא	InstalledSdk	BidRequest.Mobile.installed_sdk	זיהוי מידע על SDK שמותקן באפליקציה של בעל האפליקציה, ומידע על המידע הזה. לרוב, מדובר ב-SDK של מגיש הצעות המחיר.
inventorypartnerdomain	לא	מחרוזת	BidRequest.inventorypartnerdomain	הדומיין של השותף (של הבעלים של האפליקציה) עם בעלות על חלק מהמלאי של המודעות באפליקציה. קובץ ads.txt או הקובץ app-ads.txt של השותף יתארח כאן. מידע נוסף זמין בכתובת http://iabtechlab.com/wp-content/uploads/2021/03/ctv-app-ads-explainer-guide.pdf
InstalledSdk
id	כן	מחרוזת	BidRequest.Mobile.InstalledSdk.id	מזהה עבור ה-SDK המותקן.
sdk_version	כן	גרסה	BidRequest.Mobile.InstalledSdk.sdk_version	גרסת ה-SDK המותקנת.
adapter_version	כן	גרסה	BidRequest.Mobile.InstalledSdk.adapter_version	גרסת המתאם שמתקשרת עם ה-SDK המותקן.
גרסה
major	לא	int32	אין תמיכה	ברירת מחדל = 1.
minor	לא	int32	אין תמיכה	ברירת מחדל = 1.
micro	לא	int32	אין תמיכה	ברירת מחדל = 1.

בעל אתר

אובייקט זה מתאר את בעל האתר של המדיה שבה המודעה תוצג. בדרך כלל, המוציא לאור הוא המוכר בעסקת OpenRTB.

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
id	לא	מחרוזת	הצעת מחיר.publisher_id	2.3 2.4 2.5		מזהה בעל אתר ספציפי ל-Exchange כפי שהוגדר בסיומת של קוד בעל האתר של קוד נכס האינטרנט. לדוגמה, pub-123 הוא הקוד של בעל התוכן הדיגיטלי לקוד של נכס האינטרנט ca-pub-123.
name	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		שם המוציא לאור (יכול להיות כינוי לפי בקשת בעל האתר)
cat	לא	מערך מחרוזות	אין תמיכה	2.3 2.4 2.5		מערך של קטגוריות תוכן ב-IAB של האפליקציה. מידע נוסף זמין בכתובת ContentCategory.
domain	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		הדומיין ברמה הגבוהה ביותר של בעל התוכן הדיגיטלי (לדוגמה, 'publisher.com')
ext	לא	אובייקט PublisherExt	אין תמיכה	2.3 2.4 2.5		עבור OpenRTB/Protobuf, אפשר לגשת לאובייקט הזה באמצעות מפתח התוסף של [com.google.doubleclick.publisher] (הנתיב המדויק משתנה בהתאם לשפה המשמשת ליצירת ספריית Proto). עבור OpenRTB/JSON, צריך לגשת באמצעות השדה ext בהודעה של בעל התוכן הדיגיטלי.

בעל תוכן דיגיטלי

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
country	לא	מחרוזת	הצעת מחיר .publisher_country	המדינה בכתובת לחיוב של בעל התוכן הדיגיטלי. המיקום עשוי להיות שונה מהמדינה שצוינה של המשתמש ב-geo_criteria_id או במדינה המארחת של האתר. אפשר גם לעיין ברשימה המלאה של קודי מדינות.
host_publisher_id	לא	מחרוזת	הצעת מחיר.host_publisher_id	המזהה של המוציא לאור המארח. אם השדה מאוכלס, סימן שבעל האפליקציה המארח השתתף בחלוקת הכנסות ושאפשר להשתמש במזהה כדי לאשר את הקובץ ads.txt.

Content

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
id	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		המזהה הייחודי של התוכן.
episode	לא	int32	אין תמיכה	2.3 2.4 2.5		המספר של פרק התוכן (בדרך כלל חל על תוכן הסרטון).
title	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		כותרת התוכן. דוגמאות לסרטונים: 'וועדת החיפוש' (טלוויזיה), 'תקווה חדשה' (סרט) או 'משחק סיום' (מיועד לאינטרנט). דוגמה לשימוש שאינו וידאו: "למה קרחון אנטרקטי נמס כל כך מהר" (מאמר מגזין)
series	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		סדרת תוכן. דוגמאות לסרטונים: "המשרד" (טלוויזיה), "מלחמת הכוכבים" (סרט) או "ארב 'N' צ'יף" (עשוי באינטרנט). דוגמה לתוכן שאינו וידאו: "אקוסטי" (בלוג מגזין הזמן)
season	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		עונת התוכן. בדרך כלל מדובר בתוכן וידאו (לדוגמה, "עונה 3").
artist	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		האומן זוכה בתוכן
genre	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		ז'אנר שמתאר בצורה הטובה ביותר את התוכן (לדוגמה: רוק, פופ וכו').
album	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		האלבום שאליו התוכן שייך. בדרך כלל לאודיו.
isrc	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		קוד הקלטה סטנדרטי בינלאומי שתואם לתקן ISO-3901.
url	לא	מחרוזת	(App.content) BidRequest.url	2.3 2.4 2.5		כתובת ה-URL של התוכן, לצורך הקשר או בדיקה בצד הרכישה.
cat	לא	מערך מחרוזות	אין תמיכה	2.3 2.4 2.5		מערך של קטגוריות תוכן ב-IAB שמתארות את התוכן. למידע נוסף: ContentCategory.
prodq	לא	איכות ההפקה	אין תמיכה	2.4 2.5		איכות ההפקה.
keywords	לא		אין תמיכה	2.3 2.4 2.5		רשימה של מילות מפתח המופרדות בפסיקים, שמתארות את התוכן. הערה: OpenRTB 2.2 אפשרה מערך של מחרוזות כהטמעה חלופית, אבל הבעיה תוקנה בגרסה 2.3 ואילך, שבה אין ספק שזו מחרוזת אחת עם תוכן CSV. כדי לשמור על תאימות לחלק מהבורסות של OpenRTB 2.2 שאימצו את הייצוג החלופי, ייתכן שיהיה צורך בטיפול מותאם אישית בקובץ ה-JSON.
contentrating	לא	מחרוזת	BidRequest.זיהוי_content_label 39: "DV_G", 40: "DV_PG", 41: "DV_T", 42: "DV_MA", 43: "DV_UNRATED"	2.3 2.4 2.5		הערה: הערכים בשדה הזה מצונזרים עכשיו. סיווג תוכן (לדוגמה, MPAA).
userrating	לא	מחרוזת	(האפליקציה App.content בלבד) BidRequest.Mobile.app_rating	2.3 2.4 2.5		דירוג המשתמשים של התוכן (לדוגמה: מספר כוכבים, לייקים וכו').
context	לא	הקשר תוכן	אין תמיכה	2.3 2.4 2.5		סוג התוכן (משחק, וידאו, טקסט וכו').
context_22	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		OpenRTB <= 2.2 תאימות. יש להשתמש בהקשר ל-2.3 ואילך.
livestream	לא	בוליאני	BidRequest.Video.is_livestream	2.3 2.4 2.5		0 = לא בשידור חי, 1 = התוכן פעיל (לדוגמה, סטרימינג, בלוג בשידור חי).
sourcerelationship	לא	בוליאני	אין תמיכה	2.3 2.4 2.5		0 = עקיף, 1 = ישיר.
producer	לא	מחרוזת	הצעת מחיר.וידאו	2.3 2.4 2.5		פרטים על המפיק התוכן.
len	לא	int32	BidRequest.Video.Contentמאפיינים.duration_seconds	2.3 2.4 2.5		אורך התוכן בשניות. מתאים לסרטון או לאודיו.
qagmediarating	לא	סיווג QAGMediaRating	אין תמיכה	2.3 2.4 2.5		דירוג מדיה לפי הנחיות QAG.
embeddable	לא	בוליאני	אין תמיכה	2.3 2.4 2.5		אינדיקטור שמציין אם התוכן ניתן להטמעה (לדוגמה, נגן וידאו ניתן להטמעה), כאשר 0 = לא, 1 = כן.
language	לא	מחרוזת	BidRequest.זיהוי_language	2.3 2.4 2.5		שפת התוכן בפורמט ISO-639-1-alpha-2.

Producer

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
id	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		מזהה מפיק תוכן או יוצר. אפשרות זו שימושית אם התוכן מופץ בסינדיקציה, ואפשר לפרסם אותו באתר באמצעות תגי הטמעה.
name	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		שם מפיק התוכן או יוצר התוכן (לדוגמה, "אחים לוהטים").
cat	לא	מערך מחרוזות	אין תמיכה	2.3 2.4 2.5		מערך של קטגוריות תוכן ב-IAB שמתארות את מפיק התוכן. צריך לעיין ב-enum ContentCategory.
domain	לא	מחרוזת	BidRequest.video.description_url	2.3 2.4 2.5		הדומיין ברמה הגבוהה ביותר של מפיק התוכן (לדוגמה, Producer.com).

מכשיר

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
dnt	לא	בוליאני	לא נתמך. אפשר להיעזר במדריך לקובצי cookie, google_error=1:	2.3 2.4 2.5		האפשרות הרגילה 'לא לעקוב (DNT)' מוגדרת בכותרת בדפדפן. במקרים כאלה, 0 = המעקב לא מוגבל 1 = לא לעקוב. מומלץ לפי המפרט של OpenRTB.
ua	לא	מחרוזת	BidRequest.user_agent	2.3 2.4 2.5		מחרוזת הסוכן המשתמש של הדפדפן. מומלץ לפי המפרט של OpenRTB.
ip	לא	מחרוזת	BidRequest.ip (קיצור של AdX ל-3 הערכים הראשונים; OpenRTB הוא "X.X.X.0")	2.3 2.4 2.5		כתובת ה-IPv4 הקרובה ביותר למכשיר. מומלץ לפי המפרט של OpenRTB
geo	לא	אובייקט Geo	הצעת מחיר	2.3 2.4 2.5		מיקום המכשיר שנחשב כמיקום הנוכחי של המשתמש, שהוגדר על ידי אובייקט Geo. מומלץ לפי המפרט של OpenRTB.
didsha1	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		מזהה מכשיר בחומרה (לדוגמה, IMEI); הנתונים מגובבים באמצעות SHA1.
didmd5	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		מזהה מכשיר בחומרה (לדוגמה, IMEI); הגיבוב בוצע באמצעות MD5.
dpidsha1	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		מזהה מכשיר בפלטפורמה (לדוגמה, מזהה Android); הנתונים מגובבים באמצעות SHA1
dpidmd5	לא	מחרוזת	BidRequest.Mobile.hashed_idfa – בינארי הוא בינארי, OpenRTB הוא base16 (הקסדצימלי של אותיות קטנות) זוהי הגרסה המגובבת של ifa. אפשר להשתמש ב-dpidmd5 או ב-if בהתאם לגרסת ה-SDK לנייד.	2.3 2.4 2.5		מזהה מכשיר בפלטפורמה (לדוגמה, מזהה Android); הנתונים מגובבים באמצעות MD5.
ipv6	לא	מחרוזת	BidRequest.ip - AdX יקוצר ל-6 התווים הראשונים; OpenRTB היא "X:X:X:::::"	2.3 2.4 2.5		כתובת ה-IPv6 הקרובה ביותר למכשיר.
carrier	לא	מחרוזת	BidRequest.Device.carrier_id מזהים יהיו אותם מזהי קריטריונים כמו בפרוטוקול Authorized Buyers, עיינו ברשימת ספקי חבילות הסלולר.	2.3 2.4 2.5		ספק או ספק אינטרנט (לדוגמה, 'VERIZON'), כאשר יש להשתמש בשמות מחרוזת של אוסף שצריכים להתפרסם במגישי הצעות המחיר.
language	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		שפת הדפדפן באמצעות ISO-639-1-alpha-2.
make	לא	מחרוזת	BidRequest.Device.brand	2.3 2.4 2.5		יצרן המכשיר (לדוגמה, "Apple").
model	לא	מחרוזת	BidRequest .deviceדגם	2.3 2.4 2.5		דגם המכשיר (לדוגמה, "iPhone")
os	לא	מחרוזת	BidRequest.Device.platform	2.3 2.4 2.5		מערכת ההפעלה של המכשיר (לדוגמה, "iOS")
osv	לא	מחרוזת	BidRequest.Device.os_version	2.3 2.4 2.5		גרסת מערכת הפעלה במכשיר
hwv	לא	מחרוזת	BidRequest.Device.hardware_version	2.3 2.4 2.5		גרסת החומרה של המכשיר (לדוגמה, "5S" ל-iPhone 5S)
w	לא	int32	BidRequest.Device.screen_width	2.3 2.4 2.5		הרוחב הפיזי של המסך בפיקסלים.
h	לא	int32	הצעת מחיר.מכשיר.screen_height	2.3 2.4 2.5		הגובה הפיזי של המסך בפיקסלים.
ppi	לא	int32	אין תמיכה	2.3 2.4 2.5		גודל המסך כפיקסלים לאינץ' לינארי.
pxratio	לא	כפולה	BidRequest.Device.screen_pixel_ratio_millis / 1,000	2.3 2.4 2.5		היחס בין פיקסלים פיזיים לפיקסלים בלתי תלויים במכשיר.
js	לא	בוליאני	אין תמיכה	2.3 2.4 2.5		תמיכה ב-JavaScript, כאשר 0 = לא, 1 = כן.
geofetch	לא	בוליאני	אין תמיכה	2.4 2.5		מציינת אם ה-API של מיקום גיאוגרפי יהיה זמין לקוד JavaScript פועל בבאנר, כאשר 0 = לא, 1 = כן.
connectiontype	לא	סוג החיבור	אין תמיכה	2.3 2.4 2.5		סוג החיבור לרשת
devicetype	לא	סוג המכשיר	BidRequest.Device.device_type	2.3 2.4 2.5		הסוג הכללי של המכשיר.
flashver	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		גרסת Flash שנתמכת על ידי הדפדפן.
ifa	לא	מחרוזת	BidRequest.Mobile.Advertising_id – AdX הוא בינארי, OpenRTB הוא 36 תווים UUID (מזהה Android: הכול באותיות קטנות, IDFA: כל האותיות גדולות). ifa הוא מזהה Android או IDFA של Apple ו-dpidmd5 או ifa זמין בהתאם לגרסת ה-SDK לנייד.	2.3 2.4 2.5		סנקציות שהוצבו לשימוש של המפרסמים באופן ברור (לדוגמה, לא מגובבות).
macsha1	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		כתובת ה-MAC של המכשיר, מגובבת באמצעות SHA1.
macmd5	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		כתובת ה-MAC של המכשיר, מגובבת באמצעות MD5
lmt	לא	בוליאני	BidRequest.Device.limit_ad_tracking	2.3 2.4 2.5		"הגבל מעקב מודעות" הוא אות שנתמך באופן מסחרי על סמך מערכת ההפעלה או הגדרות המכשיר, כאשר false מציין שהמעקב אינו מוגבל ו-true מציין שהמעקב חייב להיות מוגבל על פי הנחיות מסחריות. האות הזה משקף את ההחלטות של המשתמשים בפלטפורמות, כולל שקיפות מעקב אחר אפליקציות ב-iOS. למידע נוסף, ראו הנחיות ל-LMt ולמעקב אחר אפליקציות ומזהה פרסום ב-Android.
mccmnc	לא	מחרוזת	אין תמיכה	2.5		ספק הסלולר כקוד שרשור של MCC-MNC (לדוגמה, ' 310-005' מזהה את Verizon Wireless CDMA בארה"ב). דוגמאות נוספות זמינות בכתובת https://en.wikipedia.org/wiki/Mobile_country_code. שימו לב שהמקף בין חשבון הניהול (MCC) לחלקי ה-MNC נדרש כדי להסיר את עמימות הניתוח.
ext	לא	אובייקט DeviceExt	אין תמיכה	2.3 2.4 2.5		עבור OpenRTB/Protobuf, אפשר לגשת לאובייקט הזה באמצעות מפתח התוסף של [com.google.doubleclick.device] (הנתיב המדויק משתנה בהתאם לשפה המשמשת ליצירת ספריית Proto). עבור OpenRTB/JSON, נכנסים עם השדה ext בהודעה של המכשיר.

תוסף מכשיר

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
session_id	לא	מחרוזת	BidRequest.session_id	מייצגת סשן של משתמש לטווח קצר במכשירי CTV/OTT, עם משך ביקור מקסימלי של 6 שעות. השימוש ב-session_id לעולם אינו מותר להתאמה אישית של מודעות. יש להשתמש ב-session_id רק עבור מכסת תדירות, החרגות תחרותיות או למטרות קשורות. השדה הזה מאוכלס באלפבית בסיסי בגרסה 64 של האתר.
atts	לא	int32	BidRequest.Device.app_tracking_authorization_status	(iOS בלבד) מספר שלם שהועבר כדי לייצג את סטטוס ההרשאה למעקב אחר אפליקציה של האפליקציה, כאשר 0 = לא נקבע 1 = מוגבל 2 = נדחה 3 = הרשאה. הערך הזה מאוחזר מ-ATTrackingManager ומסופק כפי שהוא. מידע נוסף על סטטוס ההרשאה למעקב אחר אפליקציות ב-iOS מפורט במאמר הזה.
user_agent_data	לא	אובייקט UserAgent	BidRequest.user_agent_data	מידע על סוכן משתמש.

סוכן משתמש

מידע על סוכן משתמש. שדה זה יאוכלס במידע על סוכן המשתמש, שחולץ מהכותרת User-Agent או מכותרות Sec-CH-UA.

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
browser	לא	אובייקט BrandVersion	BidRequest.user_agent_data.browser	מזהה את הדפדפן.
platform	לא	אובייקט BrandVersion	BidRequest.user_agent_data.platform	מזהה את הפלטפורמה.
mobile	לא	בוליאני	BidRequest.user_agent_data.mobile	הערך הוא True אם הנציג מעדיף תוכן מותאם לניידים. לקבלת מידע ספציפי על המכשיר, עיין בשדה BidRequest.device . הערך עשוי להיות שונה מהשדה הזה (לדוגמה, דפדפן של טלפון נייד יכול לבקש 'אתר למחשב').
architecture	לא	מחרוזת	BidRequest.user_agent_data.architecture	ארכיטקטורת המכשיר, לדוגמה, "x86" או "arm".
bitness	לא	מחרוזת	BidRequest.user_agent_data.bitness	קצב העברת הנתונים של המכשיר, לדוגמה, "64" עבור ארכיטקטורת 64 סיביות.
model	לא	מחרוזת	BidRequest.user_agent_data.model	דגם המכשיר.

אובייקט BrandVersion

שפע של (מותג, גרסה) של הדפדפן או הפלטפורמה.

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
brand	לא	מחרוזת	BidRequest.user_agent_data.brand	מזהה מותג, למשל "Chrome" או "Windows".
version	לא	מחרוזת	BidRequest.user_agent_data.version	גרסה, מפוצלת ברכיבים לפי הצורך, לדוגמה, {"85", "1"} = v85.1.

גיאוגרפי

אובייקט זה כולל שיטות שונות לציון מיקום גיאוגרפי. כשמשויכים לאובייקט Device, הערך מציין את המיקום של המכשיר, שאפשר לפרש אותו גם כמיקום הנוכחי של המשתמש. כשמשנה את האובייקט של User, הוא מציין את המיקום של בסיס הבית של המשתמש (לדוגמה, לא בהכרח את המיקום הנוכחי). יש להעביר את המאפיינים lat/lon רק אם הם תואמים לדיוק שצוין במאפיין הסוג. לדוגמה, אין להעביר את המרכז של אזור גיאוגרפי, כמו מיקוד.

בהטמעה של Google על ידי OpenRTB, המערכת מעריכה את המיקום הגיאוגרפי המשוער לפי כתובת ה-IP של המכשיר שממנו נשלחה הבקשה להצגת מודעה. הבקשה הזו תכלול בדרך כלל את המידע הזה, אבל לא תמיד, ו-lat/lon מייצג את הנקודה המרכזית של עיגול, שבו הרדיוס הוא accuracy. למידע נוסף על מיקום גיאוגרפי, קראו את המדריך לטירגוט גיאוגרפי.

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
lat	לא	כפולה	BidRequest.[encoded_]hyperlocal_set. center_point.width	2.3 2.4 2.5		קו רוחב מ- -90.0 עד +90.0, כאשר דרום הוא שלילי.
lon	לא	כפולה	BidRequest.[encrypt_]hyperlocal_set.center_point.length	2.3 2.4 2.5		קו אורך מ-180.0 עד +180.0, שבו הנקודה השלילית היא מערב.
country	לא	מחרוזת	הצעת מחיר.geo_criteria_id דרך geo-table.csv	2.3 2.4 2.5		מדינה באמצעות ISO-3166-1 Alpha-3.
region	לא	מחרוזת	הצעת מחיר.geo_criteria_id דרך geo-table.csv	2.3 2.4 2.5		קוד אזור באמצעות ISO-3166-2; קוד מדינה בן 2 אותיות אם הוא בארה"ב.
regionfips104	לא	מחרוזת		2.3 2.4 2.5		אזור במדינה עם סימון FIPS 10-4. למרות ש-OpenRTB תומך במאפיין הזה, הוא נסגר על ידי NIST ב-2008.
metro	לא	מחרוזת	הצעת מחיר.geo_criteria_id דרך geo-table.csv, ערים-dma-regions.csv	2.3 2.4 2.5		קוד מטרופולין של Google; דומה, אך לא מדויק, DMAs של Nielsen. קישור לקודים זמין בדף טירגוט גיאוגרפי.
city	לא	מחרוזת	הצעת מחיר.geo_criteria_id דרך geo-table.csv	2.3 2.4 2.5		עיר בשימוש בקוד האומות המאוחדות למיקומים של תחבורה ומסחר בפורמט "city": "San Antonio".למידע על הקודים, יש לעיין בנספח א'.
zip	לא	מחרוזת	BidRequest.postal_code BidRequest.postal_code_prefix	2.3 2.4 2.5		מיקוד.
type	לא	סוג מיקום		2.3 2.4 2.5		מקור נתוני המיקום. מומלץ להעביר את קו הרוחב/אורך.
accuracy	לא	int32	אין תמיכה	2.4 2.5		דיוק המיקום המשוער במטרים. מומלץ לעשות זאת כשקו הרוחב/קו הרוחב נקבע ונגזר משירותי המיקום של המכשיר (לדוגמה, סוג = 1). חשוב לזכור שזה הדיוק כפי שדווח במכשיר. יש לחפש מסמכים ספציפיים ל-OS (למשל, Android או iOS) לקבלת פרשנות מדויקת. Google: הרדיוס במטרים של עיגול שבו משוער המיקום של מכשיר, שבו נקודת המרכז מוגדרת כ-lat/lon. השדה הזה מאוכלס על סמך מיקום גיאוגרפי משוער מבוסס-IP.
lastfix	לא	int32	אין תמיכה	2.4 2.5		מספר השניות שעברו מאז שתיקון המיקום הגיאוגרפי נקבע. הערה: מכשירים עשויים לשמור את נתוני המיקום במטמון מרובות של אחזורים. באופן אידיאלי, הערך הזה צריך להיות נכון למועד ביצוע התיקון בפועל.
ipservice	לא	שירות מיקום	אין תמיכה	2.4 2.5		השירות או הספק ששימש לקביעת המיקום הגיאוגרפי לפי כתובת ה-IP אם רלוונטי (לדוגמה, סוג = 2).
utcoffset	לא	int32	RequestRequest.timezone_offset	2.3 2.4 2.5		זמן מקומי כמספר +/- דקות מ-UTC.

משתמש

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
id	לא	מחרוזת	BidRequest.[constrained_usage_]google_user_id	2.3 2.4 2.5		מזהה ספציפי ל-Exchange עבור המשתמש. מומלץ לבחור לפחות אחד מתוך id או buyerid
buyeruid	לא	מחרוזת	BidRequest.[constrained_usage_]hosted_match_data – AdX הוא בינארי, OpenRTB הוא websafe base64 (ללא מרווח פנימי)	2.3 2.4 2.5		מזהה ספציפי לקונה עבור המשתמש כפי שממופה על ידי הבורסה של הקונה. מומלץ לבחור לפחות אחד מ-buyerid או id.
gender	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		מגדר כ-"M" זכר, "F" נקבה, "O" אחר. (הסימן 'null' לא ידוע)
keywords	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		רשימה של מילות מפתח, תחומי עניין או כוונת רכישה המופרדים בפסיקים. הערה: OpenRTB 2.2 אפשרה מערך של מחרוזות כהטמעה חלופית, אבל היא תוקנה ב-2.3+, וסביר להניח שזו שוב מחרוזת אחת עם תוכן CSV. תאימות לחלק מהבורסות של OpenRTB 2.2 שאימצו את הייצוג החלופי עשויה לחייב טיפול מותאם אישית ב-JSON.
customdata	לא	מחרוזת	BidRequest.[constrained_usage_]hosted_match_data – AdX הוא בינארי, OpenRTB הוא websafe base64 (ללא מרווח פנימי)	2.3 2.4 2.5		תכונה אופציונלית להעברת נתוני מגיש הצעות המחיר בקובץ cookie של הבורסה. המחרוזת חייבת להיות באורך של תווים בטוחים בפורמט cookie85 ובפורמט כלשהו. יש להשתמש בקידוד JSON תקין כדי לכלול מירכאות שמסומנות בתו בריחה (escape).
geo	לא	אובייקט Geo	אין תמיכה	2.3 2.4 2.5		מיקום בסיס הבית של המשתמש שהוגדר באמצעות אובייקט Geo. זהו לא בהכרח המיקום הנוכחי שלהם.
data	לא	מערך של Data אובייקטים	BidRequest.זיהוי_vertical	2.3 2.4 2.5		הערה: הערכים בשדה הזה מצונזרים עכשיו. נתונים נוספים. כל אובייקט Data מייצג מקור נתונים אחר. segment.id מפנה לקטגוריה שזוהתה בבורסה. segment.value מייצג את המשקל של הקטגוריה שזוהתה, בעוד שמשקל גבוה יותר מצביע על כך שהדף רלוונטי יותר לענף שזוהה.
ext	לא	אובייקט UserExt	אין תמיכה	2.3 2.4 2.5		עבור OpenRTB/Protobuf, אפשר לגשת לאובייקט הזה באמצעות מפתח התוסף של [com.google.doubleclick.user] (הנתיב המדויק משתנה בהתאם לשפה המשמשת ליצירת ספריית Proto). עבור OpenRTB/JSON, נכנסים עם השדה ext בהודעת המשתמש.

UserExt

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
consented_providers_settings	לא	אובייקט ConsentedProvidersSettings	BidRequest.AdSlot.consented_providers_settings	מידע לגבי ספקי טכנולוגיות הפרסום שבעל האפליקציה ציין ב-Google שהמשתמש שלו ב-EEA הסכים לשימוש במידע האישי שלו לצורך התאמה אישית של מודעות בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי. השדה הזה יאוכלס רק כש-RegsExt.gdpr נכון.
consent	לא	מחרוזת	BidRequest.AdSlot.ConsentedProvidersSettings.tcf_consent_string	המחרוזת של Web Transparency & Consent Framework ( TCF – מסגרת השקיפות וההסכמה) מגרסה 24 של IAB, עם קידוד אינטרנט בטוח, שאוחזרה מפלטפורמת IAB לניהול הסכמה (CMP) של בעל התוכן הדיגיטלי. מבנה המחרוזת מוגדר על ידי TCF גרסה 2 של IAB. השדה הזה יאוכלס אם בעל התוכן הדיגיטלי שילב את CMP עבור TCF גרסה 2, וה-CMP מציין ש-GDPR חל על הבקשה הזו למודעה ומספק מחרוזת הסכמה חוקית. במאמר הזה מפורט מידע נוסף על השילוב של Google TCF בגרסה 2. רשימת הספקים הגלובלית של IAB זמינה בכתובת vendor-list.consensu.org/v2/vendor-list.json כדי לקבל פרטים על הספקים שרשומים במחרוזת ההסכמה.
eids	לא	מערך של ExtendedId אובייקטים	BidRequest.AdSlot.secure_signals	תוסף סטנדרטי המשמש להעברת אותות מאובטחים שנבחרו על ידי בעל התוכן הדיגיטלי.

הגדרות של בעלים הביעו הסכמה

מידע לגבי ספקי טכנולוגיות הפרסום שעבורם בעלי התוכן הדיגיטלי ציינו ב-Google שהמשתמשים ב-EEA הביעו הסכמה לשימוש במידע האישי שלהם לצורך התאמה אישית של מודעות בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי. השדה הזה יאוכלס רק כש-RegsExt.gdpr נכון.

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
consented_providers	לא	מערך של int64	BidRequest.AdSlot.consented_providers	קבוצה של מזהים התואמים לספקי טכנולוגיית פרסום (ATP) שעבורם בעל התוכן הדיגיטלי ציין ל-Google שהמשתמשים שלו באזור הכלכלי האירופי נתנו את הסכמתם החוקית: 1) להשתמש בקובצי cookie או באחסון מקומי אחר, היכן שהדבר נדרש על פי חוק, 2) איסוף ושיתוף של מידע אישי ושימוש בו לצורך התאמה אישית של מודעות על ידי ספק טכנולוגיית פרסום, בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי. אם בעל התוכן הדיגיטלי משתמש בגרסה 2 של Transparency and Consent Framework (TCF - מסגרת השקיפות וההסכמה) של IAB כדי לנהל את הסכמת המשתמשים, זוהי הקבוצה של ספקי טכנולוגיית הפרסום שהביעו הסכמה באמצעות המחרוזת בנושא הסכמה (למידע נוסף על סטטוס ההסכמה הנוספת של Google), ניתן לעיין במאמר הזה). ספקי טכנולוגיית פרסום שהסכימו באמצעות מחרוזת ההסכמה של TCF בגרסה 2 מוצגים בשדה UserExt.consent. מיפוי של מזהה ATP לשם ATP פורסם ב-providers.csv.

מזהה מורחב

האותות המאובטחים הועברו על ידי בעל התוכן הדיגיטלי.

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
source	לא	מחרוזת	BidRequest.AdSlot.SecureSignal.source	המקור (ספק) של האות.
uids	לא	מערך עם אובייקט ExtendedIdUid אחד	ללא	האות המאובטח.

מזהה מורחב

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
id	לא	מחרוזת	BidRequest.AdSlot.SecureSignal.data	האות המאובטח.

נתונים

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

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
id	לא	מחרוזת	נתמך	2.3 2.4 2.5		מזהה ספציפי ל-Exchange של ספק הנתונים.
name	לא	מחרוזת	נתמך	2.3 2.4 2.5		שם ספציפי Exchange עבור ספק הנתונים.
segment		מערך של Segment אובייקטים	נתמך	2.3 2.4 2.5		מערך של Segment אובייקטים שמכילים את ערכי הנתונים בפועל.

פילוח

האובייקטים data ו-segment יחד מאפשרים לציין נתונים הקשריים נוספים. הנתונים האלה יכולים להגיע מכמה מקורות, למשל מהבורה עצמה או מספקי צד שלישי, כפי שמצוין בשדה id. בקשה להצעת מחיר יכולה לשלב בין Data אובייקטים ממספר ספקים. ספקי הנתונים הספציפיים שנמצאים בשימוש צריכים להתפרסם על ידי בורסה למגישי הצעות המחיר שלהם.

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
id	לא	מחרוזת	נתמך	2.3 2.4 2.5		המזהה של פלח הנתונים הספציפי לספק הנתונים.
name	לא	מחרוזת	נתמך	2.3 2.4 2.5		השם של פלח הנתונים הספציפי לספק הנתונים.
value		מחרוזת	נתמך	2.3 2.4 2.5		ייצוג מחרוזת של הערך של פלח הנתונים.

Reg

האובייקט מכיל תקנות משפטיות, ממשלתיות או מקצועיות החלות על הבקשה. האפשרות coppa מציינת אם הבקשה עומדת בתקנות של ועדת הסחר הפדרלית של ארה"ב של ארה"ב (COPPA) ("COPPA"). למידע נוסף, ראו סעיף 7.1.

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
coppa	לא	מחרוזת	RequestRequest.user_data_handling / TAG_FOR_CHILD_DIRECTED_TREATMENT	2.3 2.4 2.5		האפשרות הזו מציינת אם הבקשה הזו כפופה לתקנות COPPA שנקבעו על ידי ה-FTC בארה"ב, כאשר 0 = לא, 1 = כן.
ext	לא	אובייקט RegsExt	אין תמיכה	2.3 2.4 2.5		עבור OpenRTB/Protobuf, אפשר לגשת לאובייקט הזה באמצעות מפתח התוסף של [com.google.doubleclick.regs] (הנתיב המדויק משתנה בהתאם לשפה המשמשת ליצירת ספריית Proto). עבור OpenRTB/JSON, צריך לגשת אל השדה ext שבהודעת ה-Regs.

ביטוי רגולרי (regex)

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
gdpr	לא	בוליאני	BidRequest.AdSlot.regs_gdpr	השדה הזה יוגדר כ-True בשני המקרים הבאים: Google מקבלת מחרוזת Transparency & Consent Framework ( TCF) של מסגרת השקיפות וההסכמה (TCF) של גרסה 2, והפלטפורמה לניהול הסכמה מציינת ש-GDPR חל על הבקשה הזו להצגת מודעות. Google לא מקבלת מחרוזת הסכמה של TCF בגרסה 2 של IAB. על סמך המידע שזמין ל-Google, החשיפה הזו תוצג למשתמשים ב-EEA. הוא לא נחשב להנחיה משפטית בנוגע ל-GDPR.
lgpd	לא	בוליאני	BidRequest.AdSlot.regs_lgpd	השדה הזה יוגדר כ-true כאשר, על סמך מידע שזמין ל-Google, החשיפה הזו תוצג למשתמש בברזיל. בכתובת https://storage.googleapis.com/adx-rtb-dictionaries/lgpd-providers.csv מופיעה רשימה של ספקי טכנולוגיות הפרסום שמורשים להציג מודעות בבקשות ל-LGPD-enforced. מידע נוסף על LGPD זמין במאמר הזה.

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

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

תשובה

האובייקט הזה הוא אובייקט התגובה להצעת מחיר ברמה העליונה (לדוגמה, אובייקט JSON חיצוני ללא שם). המאפיין id משקף את המזהה של הבקשה להצעת מחיר למטרות רישום ביומן. באופן דומה, bidid הוא מזהה לצורכי מעקב אופציונלי של מגישי הצעות מחיר. אם תציינו זאת, תוכלו לכלול את המידע הזה בתגובה להודעה על הזכייה. יש צורך באובייקט seatbid לפחות, שכולל לפחות הצעת מחיר אחת לכל חשיפה. מאפיינים אחרים הם אופציונליים. כדי להביע "ללא הצעת מחיר", צריך להחזיר תגובה ריקה עם HTTP 204. לחלופין, אם מגיש הצעות המחיר רוצה להעביר ל-Exchange את הסיבה לאי בידינג, תישלח רק אובייקט BidResponse עם קוד סיבה במאפיין nbr.

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
id	כן	מחרוזת	לא ממופה לאף שדה, אבל מאומת מול BidRequest.id.	2.3 2.4 2.5		המזהה של הבקשה להצעת המחיר שאליה מתייחסת התגובה. נדרש על ידי המפרט של OpenRTB.
seatbid	לא	מערך של Seatbid אובייקטים	BidResponse.Ad	2.3 2.4 2.5		מערך של Seatbid אובייקטים. צריך להוסיף פריט אחד או יותר אם יש להגיש הצעת מחיר.
bidid	לא	מחרוזת	BidResponse.debug_string	2.3 2.4 2.5		מזהה הבידינג נוצר על ידי מגיש הצעות המחיר כדי לעזור במעקב ובמעקב.
cur	לא	מחרוזת	BidResponse.Ad.AdSlot.currency	2.3 2.4 2.5		מטבע הצעת מחיר באמצעות קודי ISO 4217 אלפא. אם השדה הזה יאוכלס, המטבע שצוין ישמש לפענוח הצעת המחיר. אחרת, ייעשה שימוש במטבע ברירת המחדל לבידינג, שנקבע לפי סדר העדיפויות הבא: המטבע ברמת מגיש הצעות המחיר, אם הוגדר בהגדרות חשבון RTB. המטבע ברמת הקונה. הקונה יחושב לפי מזהה החיוב שצוין בשדה BidResponse.seatbid.bid.ext.billing_id של התוסף, אם הוא מאוכלס. אם הוא לא מבוסס על מזהה החיוב היחיד שנשלח בבקשת הצעת המחיר. המטבע שמוגדר בחשבון הקונה מוגדר בעת יצירת החשבון. כדי לבדוק את המטבע, אפשר לפנות למנהל החשבון הטכני.
customdata	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		תכונה אופציונלית שמאפשרת למגיש הצעות המחיר להגדיר נתונים בקובץ ה-cookie של ה-Exchange. המחרוזת חייבת להיות כתובה בתווים בטוחים מסוג cookie85 ובפורמט כלשהו. יש להשתמש בקידוד תקין של JSON כדי לכלול מירכאות שמסומנות בתו בריחה (escape).
nbr	לא	הסיבה להצעת המחיר	אין תמיכה	2.3 2.4 2.5		הסיבה לאי-הגשת הצעות המחיר.
ext	לא	אובייקט BidResponseExt	אין תמיכה	2.3 2.4 2.5		עבור OpenRTB/Protobuf, אפשר לגשת לאובייקט הזה באמצעות מפתח התוסף של [com.google.doubleclick.bid_response] (הנתיב המדויק משתנה בהתאם לשפה המשמשת ליצירת ספריית Proto). עבור OpenRTB/JSON, צריך לגשת באמצעות השדה ext בהודעה BidResponse.

BidResponseExt

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
processing_time_ms	לא	int32	BidResponse.processing_time_ms	הגדרת זמן ההמתנה באלפיות שנייה מהרגע שבו קיבלת את הבקשה ועד להחזרת התשובה.

ממשק ישיבה

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
bid	לא	מערך של Bid אובייקטים	BidResponse.Ad	2.3 2.4 2.5		מערך של יותר מ-Bid אובייקטים שקשור לכל חשיפה. הצעות מחיר מרובות יכולות להתייחס לאותה הופעה.
seat	לא	מחרוזת	BidResponse.Ad. AdSlot.buyer_reporting_id	2.3 2.4 2.5		מזהה של מושב הקונה (לדוגמה, מפרסם, סוכנות) שמטעמה הצעת המחיר הזו מוגשת.
group	לא	בוליאני	אין תמיכה	2.3 2.4 2.5		אפשר לזכות ב-0 = חשיפות בנפרד, ובתור 1 = להשיג חשיפות או לאבד אותן כקבוצה. ברירת מחדל = false

הצעת מחיר

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	נתמך		פרטי ההטמעה
				בגרסה	מאת Google
id	כן	מחרוזת	לא ממופה לאף שדה, אבל מאומת מול BidRequest.id.	2.3 2.4 2.5		המזהה של הבקשה להצעת המחיר שאליה מתייחסת התגובה. נדרש על ידי המפרט של OpenRTB.
impid	כן	מחרוזת	BidResponse.Ad.AdSlot.id	2.3 2.4 2.5		המזהה של אובייקט Imp בבקשת הצעת המחיר הקשורה. נדרש על ידי המפרט של OpenRTB.
price	כן	כפולה	BidResponse.Ad.AdSlot.max_CPM _micros * 1,000,000	2.3 2.4 2.5		המחיר בהצעת המחיר הוא עלות לאלף חשיפות, אבל העסקה בפועל היא עבור חשיפה של יחידה בלבד. שימו לב: הסוג הזה מציין צף, אבל מומלץ מאוד להשתמש במתמטיקה שלמים בעת טיפול במטבעות (לדוגמה, BigDecimal ב-Java). נדרש על ידי המפרט של OpenRTB.
adid	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		המזהה של מודעה שנטענה מראש ומוצגת אם הצעת המחיר זוכה.
nurl	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		זכייה בכתובת ה-URL של ההודעה על ידי ה-Exchange על ידי הבורסה אם הצעת המחיר זוכה; אפשרויות אופציונליות להצגת תגי עיצוב של מודעות. DoubleClick לא תומך בהודעות זכייה. השתמש ב-%%WINNING_PRICE%% בכתובת האתר של הופעות קטע הקוד, או ב-${AUCTION_PRICE}.
adm	לא	מחרוזת	BidResponse.Ad.html_snippet, BidResponse.Ad.video_url, BidResponse.Ad.video_vast_xml או BidResponse.Ad.native_ad	2.3 2.4 2.5		אמצעים אופציונליים להעברת תגי עיצוב של מודעות במקרה שהצעת המחיר זוכה; תחליף את הודעת הזכייה אם שני התגים כלולים בשניהם. כשמדובר בהצעות מחיר למודעות מותאמות, יש להשתמש רק באחד מהשדות {adm, adm_native}. זהו השדה התואם ל-OpenRTB לסידור JSON.
adm_native	לא	מותאמת	BidResponse.Ad.native_ad	2.3 2.4 2.5		תגובה של מודעה מותאמת. במקרה של הצעות מחיר למודעות מותאמות, יש להשתמש רק באחד מהשדות {adm, adm_native}. זהו השדה שמשמש לסריאליות של Protobuf.
adomain	לא	מערך מחרוזות	BidResponse.Ad.click_through_url	2.3 2.4 2.5		דומיין של מפרסם לבדיקת רשימת חסימה (לדוגמה, "addomain.com"). זאת יכולה להיות מערך במקרה של רוטציה של נכסי קריאייטיב. ב-Exchange אפשר לקבוע שרק דומיין אחד מורשה. המפרט של OpenRTB מאפשר רק שמות דומיינים ב-adomain. גם Authorized Buyers תומכים בכתובות URL מלאות. לתשומת ליבכם, הדומיין חייב להיות כתובת URL שניתן לסרוק. במודעות מותאמות, מומלץ להשתמש ב-BidResponse.seatbid[].bid[].adm_native.link.url במקום ב-adomain.
bundle	לא	מחרוזת	BidResponse.Ad.advertiserd_app_id	2.3 2.4 2.5		מזהה החנות של האפליקציה בחנות אפליקציות, כמו Apple App Store או Google Play. לקבלת מידע נוסף על מחרוזות צפויות של חנויות אפליקציות ב-CTV, תוכלו לעיין בהנחיות OTT/CTV להקצאת אפליקציות. באפליקציות לנייד בחנות Google Play, השמות האלה צריכים להיות בשם חבילה או חבילה, כמו com.foo.mygames. במקרה של אפליקציות ב-Apple App Store, אלה צריכים להיות מזהים מספריים. Google: בנוסף לשדה הזה, צריך להגדיר את השדה Bid.ext.app_promotion_type כדי לנצל את היתרונות של תכונות ספציפיות לסוגי המבצעים לקידום אפליקציות.
iurl	לא	מחרוזת	אין תמיכה	2.3 2.4 2.5		כתובת URL ללא מעקף של מטמון לתמונה שמייצגת את תוכן הקמפיין לצורך בדיקת איכות/בטיחות של מודעות.
cid	לא	מחרוזת	BidResponse.Ad.AdSlot.billing_id	2.3 2.4 2.5		מזהה קמפיין כדי לעזור בבדיקת איכות המודעה. אוסף נכסי הקריאייטיב שעבורם iurl צריך לייצג. תואם למזהה החיוב בטירגוט מראש. אם לא מוגדר ערך בשדה billing_id של הקונה, התגובה להצעת המחיר נחשבת לא חוקית. כששולחים קריאייטיבים, צריך לציין cid בתגובה אם מציינים יותר מ-billing_id בקשה, או אם למגיש הצעות המחיר יש מושבים פעילים של ילדים.
crid	לא	מחרוזת	BidResponse.Ad.buyer_creative_id	2.3 2.4 2.5		מזהה קריאייטיב שמסייע בבדיקת איכות המודעה.
cat	לא	מערך מחרוזות	BidResponse.Ad.category	2.3 2.4 2.5		קטגוריות התוכן של הקריאייטיב ב-IAB.
attr	לא	מערך של CreativeAttribute אובייקטים	BidResponse.Ad.attribute	2.3 2.4 2.5		קבוצת מאפיינים המתארת את הקריאייטיב. ניתן להצהיר על כך ב-OpenRTB בתור bid.attr (OpenRTB) או bid.ext.attribute (AdX).
api	לא	APIframework	Bid.api תומך בהצהרה על מאפיינים 1, 2, 3 ו-5 שתואמים לגרסאות VPAID ו-MRAID	2.3 2.4 2.5		API נדרש על ידי הסימון, אם רלוונטי.
protocol	לא	פרוטוקול	אין תמיכה	2.3 2.4 2.5		פרוטוקול התגובה של הסימון עבור הסרטון, אם רלוונטי.
qagmediarating	לא	סיווג QAGMediaRating	אין תמיכה	2.3 2.4 2.5		דירוג מדיה של קריאייטיב לפי הנחיות QAG.
dealid	לא	מחרוזת	BidResponse.Ad.AdSlot.deal_id (או BidResponse.Ad.AdSlot.exchange_deal_id אם Bidder הוא חילופי צד שלישי)	2.3 2.4 2.5		יש לעיין בערך deal.id מתוך הבקשה להצעת מחיר, אם הצעת המחיר הזו קשורה לעסקה ישירה בזירת מסחר פרטית.
w	לא	int32	BidResponse.Ad.width - נדרש רק אם מספר החשיפות הוא גדול	2.3 2.4 2.5		רוחב הקריאייטיב בפיקסלים בלתי תלויים במכשיר (DIPS).
h	לא	int32	BidResponse.Ad.height – נדרש רק אם החשיפה היא גדולה	2.3 2.4 2.5		גובה הקריאייטיב בפיקסלים בלתי תלויים במכשיר (DIPS).
exp	לא	int32	אין תמיכה	2.4 2.5		ייעוץ לגבי מספר השניות שמגיש הצעות המחיר מוכן להמתין בין המכירה הפומבית לבין החשיפה בפועל.
burl	לא	מחרוזת	חשיפה_tracking_url	2.5		כתובת ה-URL של הודעת החיוב שנקראת על ידי הבורסה כאשר הצעת המחיר שתזכה במכרז ניתנת לחיוב בהתאם למדיניות עסקית ספציפית לבורסה (לדוגמה, בדרך כלל, הצגה, צפייה וכו'). ניתן להשתמש ברכיבי מאקרו להחלפה. הערה: ב-BidExt.impression_tracking_url מתקבלת רשימה חוזרת של כתובות URL של הודעות חיוב. אם התרחיש לדוגמה שלך דורש יותר מכתובת URL אחת לחיוב, יש להשתמש בתוסף הזה במקום ב-burl.
lurl	לא	מחרוזת	אין תמיכה	2.5		כתובת ה-URL של ההודעה על הפסד נקראת על ידי הבורסה כאשר ידוע כי הצעת מחיר אבדה. ניתן להשתמש ברכיבי מאקרו להחלפה. מדיניות ספציפית ל-Exchange עשויה לכלול את התמיכה בהודעות על הפסדים או את הגילוי של מחירים מנצחים שכתוצאה מכך יוסרו פקודות מאקרו של ${AUCTION_PRICE} (לדוגמה, החלפה במחרוזת באורך אפס).
tactic	לא	מחרוזת	אין תמיכה	2.5		מזהה טקטי שמאפשר לקונים להוסיף תוויות להצעות מחיר לדיווח על הטקטיקה שבה נשלחה הצעת המחיר. יש להעביר את השימוש והמשמעות הספציפית של מזהה הטקטי בין הקונה לבין החליפין.
language	לא	מחרוזת	אין תמיכה	2.5		שפת הקריאייטיב באמצעות ISO-639-1-alpha-2. ניתן להשתמש גם בקוד הלא סטנדרטי "xx" אם הקריאייטיב לא כולל תוכן לשוני (לדוגמה, מודעת באנר עם לוגו של החברה בלבד).
wratio	לא	int32	אין תמיכה	2.5		הרוחב היחסי של הקריאייטיב כשמבטאים גודל כיחס. נדרש במודעות Flex.
hratio	לא	int32	אין תמיכה	2.5		הגובה היחסי של הקריאייטיב בעת ביטוי הגודל כיחס. נדרש במודעות Flex.
ext	לא	אובייקט BidExt	אין תמיכה	2.3 2.4 2.5		עבור OpenRTB/Protobuf, אפשר לגשת לאובייקט הזה באמצעות מפתח התוסף של [com.google.doubleclick.bid] (הנתיב המדויק משתנה בהתאם לשפה המשמשת ליצירת ספריית Proto). עבור OpenRTB/JSON, נכנסים עם השדה ext בהודעה להצעת המחיר.

הצעת מחיר

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
impression_tracking_url	לא	מערך מחרוזות	BidResponse.Ad.impression_tracking_url	כתובות ה-URL שאליהן יש לקרוא בעת עיבוד ההופעה. המאפיין הזה נתמך בכל סוגי המלאי ובכל הפורמטים. ב-OpenRTB 2.5, Bid.burl הוא השדה הרגיל המקביל.
ad_choices_destination_url	לא	מחרוזת	BidResponse.Ad.ad_choices_destination_כתובת URL	קישור להעדפות מודעה או לדף ביטול הצטרפות. אם קיים סמל AdChoices רגיל, הוא נוסף לקריאייטיב המקורי ומקושר לכתובת ה-URL הזו. המאפיין הזה נתמך במודעות מותאמות, אבל הוא לא חלק מההודעה המותאמת בתגובת הצעת המחיר.
click_tracking_url	לא	מחרוזת	BidResponse.Ad.click_tracking_כתובת האתר	כתובות ה-URL שאליהן רוצים להתקשר כשהמשתמש לוחץ על המודעה. בשלב זה, האפשרות נתמכת רק במודעות מותאמות ובעסקאות פרוגרמטיות מובטחות בקריאייטיבים שמנוהלים על ידי בעל התוכן הדיגיטלי. במקרה המנוהל על ידי בעל התוכן הדיגיטלי, כלים למעקב אחר קליקים יישלחו לשרת של מגיש הצעות המחיר אל שרת. בכל מצב אחר, ההודעות יישלחו מהמכשיר של המשתמש. מידע נוסף על קריאייטיבים שמנוהלים על ידי בעל התוכן הדיגיטלי זמין במאמר נכסי קריאייטיב המנוהלים על ידי בעל התוכן הדיגיטלי.
bidder_name	לא	מחרוזת	BidResponse.Ad.bidder_name	לגבי מגישי הצעות מחיר ב-Authorized Buyers (זירות מסחר של צד שלישי שבהן מגישים הצעות מחיר בזמן אמת ב-Ad Manager), השם של מגיש הצעת המחיר שהבורסה התקשרת כדי לספק את המודעה. זהו טקסט UTF8 שרירותי, אבל הוא צריך להיות מספיק כדי לזהות את מגיש הצעת המחיר, ויש להגדיר אותו באופן עקבי לאותו ערך של אותו מגיש הצעת מחיר.
exchange_deal_type	לא	סוג Enum ExchangeDealType	BidResponse.Ad.AdSlot.exchange_deal_type	Open_AUCTION = 0; CUSTOM_AUCTION = 1; PREFERRED_DEAL = 2; EXCHANGE_AUCTION_PACKAGE = 3; ברירת מחדל = Open_AUCTION
attribute	לא	מערך של int32	מאפיין BidResponse.Ad.	רשימת המזהים זמינה ב- buyer-declarable-creative-attributes.txt. שימו לב שלא כל המאפיינים מוצהרים מגיעים ב-BidRequest בשדות השונים של battr. מגישי הצעות מחיר רבים מצהירים על מאפיין מודעות מסוג 'נוזל' (שנקרא גם 'רספונסיבי' או 'ללא גודל') שגודלן משתנה באופן דינמי כדי לנצל את כל הרוחב והגובה של המסך. למידע נוסף, אפשר לקרוא את המאמר מודעות מעברון.
amp_ad_url	לא	מחרוזת	BidResponse.Ad.amp_ad_url	כתובת ה-URL לאחזור מודעת AMPHTML. יש להגדיר רק אחת מהאפשרויות הבאות: html_snippet, video_url, amp_ad_url, native_ad.
sdk_rendered_ad	לא	אובייקט SdkRenderedAd	BidResponse.Ad.sdk_rendered_ad	מודעה שתוצג על ידי SDK המוכרת לקונה. אפשר להשתמש באפשרות הזו רק כש-BidRequest כולל הודעת משנה של AppExt.InstalledSdk.
event_notification_token	לא	אובייקט EventNotificationToken	BidResponse.Ad.event_notification_token	אסימון שהוגדר על ידי מגישי הצעות המחיר לצורך פתרון בעיות, שייכלל במשוב בזמן אמת לגבי הצעת המחיר שבה הוא נשלח. התוכן של האסימון לא יתועד.
restricted_category	לא	מערך של int32	BidResponse.Ad.restricted_category	כל הקטגוריות המוגבלות של המודעות שעשויות להופיע מקטע הטקסט הזה. רשימה של מזהים זמינה במאמר ad-restricted-categories.txt.
billing_id	לא	int64	BidResponse.Ad.AdSlot.billing_id	מזהה החיוב שאליו יש לשייך את החשיפה הזו. הערך חייב להיות בשדה BidRequest.Imp.ImpExt.billing_id החוזר שנשלח עבור ההופעה הזו. אם האורך של BidRequest.Imp.ImpExt.billing_id הוא בדיוק 1 ולמגיש הצעות המחיר אין מושבים פעילים לילדים, אין צורך בשדה הזה והמערכת תתעלם מהתוכן שלו.
third_party_buyer_token	לא	מחרוזת	BidResponse.Ad.Adslot.third_party_buyer_token	אסימון המשמש לזיהוי פרטי קונה של צד שלישי אם בורסת ה-Open Bidding היא מתווך. הוא מתקבל מקונה של צד שלישי וצריך להעביר אותו ל-Google ללא שינוי בתגובת הצעת המחיר.
buyer_reporting_id	לא	מחרוזת	BidResponse.Ad.Adslot.buyer_reporting_id	המוכר הצהיר על מזהה שישמש לפירוט העלויות ומדדי התנועה הלא חוקיים בדיווח השקיפות של IVT בכלי השאילתות. לתשומת ליבך, מזהים עם פחות מ-1,000 חשיפות לא ישמשו לפירוט המדדים. המערכת תתעלם ממזהים שאורכם עולה על 64 בייטים.
skadn	לא	אובייקט SKAdNetworkResponse	BidResponse.Ad.skadn	פרטי ה-SKAdNetwork של המפרסם שיתמכו בשיוך של התקנת אפליקציות ל-iOS 14 ואילך. ממשק ה-API של SKAdNetwork של Apple מסייע למפרסמים למדוד התקנות של אפליקציות שמקורן במודעות, על ידי שליחת דיווח חוזר על המרה (PostBack) לרשת המודעות לאחר התקנה מוצלחת. רשתות המודעות יצטרכו לשלוח את מזהה הרשת ואת פרטי המפרסם החתום כדי לאפשר שיוך של התקנה לחשיפה של המודעה. מידע נוסף זמין במאמר הזה.
app_promotion_type	לא	טיפוסים בני מנייה (enum)	BidResponse.Ad.app_promotion_type	סוג המבצע לקידום האפליקציה שתואם לאפליקציה שפורסמה שצוינה בשדה seatbid.bid.bundle. אם האפליקציה שפורסמה לא יצוין, המערכת תתעלם מהשדה הזה. הגדרת השדה bundle ללא השדה הזה תיחשב כאילו השדה הזה הוגדר כ-OTHER.
SdkRenderedAd
id	לא	מחרוזת	BidResponse.ad[].sdk_rendered_ad.id	המזהה של ה-SDK שיעבד את המודעה. הערך חייב להיות זהה לערך BidRequest.app.ext.installed_sdk.id שנשלח בבקשה להצעת המחיר התואמת.
rendering_data	לא	מחרוזת	BidResponse.ad[].sdk_rendered_ad.rendering_data	הנתונים שצריך להעביר ל-SDK כדי לעבד את המודעה. הנתונים האלה עמומים אצל בעל התוכן הדיגיטלי וב-Google.
declared_ad	לא	DelcaredAd	BidResponse.ad[].sdk_rendered_ad.declared_ad	הצהרה על נכסים שמצורפים למודעות לצורך תמיכה בקריאייטיב, בסריקה ובסיווג של מדיניות המודעות וחסימות של בעלי תוכן דיגיטלי במודעות שעובדות עם SDK מותאם אישית. אפשר להגדיר רק אחד מהערכים html_snippet, video_url, video_vast_xml או native_response.
אסימון האירוע
payload	לא	מחרוזת	BidResponse.ad[].event_notification_token	התוכן של האסימון. המערכת תתעלם ממנו אם הוא מכיל יותר מ-128 בייטים.
תגובה של SKAdNetwork
version	לא	מחרוזת	BidResponse.ad[].skadn.version	גרסה של SKAdNetwork שנתמכת על ידי המפרסם. משמש גם לציון האופן שבו החתימה נוצרה על ידי המפרסם. המספר אמור להתאים לאחת מהגרסאות של BidRequest.imp.ext.skad.versions.
network	לא	מחרוזת	BidResponse.ad[].skadn.network	מזהה רשת המודעות שבו נעשה שימוש בחתימה. הוא צריך להתאים לאחד מהפריטים ב-BidRequest.imp.ext.skad.skadnetids.
campaign	לא	מחרוזת	BidResponse.ad[].skadn.campaign	מזהה הקמפיין תואם למפרט של Apple. משמש ב-SKAdNetwork 3.0 ומטה. הוחלף בשדה BidResponse.imp.ext.skad.sourceidentifier ב-SKAdNetwork 4.0 ואילך.
sourceidentifier	לא	מחרוזת	BidResponse.ad[].skadn.source_identifier	מספר שלם בן ארבע ספרות שמוגדר על ידי רשתות המודעות כדי לייצג את קמפיין המודעות. בשימוש ב-SKAdNetwork 4.0 ואילך ומחליף את השדה BidResponse.imp.ext.skad.campaign.
itunesitem	לא	מחרוזת	BidResponse.ad[].skadn.itunesitem	מזהה האפליקציה של המפרסם בחנות האפליקציות של Apple.
productpageid	לא	מחרוזת	BidResponse.ad[].skadn.product_page_id	המזהה של דף המוצר המותאם אישית שיוצג (ב-iOS 15 ואילך). אם לא צוין דף ברירת מחדל, יוצג דף מוצר המוגדר כברירת מחדל. במאמר הזה אפשר לקרוא פרטים נוספים על דפי מוצרים מותאמים אישית.
fidelities	לא	מערך של Fidelity אובייקטים	BidResponse.ad[].skadn.fidelities	גרסה 2.2 של SKAdNetwork API תומכת בכמה אפשרויות של הצגת מודעות, שצוינו באמצעות הפרמטר fidelity-type של החתימה של SKAdNetwork. הפעולה הזו כוללת פרמטרים שמשמשים ליצירת החתימה שתהיה שונה בכל סוג של איכות שנתמך. מידע נוסף זמין במאמר הזה.
nonce	לא	מחרוזת	BidResponse.ad[].skadn.nonce	UUID ייחודי באותיות קטנות שנוצר על ידי המפרסם כדי ליצור את החתימה. הערה: השדה הזה יוצא משימוש עבור השדה BidResponse.bid.ext.skadn.fooelities.noence כדי לתמוך בסוגים שונים של איכות.
sourceapp	לא	מחרוזת	BidResponse.ad[].skadn.sourceapp	מזהה האפליקציה של בעל האפליקציה בחנות האפליקציות של Apple. הוא צריך להתאים למזהה שמופיע ב-BidRequest.imp.ext.skad.sourceapp.
timestamp	לא	מחרוזת	BidResponse.ad[].skadn.timestamp	זמן Unix באלפיות השנייה שבו נעשה שימוש בעת יצירת החתימה. הערה: השדה הזה יוצא משימוש עבור השדה BidResponse.bid.ext.skadn.fooelities.timestamp כדי לתמוך בסוגים שונים של איכות.
signature	לא	מחרוזת	BidResponse.ad[].skadn.signature	חתימת SKAdNetwork כפי שצוינה ב-Apple. הערה: השדה הזה יוצא משימוש בשדה BidResponse.bid.ext.skadn.fooelities.signature כדי לתמוך בסוגים שונים של איכות.
skoverlay	לא	אובייקט SKOverlay	BidResponse.ad[].skadn.skoverlay	האפשרויות האלה מציינות איך להציג SKLayering עם המלצה על האפליקציה שפורסמה. האפשרות נתמכת ב-iOS 14 ואילך.

הצהרת הצהרת מודעה

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

אפשר להגדיר רק אחד מהערכים html_snippet, video_url, video_vast_xml או native_response.

הורה

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
html_snippet	לא	מחרוזת	BidResponse.ad[].sdk_rendered_ad.Announced_ad.html_snippet	נציג קטע ה-HTML של המודעה שמעובדת באמצעות SDK.
video_url	לא	מחרוזת	BidResponse.ad[].sdk_rendered_ad.Announced_ad.video_url	כתובת ה-URL של נכס ה-VAST שמוצג במודעה שמעובדת ב-SDK.
video_vast_xml	לא	מחרוזת	BidResponse.ad[].sdk_rendered_ad.Announced_ad.video_vast_xml	מסמך ה-VAST המשמש לעיבוד מודעה שעברה עיבוד מותאם אישית של SDK. המסמך צריך לעמוד בתקן VAST 2.0 או 3.0.
native_response	לא	NativeResponse	BidResponse.ad[].sdk_rendered_ad.Announced_ad.native_response	התוכן של מודעה מותאמת. מודעות מותאמות מורכבות מאבני בניין מרובות, שעוברות עיבוד על ידי SDK של הקונה. חייבת להתאים להגדרה הרגילה OpenRTB Native 1.2 NativeResponse. אי אפשר להשאיר את השדה NativeResponse.assets.img.type ריק.
click_through_url	לא	מחרוזת	BidResponse.ad[].sdk_rendered_ad.Announced_ad.click_through_url	דפי הנחיתה הסופיים של המודעה שמעובדת באמצעות SDK.

איכות גבוהה

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
fidelity	לא	סוג SKAdNetworkFidelity	BidResponse.ad[].skadn.fidelity_type	סוג האיכות של השיוך למעקב. ברירת מחדל = STOREKIT_RENDERED_ADS. VIEW_THROUGH_ADS = 0; שיוך (Attribution) להתקנות של אפליקציות תוך 24 שעות מצפייה במודעה במשך 3 שניות לפחות. נתמכת בגרסה 2.2 ואילך של SKAdnetwork. מידע נוסף זמין במאמר הזה. STOREKIT_RENDERED_ADS = 1; Attribution להתקנות של אפליקציה שנוצרה מדף המוצרים ב-App Store שמעובד ב-StoreKit בעקבות קליקים על מודעות. נתמכת בכל הגרסאות של SKAdNetwork. מידע נוסף זמין במאמר הזה.
nonce	לא	מחרוזת	BidResponse.ad[].skadn.nonce	UUID ייחודי באותיות קטנות שנוצר על ידי המפרסם כדי ליצור את החתימה.
timestamp	לא	מחרוזת	BidResponse.ad[].skadn.timestamp	זמן Unix באלפיות השנייה שבו נעשה שימוש בעת יצירת החתימה.
signature	לא	מחרוזת	BidResponse.ad[].skadn.signature	חתימת SKAdNetwork כפי שצוינה ב-Apple.

שכבת SK הזו

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
delay	לא	int32	BidResponse.ad[].skadn.skoverlay.delay_seconds	עיכוב של שניות ספורות לאחר תחילת הצגת המודעה לפני הצגת שכבת-העל. אם השדה הזה מוגדר לערך 0, שכבת-העל תוצג מיד אחרי שהמודעה תתחיל. אם השדה הזה לא מוגדר, שכבת-העל לא תוצג במודעה.
endcarddelay	לא	int32	BidResponse.ad[].skadn.skoverlay.endcard_delay_seconds	עיכוב של שניות לאחר הצגת כרטיס הסיום לפני הצגת שכבת-העל. (השדה הזה רלוונטי רק לנכסי קריאייטיב של מודעות וידאו מתגמלות או למודעות מעברון.) אם השדה הזה מוגדר לערך 0, שכבת-העל תוצג מיד אחרי הצגת כרטיס הסיום. אם השדה הזה לא מוגדר, שכבת-העל לא תוצג בכרטיס הקצה. אם מגדירים את delay וגם את endcarddelay, שכבת-העל תיסגר באופן אוטומטי כשהמודעה תסתיים, ואז תוצג שוב אחרי שכרטיס הסיום יוצג.
dismissible	לא	בוליאני	BidResponse.ad[].skadn.skoverlay.dismissible	אם המשתמש יכול לסגור את שכבת-העל הזו. ברירת המחדל היא TRUE.

משתני הצעת מחיר, הגדרות ותוספים מותאמים

מודעה מותאמת

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
ver	כן	מחרוזת	"1.2" ל-OpenRTB 2.5.	מספר הגרסה של תגי עיצוב מקומיים בשימוש.
layout	לא	מזהה פריסה	אין תמיכה	מזהה הפריסה של יחידת המודעות המותאמות. מומלץ על ידי OpenRTB Native 1.0. אופציונלי בגרסה 1.1, להוציא משימוש.
adunit	לא	מזהה יחידת מודעות	אין תמיכה	מזהה יחידת המודעות של יחידת המודעות המותאמות. היא תואמת לאחת מהיחידות של מודעות מותאמות מסוג Core-6 של IAB. מומלץ על ידי OpenRTB Native 1.0. אופציונלי ב-1.1, להוציא משימוש.
context	לא	סוג הקשר	אין תמיכה	ההקשר שבו המודעה מוצגת.
contextsubtype	לא	סוג משנה של הקשר	אין תמיכה	הקשר מפורט יותר שבו המודעה מוצגת.
plcmttype	לא	סוג מיקום	NativeAdTemplate.native_placement_type	העיצוב/הפורמט/הפריסה של יחידת המודעות שמוצעת.
plcmtcnt	לא	int32	אין תמיכה	מספר המיקומים הזהים בפריסה הזו.
seq	לא	int32	אין תמיכה	0 למודעה הראשונה, 1 למודעה השנייה, וכן הלאה. בדרך כלל לא צריך לעשות את זה בשילוב עם plcmtcnt – או שמכרזים כמה מיקומי מודעות זהים (במקרה כזה, plcmtcnt>1, seq=0), או אם מתבצעות מכרזים נפרדים של פריטים נפרדים בפיד (במקרה הזה, plcmtcnt=1, seq>=1).
assets	לא	מערך של Asset אובייקטים	נתמך באובייקט NativeAdTemplate. השדה של נכסי OpenRTB ממופה לשדה native_ad_template של אב AdX. לא מדובר במיפוי אחד לאחד. אב טיפוס של Google AdX מעביר את אותו המסר באמצעות האובייקט NativeAdTemplate, והשדות required_fields ו-recommended_fields אומרים למגיש הצעות המחיר אילו נכסים נדרשים או מומלצים. NativeAdTemplate כולל גם שדות אחרים כמו image_width. המידע בשדה assets ב-OpenRTB מופיע במספר שדות ב-AdX.	כל הצעת מחיר חייבת לעמוד במערך הרכיבים שמצוינת ב-Exchange. נדרש על ידי מפרט OpenRTB Native: לפחות רכיב אחד.
aurlsupport	לא	bool	יש תמיכה.	האם מקור המלאי או החשיפה תומכים בהחזרת כתובת URL של נכס במקום באובייקט נכס. אם הערך בשדה 0 הוא חסר, המשמעות היא שאין תמיכה כזו. הטמעה בגרסה 1.2
durlsupport	לא	bool	יש תמיכה.	האם מקור החשיפות / החשיפה תומכים בהחזרת כתובת URL של כלי DCO במקום באובייקט נכס. אם הערך בשדה 0 הוא חסר, המשמעות היא שאין תמיכה כזו. הטמעה בגרסה 1.2. תכונת בטא.
eventtrackers	לא	EventTrackers	גרסה 1.2 של OpenRTB תומכת במעקב אחר IMPRESSION ו-IMG. אם המדיניות OMSDK מופעלת למודעות מותאמות, המערכת תומכת ב-JS	ההגדרה הזאת קובעת איזה סוג של מעקב אחר אירועים נתמך. הטמעה בגרסה 1.2
privacy	לא	bool	אין תמיכה	יש להגדיר את הערך 1 כשהמודעה המותאמת תומכת בהודעת פרטיות הספציפית לקונה. יש להגדיר את הערך כ-0 (או בשדה חסר) כשהמודעה המותאמת לא תומכת בקישורי פרטיות מותאמים אישית או אם התמיכה לא ידועה. מומלץ ומיושם בגרסה 1.2. כל הבקשות המותאמות שאנו שולחים תומכות בכתובת אתר לשמירה על פרטיות, כך שתמיד מדובר תמיד ב-"1" לבקשות מקוריות.
ext	לא	אובייקט NativeRequestExt	נתמך	עבור OpenRTB/Protobuf, אפשר לגשת לאובייקט הזה באמצעות מפתח התוסף של [com.google.doubleclick.native_ext] (הנתיב המדויק משתנה בהתאם לשפה המשמשת ליצירת ספריית Proto). עבור OpenRTB/JSON, נכנסים עם השדה ext בהודעה NativeRequest.

NativeRequestExt

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
style_id	לא	int32	BidRequest.AdSlot. native_ad_template[0].style_id	מזהה ייחודי באופן גלובלי של הסגנון, ה-HTML ו-CSS שאיתם מוצגת המודעה המותאמת.
style_height	לא	int32	BidRequest.AdSlot. native_ad_template[0] .style_height	אם הערך של style_layout_type הוא Pixel, זהו הגובה של כל המודעה המותאמת לאחר הרינדור.
style_width	לא	int32	BidRequest.AdSlot. native_ad_template[0] .style_width	אם הערך של style_layout_type הוא Pixel, זהו הרוחב של כל המודעה המותאמת לאחר הרינדור.
style_layout_type	לא	סוג פריסה enum	BidRequest.AdSlot. native_ad_template[0] .style_layout_type	Enum LayoutType: PIXEL = 0; (ברירת מחדל) FLUID = 1;

הנכס

אובייקט המאגר הראשי של כל נכס ש-Exchange מבקש או תומך בו בשם לקוח הרינדור. כל אובייקט נדרש צריך להיות מסומן ככזה. בכל אובייקט צריך להופיע רק אובייקט אחד ({title,img,video,data}). כל השאר צריכים להיות ריקים או חסרים. הערך id צריך להיות ייחודי במערך Asset כדי שיהיה אפשר ליישר את התשובה.

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
id	כן	int32	1..N עבור N נכסים בסדר לא מוגדר, התואמים לשדות המומלצים או הנדרשים ב-NativeAdTemplate הראשונים.	מזהה נכס ייחודי, שהוקצה על ידי ההחלפה. בדרך כלל מונה למערך. נדרש על ידי מפרט OpenRTB Native.
required	לא	בוליאני	BidRequest.AdSlot.native_ad_template[0]. חובה_שדות	הערך הוא True אם נדרש נכס.
title	לא	כותרת	BidRequest.AdSlot.native_ad_template[0] מסוג HEADLINE	אובייקט Title לנכסי הכותרת. מומלץ לפי מפרט OpenRTB Native. אחד מהגדלים: Title, Image, Data, Video.
img	לא	בקשת תמונה	BidRequest.AdSlot.native_ad_template[0] מהסוגים main/IMAGE, ICON/APP_ICON, LOGO/LOGO	אובייקט Image לנכסי תמונות. מומלץ לפי מפרט OpenRTB Native. אחד מהגדלים: Title, Image, Data, Video.
video	לא	וידאו	BidRequest.AdSlot.NativeAdTemplate.required_fields	אובייקט Video לנכסי וידאו. לתשומת ליבך, מודעות וידאו In-stream אינן חלק ממודעות מותאמות. מודעות מותאמות יכולות לכלול סרטון בתור הקריאייטיב של המודעה עצמה. בקשות להצעת מחיר יכולות לציין שהסרטון נדרש ב-NativeResponse על ידי הגדרת NativeRequest.assets[].required כ- true וציון NativeRequest.assets[].video. מומלץ לפי מפרט OpenRTB Native. אחד מהערכים: Title, Image, Data, Video.
data	לא	נתונים	BidRequest.AdSlot.native_ad_template[0] סוגים CTATEXT/CALL_TO_ACTION, DESC/Body, ממומן/מפרסם, PRICE/PRICE, RATING/STAR_RATING	אובייקט Data עבור דירוגים, מחירים וכו' מומלץ לפי מפרט OpenRTB Native. אחד מהגדלים: Title, Image, Data, Video.

שם הפריט

האובייקט Title מיועד לרכיב הכותרת של המודעה המותאמת.

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
len	לא	int32	BidRequest.AdSlot.native_ad_template[0].headline_max_safe_length	האורך המקסימלי של הטקסט ברכיב הכותרת. מומלץ שהערך יהיה אחד מהערכים הבאים: 25, 90, 140. נדרש על ידי מפרט OpenRTB Native.

תמונה

האובייקט Image מיועד לרכיבי תמונה של המודעה המותאמת.

אין תמיכה

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
type	לא	סוג נכס התמונות	סוג שדה BidRequest.AdSlot.native_ad_template[0]	מזהה הסוג של רכיב התמונה שנתמך על ידי בעל התוכן הדיגיטלי. המוציא לאור יכול להציג את המידע הזה בפורמט המתאים.
w	לא	int32	אין תמיכה	רוחב התמונה בפיקסלים.
h	לא	int32	אין תמיכה	גובה התמונה בפיקסלים.
wmin	לא	int32	BidRequest.AdSlot.native_ad_template[0] מסוג: main/IMAGE:image_width LOGO/LOGO: לוגו_רוחב ICON/APP_ICON: app_icon_width	הרוחב המינימלי המבוקש של התמונה בפיקסלים. צריך להשתמש באפשרות הזו לכל שינוי גודל של תמונות על ידי הלקוח. יש להעביר את w או את wmin. אם הנתונים כוללים רק את w, זה נחשב לדרישה מדויקת. מומלץ לפי מפרט OpenRTB Native.
hmin	לא	int32	BidRequest.AdSlot.native_ad_template[0] מסוג: main/IMAGE:image_height LOGO/LOGO: logos_height ICON/APP_ICON: app_icon_height	הגובה המינימלי של בקשה לתמונה בפיקסלים. צריך להשתמש באפשרות הזו לכל שינוי גודל של תמונות על ידי הלקוח. יש לשדר את h או את hmin. אם הנתונים כוללים רק את h, זה נחשב לדרישה מדויקת. מומלץ לפי מפרט OpenRTB Native.
mimes	לא	מחרוזת		רשימת היתרים של סוגי MIME נתמכים. סוגי MIME פופולריים כוללים, בין היתר, את הפרמטרים "image/jpg" ו-"image/gif". לכל הטמעה של Exchange צריכה להיות רשימה נפרדת של סוגים נתמכים במסמכי השילוב. אפשר לעיין בדף ה-MIME של ויקיפדיה כדי לקבל מידע נוסף וקישורים לכל אישורי IETF RFC. אם השדה ריק, נניח שכל הסוגים מותרים.

וידאו

האובייקט Video מיועד לרכיבי וידאו של המודעה המותאמת.

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
mimes	כן	מערך מחרוזות	BidRequest.video.allowed_video_formats	סוגי MIME נתמכים. סוגי MIME נפוצים כוללים אך לא רק את "video/x-mswmv" עבור Windows Media, ואת "video/x-flv" עבור Flash Video או "video/mp4". חשוב לשים לב שבמקרים רבים, מודעה מותאמת אינה תומכת ב-Flash. נדרש על ידי מפרט OpenRTB Native: לפחות רכיב אחד.
minduration	כן	int32	BidRequest.Video.min_ad_duration	משך מודעת וידאו מינימלי בשניות. נדרש על ידי מפרט OpenRTB Native.
maxduration	כן	int32	BidRequest.Video.max_ad_duration	משך הזמן המקסימלי של מודעת וידאו בשניות. נדרש על ידי מפרט OpenRTB Native.
protocols	כן	מערך טיפוסים של Protocol	BidRequest.Video.פרוטוקולים	מערך של פרוטוקולים וידאו שבעלי התוכן הדיגיטלי יכולים לאשר בתגובה להצעת המחיר. נדרש על ידי מפרט OpenRTB Native: לפחות רכיב אחד. דוגמאות: VAST_1_0 = 1; VAST_2_0 = 2; VAST_3_0 = 3;

נתונים

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
type	כן	סוג נכס הנתונים	סוג שדה BidRequest.AdSlot.native_ad_template[0]	סוג הרכיב של הרכיב שנתמך על ידי בעל התוכן הדיגיטלי. המוציא לאור יכול להציג את המידע הזה בפורמט מתאים. נדרש על פי המפרט של OpenRTB Native.
len	לא	int32	BidRequest.AdSlot.native_ad_template[0] מסוג: DESC/Body: body_max_safe_length CTATEXT/CALL_TO_ACTION: call_to_action_max_safe_length ADVERTISERED/ADVERTISER: מפרסם_max_safe_length PRICE/PRICE: מחיר_max_safe_length	האורך המקסימלי של הטקסט בתגובת הרכיב. הערה: לא בשימוש עבור RATING/STAR_RATING, AdX צריך 0..5 כפול

מעקב אחר אירועים

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
event	כן	סוג האירוע	אין תמיכה	סוג האירוע הזמין למעקב. נדרש על ידי מפרט OpenRTB Native.
methods	כן	שיטת מעקב אחר אירועים	אין תמיכה	מערך של סוגי מעקב שזמינים לאירוע הנתון. נדרש על ידי מפרט OpenRTB Native.

מותאמת

אובייקט התגובה המותאמת הוא אובייקט JSON ברמה העליונה שמזהה תגובה מותאמת.

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
ver	לא	מחרוזת	'1.0' ל-OpenRTB 2.3, '1.1' ל-OpenRTB 2.4	הגרסה של תג העיצוב המקורי שנמצאת בשימוש.
assets	לא	מערך נכסים	BidResponse.Ad.native_ad[0]. כל הנכסים ממופים לשדות של מודעה מותאמת יחידה.	רשימת הנכסים של המודעה המותאמת.
link	כן	קישור	BidResponse.Ad.native_ad[0]	קישור ליעד.נדרש על פי המפרט של OpenRTB Native.
imptrackers	לא	מערך מחרוזות	BidResponse.Ad.impression_tracking_url	מערך של כתובות URL למעקב אחר חשיפות, שאמורות להחזיר תמונה בגודל 1x1 או תגובה של 204 – בדרך כלל עוברות רק כשמשתמשים בכלי מעקב של צד שלישי. משתמשים במאקרו %%WINNING_PRICE%% או ${AUCTION_PRICE}.
jstracker	לא	מחרוזת	אין תמיכה	כלי אופציונלי למעקב אחר חשיפות ב-JavaScript. מכיל script תגים להפעלה בזמן החשיפה, במצב שבו יש תמיכה בו.
eventtrackers	לא	מערך של EventTracker אובייקטים	BidResponse.Ad.impression_tracking_url ו-BidResponse.Ad.impression_tracking_resource	מערך של כלי מעקב אחר אירועי תגובה שיופעל עם המודעה, בתגובה לשיטות הנתמכות המוצהרות ב-NativeRequest. מחליף את כלי המעקב ו-jstrackers. הטמעה בגרסה 1.2.

מעקב אחר אירועים

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
event	כן	מספר שלם	אין תמיכה	סוג האירוע למעקב.
method	כן	מספר שלם	אין תמיכה	סוג המעקב המבוקש.
url	לא	טקסט	BidResponse.Ad.impression_tracking_url ו-BidResponse.Ad.impressionTrackingResource.script_url	כתובת ה-URL של התמונה או ה-js. נדרש עבור תמונה או js, אופציונלי עבור מותאם אישית.
customdata	לא	אובייקט שמכיל צמדי מפתח/ערך.	אין תמיכה	כדי להגיע להסכמה נפרדת עם הבורסה, מערך של אובייקטים של מפתח/ערך למעקב מותאם אישית, לדוגמה, מספר החשבון של ה-DSP עם חברת מעקב, לדוגמה {"accountnumber":"123"}.
ext	לא	אובייקט EventTrackerExt	אין תמיכה	עבור OpenRTB/Protobuf, אפשר לגשת לאובייקט הזה באמצעות מפתח התוסף של [com.google.doubleclick.eventtrackers] (הנתיב המדויק משתנה בהתאם לשפה המשמשת ליצירת ספריית Proto). עבור OpenRTB/JSON, נכנסים עם השדה ext בהודעה EventTracker.

EventTrackerExt

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
context	לא	מערך של טיפוסים בני מנייה (enum)	BidResponse.Ad.impressionTrackingResource.הקשר	הקשר נוסף סופק לעיבוד. UNKNOWN = 0; OMID = 1; לא נתמך כרגע.
verification_parameters	לא	מחרוזת	BidResponse.Ad.impressionTrackingResource.verification_parameters	פרמטרים המשויכים למשאב שיועבר למשאב כשהוא ייטען. הפורמט של הפרמטרים תלוי בספק הסקריפט.
vendor_key	לא	מחרוזת	BidResponse.Ad.impressionTrackingResource.vendor_key	משמש לזיהוי ייחודי של ספק הסקריפט לאימות.

קישור

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
url	לא	מחרוזת	BidResponse.ad[].native_ad.click_link_url	כתובת דף הנחיתה של הקישור שניתן ללחוץ עליו.
clicktrackers	לא	מערך מחרוזות	(NativeResponse.link) BidResponse.Ad.NativeAd.click_tracking_url[0]	כתובות URL למעקב של צד שלישי יופעלו לאחר לחיצה על כתובת ה-URL. כלי המעקב של Google אחר קליקים מפנים HTTP 30x לכלי המעקב של מגיש הצעות המחיר. ניתן להשתמש בכלים מרובים למעקב אחר קליקים.
fallback	לא	מחרוזת	אין תמיכה	כתובת URL חלופית לקישור עומק. לשימוש אם כתובת ה-URL שצוינה ב-url לא נתמכת על ידי המכשיר.

הנכס

תואם לאובייקט Asset שבבקשה. אובייקט הקונטיינר הראשי לכל נכס ש-Exchange מבקש או תומך בו בשם לקוח הרינדור. יש לסמן כל אובייקט נדרש. כל אובייקט יכול להכיל רק אחד מהאובייקטים {title,img,video,data}. כל שאר השדות צריכים להיות ריקים או חסרים. המזהה צריך להיות ייחודי במערך הנכסים כדי שניתן יהיה להתאים את התשובה.

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
id	כן	int32	אין תמיכה	מזהה הנכס הייחודי, שמוקצה באמצעות החלפה, חייב להתאים לאחד ממזהי הנכסים שצוינו בבקשה נדרש על ידי מפרט OpenRTB Native.
required	לא	בוליאני	אין תמיכה	מגדירים את הערך 1 אם נדרש נכס. (מגיש הצעת המחיר דורש את הצגתו)
title	לא	שם הפריט	AdX: BidResponse.Ad.native_ad[0] / HEADLINE	אחד מהשניים: Title, Image, Data, Video אובייקט כותרת של נכסי שם.
img	לא	תמונה	BidResponse.Ad.native_ad[0] / IMAGE|LOGO|APP_ICON	אחד מהשניים: Title, Image, Data, Video אובייקט Image לנכסי תמונות.
video	לא	וידאו	BidResponse.Ad.NativeAd.video_url או BidResponse.Ad.NativeAd.video_vast_xml	הערך יכול להיות מחרוזת שמכילה VAST XML או כתובת URL למסמך VAST דרך המאפיין NativeResponse.assets[].video.vasttag. אובייקט Video לנכסי וידאו. לתשומת ליבך, מודעות וידאו In-stream אינן חלק ממודעות מותאמות. מודעות מותאמות יכולות לכלול סרטון בתור הקריאייטיב עצמו.
data	לא	נתונים	BidResponse.Ad.native_ad[0] / Body|CALL_TO_ACTION|ADVERTISER|STAR_RATING_PRICE_STORE	אחד מהערכים: Title, Image, Data, Video. אובייקט Data עבור דירוגים, מחירים וכו'
link	לא	קישור	BidResponse.Ad.native_ad[0]	אובייקט של קישור לקריאות לפעולה. הקישור הזה משויך לשדה המאוכלס השני בתוך האובייקט.

שם הפריט

תואם לאובייקט Title שבבקשה, והערך מכיל את הערך המלא.

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
text	כן	מחרוזת	BidResponse.Ad.native_ad[0].headline	הטקסט המשויך לרכיב הטקסט. נדרש לפי המפרט של OpenRTB Native.

תמונה

תואם לאובייקט Image שבבקשה. האובייקט Image שמשמש לכל רכיבי התמונה של המודעה המותאמת, כמו סמלים, תמונה ראשית וכו'.

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
url	כן	מחרוזת	BidResponse.Ad.native_ad[0] עבור סוג הנכס המבוקש: ראשית/IMAGE: image.url ICON/APP_ICON: app_icon.url LOGO/LOGO: לוגו.url	כתובת ה-URL של נכס התמונות. נדרש על ידי מפרט OpenRTB Native.
w	לא	int32	BidResponse.Ad.native_ad[0] עבור סוג הנכס המבוקש: ראשית/IMAGE: image.url ICON/APP_ICON: app_icon.url LOGO/LOGO: לוגו.url	רוחב התמונה בפיקסלים. מומלץ על ידי מפרט OpenRTB Native.
h	לא	int32	BidResponse.Ad.native_ad[0] עבור סוג הנכס המבוקש: ראשית/IMAGE: image.url ICON/APP_ICON: app_icon.url LOGO/LOGO: לוגו.url	גובה התמונה בפיקסלים.

וידאו

הערך תואם לאובייקט Video שבבקשה, אבל מכיל ערך של תג VAST תואם.

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
vasttag	כן	מחרוזת	אין תמיכה	XML של VAST נדרש על ידי מפרט OpenRTB Native.

נתונים

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

מאפיין	תמיד עבר	Type	שווה ערך לקונים מורשים	פרטי ההטמעה
label	לא	מחרוזת	אין תמיכה	שם המחרוזת המפורמטת (אופציונלי) של סוג הנתונים שיוצג.
value	כן	מחרוזת	BidResponse.Ad.native_ad[0] עבור סוג נכס הבקשה OpenRTB/AdX: CTATEXT/CALL_TO_ACTION: קריאה_לפעולה DESC/Body: גוף ממומן/מפרסם: מפרסם PRICE/PRICE: מחיר RATING/STAR_RATING: star_rating (AdX דורש כפול 0..5)	מחרוזת הנתונים בפורמט שמתאימה להצגה. יכול להכיל ערך בפורמט כמו '5 כוכבים' או '$10' או '3.4 כוכבים מתוך 5'. נדרש על פי המפרט של OpenRTB Native.

דוגמאות

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