בניית התגובה

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

יצירת הודעה של BidResponse

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 מזהה אותם באופן אוטומטי. בהתאם לכך, הקריאייטיבים שלכם ייחסמו ו/או ייחסמו (על סמך הערכים שזוהו) ולא על סמך ההצהרה שלכם. בממשק API לקריאייטיבים מוסבר איך לקבל משוב על המאפיינים של הקריאייטיבים.

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

שדות Open Bidding

התגובות להצעות מחיר שנשלחות על ידי מגישי הצעות מחיר בבורסות וברשתות שישתתפו ב-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 שמחייבות שיוך של 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

OpenRTB JSON

הראה לי דוגמה

{
  "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, Video, Native). בדוגמה הזו, אנחנו מציינים את הקריאייטיב באמצעות השדה 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 בקטע Create messageResponse message. אחד מהכלים האלה הוא להוסיף מידע לארגומנטים של כתובות 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 יאוחזר כשמישהו ילחץ עליה. ערך ההחזרה של האחזור הוא הפניה לכתובת URL אחרת שמצרפים ל-CLICK_URL.

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

מאקרו	תיאור
ADVERTISING_IDENTIFIER	מאפשר לקונים לקבל IDFA של iOS או מזהה פרסום של Android בעת הצגת חשיפות. פרטים נוספים זמינים במאמר פענוח מזהי המפרסמים.
CACHEBUSTER	ייצוג מחרוזת של מספר שלם אקראי, לא חתום וארבעה בייט.
CLICK_URL_UNESC	כתובת ה-URL לקליקים של המודעה, ללא תווי בריחה (escape). בקטע הקוד, גרסה הבריחה של כתובת האתר של צד שלישי לקליק צריכה לעבור ישירות עם המאקרו. לדוגמה, אם כתובת ה-URL לקליקים של צד שלישי היא http://my.adserver.com/some/path/handleclick?click=clk, אפשר להשתמש בקוד הבא עם גרסת הבריחה היחידה של כתובת ה-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, ולאחר מכן תפנה מחדש לכתובת ה-URL של הקליק של צד שלישי.
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 עם תו בריחה (escape) אחרי %%CLICK_URL_ESC%%. אחרי שהביטול (escaping) מתבצע על ידי my.adserver.com, היא מותנית בגרסת בריחה יחידה של כתובת URL שמצורפת ל-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	הדומיין של כתובת ה-URL עם תו בריחה (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) ולא העלות לאלף חשיפות (CPM) במיליוניות של המטבע בחשבון. לדוגמה, אם העלות המנצחת לאלף חשיפות היא 5$, העלות לאלף חשיפות תהיה 5,000,000 micros CPM, או 5,000 micros CPI. במקרה כזה, הערך המפוענח של WINNING_PRICE הוא 5,000. המחיר הזוכה מצוין ב-CPI.
WINNING_PRICE_ESC	כתובת URL עם תווי בריחה (escape) WINNING_PRICE.

ה-escaping של כתובות ה-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 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 בתגובת הצעת מחיר שמכילה את הפורמטים האלה זמין במאמר 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

OpenRTB JSON

הראה לי דוגמה

{
  "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

OpenRTB JSON

הראה לי דוגמה

{
  "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

OpenRTB JSON

הראה לי דוגמה

{
  "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
}