יצירת תגובה

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

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

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

אם אתם לא רוצים להגיש הצעות מחיר על חשיפה, אפשר להגדיר את השדה processing_time_ms בנפרד ולהשאיר את כל שאר השדות ריקים. אפשר לקבל את realtime-bidding.proto מהדף נתוני עזר.

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

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

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

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

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

עליך להצהיר על מאפייני הקריאייטיב שמתארים באופן מלא את מאפייני המודעה ואת הטירגוט שלה ב-BidResponse.Ad.attribute. המאפיינים שצריך להצהיר עליהם הם (אפשר לעיין גם ברשימה המלאה של המאפיינים הנתמכים בכתובת buyer-declarable-creative-attributes.txt):

• 7 Tagging: IsTagged
  המודעה מכילה פיקסל או אלומת אינטרנט שמטרתם ליצור רשימת מזהים של קובצי cookie לצורך רימרקטינג עוקב.
• 8 Remarketing: IsRemarketing
  המודעה ממוקדת לצרכנים על סמך מזהה קובץ ה-cookie או מזהה המכשיר שלהם. רשימת המזהים של קובצי ה-cookie או מזהי המכשירים מייצגת קבוצה של צרכנים, שהייתה להם אינטראקציה בעבר עם אתר שנמצא בבעלות הקונה או שמיוצג על ידו.
• 9 UserInterestTargeting: IsUserInterestTargeted
  המודעה מטרגטת צרכנים על סמך מזהה קובץ ה-cookie או מזהה המכשיר שלהם. רשימת המזהים של קובצי ה-cookie או מזהי המכשיר מייצגת קבוצה של צרכנים שהקונה הגדיר כקבוצה של תחומי עניין משותפים.
• 30 InstreamVastVideoType: Vpaid
  כדי להציג את המודעה נדרשת תמיכה ב-VPAID.
• 32 MraidType: MRAID
  כדי לעבד את המודעה, נדרש MRAID API.

בנוסף, יש תמיכה במאפיינים הבאים, אבל אין צורך בהצהרה שלהם כי Authorized Buyers מזהה אותם באופן אוטומטי, והם יחסום (או יאשרו) את נכסי הקריאייטיב שלך על סמך הערכים שזוהו, ולא על סמך ההצהרה שלך. במאמר Creatives API מוסבר איך לקבל משוב על המאפיינים שאותרו של נכסי הקריאייטיב שלכם.

• 34 RichMediaCapabilityType: RichMediaCapabilityFlash
  כדי להציג את המודעה נדרשת תמיכה ב-Flash.
• 50 RichMediaCapabilityType: RichMediaCapabilityNonFlash
  לא נדרש Flash כדי להציג את המודעה.
• 47 RichMediaCapabilityType: RichMediaCapabilitySSL
  המודעה יכולה להופיע בדף SSL. לתשומת ליבך: מערכת Authorized Buyers מתייחסת לקריאייטיבים עם ערכים מוצהרים שונים של המאפיין הזה בנפרד (הם ייבדקו בנפרד עם סטטוס אישור נפרד). לכן, אם מגישים הצעות מחיר עם גרסה SSL וגרסה ללא SSL של אותו קריאייטיב, צריך להצהיר על המאפיין הזה בהתאם, כדי שהבחנה זו תבוא לידי ביטוי ב-AdX כראוי.

שדות של Open Bidding

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

OpenRTB	Authorized Buyers	פרטים
BidResponse.imp[].pmp.deals[].id	BidResponse.ad[].adslot[].exchange_deal_id	מזהה העסקה ממרחב השמות של הבורסה שמשויך להצעת המחיר הזו ומדווח לבעלי תוכן דיגיטלי. הערה: השדה הזה נשלח כרגע רק למשתתפים בגרסת הבטא הסגורה.
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	אסימון שמשמש לזיהוי פרטי הקונה של צד שלישי הסופי, אם הבורסה כמגישת הצעות מחיר פתוחה היא מתווכת. המזהה מתקבל מהקונה מצד שלישי ויש להעביר אותו ל-Google ללא שינוי בתגובה להצעת המחיר.

המלצות

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

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

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

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

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

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: 6496
    billing_id: 25059430769
    deal_id: 30183930
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_244584"
  advertiser_name: "Google"
  width: 300
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 6

קובץ JSON של OpenRTB

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

