אפשר להציג או להוריד קבצים שתומכים בפרוטוקול RTB.
פרוטוס
| קובץ | תיאור | גרסה | עדכון אחרון |
|---|---|---|---|
| cookie-bulk-upload.proto | אפשר להשתמש בהודעה הזו כדי להעלות כמות גדולה של נתוני טירגוט למשתמשים. | v.24 | 27 במרץ 2024 |
| openrtb.proto | Google תומכת בפרוטוקול OpenRTB באמצעות JSON או Protobuf באמצעות הקידוד. ה-Proto הזה הכרחי אם משתמשים ב-OpenRTB/Protobuf. כמו כן כולל תיעוד של שדות נתמכים והמיפוי שלהם של Google. | 2.6 | 22 במאי 2024 |
| openrtb-adx.proto | פרוטוקול OpenRTB של Google כולל כמה תוספים, המסופקים בפרוטו נפרד. | v.175 | 15 ביולי 2024 |
| publisher-settings.proto | קבוצת הגדרות של בעל תוכן דיגיטלי שספציפיות לרשת של מגישי הצעות מחיר בזמן אמת. | v.13 | 5 בפברואר 2024 |
| realtime-bidding.proto | פרוטוקול RTB ב-Authorized Buyers של Google. זו ההודעה שבה Google משתמשת
כדי לבקש הצעות מחיר. BidRequest כולל את מיקום המודעה מתוך
בחשיפה אחת. |
v.328 | 21 במאי 2024 |
פתיחת Protos בגרסת בטא
| קובץ | תיאור | גרסה | עדכון אחרון |
|---|---|---|---|
| openrtb-adx.proto | פרוטוקול OpenRTB של Google כולל כמה תוספים, המסופקים בפרוטו נפרד. | v.180 | 15 ביולי 2024 |
| realtime-bidding.proto | פרוטוקול RTB ב-Authorized Buyers של Google. זו ההודעה שבה Google משתמשת
כדי לבקש הצעות מחיר. BidRequest כולל את מיקום המודעה מתוך
בחשיפה אחת. |
v.338 | 21 במאי 2024 |
נתוני הפניות
מילונים (יש ללחוץ כדי להוריד קובץ 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 או על מדיה ו/או טקסט
מודעות מותרות. |
| קטגוריות של בעלי תוכן דיגיטלי | בשימוש בשדה 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
של Google. בשדות האלה, לספקים שמופיעים יש הסכמת משתמשים כפי שהועברה על ידי
בעלי תוכן דיגיטלי למשתמשים במדינות האזור הכלכלי האירופי. |
הגדרות בעל אתר
מבקשים את הקובץ publisher-settings.pb.gz מהחשבון
נציג.
נושאי מדיניות בנושא ביקורת על קריאייטיב
אפשר להשתמש בנושאי המדיניות שבקובץ הזה כדי לסנן את נכסי הקריאייטיב במהלך ביקורת ב-Real-time Bidding API
הורדה נושאים שקשורים למדיניות כקובץ CSV.עדכון אחרון: 18 באפריל 2022