צפייה או הורדה של קבצים שתומכים בפרוטוקול RTB.
פרוטוקולים
| קובץ | תיאור | גרסה | עדכון אחרון |
|---|---|---|---|
| cookie-bulk-upload.proto | אפשר להשתמש בהודעה הזו כדי להעלות בכמות גדולה נתוני טירגוט משתמשים. | v.24 | 27 במרץ 2024 |
| openrtb.proto | Google תומכת בפרוטוקול OpenRTB, באמצעות קידוד JSON או Protobuf. הפרוטו הזה נחוץ אם משתמשים ב-OpenRTB/Protobuf. הוא כולל גם תיעוד של השדות הנתמכים והמיפוי שלהם לפרוטוקול המקורי של Google. | 2.6 | 30 ביוני 2026 |
| openrtb-adx.proto | פרוטוקול OpenRTB של Google כולל כמה תוספים, שמסופקים בפרוטוקול נפרד. | v.209 | Jul 07, 2026 |
| publisher-settings.proto | קבוצה של הגדרות לבעלי תוכן דיגיטלי שספציפיות לרשת של משתתפים במכרז בזמן אמת. | v.14 | 5 בפברואר 2024 |
Open Beta Protos
| קובץ | תיאור | גרסה | עדכון אחרון |
|---|---|---|---|
| openrtb-adx.proto | פרוטוקול OpenRTB של Google כולל כמה תוספים, שמסופקים בפרוטוקול נפרד. | v.218 | Jul 07, 2026 |
נתוני הפניות
מילונים (לחיצה להורדת קובץ .txt) |
|
|---|---|
| קטגוריות של מוצרים במודעות | המאפיין הזה משמש בשדה excluded_product_category של BidRequest. בשדה הזה מתוארות קטגוריות של מוצרים ושירותים שאסור לבעל האתר להציג, למשל אם בעל האתר לא רוצה להציג מודעות שקשורות לבנקאות באינטרנט. |
| קטגוריות מוגבלות של מודעות | נעשה שימוש בשדה allowed_restricted_category של BidRequest ובשדה restricted_category של BidResponse. השדה allowed_restricted_category
מתאר קטגוריות שבדרך כלל מוגבלות, אבל בעל התוכן הדיגיטלי הצהיר במפורש שמותר להציג אותן. לדוגמה, מודעות שמכילות תוכן שקשור לאלכוהול. |
| קטגוריות רגישות של מודעות | נעשה שימוש בשדה excluded_sensitive_category של BidRequest ובשדה category של BidResponse. השדה excluded_sensitive_category
מתאר קטגוריות רגישות שאסורות לפרסום על ידי בעל האתר,
לדוגמה, אם בעל האתר לא רוצה לארח מודעות שקשורות לפוליטיקה. |
| מפרסמים | השדה advertiser_id של SnippetStatusItem. בשדה הזה מצוין המפרסם שמיוצג על ידי הקריאייטיב שמשויך לקטע הקוד. הרשימה הזו משקפת את המפרסמים בבורסה ולא משקפת את המפרסמים שמיוצגים על ידי קונה מסוים. |
| מותגים | רשימת מותגים, שמשמשת ב-API לגישת לקוח. |
| מאפייני קריאייטיב שהקונים יכולים להצהיר עליהם | משמש לשדה attribute ב-BidResponse.
בשדה הזה מתוארים מאפיינים שקניין מדיה יכול להצהיר עליהם בקריאייטיבים, שאסור להם להופיע ב-excluded_attribute ב-BidRequest. |
| קודי סטטוס של יתרונות מרכזיים | קודי הסטטוס שמוחזרים על ידי קריאה לשיטה performancereport. |
| תוויות לתיאור התוכן | המאפיין הזה משמש בשדה detected_content_labels של התג BidRequest. |
| קודי סטטוס של הכלי להתאמת קובצי Cookie | הערך הזה מופיע בשדה cookieMatcherStatusRate בדוחות הביצועים של פרוטוקול RTB. הקודים הזמינים מתוארים במדריך בנושא התאמת קובצי Cookie. |
| קודי סטטוס של קריאייטיב | בשימוש ב: creative_status_code מוחזר במשוב בזמן אמת.
|
| קודי סטטוס התאמה של אתרים מתארחים | הערך הזה מופיע בשדה hostedMatchStatusRate בדוחות הביצועים של פרוטוקול RTB. |
| סיבות לכך שלא הוצעה הצעת מחיר | ערכי הסיבות התקניים לאי הגשת הצעת מחיר שצריך לציין בשדה BidResponse.no_bid_reason בפרוטוקול הצעות המחיר של Authorized Buyers. |
| מאפייני קריאייטיב שאפשר לטרגט לפני ההצגה | משמש בשדה supportedCreativeAttribute במשאב PretargetingConfig שנחשף ב-Buyer REST API. בשדה הזה מתוארים מאפייני הקריאייטיב שצפויים להיות נוכחים בכל הקריאייטיבים שמתאימים להגדרת טירגוט מראש יחידה. |
| מאפייני קריאייטיב שאפשר להחריג בתוכן של בעלי תוכן דיגיטלי | המאפיין הזה משמש בשדה excluded_attribute של BidRequest. בשדה הזה מתוארים סוגי הקריאייטיבים שאסורים לשימוש על ידי בעל האתר. לדוגמה, הם יכולים לציין הגבלות על השימוש בקובצי Cookie, או על הצגת מודעות מדיה ו/או מודעות טקסט. |
| ספקים | המאפיין הזה משמש בשדה allowed_vendor_type של BidRequest. בשדה הזה מפורטים ספקי המדיה העשירה, כמו Campaign Monitor ו-VoiceFive, שמותר להשתמש בהם בנכס הקריאייטיב שמוצג, כפי שצוין על ידי בעל האתר. כולל ספקים מקובץ המילון |
| ספקי נתונים | המאפיין הזה משמש בשדה SegmentData.id של BidRequest. השדה הזה מכיל מידע על הישות שסיפקה את האותות שמספקים בעלי תוכן דיגיטלי. |
טבלאות הפניה (לחיצה להורדת קובצי CSV) |
|
| אפליקציות לניידים של Android | רשימה של אפליקציות לנייד ל-Android שאפשר לטרגט, עם מזהי האפליקציות, מזהי הקטגוריות ושמות האפליקציות שקלים לקריאה. |
| טבלאות גיאוגרפיות | הטבלה שמשמשת לפענוח השדה geo_criteria_id של BidRequest. מידע נוסף זמין במאמר בנושא טירגוט גיאוגרפי. |
| ספקים שעומדים בדרישות ה-LGPD |
רשימת ספקי ההתאמה האישית של מודעות שמורשים להציג מודעות בתנועה שמגיעה מברזיל, עם המזהה שלהם, שם שקל לקרוא, כתובת URL של מדיניות הפרטיות ורשימה של דומיינים שאפשר לשייך לספק. האכיפה של LGPD מצוינת בבקשה מסוימת להצעת מחיר באמצעות השדה BidRequest.adslot.regs_lgpd בפרוטוקול הבידינג של Authorized Buyers והשדה BidRequest.regs.ext.lgpd בפרוטוקול הבידינג של OpenRTB.
|
| ספקים סלולריים | רשימה של ספקי סלולר. |
| מכשירים ניידים | רשימה של מכשירים ניידים. |
| מערכות הפעלה במכשירים ניידים | רשימה של מערכות הפעלה לניידים. |
| ספקים | ממפה את מזהי ספקי ההתאמה האישית של מודעות במפות לשם שקריא לאנשים, לכתובת URL של מדיניות הפרטיות ולרשימה של דומיינים שאפשר לשייך לספק.
בשלב הזה, נעשה שימוש בספקים בשדה BidRequest.AdSlot.consented_providers_settings בפרוטוקול AdX ובשדה BidRequest.User.UserExt.consented_providers_settings בפרוטוקול OpenRTB. במקומות האלה, הספקים שמופיעים ברשימה קיבלו את הסכמת המשתמשים שהועברה על ידי בעלי האתרים לגבי משתמשים במדינות שנכללות באזור הכלכלי האירופי. |
הגדרות בעל אתר
מבקשים את קובץ publisher-settings.pb.gz מנציג החשבון.
נושאים במדיניות בנושא קריאייטיב
אפשר להשתמש בנושאי המדיניות בקובץ הזה כדי לסנן נכסי קריאייטיב במהלך בדיקה ב-Real-time Bidding API
הורדה של נושאי מדיניות כקובץ CSVעדכון אחרון: 18 באפריל 2022