{
  "id": "KO9b4i49863AW26d1Tl9q6",
  "seatbid": [
    {
      "bid": [
        {
          "id": "Zc2MS8m162f920x7944",
          "impid": "1",
          "price": 0.133555,
          "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"
          ],
          "w": 300,
          "h": 250,
          "crid": "test_creative_id_410013",
          "creativeType": "DISPLAY",
          "burl": "https://test.com/imp?id=123456",
          "cid": "37092002186",
          "adid": "test_creative_id_410013"
        }
      ],
      "seat": "8333:6953:689419"
    }
  ],
  "ext": {
    "pixels": "<script type='text/javascript'>var adContent = '';\nadContent += '<scr' + 'ipt type=\"text/javascript\" src=\"https://service.idsync.analytics.yahoo.com/sp/v0/pixels?pixelIds=58292,58301,58294&referrer=&limit=12&us_privacy=null&js=1&_origin=1&gdpr=0&euconsent=\"></scr' + 'ipt>' + '\\n';\ndocument.write(adContent);</script>"
  }
}

OpenRTB Protobuf

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

id: "kMr24Q2iIW45X66r58005i"
seatbid {
  bid {
    id: "ne1hrjHUhQ53A1rC721"
    impid: "1"
    price: 0.05813896656036377
    adid: "test_creative_id_744028"
    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: "53026323592"
    crid: "test_creative_id_744028"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 53026323592
    }
  }
  seat: "7524:3385:491205"
}
bidid: "6T5lR3ZI-U4xrqc15-Q6RK-426A53024Mf4"
cur: "USD"

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

אפשר ליצור הודעת 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.Ad.sdk_rendered_ad
• AMP
  • BidResponse.Ad.amp_ad_url
• וידאו
  • BidResponse.Ad.video_url או
  • BidResponse.Ad.video_vast_xml
• מודעות מותאמות
  • BidResponse.Ad.native_ad

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

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

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

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

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

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

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

יש לציין מאקרו כחלק מקטע HTML בפורמט %%MACRO%%, כאשר MACRO היא אחת מפקודות המאקרו הנתמכות המפורטות בטבלה הבאה.

הערה: לגבי תגובות להצעות מחיר למודעות AMP (amp_ad_url), נתמכות רק פקודות המאקרו WINNING_PRICE ו-WINNING_PRICE_ESC.

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

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

הערה: בנוסף לפקודות המאקרו של DoubleClick, אנחנו תומכים גם בפקודות מאקרו של OpenRTB. מידע נוסף על פקודות מאקרו של OpenRTB זמין במפרט של OpenRTB.

מאקרו	תיאור
ADVERTISING_IDENTIFIER	התכונה מאפשרת לקונים לקבל IDFA של iOS או מזהה פרסום של Android ברינדור החשיפות. לפרטים נוספים, אפשר לעיין במאמר בנושא פענוח מזהי מפרסמים.
CACHEBUSTER	ייצוג מחרוזת של מספר שלם אקראי שאינו חתום בגודל ארבעה בייטים.
CLICK_URL_UNESC	כתובת ה-URL של הקליק ללא קוד ה-escape עבור המודעה. בקטע הקוד, גרסה שמסומנת בתו מילוט (escape) של כתובת ה-URL של הקליק מצד שלישי צריכה לעקוב ישירות אחר המאקרו. לדוגמה, אם כתובת ה-URL של צד שלישי לקליקים היא http://my.adserver.com/some/path/handleclick?click=clk, ניתן להשתמש בקוד הבא עם גרסת ה-SSO של כתובת ה-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%%. אחרי ביצוע ה-unescaping על ידי my.adserver.com, תיווצר גרסה של כתובת ה-URL עם תו בריחה (escape) אחת שמוצמדת ל-google_click_url. כאשר google_click_url מאוחזר, הוא יוסר פעם נוספת ולאחר מכן תתבצע הפניה מחדש.
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	הדומיין המסומנים בתו בריחה (escape) של כתובת ה-URL של התוכן או של המזהה האנונימי למלאי אנונימי.
SITE_URL	הוּצא משימוש. הוחלף במאקרו SITE שמספק פונקציונליות זהה.
TZ_OFFSET	הסטה מאזור הזמן.
VERIFICATION	הערכים השונים לסביבת הייצור ומתי הקריאייטיב נסרק בצינור עיבוד הנתונים של האימות. הפורמט הוא: %%?VERIFICATION:true-val:false-val%%, כאשר ניתן להשתמש בערכים כלשהם מלבד פקודות מאקרו עבור true-val ו-false-val, כולל מחרוזות ריקות. כשמשתמשים ב-Open Bidding, מומלץ שהבורסות ישתמשו במאקרו הזה. אחרי שהן פועלות, פלטפורמות בצד הביקוש לא צריכות לבצע שינויים. לדוגמה, אם קריאייטיב כולל %%?VERIFICATION:-1:5000%% , החלפת הטקסט תהיה 5000 בהצגת המוצר ו--1 בתהליך האימות. המטרה היא לעזור להבדיל בין שתי הקבוצות האלה של פינגים.
WINNING_PRICE	העלות של החשיפות המקודדות (כלומר, עלות להתקנה (CPI) ולא עלות לאלף חשיפות) במיליוניות השנייה של מטבע החשבון. לדוגמה, עלות מנצחת לאלף חשיפות בסך 5 $שווה ערך של 5,000,000 מיקרו-עלות לאלף חשיפות, או 5,000 מיקרו-עלות להתקנה (CPI). הערך המפוענח של WINNING_PRICE במקרה הזה יהיה 5,000. המחיר הזוכה מצוין בעלות להתקנה (CPI).
WINNING_PRICE_ESC	WINNING_PRICE בתו בריחה (escape) של כתובת URL.

