נתוני Proto &amp

הצגה או הורדה של קבצים שתומכים בפרוטוקול RTB.

פרוטוס

קובץ תיאור גרסה עדכון אחרון
cookie-bulk-upload.proto אפשר להשתמש בהודעה הזו כדי להעלות כמות גדולה של נתוני טירגוט למשתמשים. גרסה 19 25 באוגוסט 2022
openrtb.proto Google תומכת בפרוטוקול OpenRTB באמצעות קידוד JSON או Protobuf. הפרוטוקול הזה נחוץ אם משתמשים ב-OpenRTB/Protobuf. הוא כולל גם תיעוד של שדות נתמכים ואת המיפוי שלהם לפרוטוקול המקורי של Google. 2.6 21 ביולי 2023
openrtb-adx.proto פרוטוקול OpenRTB של Google כולל מספר הרחבות, שמוצגות בפרוטוקול נפרד. גרסה 157 13 בספטמבר 2023
publisher-settings.proto קבוצת הגדרות של בעלי תוכן דיגיטלי שספציפיות לרשת של מגישי הצעות מחיר בזמן אמת. גרסה 13 2 בפברואר 2023
Realtime-bidding.proto פרוטוקול RTB של Google ב-Authorized Buyers. זוהי ההודעה שבה משתמשת Google כדי לבקש הצעות מחיר. השדה BidRequest כולל את מיקום המודעה בחשיפה אחת. גרסה 301 13 בספטמבר 2023

פתיחת Protos Protos

קובץ תיאור גרסה עדכון אחרון
openrtb-adx.proto פרוטוקול OpenRTB של Google כולל מספר הרחבות, שמוצגות בפרוטוקול נפרד. גרסה 158 13 בספטמבר 2023
Realtime-bidding.proto פרוטוקול RTB של Google ב-Authorized Buyers. זוהי ההודעה שבה משתמשת Google כדי לבקש הצעות מחיר. השדה BidRequest כולל את מיקום המודעה בחשיפה אחת. גרסה 305 13 בספטמבר 2023

נתוני הפניות

מילונים (יש ללחוץ להורדת קובץ 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. השדה הזה מציין את המפרסם שמיוצג על ידי הקריאייטיב שמשויך לקטע הקוד. הרשימה הזו משקפת את המפרסמים בבורסה לפרסום, ולא משקפת את המפרסמים שמיוצגים על ידי אף קונה ספציפי.
סוכנויות משמש בשדה agency_id של BidResponse. השדה הזה משמש להצהרה על הסוכנות המשויכת למודעה שמוחזרת.
מותגים רשימת מותגים ב-Client Access API.
מאפייני קריאייטיב להצהרה על ידי הקונה משמש לשדה attribute בטבלה BidResponse. השדה הזה מתאר מאפיינים הניתנים להצהרה על ידי הקונה בקריאייטיבים, שאסורים להופיע ב-excluded_attribute ב- BidRequest.
קודי סטטוס של יתרונות מרכזיים קודי הסטטוס הוחזרו על ידי הקריאה ל-method 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 יוצרת את השדה הזה על ידי סריקת הדף וקביעה באילו ענפים ייעשה שימוש.
מזהי הרשת של בתי העסק משמש בשדה seller_network_id של BidRequest. בשדה הזה מציינים את הרשת של אתרי המכירה שאליה משתייך בעל התוכן הדיגיטלי. התוכן של הקובץ הזה מופיע בסדר עולה בהתאם לערך של מזהה הרשת של אתר המכירה.
ספקים משמש בשדה allowed_vendor_type של BidRequest. בשדה הזה מפורטים ספקי המדיה העשירה, כמו Campaign Monitor ו-VoiceFive, שמורשים להציג את הקריאייטיב, כפי שצוין על ידי בעל התוכן הדיגיטלי.

כולל ספקים מקובץ המילון gdn-vendors.txt שהוצא משימוש.

טבלאות עזר (יש ללחוץ כדי להוריד קובצי 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