הצגה או הורדה של קבצים שתומכים בפרוטוקול 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 כולל כמה תוספים, שזמינים בפרוטוקול נפרד. | 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. |
| תוויות לתיאור התוכן | משמש בשדה 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