נתוני Proto &

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

Protos

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

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

קובץ תיאור גרסה עדכון אחרון
openrtb-adx.proto פרוטוקול OpenRTB של Google כולל כמה תוספים, המסופקים בפרוטו נפרד. v.186 1 בנובמבר 2024
realtime-bidding.proto פרוטוקול RTB של Authorized Buyers של Google. זו ההודעה שבה Google משתמשת כדי לבקש הצעות מחיר. BidRequest כולל את מיקום המודעה מחשיפת מודעה אחת. v.342 31 באוקטובר 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 יוצרת את השדה הזה על ידי סריקת הדף וקביעת הענפים שבהם נעשה שימוש.
ספקים בשימוש בשדה allowed_vendor_type של BidRequest. בשדה הזה מפורטים ספקי המדיה העשירה, כמו Campaign Monitor ו-VoiceFive, שמותר להשתמש בהם בקריאייטיב שמוצג, כפי שצוין על ידי בעל התוכן הדיגיטלי.

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

הגדרות בעל אתר

מבקשים את הקובץ publisher-settings.pb.gz מהנציג של החשבון.

נושאי המדיניות לבדיקת קריאייטיב

אפשר להשתמש בנושאי המדיניות בקובץ הזה כדי לסנן נכסי קריאייטיב במהלך הבדיקה ב-Real-time Bidding API.

הורדת נושאי מדיניות כקובץ CSV.

תאריך העדכון האחרון: 18 באפריל 2022