ملاحظات الإصدار

Marketplace API

الإصدار 1.0

التاريخ ملاحظات
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.
  • لن يتمّ تعبئة حقل "المشتري الذي يتمّ تحصيل الرسوم منه" في الصفقة إذا كان ينتمي إلى حساب مخطّط وسائط.
29 تشرين الثاني (نوفمبر) 2023 تمت إضافة قيمة AUDIO إلى CreativeFormat. تمت إضافة قيمة العنصر المحدد LG_TV إلى AppStoreType.
11 تشرين الأول (أكتوبر) 2021 الإطلاق الأولي لواجهة برمجة التطبيقات الخاصة ببرنامج "الشراة المعتمَدون"، والتي تتيح لك إجراء ما يلي:
  • اقتراح الصفقات مع الناشرين والتفاوض بشأنها
  • استرداد الصفقات المكتملة ومقاييس صحتها
  • إدارة اشتراكات حِزم المزادات
  • إدارة العملاء ومستخدِمي العملاء
  • الاطّلاع على الملفات الشخصية للناشرين

الإصدار التجريبي 1.0

التاريخ ملاحظات
12 يونيو 2024
  • الإصدار الأولي من واجهة برمجة التطبيقات v1alpha

Real-time Bidding API

الإصدار 1.0

التاريخ ملاحظات
6 آب (أغسطس) 2024
  • تمّ إدخال الحقلَين detectedCategoriesTaxonomy وdetectedCategories إلى CreativeServingDecision.
30 تموز (يوليو) 2024
31 تشرين الأول (أكتوبر) 2023 تم إيقاف buyers.userLists.getRemarketingTag وUrlRestriction نهائيًا، وسيتم عرض استجابة خطأ في حال استدعائهما. ننصحك باستخدام ميزة google_ula علامة مطابقة ملفات تعريف الارتباط لإضافة المستخدمين إلى قائمة المستخدمين من خلال وضع علامة من المتصفّحات. اطّلِع على مزيد من المعلومات في مستندات "مطابقة ملفات تعريف الارتباط".
12 تشرين الأول (أكتوبر) 2023 تمت إضافة قيمة RENDERING_PLAYABLE إلى CreativeAttribute.
17 آب (أغسطس) 2023 تم إيقاف buyers.userLists.getRemarketingTag وUrlRestriction نهائيًا وستتم إزالتهما في 31 تشرين الأول (أكتوبر) 2023. استخدِم ميزة google_ula لعلامة "مطابقة ملفات تعريف الارتباط" لإضافة مستخدمين إلى قائمة المستخدمين عن طريق وضع علامة من المتصفّحات. اطّلِع على مزيد من المعلومات في مستندات "مطابقة ملفات تعريف الارتباط".
17 آذار (مارس) 2023 تمت إضافة حقل missingCertificate إلى PolicyTopicEntry.
7 شباط (فبراير) 2023

تمّت إزالة قيم التعداد المتوقّفة نهائيًا التالية من 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

تمت إضافة قيمة جديدة OPENRTB_PROTOBUF في سمة التعداد لمحاولة bidders.endpoints.bidProtocol. من الآن فصاعدًا، لن يكون سوى إصدار واحد من OpenRTB متاحًا في كل مرة. يجب استخدام OPENRTB_JSON أو OpenRTB_PROTOBUF لاستخدام أحدث إصدار متوافق من OpenRTB بالتنسيق المفضّل لديك. يُرجى الاطّلاع على مقالة المدوّنة حول إيقاف الإصدارات القديمة من OpenRTB للحصول على مزيد من التفاصيل.

تم وضع علامة على حقول التعداد التالية من 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 يمكن لتبادلات "عرض الأسعار المفتوح" استخدام publisherConnections لإدارة الاتصالات مع الناشرين.
1 تشرين الثاني (نوفمبر) 2021 تمّت إضافة bidders.enpoints.patch لتعديل نقطة نهاية مقدّم عروض الأسعار.
27 أيار (مايو) 2021 تمّ إدخال حقل oneof‏ video لمورد تصميمات الإعلانات المدمجة، والذي يقبل إما videoVastXml أو videoUrl.
8 تشرين الأول (أكتوبر) 2020 تم استبدال الحقول openAuctionServingStatus وopenBiddingServingStatus dealsServingStatus وchinaServingStatus russiaServingStatus بـ networkPolicyCompliance platformPolicyCompliance وdealsPolicyCompliance chinaPolicyCompliance وrussiaPolicyCompliance على التوالي.
24 حزيران (يونيو) 2020 الإطلاق الأولي لواجهة برمجة التطبيقات لعروض الأسعار في الوقت الفعلي، بهدف استبدال واجهات برمجة التطبيقات Ad Exchange Buyer وAd Exchange Buyer II في نهاية المطاف

قديمة

الإصدار 2.0 (ميزة متوقّفة نهائيًا)

التاريخ ملاحظات
9/29/2023

تم إيقاف جميع المراجع غير تلك المستخدَمة لتحديد مشاكل "عروض الإعلانات أثناء عرض النتائج" وحلّها نهائيًا، وستُعرِض ردًا يتضمّن خطأً في حال تمّ استدعاؤها. ننصحك بالانتقال إلى 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.

6/5/2020

تمت إضافة حقل reachedQueries إلى BidMetricsRow. تمت إضافة FATAL_VAST_ERROR وLOST_IN_MEDIATION إلى التعداد Status من NonBillableWinningBidStatusRow.

9‏/3‏/2016

تم طرح إذن وصول العميل كإصدار تجريبي مفتوح. يمكنك الآن السماح للمشترين من العملاء بالوصول مباشرةً إلى سوق "المشترون المعتمَدون" ليتمكّنوا من الاطّلاع على الصفقات والتفاوض عليها والموافقة عليها. ويمكن لتطبيقك تنفيذ العملياتبرمجيًا التي كان يجب إجراؤها يدويًا سابقًا في قسم العملاء ضمن علامة التبويب إعدادات حساب المشتري في "المشترون المعتمَدون".