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

تقدّم هذه الصفحة ملاحظات الإصدار لواجهة برمجة التطبيقات Google Bid Manager API.

أحدث إصدار من واجهة برمجة التطبيقات: الإصدار 2

1 آذار (مارس) 2025

الميزات الجديدة

المشاكل المعروفة

إيقاف تقرير مدى توفّر المستودع الإعلاني في إعلانات TrueView على YouTube والسمات المتعلّقة به نهائيًا، كما أعلنّا سابقًا في مركز مساعدة "مساحة العرض والفيديو 360"

v2

  • تم إيقاف قيم التعداد التالية نهائيًا:

    Enumالقيم
    ReportType INVENTORY_AVAILABILITY
  • تم إيقاف الفلاتر التالية نهائيًا:

    قيم الفلترة

    FILTER_DETAILED_DEMOGRAPHICS

    FILTER_DETAILED_DEMOGRAPHICS_ID

    FILTER_HOUSEHOLD_INCOME

    FILTER_LIFE_EVENT

    FILTER_REMARKETING_LIST

    FILTER_TRUEVIEW_IAR_AGE

    FILTER_TRUEVIEW_IAR_CATEGORY

    FILTER_TRUEVIEW_IAR_CITY

    FILTER_TRUEVIEW_IAR_COUNTRY

    FILTER_TRUEVIEW_IAR_COUNTRY_NAME

    FILTER_TRUEVIEW_IAR_GENDER

    FILTER_TRUEVIEW_IAR_INTEREST

    FILTER_TRUEVIEW_IAR_LANGUAGE

    FILTER_TRUEVIEW_IAR_PARENTAL_STATUS

    FILTER_TRUEVIEW_IAR_REGION_NAME

    FILTER_TRUEVIEW_IAR_REMARKETING_LIST

    FILTER_TRUEVIEW_IAR_TIME_OF_DAY

    FILTER_TRUEVIEW_IAR_YOUTUBE_CHANNEL

    FILTER_TRUEVIEW_IAR_YOUTUBE_VIDEO

    FILTER_TRUEVIEW_IAR_ZIPCODE

    FILTER_YOUTUBE_CHANNEL

    FILTER_YOUTUBE_VIDEO

  • تم إيقاف المقاييس التالية نهائيًا:

    قِيم المقاييس

    METRIC_POTENTIAL_VIEWS

    METRIC_TEA_TRUEVIEW_IMPRESSIONS

    METRIC_TEA_TRUEVIEW_UNIQUE_COOKIES

‫20 نوفمبر 2024

الميزات الجديدة

تم إطلاق FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID. يتيح ذلك تضمين data البيانات الأقل ثقة للمقاييس التي تحتوي على البادئات التالية:

  • METRIC_UNIQUE_REACH_
  • METRIC_VIRTUAL_PEOPLE_DUPLICATE_
  • METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_
  • METRIC_VIRTUAL_PEOPLE_OVERLAP_

يجب تضمين أحد المقاييس ذات الصلة عند استخدام هذا الفلتر.

عند الإطلاق، سيتم تطبيق السلوك التلقائي السابق على طلبات البحث التي لا تتضمّن هذا الفلتر، وهو تضمين البيانات العالية الثقة فقط. اعتبارًا من 4 شباط (فبراير) 2025، ستتضمّن الاستعلامات التي لا تتضمّن هذا الفلتر تلقائيًا بيانات ذات ثقة أقل.

v2

  • تمت إضافة الفلاتر التالية:

    نوع الفلترالقيم المتاحة
    FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID

    0: تضمين البيانات الأقل ثقة (الإعداد التلقائي بعد 4 شباط (فبراير) 2025)

    1: يجب تضمين البيانات التي تتسم بثقة عالية فقط. (الإعداد التلقائي قبل 4 شباط (فبراير) 2025)

‫1 أكتوبر 2024

الميزات الجديدة

بلا عُري

المشاكل المعروفة

v2

إيقاف سمة إعداد تقارير نموذج المساحات الإعلانية المجهولة (AIM) نهائيًا

سمة FILTER_ANONYMOUS_INVENTORY_MODELING هي غروب الشمس.

