דף זה תורגם על ידי Cloud Translation API.

יצירת תגובה

אחרי שהאפליקציה תעבד את הבקשה להצעת מחיר מ-Google, היא צריכה ליצור ולשלוח תשובה. במדריך הזה מוסבר איך לתכנת את האפליקציה כדי ליצור את התשובה.

יצירת הודעת Protobuf BidResponse

Authorized Buyers שולח את BidRequest כגוף ההודעה של POST של HTTP. אם נקודת הקצה לבידינג מוגדרת לשימוש בפורמט Protobuf, האפליקציה צריכה לשלוח תשובה עם הכותרת Content-Type שמוגדרת כ-application/octet-stream וגוף הודעה שמכיל פרוטוקול של מאגר נתונים בסדרה. מאגר הפרוטוקול הוא הודעה מסוג BidResponse כפי שמוגדר ב-openrtb.proto. האפליקציה שלך חייבת להחזיר קובץ מנתח BidResponse בתגובה לכל BidRequest. זמן קצוב לתפוגה ותשובות שלא ניתן לנתח נחשבות לשגיאות, ו-Google מגבילה את קצב שליחת הצעות המחיר של בידינגרים עם שיעורי שגיאה גבוהים.

אם אתם לא רוצים להגיש הצעות מחיר על חשיפות, תוכלו להגדיר רק את השדה BidResponse.ext.processing_time_ms ולהשאיר את כל השדות האחרים ריקים. אפשר לקבל את openrtb.proto מ נתוני עזר.

מזהה הקריאייטיב

הערך BidResponse מציין קריאייטיב דרך שדה BidResponse.seatbid.bid.crid (מגבלה של 64 בייטים). גם לנכסי קריאייטיב דומים צריכים להיות ערכים ייחודיים בשדה הזה אם יש להם מאפיינים בולטים שונים, כולל, בין היתר: גודל, כתובת URL שהוצהרה, מאפייני קריאייטיב וסוגים של ספקים. במילים אחרות, עליכם להקצות מזהי קריאייטיב שונים לשתי מודעות:

מראה או התנהגות שונים.
עיבוד לתמונות שונות.
עיבוד באמצעות אמצעים שונים (לדוגמה, מודעה אחת מורכבת מתמונה והשנייה מורכבת מסרטון).

כשמעצבים את האפליקציה, צריך להחליט על דרך שיטתית ליצירת מזהים שתתאים לסוגי הקריאייטיב שאתם מתכננים לשלוח.

מאפייני מודעה

Google ממליצה להצהיר על מאפייני קריאייטיב כדי לתאר את המודעה המאפיינים והטירגוט שלו באמצעות שילוב של BidResponse.seatbid.bid.apis והקבוצה BidResponse.seatbid.bid.attr, או תוסף BidResponse.seatbid.bid.ext.attribute. בהמשך מוסבר איך מגדירים מאפיינים:

VPAID
מגדירים את BidResponse.seatbid.bid.apis לערך VPAID_1 או VPAID_2. בפורמט JSON, אפשר להגדיר את הערך הזה כך: 1 או 2 בהתאמה.
MRAID
מגדירים את BidResponse.seatbid.bid.apis לערך MRAID_1 או 3 עבור פורמט JSON.
SIZELESS
הגדרה של BidResponse.seatbid.bid.attr לערך RESPONSIVE, או 18 בשביל ה-JSON הפורמט.
PLAYABLE
כדי לציין זאת, מגדירים את BidResponse.seatbid.bid.attr לערך USER_INTERACTIVE או 13 לפורמט JSON.

הערה: אם משתמשים התוסף BidResponse.seatbid.bid.ext.attribute, אפשר להשתמש בו ערכים שנמצאו ב- buyer-declarable-creative-attributes.txt כדי להצהיר על המאפיינים האלה.

במאמר משאב בנושא נכסי קריאייטיב מוסבר איך לקבל משוב לגבי המאפיינים שזוהו בנכסי הקריאייטיב.

שדות של Open Bidding

תגובות לבקשות להצעת מחיר שנשלחו ממגישי הצעות מחיר ב-Exchange וברשת של מגישי הצעות מחיר שמשתתפים בתוכנית Open. הבידינג דומה לשיטות הבידינג של Authorized Buyers שמשתתפים בתוכנית הרגילה בידינג בזמן אמת. לקוחות שמשתמשים ב-Open Bidding יכולים לציין מספר קטן בשדות נוספים, ובכמה שדות קיימים עשויים להיות שימושים חלופיים. למשל:

