נתוני Proto &

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

Protos

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

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

קובץ תיאור גרסה עדכון אחרון
openrtb-adx.proto פרוטוקול OpenRTB של Google כולל כמה תוספים, שמוצגים בפרוטו נפרד. v.187 6 בנובמבר 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.
קודי סטטוס של תוספי יתרונות מרכזיים קודי הסטטוס שמוחזרים על ידי קריאת השיטה performancereport.
תוויות התאמת תוכן לקהל נעשה בו שימוש בשדה detected_content_labels של BidRequest.
קודי הסטטוס של מתאמי קובצי ה-Cookie השדה הזה מופיע בשדה cookieMatcherStatusRate בדוחות הביצועים של פרוטוקול RTB. הקודים הזמינים מתוארים במדריך בנושא התאמת קובצי cookie.
קודי סטטוס של נכסי קריאייטיב

בשימוש ב:

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