הזרמת כתובת אתר בפקודות מאקרו משתמשת בסכימה הבאה:

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

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

בעלי אתרים משתמשים בBidRequest כדי לקבוע הגבלות על המודעות שהם מתירים. עליך לאכוף את ההגבלות בשדות הבאים:

• allowed_vendor_type
• excluded_attribute
• excluded_sensitive_category

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

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

הערכים האפשריים של BidRequest.excluded_attribute הם (מידע נוסף זמין במאמר publisher-excludable-creative-attributes.txt):

• 7 Tagging: IsTagged
  מודעות אסורות אם הן מכילות פיקסל או אלומת אינטרנט, על מנת ליצור רשימה של מזהים של קובצי cookie לצורך רימרקטינג עוקב.
• 8 CookieTargeting: IsCookieTargeted
  אסור לפרסם מודעות אם הן מטרגטות לצרכנים על סמך המזהה של קובצי ה-cookie שלהם. רשימת המזהים של קובצי ה-cookie מייצגת קבוצה של צרכנים שקיימו בעבר אינטראקציה עם אתר שנמצא בבעלות הקונה או שמיוצג על ידו.
• 9 UserInterestTargeting: IsUserInterestTargeted
  אסור לפרסם מודעות אם הן מטרגטות לצרכנים על סמך המזהה של קובצי ה-cookie שלהם. רשימת המזהים של קובצי ה-cookie מייצגת קבוצה של צרכנים שהקונה הגדיר כקבוצה של תחום עניין משותף.
• 21 CreativeType: Html
  אסור להשתמש בשדה html_snippet או בשדה snippet_template במודעות ב-BidResponse.Ad.
• 22 CreativeType: VastVideo
  אסור להשתמש בשדה video_url במודעות BidResponse.Ad.
• 30 InstreamVastVideoType: Vpaid
  אסור שיהיה צורך בתמיכה ב-VPAID כדי להציג מודעות.
• 32 MraidType: MRAID
  אסור שיהיה צורך להשתמש ב-MRAID API כדי להציג מודעות.
• 34 RichMediaCapabilityType: RichMediaCapabilityFlash
  מודעות אינן יכולות לדרוש תמיכה ב-Flash לצורך הצגתן.
• 39 RichMediaCapabilityType: RichMediaCapabilityHTML5
  אסור לדרוש תכונות HTML5 לצורך עיבוד המודעות.
• 48 RichMediaCapabilityType: RichMediaCapabilityNonSSL
  מודעות לא יכולות לשלוח בקשות שאינן SSL.

לכן, אם השדה excluded_attribute מכיל את הערך 7, לא צריך להחזיר מודעה שמשתמשת בפיקסל או באלומת אינטרנט ליצירת רשימה. שימו לב שאם המודעה עושה זאת, צריך להגדיר את הערך 7 בשדה המאפיין של BidResponse. באופן דומה, אם השדה excluded_attribute מכיל את הערך 48, עליך להחזיר רק מודעות שניתן להציג בדף SSL (ולכן יש להצהיר על מאפיין 47 RichMediaCapabilityType: RichMediaCapabilitySSL).

