הערות מוצר

Marketplace API

גירסה 1.0

תאריך הערות
‫26 באוגוסט 2025
  • מותר להשתמש רק בגדלים של מלאי שטחי פרסום מסוג PIXEL לטירגוט לפי גודל מלאי כשמבצעים קריאה אל buyers.proposals.sendRfp.
‫27 בפברואר 2025
‫9 בדצמבר 2024
‫17 ביוני 2024
‫6 ביוני 2024
  • נוספה תמיכה בדילים בלעדיים ללקוחות מועדפים של pausing ושל resuming.
‫25 באפריל 2024
‫23 באפריל 2024 נוסף ערך הטירגוט excludedSensitiveCategoryIds אל MarketplaceTargeting. הוספתי את ערך הטירגוט vertical_targeting אל MarketplaceTargeting.
‫15 באפריל 2024
  • הוספנו את bidders.auctionPackages.list כדי לפרט חבילות של מכרזים ברמת המגיש. חבילות המכרז שמוחזרות על ידי השיטה הזו מפרטות את המתכננים של קמפיינים לפרסום במדיה שנרשמו אליהן בשדה subscribedMediaPlanners.
  • הוספנו את השדה subscribedBuyers ל-AuctionPackage.
  • הוספנו את השדה subscribedMediaPlanners ל-AuctionPackage.
  • הוספנו את השדה eligibleSeatIds ל-AuctionPackage.
‫7 במרץ 2024
‫29 בפברואר 2024
  • הוספנו את השדה mediaPlanner אל Deal.
  • הוספנו את השדה eligibleSeatIds ל-Deal.
  • השדה billedBuyer של העסקה לא יאוכלס אם העסקה שייכת לחשבון של מתכנן מדיה.
‫29 בנובמבר 2023 הוספנו את ערך ה-enum‏ AUDIO אל CreativeFormat. הוספנו את ערך ה-enum‏  LG_TV אל AppStoreType.
‫11 באוקטובר 2021 השקנו את Authorized Buyers Marketplace API, שמאפשר לכם:
  • הצעת עסקאות וניהול משא ומתן עם בעלי תוכן דיגיטלי
  • אחזור של דילים סופיים ומדדי תקינות של דילים
  • ניהול מינויים לחבילות של מכרזים
  • ניהול לקוחות ומשתמשים של לקוחות
  • איך מוצאים פרופילים של בעלי תוכן דיגיטלי

גרסת בטא 1.0

תאריך הערות
‫11 ביוני 2025
  • גרסה ראשונית של v1beta API.
  • מקור המידע dataSegments זמין עכשיו בגרסה v1beta.
    • נתיב המשאב של dataSegments השתנה מ-buyers/{accountId}/dataSegments בגרסה v1alpha ל-curators/{accountId}/dataSegments בגרסה v1beta

גרסה 1.0 אלפא

תאריך הערות
‫12 ביוני 2024
  • גרסה ראשונית של v1alpha API.

Real-time Bidding API

גירסה 1.0

תאריך הערות
‫1 במאי 2025 הערך GOOGLE_RTB הוצא משימוש במרחב ה-enum של BidProtocol.
‫24 בפברואר 2025 נוסף ערך חדש GOOGLE_AD_CATEGORY_TAXONOMY למרחב enum‏ AdCategoryTaxonomy.
‫13 בפברואר 2025 הוצאנו משימוש קטגוריות מוגבלות מוצהרות בCreative.
‫6 באוגוסט 2024
‫30 ביולי 2024
‫31 באוקטובר 2023 הפונקציות buyers.userLists.getRemarketingTag ו-UrlRestriction הוצאו משימוש, ואם תתבצע קריאה שלהן, תוחזר תגובת שגיאה. מומלץ להשתמש בתכונה google_ula של תג Cookie Matching כדי להוסיף משתמשים לרשימת משתמשים על ידי הצבת תג מהדפדפנים. מידע נוסף מופיע ב מאמרי העזרה בנושא התאמות של קובצי Cookie.
‫12 באוקטובר 2023 נוסף ערך ה-enum‏ RENDERING_PLAYABLE אל CreativeAttribute.
‫17 באוגוסט 2023 השדות buyers.userLists.getRemarketingTag ו-UrlRestriction הוצאו משימוש והם יפסיקו לפעול ב-31 באוקטובר 2023. משתמשים בתכונה google_ula של תג Cookie Matching כדי להוסיף משתמשים לרשימת משתמשים על ידי הצבת תג מהדפדפנים. מידע נוסף מופיע ב מאמרי העזרה בנושא התאמות של קובצי Cookie.
‫17 במרץ 2023 הוספנו את השדה missingCertificate אל PolicyTopicEntry.
‫7 בפברואר 2023