OpenRTB	Authorized Buyers	פרטים
`BidResponse.imp[].pmp.deals[].id`	`BidResponse.ad[].adslot[].exchange_deal_id`	מזהה העסקה ממרחב השמות של פלטפורמת ה-Exchange שמשויך לבידינג הזה ומדווח לבעלי האפליקציות. הערה: השדה הזה נשלח רק למשתתפים בגרסת בטא סגורה.
`BidResponse.seatbid[].bid[].ext.exchange_deal_type`	`BidResponse.ad[].adslot[].exchange_deal_type`	סוג העסקה שמדווח לבעלי התוכן הדיגיטלי, שמשפיע על האופן שבו העסקה מטופלת במכרז. הערה: השדה הזה נשלח רק למשתתפים בגרסת בטא סגורה.
`BidResponse.seatbid[].bid[].ext.third_party_buyer_token`	`BidResponse.ad[].adslot[].third_party_buyer_token`	אסימון המשמש לזיהוי פרטי הקונה הסופי מצד שלישי, אם מערכת ה-Exchange כמציע במכרז Open Bidding היא מתווך. הוא מתקבל קונה מצד שלישי ויש להעבירו אל Google ללא שינוי בהצעת המחיר תשובה.

המלצות

להפעיל חיבורי HTTPS מתמידים (שנקראים גם 'Keep-alive', או 'שימוש חוזר בחיבור') בשרתים. כדאי להגדיר את הזמן הקצוב לתפוגה ל-10 שניות לפחות. במקרים רבים, כדאי להגדיר זמן קצוב ארוך יותר. Google מאמתת זאת במהלך בדיקות זמן האחזור הראשוניות של האפליקציה, כי תוכנית Authorized Buyers שולחת בקשות בקצב גבוה וצריך להימנע מהזמן הנוסף שנדרש ליצירת חיבור TCP נפרד לכל בקשה.
מומלץ לכלול את כתובת ה-URL האופציונלית למעקב אחר חשיפות כדי לעקוב אחרי הזמן שבו החשיפות מוצגות, ולא אחרי הזמן שבו המשתמש שהגיש את הצעת המחיר הגבוהה ביותר זכה. בגלל הנטישה בין ניצחונות לבין עיבודים, כך מתקבל מעקב מדויק יותר סטטיסטיים.

הערה: כשמשתמשים ב-OpenRTB, השדה הרגיל לכך הוא BidResponse.seatbid.bid.burl.
עליכם לדאוג שהקוד של מגיש הצעות המחיר לא תלוי בשדות שהוצאו משימוש. מה שעלול לגרום להצעות מחיר להיכשל ולגרום לשגיאות.
כוללים את BidResponse.seatbid.bid.w ו-BidResponse.seatbid.bid.h ב-BidResponse. א' BidResponse לבקשה שכוללת כמה גדלים של מודעה חייבת כוללים את השדות האלה, אחרת הם יוסרו מהמכרז.
אפשר להגביל את גודל התשובה לערך של פחות מ-8K. תגובות גדולות מאוד עלולות להאריך את זמן האחזור ברשת ולגרום לחריגות מזמן הקצוב.
צריך לפעול לפי ההנחיות עבור הצעות מחיר על מלאי שטחי פרסום ב-iOS שמחייבים שיוך (Attribution) של SKAdNetwork.

דוגמה לתגובה להצעת מחיר

הדוגמאות הבאות מייצגות בקשות Protobuf ו-JSON שקריאות לבני אדם.

OpenRTB Protobuf

אני רוצה לראות את הדוגמה

id: "q745y3S4jz5Qg43A6izy2V"
seatbid {
  bid {
    id: "Fi366E0I1RN4Ofm8Ug5"
    impid: "1"
    price: 0.02
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "51570472186"
    crid: "test_creative_id_520474"
    w: 468
    h: 60
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 51570472186
    }
  }
  seat: "1608:1311:489067"
}
bidid: "6930l9D4-1A9090lR-451S-01g3xTZv8382"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 100
}

קובץ JSON של OpenRTB

אני רוצה לראות את הדוגמה