כמו כן, בשדה excluded_sensitive_category ב-BidRequest נעשה שימוש בקודים מהקובץ ad-sensitive-categories.txt הזמין בדף נתוני עזר. הנה תיאורים מורחבים של חלק מקודים אלה:

• 3 Politics
  כוללת נושאים פוליטיים או חברתיים השנויים במחלוקת. לא כוללת מודעות של ארגוני חדשות, שאינם משויכים בדרך כלל להשקפה מפלגתית על נושאים.
• 4 Dating
  כוללת שירותי היכרויות וקהילות אונליין להיכרויות.
• 5 Religion
  כולל מודעות מתחום הדת ומודעות בעד או נגד השקפות דתיות. לא כולל אסטרולוגיה ורוחניות שאינה של כת דתית.
• 7 Video Games (Casual & Online)
  כולל משחקי וידאו, משחקים באינטרנט ומשחקים שניתן להוריד. לא כולל קונסולות למשחקי וידאו.
• 8 Ringtones & Downloadables
  תוספים לנייד, כולל רינגטונים, ודברים טובים אחרים שניתן להוריד כמו שומרי מסך וטפטים למחשבים שולחניים, ופריסות וגרפיקות פרופיל לרשתות חברתיות.
• 10 Get Rich Quick
  מזימות שמבטיחות רווחים מהירים.
• 18 Weight Loss
  כולל ירידה במשקל, הרזיה ותוכניות ומוצרים שקשורים לנושא זה. לא כולל מודעות המעודדות אכילה בריאה או מודעות כלליות בנושא כושר.
• 19 Cosmetic Procedures & Body Modification
  כולל שירותי הרמה, שאיבה, לייזר, הסרת שיער ושחזור, קעקועים ושינויים גופניים.
• 23 Drugs & Supplements:
  כוללת תרופות, ויטמינים, תוספי מזון וקמעונאים דומים. לא כוללת מקורות שמספקים מידע על סמים.
• 24 Sexual & Reproductive Health
  כוללת מודעות בנושא תפקוד מיני ופוריות. לא כוללת מקורות להיריון רגיל.
• 35 Social Casino Games
  כוללת משחקי סימולציה של הימורים (לרבות, ללא הגבלה, פוקר, מכונות מזל, בינגו, הגרלות, הימורים בספורט, הימורים במרוצי סוסים, וכן משחקי קלפים ומשחקי קזינו אחרים), שבהם לא ניתן לזכות בדבר-מה בעל ערך (כגון כסף או פרסים).
• 36 Significant Skin Exposure
  תמונות למודעות שבהן חלק כלשהו מהגוף לבוש מסטרנום עד אמצע הירך, או לבוש בבגדים תחתונים, בבגדי ים, בהלבשה תחתונה או בבגדים שקופים אחרים, או בפריטים שאינם בגד כמו מגבת או סדין.
• 37 Sensationalism
  מודעות שמטרתן לשכנע משתמשים ללחוץ עליהן על ידי גירוי יצר הסקרנות שלהם. לרוב, הן כוללות טיזר עם תמונות או תיאורים מוגזמים. כוללת מודעות שמתמקדות בנושאים סנסציוניים (כמו מעצרים של ידוענים, מקרי מוות או גירושין) או מודעות שמטרתן לגרום הלם.

מדידה פתוחה

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

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

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

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

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

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: 68101
    billing_id: 86124453824
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 105
  buyer_creative_id: "test_creative_id_450011"
  width: 390
  height: 61
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 23

קובץ JSON של OpenRTB

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

{
  "id": "4735YiDtCstD1Y445YHstT",
  "cur": "USD",
  "seatbid": [
    {
      "seat": "6670:8027:659779",
      "bid": [
        {
          "ext": {
            "third_party_buyer_token": "7Njk3e2s21E6Url23a30w4d4621Qh57u4w2L9uy4xq864V6lMf348aC72L767592sIPdJ84U2E2aU00jjVGF3wbjl25L019c7Z43eKVb09Sk5fRX72B33Q92f359l40M0t6jAseiJVp8"
          },
          "crid": "test_creative_id_109447",
          "exp": 900,
          "id": "M9mAq8768Nr7W048E6G",
          "price": 0.025286061000000002,
          "adomain": [
            "google.com"
          ],
          "w": 320,
          "impid": "1",
          "h": 50,
          "burl": "https://test.com/imp?id=123456",
          "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>",
          "cid": "48666909902"
        }
      ]
    }
  ]
}

