הערות מוצר

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
‫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
‫20 ביולי 2026
‫29 ביוני 2026
‫14 בדצמבר 2025
  • המשאבים curatedPackages ו-mediaPlanners זמינים עכשיו לאוצרים בגרסה v1alpha.
  • השדה accountID במשאב mediaPlanners הוצא משימוש.
‫12 ביוני 2024
  • הגרסה הראשונה של v1alpha API.

Real-time Bidding API

גירסה 1.0

תאריך הערות
‫10 בנובמבר 2026 הוספנו את הפרמטר של השאילתה adCategoryTaxonomyOverride ל-methods‏ buyers.creatives.get,‏ buyers.creatives.list ו-bidders.creatives.list כדי לאפשר למגישי הצעות המחיר לשנות את AdCategoryTaxonomy שנעשה בו שימוש בתגובה. הוספנו את ערך ה-enum‏ IAB_CONTENT_2_2 ל-AdCategoryTaxonomy. בשלב הזה, אי אפשר להגדיר את IAB Content Taxonomy 2.2 כטקסונומיית קטגוריות המודעות בחשבונות Authorized Buyers או Open Bidding.
‫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 כדי שיוכלו לראות, לנהל משא ומתן ולאשר עסקאות. בנוסף, האפליקציה יכולה לבצע באופן פרוגרמטי פעולות שבעבר היה צריך לבצע באופן ידני בקטע Clients (לקוחות) בכרטיסייה Buyer Account Settings (הגדרות חשבון הקונה) ב-Authorized Buyers.