{
  "id": "sW2R7543D2w77f0542uu0F",
  "seatbid": [
    {
      "bid": [
        {
          "id": "U4495qveIO2A83s1iOs",
          "impid": "1",
          "price": 0.10701,
          "adid": "test_creative_id_323125",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "54460865479",
          "crid": "test_creative_id_323125",
          "w": 300,
          "h": 250,
          "ext": {
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "1506:2993:976791"
    }
  ],
  "bidid": "WN7415ff-hN7R6080-3txk-r0J45ckY5970"
}

Google

אני רוצה לראות את הדוגמה

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 10100
    billing_id: 30279159795
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_766108"
  advertiser_name: "Google"
  width: 320
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 8

חשוב: הודעות ה-Protobuf שמופיעות ב הדוגמאות מיוצגות כאן כטקסט קריא לאנשים. עם זאת, זו לא הדרך ההודעות נשלחות דרך החוט. כשמשתמשים בפורמט Protobuf של Google או OpenRTB, מתקבלות רק הודעות BidResponse בסדרה.

אפשר ליצור הודעה מסוג BidResponse ולסדר אותה בסדרת ביטים באמצעות הקוד הבא ב-C++‎:

BidResponse bid_response;
// fill in bid response with bid information
string post_response;
if (bid_response.SerializeToString(&post_response)) {
  // respond to the POST with post_response as the content
} else {
  // return an error to the POST
}

ציון הקריאייטיב

התגובה להצעת מחיר מציינת את הקריאייטיב שיוצג אם הצעת המחיר תזכה. הצעת המחיר חייבת לכלול אחד מהפורמטים הנתמכים של המודעות (AMP, וידאו, מודעות מותאמות). כאן אנחנו מציינים את הקריאייטיב באמצעות השדה html_snippet.

לחלופין, אפשר לציין את הקריאייטיב באמצעות אחד על סמך פורמט המודעה:

מודעה שעבר עיבוד על ידי SDK
- BidResponse.seatbid.bid.ext.sdk_rendered_ad
דפי AMP
- BidResponse.seatbid.bid.amp_ad_url
וידאו
- BidResponse.seatbid.bid.adm
מותאמת
- BidResponse.seatbid.bid.adm_native

מציינים מודעה שמתארחת בשרתים שלכם באמצעות קטע קוד HTML בשדה BidResponse.seatbid.bid.adm. קטע הקוד מוקף ב-iFrame שמוחדר בדף האינטרנט, וכתוצאה מכך המודעה מאוחזרת ומוצגת כשהדף נטען. צריך ליצור את קטע קוד ה-HTML כך מודעה (מודעת באנר או מודעת מעברון) מוצגת בצורה תקינה בתוך iFrame, וב המתאים למיקום המודעה שעליו אתם מגישים הצעות מחיר.

בנוסף, גודל המודעה המוצהר בתגובה להצעת מחיר חייב להתאים בדיוק לאחד של שילובי הגדלים בבקשה להצעת המחיר כאשר:

המודעה היא מודעת באנר רגילה (לא מודעת וידאו, מודעת וידאו מותאמת או מודעת מעברון).
המגיש הצעת המחיר הצהיר על הגודל בתשובה להצעת המחיר. הצהרת הגודל היא נדרש כשבבקשה מופיע יותר מגודל אחד.
יש חריג למודעות מעברון. הרוחב של מודעות מעברון צריך להיות לפחות 50% מרוחב המסך ואת הגובה של 40% לפחות את גובה המסך.

אפשר לציין נכס קריאייטיב מסוג קטע קוד HTML באמצעות כל קוד HTML תקין שמוצג בצורה תקינה, אבל חשוב לזכור את ההגבלות על ציון השדה crid בקטע יצירת הודעת BidResponse. אחת מהשימושים האפשריים היא להוסיף מידע נוסף לארגומנטים של כתובות ה-URL שאוחזרות מהשרתים שלכם כחלק מהעיבוד של המודעה. כך תוכלו להעביר חזרה לשרתים שלכם נתונים שרירותיים לגבי החשיפות.

רוב כללי המדיניות לגבי קטעי HTML שמוחזרים בתשובות לבקשות להצעת מחיר זהים לכללי המדיניות לגבי מודעות של צד שלישי. מידע נוסף זמין במאמרים הנחיות התוכנית של Authorized Buyers, דרישות להצגת מודעות על ידי צד שלישי והצהרה על כתובות URL לקליק-תורן במודעות.

ציון רכיבי מאקרו

פקודות מאקרו הן טקסט שמוטמע בשדות מסוימים של תגובה להצעות מחיר, כתובות URL שמוחלפות בערך רלוונטי בזמן הצגת המודעה. לדוגמה, אם הצעת המחיר הזוכה כללה את המאקרו AUCTION_PRICE ב-HTML בקטע הקריאייטיב שנכלל בהצעת המחיר שלך, המאקרו יוחלף שאפשר לפענח אותו כדי לקבוע את הסכום ששילמתם על החשיפה המכרז.

אפשר לכלול מק"טים בשדות הבאים:

BidResponse.seatbid.bid.adm

יש תמיכה במאקרו בפורמטים הבאים: קטע קוד HTML, מודעות וידאו מותאמות אישית, כתובת URL של סרטון ו-VAST XML של סרטון.
BidResponse.seatbid.bid.adm_native.eventtrackers.url
BidResponse.seatbid.bid.adm_native.imptrackers
BidResponse.seatbid.bid.ext.amp_ad_url

רק WINNING_PRICE ותגים ספציפיים ל-Google יש תמיכה בפקודות מאקרו WINNING_PRICE_ESC לקריאייטיבים של AMP.
BidResponse.seatbid.bid.burl
BidResponse.seatbid.bid.ext.impression_tracking_url

משתמשים באפשרות הזו במקום ב-BidResponse.seatbid.bid.burl אם צריך יותר מכתובת URL אחת לחיוב.

לדוגמה, אפשר לכלול מאקרו כחלק מקטע HTML על ידי הטמעת ${MACRO} בכתובת ה-URL שמשמש לאחזור הקריאייטיב, כאשר MACRO הוא אחת מפקודות המאקרו הנתמכות שמתוארות במפרט OpenRTB.

פקודות מאקרו של Google RTB

Google תומכת בפקודות מאקרו נוספות מלבד אלה שנמצאות ב-OpenRTB מפרט הם מופיעים בפורמט שונה, והם יופיעו כך %%MACRO%% אם הוא מוטמע בכתובת URL. הטבלה הבאה מתארת פקודות המאקרו הבאות:

מאקרו	תיאור
`ADVERTISING_IDENTIFIER`	מאפשרת לקונים לקבל IDFA של iOS או מזהה פרסום של Android בזמן עיבוד החשיפה. למידע נוסף בנושא פענוח של מזהי המפרסם אפשר לקבל פרטים נוספים.
`CACHEBUSTER`	ייצוג מחרוזת של מספר שלם אקראי ללא סימן באורך ארבעה בייטים.
`CLICK_URL_UNESC`	כתובת ה-URL של הקליק על המודעה, המערכת לא תסמן בתו מילוט (escape). בקטע הקוד, תו בריחה (escape) של כתובת האתר לקליקים של צד שלישי צריכה להופיע ישירות במאקרו. לדוגמה, אם כתובת ה-URL של הקליק של הצד השלישי היא `http://my.adserver.com/some/path/handleclick?click=clk`, אפשר להשתמש בקוד הבא עם הגרסה עם תווי בריחה (escape) יחיד. של כתובת ה-URL לקליקים של צד שלישי לאחר הפעלת המאקרו: <a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> בזמן הצגת המודעה, הגודל הזה מתרחב ל: <a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> כתובת ה-URL קודם כל תרשום את הקליק ב-Google, ואז תפנה לכתובת אחרת לכתובת האתר לקליקים של הצד השלישי.
`CLICK_URL_ESC`	כתובת ה-URL של הקליק על המודעה עם תווי ה-escape. שימוש בטיוטה הזו במקום `CLICK_URL_UNESC` אם צריך להעביר קודם את הערך באמצעות שרת אחר שיחזיר הפניה אוטומטית. לדוגמה, ניתן להשתמש בקוד הבא בקטע קוד HTML: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a> בזמן הצגת המודעה, האפשרויות האלה מורחבות: <a href="http://my.adserver.com/click?google_click_url=http://google-click- url%3F...%26ad_url%3D"></a> הפעולה הזו תירשם את הקליק ב-`my.adserver.com`, שתהיה אחראית להפניה לכתובת ה-URL שהועברה בפרמטר `google_click_url`. בהנחה `my.adserver.com` גורם ליציאה מהטווח `google_click_url`. אפשר לצרף כתובת URL עם שני תווי בריחה אחרי `%%CLICK_URL_ESC%%`. אחרי שה-`my.adserver.com` מבצע את ה-Unescape, נשארת גרסה של כתובת ה-URL עם בריחה אחת שמצורפת ל-`google_click_url`. כשה-`google_click_url` ייאוחזר, הוא יוסר ממנו ה-escape שוב ואז תתבצע הפניה אוטומטית.
`CLICK_URL_ESC_ESC`	כתובת ה-URL של המודעה עם תווי escape כפולים. משתמשים בערך הזה במקום ב-`CLICK_URL_UNESC` אם צריך להעביר את הערך דרך שרת אחר, שיחזיר לאחר מכן הפניה אוטומטית. לדוגמה, ניתן להשתמש בקוד הבא בקטע קוד HTML: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC_ESC%%"></a> בזמן הצגת המודעה, האפשרויות האלה מורחבות: <a href="http://my.otheradserver.com/click?google_click_url=http%3A%2F%2Fmy.adserver.com%2Fclick%3Fgoogle_click_url%3Dhttp%3A%2F%2Fgoogle-click-%20url%253F...%2526ad_url%253D"></a>
`SCHEME`	הורחב ל-`http:` אם בקשת הצעת המחיר לא מחייבת SSL או `https:` אם הבקשה להצעת המחיר מחייבת SSL.
`SITE`	הדומיין של כתובת ה-URL של התוכן, עם תוויות בריחה (escape) של כתובות URL, או המזהה האנונימי של מלאי שטחי הפרסום האנונימי.
`SITE_URL`	הוצא משימוש. הוחלף על ידי המאקרו SITE שמספק פונקציונליות זהה.
`TZ_OFFSET`	הסטייה מאזור הזמן.
`VERIFICATION`	הערכים השונים בסביבת הייצור והמועד שבו הקריאייטיב נסרק בצינור האימות. הפורמט הוא: `%%?VERIFICATION:true-val:false-val%%`, כאשר אפשר להשתמש בכל הערכים מלבד מאקרואים עבור `true-val` ו- `false-val`, כולל מחרוזות ריקות. עבור Open Bidding, מומלץ שפלטפורמות ה-Exchange ישתמשו במאקרו הזה; ברגע שהם עושים את זה, הפלטפורמות לא צריכות לבצע שינויים. לדוגמה, אם הקריאייטיב צריך לכלול `%%?VERIFICATION:-1:5000%%` ואז הטקסט החלופי יהיה `5000` בהצגת מודעות ו-`-1` בהגשה של צינור עיבוד הנתונים. המטרה היא לעזור להבדיל בין שתי הקבוצות האלה של פינגים.
`WINNING_PRICE`	עלות החשיפות המקודדות (כלומר עלות לחשיפה במקום עלות לאלף חשיפות) במיקרו-מטבעות של מטבע החשבון. לדוגמה, עלות מנצחת לאלף חשיפות בסך 20 ש"ח תואם עלות לאלף חשיפות (CPM) של 5,000,000 מיקרוים או 5,000 מיקרו-עלות להתקנה (CPI). הקוד המפוענח הערך של `WINNING_PRICE` במקרה הזה יהיה 5,000. המחיר הזוכה מצוין בעלות להתקנה (CPI). כדי לנתח את המאקרו הזה, תצטרכו להטמיע אפליקציה שמפענחת את אישורי המחירים. למידע נוסף, אפשר לעיין בדף פענוח של אישורי מחירים.
`WINNING_PRICE_ESC`	`WINNING_PRICE`, המערכת תסמן בתו מילוט (escape) את כתובת ה-URL.

Google דורשת להשתמש בCLICK_URL_UNESC או מאקרו CLICK_URL_ESC בתוך הקריאייטיב של המודעה המוצגת על ידי הצד השלישי המודעה. Google משתמשת במאקרו CLICK_URL למעקב אחר קליקים.

כתובת בריחה של כתובת URL בפקודות מאקרו משתמשת בסכמה הבאה:

תו הרווח מוחלף בסימן פלוס (+).
תווים אלפאנומריים (0-9,‏ a-z,‏ A-Z) ותווים מתוך הקבוצה ‎!()*,-./:_~ לא משתנים.
כל שאר התווים מוחלפים ב-%XX, כאשר XX הוא ההקסדצימלי מספר שמייצג את התו.

הגבלות ודרישות לבעלי תוכן דיגיטלי

בקשת הצעת המחיר כוללת מידע על סוגי ההגבלות והדרישות שמפרסמים מטילים על נכסי הקריאייטיב במכרז.

BidRequest.bcat
- אפשר להשוות בין הקטגוריות החסומות שצוינו בשדה הזה לבין הקטגוריות שזוהו בנכסי הקריאייטיב ששלחתם באמצעות השדה detectedCategories ב-Real-time Bidding API.
BidRequest.imp.ext.allowed_vendor_type
BidRequest.imp.secure
- בפועל, הערך הזה תמיד יהיה true כי Google דורשת תמיכה ב-SSL לכל נכסי הקריאייטיב.
BidRequest.imp.{audio/banner/native/video}
BidRequest.imp.{audio/banner/native/video}.api
BidRequest.imp.{audio/banner/native/video}.battr
BidRequest.imp.{audio/banner/video}.mimes

לעולם אל תגישו הצעות מחיר על מודעות שמכילות תכונה מוגבלת. לגבי תכונות מותרות, כמו סוג הספק, מחזירים מודעה רק אם סוג הספק שלה נמצא ברשימה allowed_vendor_type בקובץ BidRequest. הצעת המחיר צריכה לכלול רק את פורמטים המודעות שצוינו בבקשת הצעת המחיר על ידי מילוי שדות כמו BidRequest.imp.banner. פרטים נוספים זמינים בתגובות לשדות האלה בהגדרה של מאגר ה-Protocol BidRequest.

אם מודעה מוחזרת בחודש BidResponse, עליך הגדרה מדויקת של BidResponse.seatbid.bid.attr, BidResponse.seatbid.bid.cat, וגם BidResponse.seatbid.bid.adomain או BidResponse.seatbid.bid.adm_native.link.url שדות ב BidResponse אם למודעה יש כמה ערכים רלוונטיים צריך לכלול כל ערך. אפשר לראות את התגובות בשדות האלה ב- בהגדרה של מאגר הנתונים הזמני של הפרוטוקול BidResponse לפרטים נוספים. המערכת תמחק תשובות שלא הוגדרו בהן השדות האלה.

פתיחת המדידה

מדידה פתוחה מאפשרת לך לציין ספקי צד שלישי שמספקים שירותי מדידה ואימות למודעות שהוצגו באפליקציה לנייד בסביבות שונות.

הפורמטים הנתמכים של מודעות כוללים מודעות וידאו, מודעות באנר ומודעות מעברון. לקבלת מידע נוסף מידע על השימוש במדידה פתוחה בתגובה להצעת מחיר שכוללת את בפורמטים, קראו את המאמר Open Measurement SDK מאמר במרכז העזרה.

דוגמאות לתשובות לבקשות להצעת מחיר

בקטעים הבאים מוצגות תגובות לדוגמה לבקשות להצעות מחיר לסוגים שונים של מודעות.

OpenRTB Protobuf

אני רוצה לראות את הדוגמה

id: "m7T91l3qg177P4b39N26W1"
seatbid {
  bid {
    id: "5viGQ43x3HI44d22DW3"
    impid: "1"
    price: 0.040404
    adid: "test_creative_id_566440"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "67427969102"
    crid: "test_creative_id_566440"
    cat: "IAB3"
    cat: "IAB13"
    w: 320
    h: 50
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      billing_id: 67427969102
    }
  }
  seat: "1912:1424:626226"
  group: false
}
bidid: "38508qU5-957YGflD-M2rg-7B19HjXU00n2"
cur: "USD"

קובץ JSON של OpenRTB

אני רוצה לראות את הדוגמה

{
  "id": "SwkWZ9w3I3gJ803j84253U",
  "seatbid": [
    {
      "bid": [
        {
          "id": "ro22H780p349mF6oe0h",
          "impid": "1",
          "price": 0.04001,
          "adid": "test_creative_id_978541",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "82346236545",
          "crid": "test_creative_id_978541",
          "w": 390,
          "h": 61,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "5c39728P",
              "campaign": "10199716",
              "itunesitem": "640052147",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "0HY71438fqxkY2tqD14kV9DY1q3Fi77sc99e0D97Qo833M266T75c28Y5NM23wiL61WyNCe0277ER5eM32UxaKGf99GUM1jI",
                  "timestamp": "1714079463090"
                },
                {
                  "fidelity": 0,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "J6RVg1KI31q1lB68f6F16fA07kY93DAYU2IL5ETDuvczR48oMr3S3X9tIohWi4L2VcE0w4mi42o0Mqa174U7o65951z44ru4",
                  "timestamp": "1714079463090"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "4372:2283:725828"
    }
  ],
  "bidid": "Z8aZJEk4-r2e3z85n-je52-q0E586r76K4T"
}

Google

אני רוצה לראות את הדוגמה

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 31014
    billing_id: 16751333146
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 50
  category: 0
  buyer_creative_id: "test_creative_id_173035"
  advertiser_name: "Google"
  width: 300
  height: 250
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 10

מודעת מעברון באפליקציה

OpenRTB Protobuf

אני רוצה לראות את הדוגמה

id: "wqZn032336g5U2Saroj8Lc"
seatbid {
  bid {
    id: "mTD7EYxAyF6n763v7pJ"
    impid: "1"
    price: 0.033932000398635864
    adid: "test_creative_id_237493"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    adomain: "google.com"
    cid: "42834631855"
    crid: "test_creative_id_237493"
    cat: "IAB2-18"
    cat: "IAB20"
    w: 360
    h: 711
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      attribute: 8
      event_notification_token {
        payload: "token"
      }
      billing_id: 42834631855
    }
  }
}
bidid: "62i6224k-ada8764U-y4Fi-2z760VkR3s35"
cur: "USD"

קובץ JSON של OpenRTB

אני רוצה לראות את הדוגמה

{
  "id": "BQig8glrLj2K7p818w3s0S",
  "seatbid": [
    {
      "bid": [
        {
          "id": "v0x1j4q0B388Z5lv600",
          "impid": "1",
          "price": 0.25109,
          "adid": "test_creative_id_654733",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "73848702501",
          "crid": "test_creative_id_654733",
          "w": 428,
          "h": 846,
          "ext": {
            "skadn": {
              "version": "4.0",
              "network": "43D4r5x9",
              "sourceidentifier": "6217",
              "itunesitem": "950280085",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "8fZn83e3d0742gU7E8Ra7Vif4v1vK61X899f7G7q9Dl998035Gq81Zd4r3032814bQ03HP49709yf38n6U35YY29D0w2Ac5B",
                  "timestamp": "1714058970102"
                },
                {
                  "fidelity": 1,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "zs0k0e335UoH9M6mp1V228I8JAl2526LCKF0dc2l8x7o4270lsQ37B12Cf91a770RcNqSG7Kl667xsw97Eo4nA23o41h3c0H",
                  "timestamp": "1714058970102"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "9150:1636:894279"
    }
  ],
  "bidid": "taiup4HY-42ggR62I-120u-3kyZ4831M9Yt"
}

Google

אני רוצה לראות את הדוגמה

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 1079285
    billing_id: 37034094959
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 105
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_903208"
  advertiser_name: "Google"
  width: 398
  height: 744
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  skadn {
    version: "4.0"
    network: "41dEOEaD"
    itunesitem: "151251861"
    sourceapp: "500811620"
    fidelities {
      fidelity_type: VIEW_THROUGH_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "p1f6bi578Q0jX163o5ws6n630p142H1v75rziXPtoak952g0Be18230732OkYu7epL9elCJ25078L09G5Mi6u7s7MyO2j5sI"
    }
    fidelities {
      fidelity_type: STOREKIT_RENDERED_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "JFtn495ab0EX97ci69Ru9c39ot9TWn5T0052F4439Y2a9u7zN2do7Q9AH4N584irpJmS8K877980K14iQgO74I33vgx231Cf"
    }
    skadn_options {
      always_open_appstore: true
    }
    source_identifier: 72
  }
}
processing_time_ms: 70

מודעת מעברון בסרטון באפליקציה

OpenRTB Protobuf

אני רוצה לראות את הדוגמה

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

Google

אני רוצה לראות את הדוגמה

ad {
  adslot {
    id: 1
    max_cpm_micros: 5037989
    billing_id: 82632801525
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_497252"
  advertiser_name: "Google"
  width: 720
  height: 1280
  video_vast_xml: "OMITTED_VAST_XML"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 70

מותאמת של אפליקציה

OpenRTB Protobuf

אני רוצה לראות את הדוגמה

id: "P3mh232944yQx803R73ayZ"
seatbid {
  bid {
    id: "79B1S3h454910R471JL"
    impid: "1"
    price: 0.044748470187187195
    adomain: "google.com"
    cid: "52078759229"
    crid: "test_creative_id_537521"
    cat: "IAB20"
    burl: "https://test.com/imp?id=123456"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
          type: MAIN
        }
      }
      assets {
        id: 6
        required: false
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 100
          h: 100
          type: LOGO
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
          type: DESC
        }
      }
      assets {
        id: 3
        required: false
        data {
          value: "Book today"
          type: CTATEXT
        }
      }
      assets {
        id: 4
        required: true
        data {
          value: "Galactic Luxury Cruises"
          type: SPONSORED
        }
      }
      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"
      }
    }
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 52078759229
    }
  }
  seat: "2237:7356:617887"
}
cur: "USD"

קובץ JSON של OpenRTB

אני רוצה לראות את הדוגמה

{
  "id": "3u95d40fy46B0y3CEL73uy",
  "seatbid": [
    {
      "bid": [
        {
          "id": "d501820Aa099K69Ia64",
          "impid": "1",
          "price": 1.63,
          "burl": "https://test.com/imp?id=123456",
          "adm": "{\"assets\": [{\"id\": 1, \"required\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"required\": 1, \"data\": {\"value\": \"Visit the planet in a luxury spaceship.\", \"label\": \"\"}}, {\"id\": 3, \"data\": {\"value\": \"Book today\", \"label\": \"\"}}, {\"id\": 4, \"required\": 1, \"data\": {\"value\": \"Galactic Luxury Cruises\", \"label\": \"\"}}, {\"id\": 5, \"required\": 1, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"h\": 628, \"w\": 1200}}, {\"id\": 6, \"img\": {\"url\": \"https://native.test.com/logo?id=123456\", \"h\": 640, \"w\": 640}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"], \"privacy\": \"\"}",
          "adid": "test_creative_id_237765",
          "adomain": [
            "google.com"
          ],
          "cid": "30567639040",
          "crid": "test_creative_id_237765",
          "cat": [
            "IAB8"
          ],
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "345vh5bv",
              "campaign": "62744790",
              "itunesitem": "608550422",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "4063Vhn5W7oGEcJ202oj6k990Y3H7f9sJ6luK3O65RbQ3S9kp45VK84le4a424c6SU79384DTdXS1cHWcxl9SB98563Y38K9"
                },
                {
                  "fidelity": 1,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "r1852LY7j0f25q2s868j1Ub7r07S16e607BC5909O272F8i528732r22W7D138t3706205Ez139N73Iho3vJKp257Pp4vmet"
                }
              ]
            },
            "app_promotion_type": 1,
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "3512:7802:295531"
    }
  ],
  "cur": "USD"
}

