יצירת תגובה

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

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

Authorized Buyers שולח את BidRequest כגוף ההודעה של POST של HTTP. התגובה שהאפליקציה שולחת חייבת הכותרת Content-Type מוגדרת ל-application/octet-stream וגוף הודעה שמכיל מאגר נתונים זמני של פרוטוקול. הפרוטוקול מאגר נתונים זמני הוא הודעת BidResponse כפי שמוגדר ב- realtime-bidding.proto. האפליקציה שלך חייבת להחזיר קובץ מנתח BidResponse בתגובה לכל BidRequest. חסימות זמניות ותגובות שלא ניתן לנתח נחשבות לשגיאות ול ויסות נתונים (throttle) של 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
  כדי שהמודעה תפעל, נדרש ממשק API של MRAID.

בנוסף, המאפיינים הבאים נתמכים, אבל ההצהרה שלהם לא נדרש, כי 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. הבידינג דומה לשיטות הבידינג של 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	אסימון שמשמש לזיהוי פרטי קונה של צד שלישי אם Exchange כמגיש הצעות מחיר ב-Open Bidding הוא מתווך. הוא מתקבל קונה מצד שלישי ויש להעבירו אל Google ללא שינוי בהצעת המחיר תשובה.

המלצות

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

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

  הערה: כשמשתמשים ב-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: 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

קובץ 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"
}

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
}

חשוב: הודעות ה-Protobuf שמופיעות ב הדוגמאות מיוצגות כאן כטקסט קריא לאנשים. עם זאת, זו לא הדרך ההודעות נשלחות דרך החוט. כשמשתמשים ב-Google Analytics או ב-OpenRTB Protobuf רק הודעות 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.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 BidResponse message. אחת משמש להוספת מידע לארגומנטים של כתובות ה-URL שאוחזרו מהשרתים שלכם כחלק מהצגת המודעה. כך אפשר להעביר נתונים שרירותיים על החשיפה בחזרה לשרתים שלכם.

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

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

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

כתובת בריחה של כתובת 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: 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

קובץ 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"
}

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"

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

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

קובץ 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"
}

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"

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

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

קובץ 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"
}

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"

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

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