צפייה בקבצים שתומכים בפרוטוקול RTB או הורדה שלהם.
פרוטוס
| קובץ | תיאור | גרסה | עדכון אחרון |
|---|---|---|---|
| cookie-bulk-upload.proto | אפשר להשתמש בהודעה הזו כדי להעלות בכמות גדולה נתוני טירגוט משתמשים. | v.24 | 27 במרץ 2024 |
| openrtb.proto | Google תומכת בפרוטוקול OpenRTB, באמצעות קידוד JSON או Protobuf. הפרוטו הזה נחוץ אם משתמשים ב-OpenRTB/Protobuf. הוא כולל גם תיעוד של השדות הנתמכים ומיפוי שלהם לפרוטוקול המקורי של Google. | 2.6 | 2 ביוני 2026 |
| openrtb-adx.proto | פרוטוקול OpenRTB של Google כולל כמה תוספים, שמופיעים בקובץ proto נפרד. | v.207 | 13 באפריל 2026 |
| publisher-settings.proto | קבוצה של הגדרות לבעלי תוכן דיגיטלי שספציפיות לרשת של משתתפים במכרז בזמן אמת. | v.14 | 5 בפברואר 2024 |
Open Beta Protos
| קובץ | תיאור | גרסה | עדכון אחרון |
|---|---|---|---|
| openrtb-adx.proto | פרוטוקול OpenRTB של Google כולל כמה תוספים, שמופיעים בקובץ proto נפרד. | v.215 | 13 באפריל 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 שנחשף ב-API בארכיטקטורת REST של הקונה. בשדה הזה מתוארים מאפייני הקריאייטיב שצפויים להיות נוכחים בכל הקריאייטיבים שמתאימים להגדרת טירגוט מראש יחידה. |
| מאפייני קריאייטיב שאפשר להחריג בתוכן של בעלי תוכן דיגיטלי | השדה 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 מנציג החשבון.
נושאים במדיניות בנושא קריאייטיב
אפשר להשתמש בנושאי המדיניות בקובץ הזה כדי לסנן נכסי קריאייטיב במהלך הבדיקה ב-API של בידינג בזמן אמת.
הורדה של נושאי מדיניות כקובץ CSVעדכון אחרון: 18 באפריל 2022