מודעות מותאמות הן מודעות בפורמט שמתאים לתוכן ולעיצוב החזותי שמסביב, כך שיש סיכוי גבוה יותר שהמשתמשים יראו אותן וילחצו עליהן. מלאי שטחי הפרסום של מודעות מותאמות אישית זמין באפליקציות לנייד, וגם באתרים למחשבים ולניידים. מידע נוסף על מודעות מותאמות זמין במאמר סקירה כללית על מודעות מותאמות.
מודעות נתמכות גם ב-Authorized Buyers וגם ב-Open Bidding.
זהו תהליך העבודה של מודעות מותאמות:
- מתבצעת קריאה למודעה מותאמת ב-Google. בקריאה מצוינות אחת או שתי התבניות הבאות של מודעות מותאמות אישית, וכל אחת מהן מציינת את השדות המותאמים אישית המועדפים.
- Google שולחת לקונים בקשה להצעת מחיר ב-RTB שמכילה רשימה של השדות המבוקשים.
- קונים מעוניינים משיבים עם הפרטים הנדרשים.
- Google מפעילה מכרז כדי לבחור את הצעת המחיר הזוכה, ושולחת את נכסי הקריאייטיב שסופקו על ידי הקונה לבעלי התוכן הדיגיטלי.
- בעלי התוכן הדיגיטלי אוספים את הנכסים למודעה מותאמת ומתאימים את העיצוב שלהם לעיצוב האתר.
פורמטים של הודעות
Google תומכת במפרט OpenRTB גם ב-JSON וגם ב-Protobuf.
במודעות מותאמות מסוג OpenRTB Protobuf, השדות הבאים שונים מהמפרט:
| JSON | סוג JSON | Protobuf | סוג Protobuf |
|---|---|---|---|
BidRequest.imp[].native.request |
string |
BidRequest.imp[].native.request_native |
NativeRequest |
BidResponse.seatbid[].bid[].adm |
string |
BidResponse.seatbid[].bid[].adm_native |
NativeResponse |
השדות של OpenRTB Protobuf הם הודעות Protobuf ולא מחרוזות.
אם משתמשים בהטמעה של OpenRTB Protobuf, נקודת הקצה מקבלת בקשות להצעות מחיר שמכילות את הערך BidRequest.imp.native.request_native במקום BidRequest.imp.native.request. בנוסף, נקודת הקצה חייבת להחזיר תגובות של הצעות מחיר שמאכלסות את השדה BidResponse.seatbid.bid.adm_native במקום את השדה BidResponse.seatbid.bid.adm, אחרת היא תסונן מהמכרז.
אם אתם משתמשים ב-buyer SDK כדי להציג מודעות מותאמות, עליכם לכלול תמונה type בקובץ declared_ad כשאתם שולחים קריאייטיבים לבדיקה.
תבניות של מודעות מותאמות
תבניות של מודעות מותאמות מתארות את הרכיבים של מודעה מותאמת, ומגדירות את התוכן והמבנה של NativeRequest ב-OpenRTB או של NativeAdTemplate בפרוטוקול Google RTB שהוצא משימוש בבקשת הצעת המחיר. Google תומכת בשתי התבניות הנפוצות ביותר של מודעות מותאמות לתוכן, למודעות מותאמות לתוכן שאין בהן וידאו ולמודעות וידאו מותאמות לתוכן:
- תבנית של מודעה להתקנת אפליקציה – קידום התקנות של אפליקציות לנייד והגדלת מספרן.
- תבנית של מודעה באתר תוכן – שילוב כללי יותר של טקסט ותמונות למודעות של מותג או למודעות באינטרנט.
- תבנית של מודעת וידאו להתקנת אפליקציה
- תבנית של מודעה בתוכן וידאו
יש תבניות אחרות, ויכול להיות שיש להן קבוצה שונה של דרישות לגבי שדות, מאפיינים ומידות.
תבנית של מודעה להתקנת אפליקציה
שדות נדרשים ומומלצים
בטבלאות הבאות מוצגים שדות עם התוויות חובה או מומלץ. יש לשים לב לכללים הבאים:
- שדות שמסומנים ב-חובה הם שדות חובה למגיש הצעות המחיר.
- השדות שמסומנים בתווית מומלץ לא נדרשים על ידי המגישים של הצעות המחיר, והבעלים של אתר החדשות יכולים להציג אותם אם הם סיפקו אותם, או לא להציג אותם (לדוגמה, דירוג בכוכב).
- קריאה לפעולה (CTA) תמיד מסומנת כמומלצת כי אם המגיש לא שולח קריאה לפעולה, המערכת מקצה קריאה לפעולה כברירת מחדל, אבל אם המגיש שולח קריאה לפעולה, היא תמיד תוצג.
בטבלה הבאה מפורטים השדות של תבנית של מודעה להתקנת אפליקציה. אפליקציות לנייד משתמשות בשדות האלה כדי ליצור מודעות מותאמות להתקנת אפליקציות.
| שדה | תיאור | חובה או מומלץ? | תמיד מוצגים? | גודל תמונה מומלץ/מספר תווים מקסימלי | דוגמה |
|---|---|---|---|---|---|
| כותרת | שם האפליקציה | חובה | כן | 25 תווים | Flood-It! |
| תמונה | צילום מסך מהאפליקציה או תמונה רלוונטית אחרת | חובה | לא | 1,200px x 627px או 600px x 600px, בהתאם ליחס הגובה-רוחב שנדרש על ידי בעל התוכן הדיגיטלי. | <צילום מסך מהמשחק Flood-It!> |
| גוף | הטקסט הראשי של האפליקציה | חובה | לא | 90 תווים | פשוט למראית עין ומאתגר להפליא = ממכר להפליא! |
| סמל האפליקציה | סמל האפליקציה | חובה | לא | 128 x 128 פיקסלים | <סמל האפליקציה Flood-it!> |
| קריאה לפעולה | פעולת המשתמש המועדפת | מומלץ | כן | 15 תווים | התקנה |
| Star rating | מספר הכוכבים (0 עד 5) שמייצג את הדירוג של האפליקציה בחנות האפליקציות | מומלץ | לא | 0 - 5 | 4.5 |
| מחיר | עלות האפליקציה | מומלץ | לא | 15 תווים | חינם |
הערות לגבי אורך הטקסט
אם הקונה שולח נכס טקסט (למשל, גוף הטקסט) ארוך יותר ממספר התווים המקסימלי המוצע, יכול להיות ש-Google או בעל התוכן הדיגיטלי יקיצרו את הטקסט ויוסיפו לו קו נטוי. שימו לב שהמגבלות על חיתוך הטקסט הן חצי ממספר התווים שצוין בשפות סינית, יפנית וקוריאנית. לדוגמה: מגבלת התווים לכותרת היא 90 באנגלית ו-45 בסינית.
הערות לגבי גודל התמונה
בעלי אתרים רשאים:
- לחתוך את התמונה הראשית באופן סימטרי בשיעור של עד 20% בממד אחד (גובה או רוחב).
- לשנות את הגודל של התמונה בלי לשנות את יחס הגובה-רוחב שלה.
- יכול להיות שנסנן תמונות עם יחסי גובה-רוחב ששונים באופן משמעותי מאלה שמשתמעים מהגובה והרוחב.
תבנית של מודעת תוכן
בטבלה הבאה מפורטים השדות של תבנית של מודעה מסוג 'תוכן'. בעלי תוכן דיגיטלי משתמשים בשדות האלה כדי ליצור מודעות מותאמות ברשת המדיה.
| שדה | תיאור | חובה או מומלץ? | תמיד מוצגים? | גודל תמונה מומלץ/מספר תווים מקסימלי * | דוגמה |
|---|---|---|---|---|---|
| כותרת | כותרת המודעה | חובה | כן | 25 תווים | שיעורי הריבית הנמוכים ביותר למשכנתאות |
| תמונה | התמונה הראשית של המודעה | חובה | לא | 1,200px x 627px או 600px x 600px, בהתאם ליחס הגובה-רוחב שנדרש על ידי בעל התוכן הדיגיטלי. | <Ad's main image> |
| גוף | תוכן המודעה | חובה | לא | 90 תווים | בית חלומות בברוקלין – זול יותר ומוקדם יותר ממה שאתם חושבים! |
| לוגו | הלוגו של המפרסם או תמונה קטנה רלוונטית אחרת | מומלץ | לא | 128 x 128 פיקסלים | <NY Mortgage Inc.'s logo> |
| קריאה לפעולה | הפעולה המועדפת של המשתמש | מומלץ | לא | 15 תווים | לקבלת הצעת מחיר |
| מפרסם | טקסט המזהה את המפרסם או המותג | חובה | לא | 25 תווים | NY Mortgage Inc. |
תבנית של מודעת וידאו להתקנת אפליקציה
| שדה | תיאור | חובה או מומלץ? | תמיד מוצגים? | גודל תמונה מומלץ/מספר תווים מקסימלי * | דוגמה |
|---|---|---|---|---|---|
| וידאו | תגובת VAST של הסרטון, שמכילה את כל הנכסים הנדרשים להפעלה של מודעת וידאו. | חובה | לא | - | כתובת URL לקובץ VAST XML שמכיל Flood-It! מודעת וידאו |
| כותרת | שם האפליקציה | חובה | כן | 25 תווים | Flood-It! |
| תמונה | התמונה (הממוזערת) שמוצגת בנגן לפני שלוחצים על מודעת הווידאו או בזמן שהיא נטענת. | חובה | לא | מידות התמונה צריכות להתאים ליחס הגובה-רוחב של הסרטון (לדוגמה: 1280x720 לסרטון ביחס 16:9, 4x3 לסרטון ביחס 640x480). | צילום מסך מהמשחק Flood-It! או מהסרטון |
| גוף | הטקסט הראשי של האפליקציה | חובה | לא | 90 תווים | פשוט למראית עין ומאתגר להפליא = ממכר להפליא! |
| סמל האפליקציה | סמל האפליקציה | חובה | לא | 128 x 128 פיקסלים | סמל האפליקציה Flood-it! |
| קריאה לפעולה | פעולת המשתמש המועדפת | חובה | כן | 15 תווים | התקנה |
| Star rating | מספר הכוכבים (0 עד 5) שמייצג את הדירוג של האפליקציה בחנות האפליקציות | מומלץ | לא | 0 - 5 | 4.5 |
| מחיר | עלות האפליקציה | מומלץ | לא | 15 תווים | חינם |
הגבלות
סרטון: כל הסרטונים חייבים להיות בפורמט של כתובת URL של VAST או תג VAST. אי אפשר לציין קובץ וידאו גולמי כמו WebM, MP4 וכו'.
אורך הטקסט: אם הקונה מציין נכס טקסט כמו
bodyבתגובה, יכול להיות ש-Google או בעל התוכן הדיגיטלי יקיצרו אותו ויוסיפו לו קו נטוי. חשוב לזכור שהמגבלות על קיצור הטקסט הן חצי ממספר התווים שצוין בשפות סינית, יפנית וקוריאנית. לדוגמה: מגבלת התווים לכותרת היא 90 באנגלית ו-45 בסינית.גודל התמונה: בעלי אתרים רשאים:
- לחתוך את התמונה הראשית באופן סימטרי בשיעור של עד 20% בממד אחד (גובה או רוחב).
- לשנות את הגודל של התמונה בלי לשנות את יחס הגובה-רוחב שלה.
דוגמה למודעת התקנת אפליקציה
תבנית של מודעת וידאו לתוכן
| שדה | תיאור | חובה או מומלץ? | תמיד מוצגים? | גודל תמונה מומלץ/מספר תווים מקסימלי * | דוגמה |
|---|---|---|---|---|---|
| וידאו | תגובת VAST של הסרטון, שמכילה את כל הנכסים הנדרשים להפעלה של מודעת וידאו. | חובה | כן | - | כתובת URL לקובץ VAST XML שמכיל Flood-It! מודעת וידאו |
| כותרת | כותרת המודעה | חובה | כן | 25 תווים | שיעורי הריבית הנמוכים ביותר למשכנתאות |
| תמונה | התמונה (הממוזערת) שמוצגת בנגן לפני שלוחצים על מודעת הווידאו או בזמן שהיא נטענת. | חובה | לא | מידות התמונה צריכות להתאים ליחס הגובה-רוחב של הסרטון (לדוגמה: 1280x720 לסרטון ביחס 16:9, 4x3 לסרטון ביחס 640x480). | צילום מסך מהסרטון |
| גוף | תוכן המודעה | חובה | לא | 90 תווים | בית חלומות בברוקלין – זול יותר ומוקדם יותר ממה שאתם חושבים! |
| לוגו | הלוגו של המפרסם או תמונה קטנה רלוונטית אחרת | מומלץ | לא | 128 x 128 פיקסלים | הלוגו של NY Mortgage Inc. |
| קריאה לפעולה | הפעולה המועדפת של המשתמש | חובה | לא | 15 תווים | לקבלת הצעת מחיר |
| מפרסם | טקסט המזהה את המפרסם או המותג | חובה | לא | 25 תווים | NY Mortgage Inc. |
שדות מטא
כל תבניות המודעות הנתמכות משתפות את שדות המטא הבאים:
| פרוטוקול RTB של Google | המקבילה ב-OpenRTB | תיאור |
|---|---|---|
NativeAd.click_link_url |
Link.url |
כתובת ה-URL שתופעל על ידי הדפדפן כשהמשתמש ילחץ על המודעה.
יכול להיות השלב הראשון בשרשרת של הפניות אוטומטיות שמובילה בסופו של דבר לדף הנחיתה. במודעות נתמכות, מומלץ להשתמש בשדה click_link_url כדי להגדיר את היעד שאליו המשתמש יועבר בסופו של דבר. חובה להשתמש בשדה הזה במקרה של דפי נחיתה דינמיים. |
Ad.click_through_url |
Bid.adomain |
צריך להגדיר את השדה הזה אם המשתמש מעוניין להגיש הצעת מחיר. זוהי קבוצת כתובות ה-URL של היעד של קטע הטקסט, כולל כתובות ה-URL שהמשתמש יועבר אליהן אם הוא ילחץ על המודעה המוצגת, וכתובות URL שגלויות במודעה שעבר רינדור. אין לכלול קריאות ביניים לשרת המודעות שלא קשורות לדף הנחיתה הסופי. מערכת Google Ads תתעלם מ-BidResponse שמחזיר קטע קוד או מודעה וידאו, אבל מצהיר על כך שאין במודעות לא ילידיות, השדה לא משמש למעקב אחר קליקים או לכל פונקציונליות אחרת של מודעות. הוא משמש רק כהצהרה על כתובת אתר יעד. במודעות מותאמות אישית, אם הערך של |
NativeAd.click_tracking_urls |
Link.clicktrackers |
זה שינוי אופציונלי. כתובות URL נוספות שמאפשרות למפרסמים לעקוב אחרי קליקים של משתמשים על המודעה. |
Ad.ad_choices_destination_url |
BidExt.ad_choices_destination_url |
קישור לדף של העדפות מודעות או לדף שבו מבטלים את ההסכמה. אם הוא קיים, נוסף סמל AdChoices רגיל לקריאייטיב המקורי ומקושר לכתובת ה-URL הזו. התכונה הזו נתמכת במודעות נתמכות, אבל היא לא חלק מההודעה הנתמכת בתשובה לבידינג. |
Ad.impression_tracking_url |
NativeResponse.imptrackers |
צריך לעקוב אחרי החשיפות של המודעות הנתמכות ב-Native באמצעות impression_tracking_url בפרוטוקול של בידינג בזמן אמת של Authorized Buyers או באמצעות מודדים של חשיפות של מודעות נתמכות ב-Native ב-OpenRTB. |
שדות נדרשים ומומלצים בפרוטוקול RTB של Google
required_fields
ו-recommended_fields מצוינים על ידי בעלי התוכן הדיגיטלי. אנחנו מראים איך לתרגם את שדות הביטים האלה כדי לקבוע אם שדה הוא חובה או מומלץ.
בשדה ביטים, כל ביט של ערך בינארי משמש לאחסון טענת true או false, באופן שזהה לשליחת אותות בוליאניים רבים כמו is_logo_required או is_header_required, אבל כולם ארוזים יחד.
דוגמה
בדוגמה הזו נשתמש בערך required_fields של 1085.
קודם כול, מוצאים את הערך הבינארי המקביל:
10000111101
אחרי שמקבלים את הערך הבינארי, אפשר לבדוק את הביטים כדי לראות אם השדה נדרש (1) או לא נדרש (0).
בטבלה הבאה מפורטת המיפוי של השדות למיקום שלהם בערך הבינארי. קוראים את הערך הבינארי משמאל לימין, כאשר הביט '1' תואם למקום הימני ביותר בערך הבינארי.
| שדה | מיקום הערך הבינארי (ימין לשמאל) |
|---|---|
HEADLINE |
1 |
BODY |
2 |
CALL_TO_ACTION |
4 |
ADVERTISER |
8 |
IMAGE |
16 |
LOGO |
32 |
APP_ICON |
64 |
STAR_RATING |
128 |
PRICE |
256 |
STORE |
512 |
VIDEO |
1024 |
אם מסתכלים על הערך הבינארי לדוגמה 10000111101, הביט היחיד (בצד שמאל) הוא 1, שמציין ערך נדרש. לפי הטבלה, הביט היחיד תואם ל-HEADLINE.
ה-2 ביט (הערך השני מימין) הוא 0, כלומר לא נדרש. הביט השני תואם ל-BODY.
אלה כל שדות החובה שפורשו בדוגמה שלנו:
| ערך | תיאור | חובה? |
|---|---|---|
1 |
VIDEO |
כן |
0 |
STORE |
לא |
0 |
PRICE |
לא |
0 |
STAR_RATING |
לא |
0 |
APP_ICON |
לא |
1 |
LOGO |
כן |
1 |
IMAGE |
כן |
1 |
ADVERTISER |
כן |
1 |
CALL_TO_ACTION |
כן |
0 |
BODY |
לא |
1 |
HEADLINE |
כן |
ייצוג של תבנית המודעה המותאמת בבקשת הצעת המחיר
כשמקבלים בקשת הצעת מחיר שמכילה מלאי שטחי פרסום של מודעות מותאמות, היא מכילה את תבנית המודעה המותאמת בפורמטים שונים בהתאם לפרוטוקול שבו נעשה שימוש. מומלץ להשתמש ב-OpenRTB כי פרוטוקול Google הוצא משימוש.
ב-OpenRTB, תבנית המודעה המותאמת מתוארת באמצעות ההודעה NativeRequest. בפרוטוקול RTB של Google, הוא מתואר באמצעות NativeAdTemplate. ההודעות האלה כוללות את הפרטים הבאים לגבי מלאי שטחי הפרסום של המודעות המותאמות:
- שדות נדרשים או מומלצים.
- מידות של תמונות, סמלי לוגו וסמלי אפליקציות.
- מפרטי הסגנון שבו המודעה עוברת רינדור.
מזהי נכסים ב-OpenRTB
ב-OpenRTB, בבקשת הצעת המחיר מועברת מערך של נכסים שמתארים את המבנה של המודעה המוטמעת שאתם צריכים להחזיר בתגובה. לכל נכס בבקשה יהיה מזהה שצריך לציין לנכס התואם בתגובה. דוגמה לאופן שבו המזהים האלה תואמים בין הבקשה לתגובה מופיעה בדוגמה לבקשת הצעת מחיר רגילה ובדוגמה לתגובה להצעת מחיר רגילה.
ייצוג של מודעה מותאמת בתגובה להצעת מחיר
כשמבצעים בידינג על מלאי שטחי פרסום מותאם אישית, הקונה צריך לאכלס את השדות הנדרשים שזוהו בבקשת הצעת המחיר. ב-OpenRTB, אפשר לעשות זאת באמצעות BidResponse.seatbid.bid.adm_native כשמשתמשים ב-Protobuf, או באמצעות BidResponse.seatbid.bid.adm ל-JSON. בפרוטוקול Google שהוצא משימוש, הדבר נעשה באמצעות השדה BidResponse.ad.native_ad.
דוגמאות לבקשות להצעת מחיר
בקשות להצעות מחיר למודעות שאינן וידאו
הצגת הדוגמה
בקשה בסריאליזציהid: "l6210s8bS8Uc726V81B821" imp { id: "1" tagid: "3019814809" bidfloor: 0.06 bidfloorcur: "USD" secure: true native { ver: "1.2" request_native { ver: "1.2" assets { id: 1 required: true title { len: 25 } } assets { id: 2 required: true data { type: DESC len: 90 } } assets { id: 3 data { type: CTATEXT len: 15 } } assets { id: 4 required: true img { type: MAIN wmin: 1200 hmin: 627 } } assets { id: 5 img { type: LOGO wmin: 100 hmin: 100 } } eventtrackers { event: IMPRESSION methods: IMG } privacy: true [com.google.doubleclick.native_ext] { style_id: 497439 style_height: 1 style_width: 1 style_layout_type: FLUID } } } exp: 3600 metric { type: "click_through_rate" value: 0.0006697923527099192 vendor: "EXCHANGE" } metric { type: "viewability" value: 0.05 vendor: "EXCHANGE" } [com.google.doubleclick.imp] { billing_id: 50577321529 dfp_ad_unit_code: "/3711494/google/test" ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED buyer_generated_request_data { data: "Test Data" } excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } open_bidding { is_open_bidding: true } creative_enforcement_settings { policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_OVERRIDDEN } auction_environment: SERVER_SIDE_AUCTION ae: SERVER_SIDE_AUCTION } } site { page: "https://www.google.com" publisher { id: "pub-1111111111111111" [com.google.doubleclick.publisher] { country: "FR" } } content { livestream: false language: "fr" } [com.google.doubleclick.site] { amp: DIALECT_HTML page_visibility: VISIBILITY_STATE_VISIBLE inventorypartnerdomain: "" ntype: NAVIGATION_TYPE_NAVIGATE } } device { ua: "OMITTED" geo { lat: 0.0 lon: 0.0 country: "FRA" region: "FR-C" zip: "63120" type: IP utcoffset: 120 accuracy: 6948 [com.google.doubleclick.geo] { geo_criteria_id: 9112278 } } ipv6: "2a01:cb14:8183::" os: "Windows" devicetype: PERSONAL_COMPUTER lmt: false pxratio: 1.0 sua { browsers { brand: "Chromium" version: "130" version: "0" } browsers { brand: "Microsoft Edge" version: "130" version: "0" } platform { brand: "Windows" version: "15" version: "0" } mobile: false architecture: "x86" bitness: "64" source: CLIENT_HINTS_HIGH_ENTROPY } } user { [com.google.doubleclick.user] { consented_providers_settings { consented_providers: 1712 consented_providers: 2316 additional_consent: "OMITTED" } consent: "OMITTED" eids { source: "OMITTED" uids { id: "12JD92JD8078S8J29SDOAKC0EF230337" } } } } at: FIRST_PRICE tmax: 350 cur: "USD" regs { gpp: "OMITTED" [com.google.doubleclick.regs] { gdpr: true } } source { schain { complete: true nodes { asi: "testssp.com" sid: "pub-1111111111111111" hp: true } ver: "1.0" } [com.google.doubleclick.source] { schain { complete: 1 nodes { asi: "testssp.com" sid: "pub-1111111111111111" hp: 1 } ver: "1.0" } } } [com.google.doubleclick.bid_request] { google_query_id: "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v" fcap_scope: FREQUENCY_CAPPING_SCOPE_NONE }
הצגת הדוגמה
{ "id": "l6210s8bS8Uc726V81B821", "imp": [ { "id": "1", "tagid": "3019814809", "bidfloor": 0.06, "bidfloorcur": "USD", "secure": 1, "native": { "ver": "1.2", "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"id\":2,\"required\":1,\"data\":{\"type\":2,\"len\":90}},{\"id\":3,\"data\":{\"type\":12,\"len\":15}},{\"id\":4,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}},{\"id\":5,\"img\":{\"type\":2,\"wmin\":100,\"hmin\":100}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"privacy\":1,\"ext\":{\"style_id\":497439,\"style_height\":1,\"style_width\":1,\"style_layout_type\":1}}" }, "exp": 3600, "metric": [ { "type": "click_through_rate", "value": 0.0006697923527099192, "vendor": "EXCHANGE" }, { "type": "viewability", "value": 0.05, "vendor": "EXCHANGE" } ], "ext": { "billing_id": [ "50577321529" ], "dfp_ad_unit_code": "/3711494/google/test", "ampad": 3, "buyer_generated_request_data": [ { "data": "Test Data" } ], "excluded_creatives": [ { "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID" }, { "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID" } ], "open_bidding": { "is_open_bidding": 1 }, "creative_enforcement_settings": { "policy_enforcement": 1, "publisher_blocks_enforcement": 2 }, "auction_environment": 0, "ae": 0 } } ], "site": { "page": "https://www.google.com", "publisher": { "id": "pub-1111111111111111", "ext": { "country": "FR" } }, "content": { "livestream": 0, "language": "fr" }, "ext": { "amp": 0, "page_visibility": 1, "inventorypartnerdomain": "OMITTED", "ntype": 1 } }, "device": { "ua": "OMITTED", "geo": { "lat": 0.0, "lon": 0.0, "country": "FRA", "region": "FR-C", "zip": "63120", "type": 2, "utcoffset": 120, "accuracy": 6948, "ext": { "geo_criteria_id": 9112278 } }, "ipv6": "2a01:cb14:8183::", "os": "Windows", "devicetype": 2, "lmt": 0, "pxratio": 1.0, "sua": { "browsers": [ { "brand": "Chromium", "version": [ "130", "0" ] }, { "brand": "Microsoft Edge", "version": [ "130", "0" ] } ], "platform": { "brand": "Windows", "version": [ "15", "0" ] }, "mobile": 0, "architecture": "x86", "bitness": "64", "source": 2 } }, "user": { "ext": { "consented_providers_settings": { "consented_providers": [ "1712", "2316" ], "additional_consent": "OMITTED" }, "consent": "OMITTED", "eids": [ { "source": "OMITTED", "uids": [ { "id": "12JD92JD8078S8J29SDOAKC0EF230337" } ] } ] } }, "at": 1, "tmax": 350, "cur": [ "USD" ], "regs": { "gpp": "OMITTED", "ext": { "gdpr": 1 } }, "source": { "schain": { "complete": 1, "nodes": [ { "asi": "testssp.com", "sid": "pub-1111111111111111", "hp": 1 } ], "ver": "1.0" }, "ext": { "schain": { "complete": 1, "nodes": [ { "asi": "testssp.com", "sid": "pub-1111111111111111", "hp": 1 } ], "ver": "1.0" } } }, "ext": { "google_query_id": "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v", "fcap_scope": 1 } }
הצגת הדוגמה
בקשה בסריאליזציהid: "\213\371#\236Mh\214uJ\356\225qW88=7|\2448\315Wx" ip: "\300\250" user_agent: "OMITTED" url: "https://www.google.com" detected_language: "it" adslot { id: 1 excluded_attribute: 14 excluded_attribute: 32 allowed_vendor_type: 42 allowed_vendor_type: 144 excluded_sensitive_category: 36 excluded_sensitive_category: 19 matching_ad_data { billing_id: 74792558829 billing_id: 11204117851 minimum_cpm_micros: 390000 } matching_ad_data { billing_id: 44428418146 billing_id: 91112044263 minimum_cpm_micros: 110000 } slot_visibility: BELOW_THE_FOLD excluded_product_category: 10366 excluded_product_category: 11504 ad_block_key: 8767661977 publisher_settings_list_id: 7807286827624818876 publisher_settings_list_id: 8186380472781289268 allowed_restricted_category: 32 allowed_restricted_category: 33 excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } iframing_state: UNKNOWN_IFRAME_STATE viewability: 6 allowed_restricted_category_for_deals: 32 allowed_restricted_category_for_deals: 33 click_through_rate: 0.0010397299 allowed_ad_types: ALLOWED_AD_TYPE_NATIVE is_amp_page: DIALECT_HTML amp_ad_requirement_type: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED secure_signals { data: "Test Data: bw44G12BFZ" source: "OMITTED" } consented_providers_settings { tcf_consent_string: "OMITTED" additional_consent_string: "OMITTED" } regs_gdpr: true native_ad_template { required_fields: 17 recommended_fields: 0 headline_max_safe_length: 90 body_max_safe_length: 90 call_to_action_max_safe_length: 15 advertiser_max_safe_length: 25 image_width: 1200 image_height: 627 style_id: 749853 style_layout_type: FLUID style_height: 1 style_width: 1 } creative_enforcement_settings { policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES } auction_environment: SERVER_SIDE_AUCTION impression_expiration_seconds: 3600 supported_auction_environment: SERVER_SIDE_AUCTION } is_test: false timezone_offset: 120 geo_criteria_id: 1008463 bid_response_feedback { request_id: "\314\354d\177=@0\271\226a^\250\302u\037\301" creative_status_code: 1 event_notification_token: "token" buyer_creative_id: "test_creative_id_744913" minimum_bid_to_win: 220000 feedback_type: BID_FEEDBACK } bid_response_feedback { request_id: "\2354\335\340\347!\341~\265\n\206\327\300\005\370G" creative_status_code: 80 event_notification_token: "token" buyer_creative_id: "test_creative_id_744913" minimum_bid_to_win: 3450000 feedback_type: BID_FEEDBACK } publisher_type: PUBLISHER_OWNED_AND_OPERATED device { device_type: PERSONAL_COMPUTER platform: "Windows" screen_pixel_ratio_millis: 1000 limit_ad_tracking: false } publisher_country: "IT" publisher_id: "pub-1111111111111111" response_deadline_ms: 350 google_query_id: "ANy-zJXQF6-ob5v09r508m39543114QNHDY20RX67Ajs996K62nkEpcMuvWam950XP9486e6" auction_type: FIRST_PRICE geo { lat: 0.0 lon: 0.0 country: "ITA" region: "IT-MI" city: "Milan" utcoffset: 120 accuracy: 6821 } user_agent_data { platform { brand: "Windows" version: "10" version: "0" } mobile: false architecture: "x86" browsers { brand: "Chromium" version: "128" version: "0" } browsers { brand: "Not;A=Brand" version: "24" version: "0" } bitness: "64" source: CLIENT_HINTS_HIGH_ENTROPY } page_visibility: VISIBILITY_STATE_VISIBLE supply_chain { complete: true nodes { advertising_system_identifier: "testdomain.com" seller_identifier: "pub-1111111111111111" handles_payment: true } version: "1.0" } frequency_capping_scope: FREQUENCY_CAPPING_SCOPE_NONE privacy_treatments { allow_user_data_collection: true } inventory_partner_domain: "OMITTED"
בקשות להצעות מחיר למודעות וידאו
{ id: "\\\123/f\000\t\456&\n\789\1234\"\001a\123", ip: "\0338\355", google_user_id: "CAESEJ1ur2l94_8ruuu", cookie_version: 1, cookie_age_seconds: 5184000, hosted_match_data: "W9ABDAAAAGR67nl0", user_agent: "Mozilla/5.0 (Linux; Android 5.1; CP8298_I00) Mobile Safari/537.36", publisher_country: "IN", geo_criteria_id: 1007796, timezone_offset: 330, publisher_id: "pub-2230723027927371", seller_network_id: 989, url: "https://m.example.com", detected_language: [en], google_query_id: "ANy-zJEgdus4l0MishbSmH0eOcXUA1Fbo4_tKROsbR37q", auction_type: "SECOND_PRICE", device: { device_type: "HIGHEND_PHONE", platform: "android", brand: "coolpad", model: "cp8298_i00", os_version: { major: 5, minor: 1 }, carrier_id: 70210, screen_width: 360, screen_height: 640, screen_pixel_ratio_millis: 2000 }, mobile: { is_app: false, is_mobile_web_optimized: true, DEPRECATED_platform: "android", DEPRECATED_mobile_device_type: "HIGHEND_PHONE", DEPRECATED_brand: "coolpad", DEPRECATED_model: "cp8298_i00", DEPRECATED_os_version: { os_version_major: 5, os_version_minor: 1 }, DEPRECATED_screen_width: 360, DEPRECATED_screen_height: 640, DEPRECATED_carrier_id: 70210, DEPRECATED_device_pixel_ratio_millis: 2000 }, publisher_type: "ADX_PUBLISHER_OWNED_AND_OPERATED", adslot: [{ id: 1, ad_block_key: 2882274820, width: [300,250], height: [250,250], excluded_attribute: [114,22,34,25,27,13,14,15,16,17,18,19,20,25,27,22], allowed_vendor_type: [42,144,575,698,704,743,776,785,793,797,808,828,832,885], excluded_sensitive_category: [36,27,19,4,23,30,10,3,31,5,8,37,18], excluded_product_category: [10031,11669,13423,13525,13566,13589,13612,13740], excluded_creatives: [{ buyer_creative_id: "1234567.1234567890-ssl" }], matching_ad_data: [{ billing_id: [6629616415,51386650457], minimum_cpm_micros: 1380000, direct_deal: [{ direct_deal_id: 410401, fixed_cpm_micros: 1360000, deal_type: "PREFERRED_DEAL", publisher_blocks_overridden: true },{ direct_deal_id: 240644, fixed_cpm_micros: 1500000, deal_type: "PREFERRED_DEAL", publisher_blocks_overridden: true }] },{ billing_id: [1234567890], minimum_cpm_micros: 1380000 }], publisher_settings_list_id: [12109930661871909476,11138951146123409010], slot_visibility: "BELOW_THE_FOLD", viewability: 30, click_through_rate: 0.0010072842, iframing_state: "UNKNOWN_IFRAME_STATE", native_ad_template: [{ required_fields: 1065, recommended_fields: 4, headline_max_safe_length: 25, body_max_safe_length: 90, call_to_action_max_safe_length: 15, advertiser_max_safe_length: 25, logo_width: 100, logo_height: 100, style_id: 199892, style_height: 250, style_width: 300 }], sticky_settings: { }, renderer: "GOOGLE", is_amp_page: "DIALECT_HTML", amp_ad_requirement_type: "AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED", allowed_ad_types: [ALLOWED_AD_TYPE_BANNER,ALLOWED_AD_TYPE_NATIVE], session_depth: 1, internal_data: { } }], response_deadline_ms: 122, is_test: false }
תגובות לדוגמה לבקשות להצעת מחיר
תגובות לבקשות להצעת מחיר שאינן סרטונים
הצגת הדוגמה
תגובה בסריאליזציהid: "22i22S9494PQl819H7Ld5K" seatbid { bid { id: "2GTnPXOn76gg1C6574T" impid: "1" price: 0.24 adid: "test_creative_id_713312" adomain: "google.com" crid: "test_creative_id_713312" exp: 300 language: "xx" adm_native { ver: "1.2" assets { id: 1 title { text: "Luxury Mars Cruises" } } assets { id: 2 data { value: "Visit the planet in a luxury spaceship." } } assets { id: 3 data { value: "Book today" } } assets { id: 4 img { url: "https://native.test.com/image?id=123456" w: 1200 h: 627 } } assets { id: 5 img { url: "https://native.test.com/logo?id=123456" w: 1200 h: 1200 } } link { url: "https://www.google.com" clicktrackers: "https://native.test.com/click?id=123456" } eventtrackers { event: IMPRESSION method: IMG url: "https://test.com/event?id=123456" } eventtrackers { event: IMPRESSION method: IMG url: "https://test.com/event?id=123456" } privacy: "https://adssettings.google.com/whythisad?source=display&reasons=OMITTED" } [com.google.doubleclick.bid] { event_notification_token { payload: "token" } billing_id: 50577321529 third_party_buyer_token: "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7" } } seat: "5249:9218:332606" } cur: "USD"
הצגת הדוגמה
{ "id": "22i22S9494PQl819H7Ld5K", "seatbid": [ { "bid": [ { "id": "2GTnPXOn76gg1C6574T", "impid": "1", "price": 0.24, "adid": "test_creative_id_713312", "adomain": [ "google.com" ], "crid": "test_creative_id_713312", "exp": 300, "language": "xx", "ext": { "event_notification_token": { "payload": "token" }, "billing_id": "50577321529", "third_party_buyer_token": "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7" }, "adm": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}},{\"id\":5,\"img\":{\"url\":\"https://native.test.com/logo?id=123456\",\"w\":1200,\"h\":1200}}],\"link\":{\"url\":\"https://www.google.com\",\"clicktrackers\":[\"https://native.test.com/click?id=123456\"]},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"},{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}" } ], "seat": "5249:9218:332606" } ], "cur": "USD" }
הצגת הדוגמה
תגובה בסריאליזציהad { adslot { id: 1 max_cpm_micros: 110734 min_cpm_micros: 0 billing_id: 74792558829 deal_id: 0 } click_through_url: "google.com" attribute: 47 attribute: 8 buyer_creative_id: "test_creative_id_907643" advertiser_name: "Google" native_ad { headline: "Luxury Mars Cruises" body: "Visit the planet in a luxury spaceship." call_to_action: "Book today" advertiser: "Galactic Luxury Cruises" image { url: "https://native.test.com/image?id=123456" width: 800 height: 800 } logo { url: "https://native.test.com/logo?id=123456" width: 200 height: 200 } price: "\342\202\254 225" click_link_url: "https://www.google.com" } impression_tracking_url: "https://test.com/imp?id=123456" impression_tracking_url: "https://test.com/imp?id=123456" ad_choices_destination_url: "https://test.com/preferences" event_notification_token: "token" dsa_transparency { buyer_render: true } } processing_time_ms: 27
תגובות לבקשות להצעת מחיר על מודעות וידאו
bid_response { ad { ... click_through_url: "https://www.exampleDomain.com" impression_tracking_url: "https://my_impression_tracking_url.com/" ad_choices_destination_url: "https://my_ad_choices_destination_url.com/" ... native_ad { headline: "Lowest mortgage rates" video_url: "https://pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/124319096/external/single_ad_samples&ciu_szs=300x250&impl=s&gdfp_req=1&env=vp&output=vast" call_to_action: "Get a quote" advertiser: "NY Mortgage Inc." image { url: "https://www.example.net/mypromoimage.png" width: 1200 height: 700 } logo { url: "https://www.example.net/mylogo.png" width: 200 height: 200 } click_link_url: "https://r1.example.com/r/u1dhfh3cow00/b1_googleadx/830/41972/ ?_b_ctrl=1" click_tracking_urls: "https://my_click_tracking_url.com/" } } }