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

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

الإصدار 1.0

التاريخ	Notes
17 يونيو 2024	تم إصلاح الخطأ الذي كان يؤدي إلى استخدام buyers.proposals.addNote في عروض المزادات الخاصة، وهذا الإجراء ليس سير عمل صالحًا لأنّ هذا النوع من الصفقات لا ينطوي على تفاوض.
‫6 يونيو 2024	تمت إضافة معلومات عن الصفقات المفضَّلة pausing وresuming.
25 أبريل 2024	تمت إضافة إمكانية استخدام المعلَمة orderBy إلى bidders.auctionPackages.list.
23 أبريل 2024	تمت إضافة قيمة الاستهداف excludedCategoryIds إلى MarketplaceTargeting. تمت إضافة قيمة الاستهداف vertical_targeting إلى MarketplaceTargeting.
15 أبريل 2024	تم تقديم bidders.auctionPackages.list لإدراج حِزم المزادات على مستوى مقدِّم عروض الأسعار. تسرد حِزم المزادات التي يتم عرضها باستخدام هذه الطريقة أدوات تخطيط الوسائط المشتركين فيها من خلال الحقل subscribedMediaPlanners. تم تقديم حقل المشترِكون المشترون في AuctionPackage. تم تقديم الحقل signedMediaPlanners على "AuctionPackage". تم تقديم الحقل eligibleSeatIds في AuctionPackage.
7 مارس 2024	تم إدخال قيمة التعداد PUBLISHER_PROVIDED_ID بالعدد PretargetingConfig.
29 فبراير 2024	تم إدخال الحقل mediaPlanner في Deal. تم تقديم الحقل eligibleSeatIds في Deal. لن تتم تعبئة مشتري الصفقة إذا كانت تنتمي إلى حساب منسّق وسائط.
29 تشرين الثاني (نوفمبر) 2023	تمت إضافة قيمة تعداد AUDIO إلى CreativeFormat. تمت إضافة قيمة تعداد LG_TV إلى AppStoreType.
11 تشرين الأول (أكتوبر) 2021	الإطلاق الأولي لواجهة واجهة برمجة تطبيقات الشراة المعتمَدين في السوق، ما يتيح لك ما يلي: اقتراح الصفقات والتفاوض بشأنها مع الناشرين استرداد الصفقات النهائية ومقاييس الحالة الصحية للصفقات إدارة اشتراكات حزم المزاد إدارة العملاء ومستخدمي البرنامج استكشاف الملفات الشخصية للناشرين

الإصدار 1.0 alpha

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

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.

قديمة

تم إيقاف واجهة برمجة التطبيقات Ad Exchange Purchases API II نهائيًا. باستثناء المراجع المستخدَمة لميزة تحديد المشاكل في عرض الأسعار في الوقت الفعلي (RTB) وتحديد المشاكل وحلّها، سيتم إيقاف جميع المصادر الأخرى اعتبارًا من 29 أيلول (سبتمبر) 2023. إذا كنت بحاجة إلى مواصلة استخدام Marketplace، ننصحك بالنقل إلى Marketplace API.

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

التاريخ	Notes
29 أيلول (سبتمبر) 2023	تم إيقاف جميع الموارد باستثناء الموارد المستخدَمة لتحديد المشاكل وحلّها في "عرض الأسعار في الوقت الفعلي" (RTB)، وسيتم عرض رد بخطأ في حال استدعائها. ننصحك بنقل البيانات إلى واجهة برمجة تطبيقات Marketplace لمواصلة الوصول إلى 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.
2016/3/9	تم إطلاق ميزة وصول العميل كإصدار تجريبي مفتوح. يمكنك الآن السماح للمشترين من العملاء بالوصول مباشرةً إلى "سوق الشراة المعتمَدين" ليتمكّنوا من الاطّلاع على الصفقات والتفاوض بشأنها والموافقة عليها. ويمكن لتطبيقك تنفيذ عمليات بشكل آلي كانت مطلوبة في السابق يدويًا في قسم العملاء ضمن علامة التبويب إعدادات حساب المشتري ضمن "الشراة المعتمَدون".