Google

אני רוצה לראות את הדוגמה

ad {
  adslot {
    id: 1
    max_cpm_micros: 1581987
    billing_id: 32132054378
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_285893"
  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\254106.40"
    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"
}
processing_time_ms: 20

סרטונים באינטרנט

Google

אני רוצה לראות את הדוגמה

ad {
  adslot {
    id: 1
    max_cpm_micros: 16000000
    billing_id: 34223090460
    deal_id: 17775265
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_551392"
  advertiser_name: "Google"
  event_notification_token: "token"
}
processing_time_ms: 7

OpenRTB Protobuf

אני רוצה לראות את הדוגמה

id: "878w58e050dSf05LS9l424"
seatbid {
  bid {
    id: "478u6K990C990n7FPTX"
    impid: "1"
    price: 0.03
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "46483683815"
    crid: "test_creative_id_527097"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 46483683815
    }
  }
  seat: "6954:3639:781296"
}
bidid: "7a2CAWgt-IKR8mp06-0E3d-TPNq4zO9l767"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 120
}

יצירת תגובה

יצירת הודעת Protobuf BidResponse

מזהה הקריאייטיב

מאפייני מודעה

שדות של Open Bidding

המלצות

דוגמה לתגובה להצעת מחיר

OpenRTB Protobuf