הסרנו את ערכי ה-enum הבאים שהוצאו משימוש מתוך bidders.endpoints.bidProtocol:

  • OPENRTB_2_2
  • OPENRTB_2_3
  • OPENRTB_PROTOBUF_2_3
  • OPENRTB_2_4
  • OPENRTB_PROTOBUF_2_4
  • OPENRTB_2_5
  • OPENRTB_PROTOBUF_2_5
‫8 בנובמבר 2022

נוסף ערך enum חדש OPENRTB_PROTOBUF עבור bidders.endpoints.bidProtocol. מעכשיו והלאה, תהיה תמיכה רק בגרסה אחת של OpenRTB בכל פעם. כדי להשתמש בגרסה העדכנית ביותר של OpenRTB שנתמכת בפורמט המועדף עליכם, מומלץ להשתמש ב-OPENRTB_JSON או ב-OpenRTB_PROTOBUF. פרטים נוספים זמינים בפוסט בבלוג בנושא הסרת התמיכה בגרסאות ישנות של OpenRTB.

השדות הבאים של enum מתוך bidders.endpoints.bidProtocol סומנו כהוצאה משימוש:

  • OPENRTB_2_2
  • OPENRTB_2_3
  • OPENRTB_PROTOBUF_2_3
  • OPENRTB_2_4
  • OPENRTB_PROTOBUF_2_4
  • OPENRTB_2_5
  • OPENRTB_PROTOBUF_2_5
20 בספטמבר 2022 הוספנו את השדה creatives.renderUrl לגרסאות המקור לניסיון של FLEDGE.
1 בספטמבר 2022 הוספנו את הסטטוס CERTIFICATE_REQUIRED לחלק מהנכסים הקריאטיביים. מידע נוסף זמין במדיניות בנושא הימורים ומשחקים.
27 באפריל 2022 הפצת המשאב publisherConnections. בורסות Open Bidding יכולות להשתמש ב-publisherConnections כדי לנהל את החיבורים עם בעלי האתרים.
‫1 בנובמבר 2021 הוספנו את bidders.enpoints.patch כדי לעדכן את נקודת הקצה של משתתף בהצעת מחיר.
27 במאי 2021 הוספנו את שדה ה-oneof‏ video למשאב Native Creatives, שמקבל את הערכים videoVastXml או videoUrl.
‫8 באוקטובר 2020 השדות openAuctionServingStatus, ‏ openBiddingServingStatus,‏ dealsServingStatus, ‏ chinaServingStatus ו-russiaServingStatus הוחלפו בשדות networkPolicyCompliance,‏ platformPolicyCompliance, ‏ dealsPolicyCompliance,‏ chinaPolicyCompliance ו-russiaPolicyCompliance בהתאמה.
24 ביוני 2020 השקה ראשונית של Real-time Bidding API, שנועד להחליף בסופו של דבר את Ad Exchange Buyer API ואת Ad Exchange Buyer II API.

הדור הקודם

גרסה 2.0 (יצאה משימוש)

תאריך הערות
11.08.2025

הוספנו את הסטטוס OVERDELIVERED_IMPRESSION ל-enum‏ Status של NonBillableWinningBidStatusRow.

29.09.2023

כל המשאבים האחרים, חוץ מאלה שמשמשים לפתרון בעיות ב-RTB, הוצאו משימוש ויחזירו תגובת שגיאה אם תתבצע אליהם קריאה. מומלץ לעבור ל-Marketplace API כדי להמשיך לגשת ל-Marketplace באופן פרוגרמטי. משאבים שיוצאו משימוש כוללים את המשאבים הבאים ואת כל משאבי המשנה שלהם:

  • accounts.clients
  • accounts.creatives
  • accounts.finalizedProposals
  • accounts.products
  • accounts.proposals
  • accounts.publisherProfiles
  • accounts.clients
24/5/2021

נוספו שיטות pause ו-resume ברמת העסקה.

20/8/2020

השדה detail נוסף לBidMetricsRow.

06/05/2020

השדה reachedQueries נוסף ל-BidMetricsRow. נוספו FATAL_VAST_ERROR ו-LOST_IN_MEDIATION ל-enum‏ Status של NonBillableWinningBidStatusRow.

09/03/2016

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