OpenRTB Protobuf

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

id: "AA1796z4iC270863f4w9n0"
seatbid {
  bid {
    id: "9hJvWOk2f3GF6Z0qIR6"
    impid: "1"
    price: 0.917419
    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: "38676986454"
    crid: "test_creative_id_589316"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 38676986454
    }
  }
  seat: "5890:4144:786042"
}
bidid: "3L6xM6aN-2c492E7J-IxrR-gA80g0xJb980"
cur: "USD"

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

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: 7510304
    billing_id: 70362152071
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_775966"
  advertiser_name: "Google"
  width: 344
  height: 566
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 16

קובץ JSON של OpenRTB

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

{
  "id": "I61Sxs7d484326p4D83O5f",
  "seatbid": [
    {
      "bid": [
        {
          "id": "9T39T8KnUivM9518KnH",
          "impid": "1",
          "price": 0.6353,
          "adid": "test_creative_id_288773",
          "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": "42824952399",
          "crid": "test_creative_id_288773",
          "w": 414,
          "h": 816,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "QyYKoxm0",
              "campaign": "87661657",
              "itunesitem": "434836425",
              "sourceapp": "240782188",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "abc1f08d-785b-4937-90eb-c2bbd92dd5d8",
                  "signature": "j3kdO5nT3kl4X9488yr6h7N8I83Ck3n0fRQ1tidNAy13q29QBC67917Dw44w99BRx70a6z5i565lc64979x9G1a83d3gjiA0",
                  "timestamp": "1674986741687"
                },
                {
                  "fidelity": 0,
                  "nonce": "abc1f08d-785b-4937-90eb-c2bbd92dd5d8",
                  "signature": "H6opG1lxBHNi921C65Yq6972239i01goGrQb53xtq38Dlm9M0wU4256868fwy509762N5po8Ou2x3vb0JJX7432yLTv2X021",
                  "timestamp": "1674986741687"
                }
              ]
            },
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "6447:7558:568680"
    }
  ],
  "bidid": "4Jol9v45-xp0442M7-268b-9Ix24W30Q298"
}

OpenRTB Protobuf

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

id: "82WW59EKX928i315ws8Vf6"
seatbid {
  bid {
    id: "GzqINzH96g3ZX8g67FO"
    impid: "1"
    price: 0.011380645260214805
    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: "43834715105"
    crid: "test_creative_id_772436"
    cat: "IAB14"
    w: 360
    h: 640
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 43834715105
    }
  }
  seat: "1184:9545:274689"
}
cur: "USD"

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

Google

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

ad {
  adslot {
    id: 1
    max_cpm_micros: 830000
    billing_id: 45806415189
    buyer_reporting_id: "T7f433l"
  }
  click_through_url: "google.com"
  attribute: 47
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_596030"
  width: 640
  height: 360
  event_notification_token: "token"
}
processing_time_ms: 9

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: 80000
    billing_id: 52511964331
    deal_id: 1
  }
  click_through_url: "google.com"
  attribute: 70
  buyer_creative_id: "test_creative_id_287513"
  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: 1200
      height: 627
    }
    app_icon {
      url: "https://native.test.com/icon?id=123456"
      width: 100
      height: 100
    }
    star_rating: 4.800000190734863
    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"
  event_notification_token: "token"
  skadn {
    version: "3.0"
    network: "Ft98iS7c"
    campaign: 31947859
    itunesitem: "305656909"
    sourceapp: "531025541"
    fidelities {
      fidelity_type: STOREKIT_RENDERED_ADS
      nonce: "42748172-ff0e-43a1-a9da-e97f28e09eab"
      timestamp: 1675328391911
      signature: "9bGR391q8KEUGg0N8aI5Vg90fgX731q67y2xtXH09k27A5UccmE83YT9833q4g72P3t01759F15J9ZVSx0984q9A2eHnM5fn"
    }
    fidelities {
      fidelity_type: VIEW_THROUGH_ADS
      nonce: "42748172-ff0e-43a1-a9da-e97f28e09eab"
      timestamp: 1675328391911
      signature: "Hxr3FdOR2298951684ztq85X3GgF0gI1O3K7CuhAb6tC9g06fsvU1N1Uo7h7Ts38755801rVSB63o50cfk6q80N66vHr1u59"
    }
  }
  click_tracking_urls: "https://google.com/rtb/click?imp_id=4a4cb2c0-4012-4434-b37e-ed08095a1bc8"
  advertised_app_id: "APP_ID_OMITTED"
}
processing_time_ms: 57

