נתוני Proto &

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

פרוטוס

קובץ תיאור גרסה עדכון אחרון
cookie-bulk-upload.proto אפשר להשתמש בהודעה הזו כדי להעלות כמות גדולה של נתוני טירגוט למשתמשים. v.23 12 בינואר 2024
openrtb.proto Google תומכת בפרוטוקול OpenRTB בקידוד JSON או Protobuf. הפרוטו הזה נדרש אם משתמשים ב-OpenRTB/Protobuf. הוא כולל גם תיעוד של שדות נתמכים והמיפוי שלהם לפרוטוקול המקורי של Google. 2.6 23 במרץ 2024
openrtb-adx.proto פרוטוקול OpenRTB של Google כולל מספר תוספים, המסופקים בפרוטוקול נפרד. v.169 23 במרץ 2024
publisher-settings.proto קבוצה של הגדרות בעל אפליקציה שספציפיות לרשת של מגישי הצעות מחיר בזמן אמת. v.13 5 בפברואר 2024
realtime-bidding.proto פרוטוקול RTB של Google ב-Authorized Buyers. זוהי ההודעה שבה Google משתמשת כדי לבקש הצעות מחיר. BidRequest כולל את מיקום המודעה בחשיפה אחת. v.322 13 במרץ 2024

גרסת בטא פתוחה של Protos

קובץ תיאור גרסה עדכון אחרון
openrtb-adx.proto פרוטוקול OpenRTB של Google כולל מספר תוספים, המסופקים בפרוטוקול נפרד. v.172 23 במרץ 2024
realtime-bidding.proto פרוטוקול RTB של Google ב-Authorized Buyers. זוהי ההודעה שבה Google משתמשת כדי לבקש הצעות מחיר. BidRequest כולל את מיקום המודעה בחשיפה אחת. v.329 14 במרץ 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.
קודי סטטוס של נכסי יתרונות מרכזיים קודי סטטוס שהוחזרו על ידי הקריאה ל-method 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 יוצרת את השדה הזה על ידי סריקת הדף וקביעת התחומים שבהם ייעשה שימוש.
מזהי רשתות של בתי עסק משמש בשדה 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