צפייה בקבצים שתומכים בפרוטוקול RTB או הורדה שלהם.
Protos
| קובץ | תיאור | גרסה | עדכון אחרון |
|---|---|---|---|
| cookie-bulk-upload.proto | אפשר להשתמש בהודעה הזו כדי להעלות בכמות גדולה נתונים לטירגוט משתמשים. | v.24 | 27 במרץ 2024 |
| openrtb.proto | Google תומכת בפרוטוקול OpenRTB, באמצעות קידוד JSON או Protobuf. הפרוטוקול הזה נדרש אם משתמשים ב-OpenRTB/Protobuf. הוא כולל גם תיעוד של השדות הנתמכים והמיפוי שלהם לפרוטוקול המקורי של Google. | 2.6 | 11 באוגוסט 2025 |
| openrtb-adx.proto | פרוטוקול OpenRTB של Google כולל כמה תוספים, שמופיעים בקובץ proto נפרד. | v.192 | 21 ביולי, 2025 |
| publisher-settings.proto | קבוצה של הגדרות לבעלי תוכן דיגיטלי שספציפיות לרשת של משתתפים במכרז בזמן אמת. | v.14 | 5 בפברואר 2024 |
Open Beta Protos
| קובץ | תיאור | גרסה | עדכון אחרון |
|---|---|---|---|
| openrtb-adx.proto | פרוטוקול OpenRTB של Google כולל כמה תוספים, שמופיעים בקובץ proto נפרד. | v.200 | 21 ביולי, 2025 |
נתוני הפניות
מילונים (לחיצה להורדת קובץ .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, או אם מותר להציג מודעות מדיה ו/או מודעות טקסט. |
| קטגוריות ההתמחות של בעל התוכן הדיגיטלי | בשימוש בשדה detected_vertical של
BidRequest. בשדה הזה מציינים את הענפים (בדומה למילות מפתח) של הדף שבו תוצג המודעה. Google יוצרת את השדה הזה על ידי סריקת הדף וקביעה של הענפים שבהם נעשה שימוש. |
| ספקים | בשימוש בשדה allowed_vendor_type של
BidRequest. בשדה הזה מפורטים ספקי המדיה העשירה, כמו Campaign Monitor ו-VoiceFive, שמורשים להציג את הקריאייטיב, כפי שצוין על ידי בעל האתר. כולל ספקים מקובץ המילון |
| ספקי נתונים | בשימוש בשדה SegmentData.id של
BidRequest. השדה הזה מכיל מידע על הישות שסיפקה את האותות שמסופקים על ידי בעלי תוכן דיגיטלי. |
טבלאות הפניה (לחיצה להורדת קובצי CSV) |
|
| אפליקציות לניידים של Android | רשימה של אפליקציות לנייד ל-Android שאפשר לטרגט, עם מזהי האפליקציות, מזהי הקטגוריות ושמות האפליקציות שקלים לקריאה. |
| טבלאות גיאוגרפיות | הטבלה שמשמשת לפענוח השדה geo_criteria_id של BidRequest. מידע נוסף זמין במאמר בנושא טירגוט גיאוגרפי. |
| ספקי LGPD |
רשימת ספקי ההתאמה האישית של מודעות שמורשים להציג מודעות לתנועה שמגיעה מברזיל בהתאם לחוק LGPD,
כולל המזהה שלהם, שם שקל לקרוא, כתובת URL של מדיניות הפרטיות ורשימה של דומיינים
שאפשר לשייך לספק. האכיפה של LGPD מצוינת בבקשה להצעת מחיר באמצעות השדה BidRequest.adslot.regs_lgpdבפרוטוקול הבידינג של Authorized Buyers והשדה BidRequest.regs.ext.lgpdבפרוטוקול הבידינג של OpenRTB.
|
| ספקי סלולר | רשימה של ספקי סלולר. |
| מכשירים ניידים | רשימה של מכשירים ניידים. |
| מערכות הפעלה במכשירים ניידים | רשימה של מערכות הפעלה לניידים. |
| ספקים | מפות Google ממפה מזהים של ספקי התאמה אישית של מודעות לשם שקריא לאנשים, לכתובת 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