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

واجهة برمجة تطبيقات Marketplace

الإصدار 1.0

التاريخ Notes
7 آذار (مارس) 2024
29 شباط (فبراير) 2024
  • تم تقديم الحقل mediaPlanner إلى Deal.
  • تم إدخال الحقل validSeatIds إلى Deal.
  • لن تتم تعبئة فاتورة المشتري ضمن الصفقة إذا كانت تنتمي إلى حساب مخطِّط وسائط الإعلان.
29 تشرين الثاني (نوفمبر) 2023 تمت إضافة قيمة تعداد AUDIO إلى CreativeFormat. تمت إضافة قيمة تعداد LG_TV إلى AppStoreType.
11 تشرين الأول (أكتوبر) 2021 الإطلاق الأولي لواجهة واجهة برمجة تطبيقات "الشراة المعتمَدون"، التي تتيح لك ما يلي:
  • اقتراح صفقات مع الناشرين والتفاوض بشأنها
  • استرداد مقاييس سلامة الصفقات والصفقات النهائية
  • إدارة اشتراكات حزم المزادات
  • إدارة العملاء ومستخدمي البرنامج
  • التعرّف على الملفات الشخصية للناشرين

Real-time Bidding API

الإصدار 1.0

التاريخ Notes
31 تشرين الأول (أكتوبر) 2023 تم إيقاف buyers.userLists.getRemarketingTag وUrlRestriction، وستظهر رسالة خطأ في حال طلبها. ننصح باستخدام ميزة google_ula الخاصة بعلامة مطابقة ملفات تعريف الارتباط لإضافة مستخدمين إلى قائمة المستخدمين من خلال وضع علامة من المتصفحات. اطّلِع على مزيد من المعلومات في مستندات مطابقة ملفات تعريف الارتباط.
12 تشرين الأول (أكتوبر) 2023 تمت إضافة قيمة التعداد RENDERING_PLAYABLE إلى CreativeAttribute.
17 آب (أغسطس) 2023 تم إيقاف buyers.userLists.getRemarketingTag وUrlRestriction نهائيًا وسيتم إيقافهما في 31/10/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 تم إدخال أحد الحقل video في مورد تصميمات الإعلانات المدمجة مع المحتوى، والذي يقبل إما videoVastXml أو videoUrl.
8 تشرين الأول (أكتوبر) 2020 تم استبدال الحقول openAuctionServingStatus وopenBiddingServingStatus وdealsServingStatus وchinaServingStatus وrussiaServingStatus بـ networkPolicyCompliance وplatformPolicyCompliance وdealsPolicyCompliance وchinaPolicyCompliance وrussiaPolicyCompliance على التوالي.
24 حزيران (يونيو) 2020 تم الإطلاق الأولي لواجهة برمجة التطبيقات لعرض الأسعار في الوقت الفعلي، لتحل في النهاية محل واجهتَي برمجة التطبيقات "مشتري Ad Exchange" و"مشتري Ad Exchange" II.

قديمة

الإصدار 2.0 (متوقف)

التاريخ Notes
29 أيلول (سبتمبر) 2023

تم إيقاف جميع الموارد بخلاف تلك المستخدَمة لتحديد المشاكل وحلّها في عرض الأسعار في الوقت الفعلي (RTB)، وسيتم عرض استجابة للخطأ في حال طلبها. ننصحك بنقل البيانات إلى Marketplace API لمواصلة الوصول إلى Marketplace آليًا. وتشمل موارد الإيقاف النهائي ما يلي وجميع مواردها الفرعية:

  • accounts.clients
  • accounts.creatives
  • accounts.finalizedProposals
  • accounts.products
  • accounts.proposals
  • accounts.publisherProfiles
  • accounts.clients
24/5/2021

تمت إضافة طريقتَي pause وresume على مستوى الصفقة.

20 آب (أغسطس) 2020

تمت إضافة الحقل detail إلى BidMetricsRow.

6/5/2020

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

9/3/2016

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