אני רוצה לראות את הדוגמה

קובץ JSON של OpenRTB

אני רוצה לראות את הדוגמה

Google

אני רוצה לראות את הדוגמה

ציון הקריאייטיב

ציון רכיבי מאקרו

פקודות מאקרו של Google RTB

הגבלות ודרישות לבעלי תוכן דיגיטלי

פתיחת המדידה

דוגמאות לתשובות לבקשות להצעת מחיר

באנר של אפליקציה

OpenRTB Protobuf

אני רוצה לראות את הדוגמה

קובץ JSON של OpenRTB

אני רוצה לראות את הדוגמה

Google

אני רוצה לראות את הדוגמה

מודעת מעברון באפליקציה

OpenRTB Protobuf

אני רוצה לראות את הדוגמה

קובץ JSON של OpenRTB

אני רוצה לראות את הדוגמה

Google

אני רוצה לראות את הדוגמה

מודעת מעברון בסרטון באפליקציה

OpenRTB Protobuf

אני רוצה לראות את הדוגמה

Google

אני רוצה לראות את הדוגמה

מותאמת של אפליקציה

OpenRTB Protobuf

אני רוצה לראות את הדוגמה

קובץ JSON של OpenRTB

אני רוצה לראות את הדוגמה

Google

אני רוצה לראות את הדוגמה

סרטונים באינטרנט

Google

אני רוצה לראות את הדוגמה

באנר לאינטרנט לנייד למגיש הצעות מחיר ב-Exchange

OpenRTB Protobuf

אני רוצה לראות את הדוגמה