הערות מוצר

Marketplace API

גירסה 1.0

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

גרסת בטא 1.0

תאריך	הערות
‫25 באוגוסט 2026	הוספנו את השדה userListId אל DataSegment.
‫20 ביולי 2026	הוספנו את השדה curationFeeVisibility אל CuratedPackage.
‫29 ביוני 2026	הוספנו את השדה millipercentOfMediaFee אל DataSegment. הוספנו את השדה millipercentOfMediaFee אל CuratedPackage.
‫14 בדצמבר 2025	המשאבים curatedPackages ו-mediaPlanners זמינים עכשיו לאוצרים בגרסה 1beta. השדה accountID במשאב mediaPlanners הוצא משימוש.
‫11 ביוני 2025	הגרסה הראשונית של v1beta API. המשאב dataSegments זמין עכשיו בגרסה v1beta. נתיב המשאב של dataSegments השתנה מ-buyers/{accountId}/dataSegments בגרסה v1alpha ל-curators/{accountId}/dataSegments בגרסה v1beta

גרסה 1.0 אלפא

תאריך	הערות
‫25 באוגוסט 2026	הוספנו את השדה userListId אל DataSegment.
‫20 ביולי 2026	הוספנו את השדה curationFeeVisibility אל CuratedPackage.
‫29 ביוני 2026	הוספנו את השדה millipercentOfMediaFee אל DataSegment. הוספנו את השדה millipercentOfMediaFee אל CuratedPackage.
‫14 בדצמבר 2025	המשאבים curatedPackages ו-mediaPlanners זמינים עכשיו לאוצרים בגרסה v1alpha. השדה accountID במשאב mediaPlanners הוצא משימוש.
‫12 ביוני 2024	הגרסה הראשונה של v1alpha API.

Real-time Bidding API

גירסה 1.0

תאריך	הערות
‫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 space של AdCategoryTaxonomy.
‫13 בפברואר 2025	הוצאנו משימוש קטגוריות מוגבלות מוצהרות בקריאייטיב.
‫6 באוגוסט 2024	הוספנו את השדות detectedCategoriesTaxonomy ו-detectedCategories ל-CreativeServingDecision.
‫30 ביולי 2024	הוספנו את הערך המספרי PUBLISHER_FIRST_PARTY_ID ל-PretargetingConfig.
‫31 באוקטובר 2023	הפונקציות buyers.userLists.getRemarketingTag ו-UrlRestriction הוצאו משימוש, ואם תתבצע קריאה שלהן, תוחזר תגובת שגיאה. מומלץ להשתמש בתכונה google_ula של תג Cookie Matching כדי להוסיף משתמשים לרשימת משתמשים באמצעות הצבת תג מהדפדפנים. מידע נוסף מופיע ב מאמרי העזרה בנושא התאמות של קובצי Cookie
‫12 באוקטובר 2023	הוספנו את ערך ה-enum‏ RENDERING_PLAYABLE אל CreativeAttribute.
‫17 באוגוסט 2023	השיטות buyers.userLists.getRemarketingTag ו-UrlRestriction הוצאו משימוש והן יבוטלו ב-31/10/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	השקה ראשונית של API לבידינג בזמן אמת, שנועד להחליף בסופו של דבר את ממשקי ה-API של Ad Exchange Buyer ו-Ad Exchange Buyer II.

דור קודם

הוצאנו משימוש את Ad Exchange Buyer API II. כל המשאבים הושבתו ב-29 בספטמבר 2023, למעט המשאבים שמשמשים לפתרון בעיות ב-RTB. אם אתם רוצים להמשיך להשתמש ב-Marketplace, מומלץ לעבור ל-Marketplace API.

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

תאריך	הערות
8/11/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	נוספו methods ברמת העסקה pause ו-resume.
20/8/2020	השדה detail נוסף לBidMetricsRow.
06/05/2020	השדה reachedQueries נוסף ל-BidMetricsRow. נוספו הערכים FATAL_VAST_ERROR ו-LOST_IN_MEDIATION לרשימת הערכים Status של NonBillableWinningBidStatusRow.
09/03/2016	השקנו את הגישה ללקוח כגרסת בטא פתוחה. עכשיו אתם יכולים לאפשר לקונים של הלקוחות שלכם לגשת ישירות אל Authorized Buyers Marketplace כדי לראות עסקאות, לנהל משא ומתן ולאשר אותן. בנוסף, האפליקציה יכולה לבצע באופן פרוגרמטי פעולות שבעבר היה צריך לבצע באופן ידני בקטע לקוחות בכרטיסייה הגדרות חשבון קונה ב-Authorized Buyers.