يؤدي إنشاء موارد Query أو تشغيلها باستخدام قيم الإيقاف النهائي في params.groupBy إلى ظهور خطأ 400.

أصبحت مقاييس ضريبة الخدمات الرقمية (DST) أو تكاليف التشغيل التنظيمية (ROC) وإجمالي تكلفة الوسائط غير متوافقة مع تقارير YOUTUBE.

لم يعُد بالإمكان استخدام قيم المقاييس التالية في تقارير YOUTUBE:

  • METRIC_TOTAL_MEDIACOST_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPAPC_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPAPC_USD
  • METRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPAPV_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPAPV_USD
  • METRIC_TOTAL_MEDIACOST_ECPA_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPA_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPA_USD
  • METRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPCV_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPCV_USD
  • METRIC_TOTAL_MEDIACOST_ECPC_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPC_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPC_USD
  • METRIC_TOTAL_MEDIACOST_ECPM_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPM_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPM_USD
  • METRIC_TOTAL_MEDIACOST_PARTNER
  • METRIC_TOTAL_MEDIACOST_USD
  • METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNER
  • METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USD
  • METRIC_FEE32_ADVERTISER
  • METRIC_FEE32_PARTNER
  • METRIC_FEE32_USD

يؤدي إنشاء موارد Query أو تشغيلها باستخدام params.typeYOUTUBE وقيمة مقياس ذات صلة في params.metrics إلى ظهور خطأ 400.

1 أيار (مايو) 2024

الميزات الجديدة

بلا عُري

المشاكل المعروفة

v2

إيقاف تقارير "المسار الكامل" و"تحديد مصدر المسار" نهائيًا

سيتم إيقاف تقريرَي "المسار الكامل" و"تحديد مصدر المسار" نهائيًا. يؤدي استرداد هذين نوعَي موارد Query و Report أو إنشاؤهما إلى ظهور خطأ.

في ما يلي قيم ReportType الخاصة بحالة غروب الشمس:

  • FULL_PATH
  • PATH_ATTRIBUTION

حقل pathQueryOptions للكائن Options هو sunset أيضًا.

‫28 فبراير 2024

الميزات الجديدة

بلا عُري

المشاكل المعروفة

v2

إيقاف قيم مقياس الإحالات الناجحة باستخدام أكثر من جهاز واحد نهائيًا

سيتم إيقاف مقاييس الإحالات الناجحة باستخدام أكثر من جهاز واحد نهائيًا. يتم تضمين مقاييس قيم Bid Manager API التالية:

  • METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENT
  • METRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENT
  • METRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENT
  • METRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENT
  • METRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT

6 تموز (يوليو) 2022

الميزات الجديدة

تم إصدار الإصدار 2 من Bid Manager API.

تم إجراء تغييرات هيكلية على واجهة برمجة التطبيقات، بما في ذلك تعديل نقطة نهاية الخدمة وإعادة تسمية الخدمات والطُرق.

تم تعديل موارد الطلبات والتقارير بشكل كبير من خلال إزالة الحقول غير الضرورية وإعادة تنظيم الحقول الحالية وتغيير أنواع الحقول. ويشمل ذلك تغيير أنواع الحقول لاستخدام عناصر مُسمّاة بدلاً من تعريف "كائن مُدمَج" عام.

مطلوب تشغيل طلبات بحث مخصّصة باستخدام طريقة queries.run بدلاً من تشغيلها تلقائيًا بعد إنشائها.

استبدال مَعلمة طلب البحث asynchronous في queries.run ب synchronous

استرداد التقارير المبسّط من خلال التغييرات التالية:

تم تعديل رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات لتكون أكثر تحديدًا وتقديم المزيد من الحلول المقترَحة.

اتّبِع التعليمات الواردة في دليل نقل البيانات إلى الإصدار 2 للقيام بنقل البيانات من الإصدار 1.1 إلى الإصدار 2.

v2

المشاكل المعروفة

بلا عُري

الإصدارات السابقة

للاطّلاع على معلومات عن الإصدارات السابقة من Bid Manager API للإصدارات التي سيتم إيقافها نهائيًا، يُرجى الاطّلاع على ملاحظات الإصدارات المؤرشفة.