הצגה או הורדה של קבצים שתומכים בפרוטוקול RTB.
פרוטוקולים
| קובץ | תיאור | גרסה | עדכון אחרון |
|---|---|---|---|
| cookie-bulk-upload.proto | אפשר להשתמש בהודעה הזו כדי להעלות בכמות גדולה נתונים של טירגוט משתמשים. | v.25 | 27 במרץ 2024 |
| openrtb.proto | Google תומכת בפרוטוקול OpenRTB, באמצעות קידוד JSON או Protobuf. הפרוטוקול הזה נדרש אם אתם משתמשים ב-OpenRTB או ב-Protobuf. הוא כולל גם תיעוד של השדות הנתמכים והמיפוי שלהם לפרוטוקול המקורי של Google. | 2.6 | 15 באוקטובר 2026 |
| openrtb-adx.proto | פרוטוקול OpenRTB של Google כולל כמה תוספים, שמופיעים בקובץ proto נפרד. | v.210 | 4 באוגוסט 2026 |
| publisher-settings.proto | קבוצה של הגדרות לבעלי תוכן דיגיטלי שספציפיות לרשת של בידינג בזמן אמת. | v.14 | 5 בפברואר 2024 |
פרוטוקולים של גרסת בטא פתוחה
| קובץ | תיאור | גרסה | עדכון אחרון |
|---|---|---|---|
| openrtb-adx.proto | פרוטוקול OpenRTB של Google כולל כמה תוספים, שמופיעים בפרוטוקול נפרד. | v.220 | 16 בספטמבר 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. בשדה הזה מצוין המפרסם שמיוצג על ידי הקריאייטיב שמשויך לקטע הקוד. הרשימה הזו משקפת את המפרסמים בכל רחבי הבורסה, ולא את המפרסמים שמיוצגים על ידי קונה מסוים. |
| מותגים | רשימת מותגים, שמשמשת ב-Client Access 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 |
רשימת הספקים של התאמה אישית של מודעות שמורשים להציג מודעות בתנועה שכפופה ל-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