הערות מוצר

Marketplace API

גירסה 1.0

תאריך הערות
‫10 בנובמבר 2025
‫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 space‏ 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/05/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.