یادداشت های انتشار

این صفحه یادداشت‌های انتشار مربوط به API مدیریت پیشنهادات گوگل (Google Bid Manager) را ارائه می‌دهد.

آخرین نسخه API: v2

۲۲ سپتامبر ۲۰۲۵

مشکلات شناخته شده

همانطور که قبلاً در مرکز راهنمای Display & Video 360 اعلام شده بود، به دلیل استفاده کم، سه مقدار شمارشی Filter را غیرفعال می‌کنیم.

نسخه ۲

  • Filters زیر منسوخ شده‌اند:

    مقدار Filter (ها)

    FILTER_DFP_ORDER_ID

    FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_INSERTION_ORDER

    FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_PARTNER

۱ مارس ۲۰۲۵

مشکلات شناخته شده

گزارش موجودی و ابعاد مرتبط با غروب آفتاب در YouTube Trueview همانطور که قبلاً در مرکز راهنمای Display & Video 360 اعلام شده بود.

نسخه ۲

  • فیلترهای زیر منسوخ شده‌اند:

    مقدار فیلتر (ها)

    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

۲۰ نوامبر ۲۰۲۴

ویژگی‌های جدید

تابع FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID اجرا می‌شود. این تابع امکان گنجاندن داده‌های با اطمینان پایین‌تر برای معیارهایی با پیشوندهای زیر را فراهم می‌کند:

  • METRIC_UNIQUE_REACH_
  • METRIC_VIRTUAL_PEOPLE_DUPLICATE_
  • METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_
  • METRIC_VIRTUAL_PEOPLE_OVERLAP_

هنگام استفاده از این فیلتر، باید یکی از معیارهای مربوطه لحاظ شود.

پس از اجرا، کوئری‌هایی که این فیلتر را شامل نمی‌شوند، به طور پیش‌فرض به رفتار پیش‌فرض قبلی که فقط شامل داده‌های با اطمینان بالا بود، برمی‌گردند. در تاریخ ۴ فوریه ۲۰۲۵ و پس از آن، کوئری‌هایی که این فیلتر را شامل نمی‌شوند، به طور پیش‌فرض شامل داده‌های با اطمینان کمتر خواهند بود.

نسخه ۲

  • فیلترهای زیر اضافه شده‌اند:

    نوع فیلتر مقادیر موجود
    FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID

    0 : داده‌های با اطمینان کمتر را نیز شامل می‌شود. (پیش‌فرض پس از ۴ فوریه ۲۰۲۵ )

    1 : فقط داده‌های با اطمینان بالا را لحاظ کنید. (پیش‌فرض قبل از ۴ فوریه ۲۰۲۵ )

۱ اکتبر ۲۰۲۴

ویژگی‌های جدید

هیچ کدام.

مشکلات شناخته شده

نسخه ۲

پایان بُعد گزارش‌دهی مدل‌سازی موجودی ناشناس (AIM)

بُعد FILTER_ANONYMOUS_INVENTORY_MODELING برابر با sunset است.

ایجاد یا اجرای منابع Query با استفاده از مقادیر sunset در 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.type YOUTUBE و مقدار متریک مرتبط در params.metrics خطای 400 را برمی‌گرداند.

۱ مه ۲۰۲۴

ویژگی‌های جدید

هیچ کدام.

مشکلات شناخته شده

نسخه ۲

پایان گزارش‌های مسیر کامل و انتساب مسیر

گزارش‌های مسیر کامل و نسبت‌دهی مسیر منسوخ شده‌اند. بازیابی یا ایجاد این نوع منابع Query و Report منجر به خطا می‌شود.

مقادیر ReportType زیر مربوط به sunset هستند:

  • FULL_PATH
  • PATH_ATTRIBUTION

فیلد pathQueryOptions از شیء Options نیز دارای مقدار sunset است.

۲۸ فوریه ۲۰۲۴

ویژگی‌های جدید

هیچ کدام.

مشکلات شناخته شده

نسخه ۲

غروب مقادیر معیار تبدیل بین دستگاهی

معیارهای تبدیل بین دستگاهی منسوخ شده‌اند. مقادیر معیار 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

۶ ژوئیه ۲۰۲۲

ویژگی‌های جدید

API مدیریت پیشنهاد نسخه ۲ منتشر شد.

تغییرات ساختاری در API ایجاد شد، از جمله به‌روزرسانی نقطه پایانی سرویس و تغییر نام سرویس‌ها و روش‌ها.

منابع پرس‌وجو و گزارش با حذف فیلدهای غیرضروری، سازماندهی مجدد فیلدهای موجود و تغییر نوع فیلدها به‌طور قابل‌توجهی به‌روزرسانی شده‌اند. این شامل تغییر نوع فیلدها برای استفاده از اشیاء نامگذاری‌شده به جای تعریف کلی «شیء تودرتو» می‌شود.

اجرای کوئری‌های ad-hoc با استفاده از متد queries.run به جای اجرای خودکار آنها پس از ایجاد، الزامی است.

پارامتر query مربوط queries.run به asynchronous با synchronous جایگزین شد.

بازیابی گزارش ساده شده از طریق تغییرات زیر:

پیام‌های خطایی که توسط API برگردانده می‌شوند، به‌روزرسانی شده‌اند تا دقیق‌تر باشند و راه‌حل‌های تجویزی‌تری ارائه دهند.

برای مهاجرت از نسخه ۱.۱ به نسخه ۲، دستورالعمل‌های ارائه شده در راهنمای مهاجرت نسخه ۲ را دنبال کنید.

نسخه ۲

مشکلات شناخته شده

هیچ کدام.

نسخه‌های قبلی

برای مطالعه درباره نسخه‌های قبلی API مدیریت پیشنهاد قیمت برای نسخه‌های منسوخ‌شده، به یادداشت‌های انتشار بایگانی‌شده ما مراجعه کنید.