קובץ JSON של OpenRTB

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

{
  "id": "w68lr2H3Q9S8mAc18QP2wp",
  "seatbid": [
    {
      "bid": [
        {
          "id": "4VF8803Y5b4314j072f",
          "impid": "1",
          "price": 0.01575,
          "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\": 100, \"h\": 100}}, {\"id\": 5, \"img\": {\"url\": \"https://native.test.com/icon?id=123456\", \"w\": 200, \"h\": 200}}, {\"id\": 7, \"data\": {\"value\": \"\\uc804\\uc124\\uc758 \\ub9cc\\ub819 \\uc2ac\\ub77c\\uc784\\uc774 \\ub418\\uc5b4\\ubcf4\\uae30\"}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"]}",
          "adid": "test_creative_id_546056",
          "adomain": [
            "google.com"
          ],
          "cid": "19851733647",
          "crid": "test_creative_id_546056",
          "cat": [
            "IAB9-25"
          ],
          "w": 1200,
          "h": 627,
          "ext": {
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "7859:5415:609992"
    }
  ],
  "bidid": "58nBZSP4-e3LCgFS8-C2Pz-01O0337Vr56A",
  "cur": "USD"
}

OpenRTB Protobuf

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

id: "a504l3y62599Xv09173V2Z"
seatbid {
  bid {
    id: "jP1Ok7b46T9p789v6R2"
    impid: "1"
    price: 0.1680304792439826
    adid: "test_creative_id_620230"
    adomain: "google.com"
    cid: "74994669337"
    crid: "test_creative_id_620230"
    w: 1200
    h: 627
    adm_native {
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
        }
      }
      assets {
        id: 3
        data {
          value: "Book today"
        }
      }
      assets {
        id: 4
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/icon?id=123456"
          w: 128
          h: 128
        }
      }
      assets {
        id: 6
        data {
          value: "5"
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      imptrackers: "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
    }
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 74994669337
      skadn {
        version: "3.0"
        network: "46L6RQ79"
        campaign: "17432314"
        itunesitem: "782565581"
        nonce: "ecfc7b9a-f328-4719-bba5-fa14c0233615"
        sourceapp: "187789793"
        timestamp: ""
        signature: "169L03hq0qtDeIoj19lL880oO96P24du405y60U08H71302C5d5r315jus940016d208o6kFt2G14x4YK530KI683wI41bR4"
        fidelities {
          fidelity: VIEW_THROUGH_ADS
          nonce: "1919c279-d6c5-46d3-b486-0c15b91bfd51"
          timestamp: "1675346267364"
          signature: "12g8675BqX3x8jJ60Zt9LwlNQwfe20s6M6n4zwtJ4H5170DU991wfwi9hn108rX53bU872L60u2io288755x0RS9bsvAg68b"
        }
        fidelities {
          fidelity: STOREKIT_RENDERED_ADS
          nonce: "1919c279-d6c5-46d3-b486-0c15b91bfd51"
          timestamp: "1675346267364"
          signature: "qAF324j0597P58JrYins8Lz01v7p41zfJ8JK6l2hoZ36z6RS1GE7FT0r8bAn6B93s77tv04k59fr4J173W992Wa3Ev40489R"
        }
      }
    }
  }
  seat: "6989:4819:604522"
}
bidid: "15ds1647-89y8715T-V0AX-6DL468ks81Q5"
cur: "USD"

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

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

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

OpenRTB Protobuf

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

id: "q39213i4x083QS49D4334b"
seatbid {
  bid {
    id: "T55L5u7y56cBy4x484B"
    impid: "1"
    price: 0.35
    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: "11573735693"
    crid: "test_creative_id_591839"
    w: 300
    h: 600
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 11573735693
      third_party_buyer_token: "w7KR11S30AAE1345q5aG7tz46OkB8u911zbR7HVMwk0E6zUx7Y0uo4cxz32kwa3bZ320H00QT5yYifRxY8z96r74bLedPf6Fb25Z4y0U7T3i3j9k587N2iFlZ5Kl20Z5vou8M5zFWAwa"
    }
  }
  seat: "8020:4047:162759"
}
bidid: "DQd2WoG7-96j6H89H-4uCI-1303QT599c50"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 170
}