נתוני Proto &amp

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

פרוטו

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

פתיחת גרסת הבטא של Proto

קובץ תיאור גרסה עדכון אחרון
openrtb-adx.proto פרוטוקול OpenRTB של Google כולל תוספים מסוימים, שסופקו בפרוטוקול נפרד. גרסה 149 4 ביוני 2023
Realtime-bidding.proto פרוטוקול RTB של Authorized Buyers. זוהי ההודעה שבה Google משתמשת כדי לבקש הצעות מחיר. מודעה מסוג BidRequest כוללת את משבצת המודעה מחשיפה אחת. גרסה 290 4 ביוני 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.
קודים של סטטוס היתרונות המרכזיים קודי סטטוס שהוחזרו על ידי הקריאה לשיטה performancereport.
תוויות התאמת תוכן לקהל נעשה שימוש בשדה detected_content_labels של BidRequest.
קודי סטטוס של התאמת קובצי cookie נעשה שימוש בשדה cookieMatcherStatusRate של דוחות הביצועים של פרוטוקול RTB. הקודים הזמינים מתוארים במדריך התאמה לקובצי cookie.
קודים של סטטוסים של קריאייטיב

בשימוש ב:

הוחזרה על ידי creative_status_code במשוב בזמן אמת.
קודים של סטטוס התאמה מתארח נעשה שימוש בשדה hostedMatchStatusRate של דוחות הביצועים של פרוטוקול RTB.
אין סיבות להגשת הצעת מחיר ערכים רגילים של הצעות מחיר שאינם ניתנים בשדה BidResponse.no_bid_reason בפרוטוקול הצעת המחיר של Authorized Buyers.
מאפייני קריאייטיב שניתנים לטירגוט מראש נעשה שימוש בשדה supportedCreativeAttribute במשאב ה-pretargetConfig שנחשף ב-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 מהנציג של החשבון.