הערות מוצר

Marketplace API

גירסה 1.0

תאריך הערות
‫14 בדצמבר 2025
  • השדה accountID במשאב mediaPlanners הוצא משימוש.
‫10 בנובמבר 2025
‫26 באוגוסט 2025
  • כשמפעילים את 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 כדי להציג חבילות מכרזים ברמת מגיש הצעת המחיר. חבילות המכרזים שמוחזרות על ידי השיטה הזו מציגות את ה-Media Planners שמנויים אליהן בשדה subscribedMediaPlanners.
  • הוספנו את השדה subscribedBuyers ל-AuctionPackage.
  • הוספנו את השדה subscribedMediaPlanners ל-AuctionPackage.
  • הוספנו את השדה eligibleSeatIds ל-AuctionPackage.
‫7 במרץ 2024
‫29 בפברואר 2024
  • הוספנו את השדה mediaPlanner ל-Deal.
  • הוספת השדה eligibleSeatIds ל-Deal.
  • השדה billedBuyer של העסקה לא יאוכלס אם היא שייכת לחשבון של Media Planner.
‫29 בנובמבר 2023 הוספנו את ערך ה-enum‏ AUDIO ל-CreativeFormat. הוספנו את ערך ה-enum‏ LG_TV ל-AppStoreType.
‫11 באוקטובר 2021 השקה ראשונית של Authorized Buyers Marketplace API, שמאפשר לכם:
  • הצעת עסקאות לבעלי תוכן דיגיטלי וניהול משא ומתן איתם
  • אחזור של עסקאות סופיות ומדדי תקינות של עסקאות
  • ניהול המינויים לחבילות המכרזים
  • ניהול לקוחות ומשתמשים של לקוחות
  • איך למצוא פרופילים של אתרי חדשות

גרסה 1.0 בטא

תאריך הערות
‫19 באוקטובר 2026
  • הוספנו את mediaPlanners.search כדי לחפש חשבונות של Media Planner לפי מזהה המושב ב-DSP.
‫25 באוגוסט 2026
  • הוספנו את השדה userListId ל-DataSegment.
‫20 ביולי 2026
‫29 ביוני 2026
‫14 בדצמבר 2025
  • המשאבים curatedPackages ו-mediaPlanners זמינים עכשיו לאוצרים בגרסה v1beta.
  • השדה accountID במשאב mediaPlanners הוצא משימוש.
‫11 ביוני 2025
  • גרסה ראשונית של v1beta API.
  • המשאב dataSegments זמין עכשיו בגרסה v1beta.
    • נתיב המשאב של dataSegments השתנה מ-buyers/{accountId}/dataSegments בגרסה v1alpha ל-curators/{accountId}/dataSegments בגרסה v1beta

גרסה 1.0 אלפא

תאריך הערות
‫19 באוקטובר 2026
  • הוספנו את mediaPlanners.search כדי לחפש חשבונות של Media Planner לפי מזהה המושב ב-DSP.
‫25 באוגוסט 2026
  • הוספנו את השדה userListId ל-DataSegment.
‫20 ביולי 2026
‫29 ביוני 2026
‫14 בדצמבר 2025
  • המשאבים curatedPackages ו-mediaPlanners זמינים עכשיו לאוצרים בגרסה v1alpha.
  • השדה accountID במשאב mediaPlanners הוצא משימוש.
‫12 ביוני 2024
  • הגרסה הראשונה של v1alpha API.

Real-time Bidding API

גירסה 1.0

תאריך הערות
‫20 בספטמבר 2026 הוצאנו משימוש את הסטטוס CERTIFICATE_REQUIRED ואת השדה missingCertificate בעקבות עדכוני מדיניות שבהם כבר לא נדרשים אישורים להימורים ולמשחקי קזינו חברתיים.
‫10 בספטמבר 2026 הוספנו את השיטה addDeals למשאב buyers.creatives, שמאפשרת לקונים לשייך מזהי עסקאות (כולל עסקאות פרוגרמטיות מובטחות, מכרזים פרטיים, עסקאות מועדפות וחבילת שטחי פרסום ייעודית לזירות מסחר) לקריאייטיב.
‫9 ביולי 2026 הוצאנו משימוש את השדה allowed_user_targeting_modes ואת ה-enum‏ UserTargetingMode ב- PretargetingConfig.
‫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 כדי להוסיף משתמשים לרשימת המשתמשים על ידי הצבת תג מהדפדפנים. מידע נוסף זמין ב מאמרי העזרה בנושא התאמות של קובצי Cookie.
‫12 באוקטובר 2023 הוספנו את ערך ה-enum‏ RENDERING_PLAYABLE ל-CreativeAttribute.
‫17 באוגוסט 2023 השדות buyers.userLists.getRemarketingTag ו-UrlRestriction הוצאו משימוש ויוסרו ב-31 באוקטובר 2023. משתמשים בתכונה google_ula של תג התאמת Cookie כדי להוסיף משתמשים לרשימת המשתמשים על ידי הצבת תג מהדפדפנים. מידע נוסף זמין ב מאמרי העזרה בנושא התאמות של קובצי 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 השקה ראשונית של 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 באופן פרוגרמטי, מומלץ לעבור ל-Marketplace API. המשאבים שהוצאו משימוש כוללים את המשאבים הבאים ואת כל משאבי המשנה שלהם:

  • accounts.clients
  • accounts.creatives
  • accounts.finalizedProposals
  • accounts.products
  • accounts.proposals
  • accounts.publisherProfiles
  • accounts.clients
24.05.2021

נוספו methods ברמת העסקה: pause ו-resume.

20.08.2020

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

5/6/2020

השדה reachedQueries נוסף אל BidMetricsRow. הוספנו את FATAL_VAST_ERROR ואת LOST_IN_MEDIATION לטיפוסים בני מנייה (enum) Status של NonBillableWinningBidStatusRow.

09.03.2016

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