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