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

این صفحه یادداشت‌های انتشار را برای Google Bid Manager API ارائه می‌کند.

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

1 مارس 2025

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

مسائل شناخته شده

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

v2

• مقادیر enum زیر منسوخ شده اند:

  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 راه اندازی شد. این اجازه می دهد تا داده های اطمینان کمتری را برای معیارها با پیشوندهای زیر لحاظ کنید:

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

1 مه 2024

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

هیچ کدام

مسائل شناخته شده

v2

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

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

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

• FULL_PATH
• PATH_ATTRIBUTION

فیلد pathQueryOptions شی Options نیز غروب است.

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

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

Released Bid Manager API v2.

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

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

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

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

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

• اضافه شدن یک روش queries.reports.get .
• افزودن یک پارامتر پرس و جو orderBy به queries.reports.list .
• به روز رسانی بدنه پاسخ queries.run از یک شی خالی به یک نمونه از منبع Report تولید شده.

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

دستورالعمل های ارائه شده در راهنمای مهاجرت v2 را برای مهاجرت از نسخه 1.1 به نسخه 2 دنبال کنید.

v2

• نقطه پایانی سرویس تغییر کرده است:

  نقطه پایانی سرویس v1	نقطه پایانی سرویس v2
  https://www.googleapis.com/doubleclickbidmanager	https://doubleclickbidmanager.googleapis.com

• خدمات به شرح زیر تغییر نام داده است:

  سرویس v1	سرویس v2
  پرس و جوها	پرس و جوها
  گزارش ها	پرس و جوها.گزارش ها

• متدها به صورت زیر تغییر نام داده اند:

  روش v1	روش v2
  Queries.createquery	پرس و جو. ایجاد
  Queries.deletequery	پرس و جو.حذف
  Queries.getquery	query.get
  Queries.listqueries	quries.list
  Queries.runquery	query.run
  Reports.listreports	quries.reports.list

• روش های زیر اضافه شده است:

  خدمات	روش(های)
  پرس و جوها.گزارش ها	دریافت کنید

• روش های زیر بدنه پاسخ جدیدی دارند:

  روش	جسم پاسخ جدید
  query.run	گزارش دهید

• فیلدهای زیر حذف شده اند:

  منبع	زمینه(های)
  queries.list بدنه پاسخ	مهربان
  queries.reports.list بدنه پاسخ	مهربان
  پرس و جو	مهربان ReportDataEndTimeMs ReportDataStartTimeMs کد منطقه زمانی
  RunQueryRequest	ReportDataEndTimeMs ReportDataStartTimeMs کد منطقه زمانی

• نوع شی فیلدهای زیر به شکل زیر تغییر یافته است:

  منبع	زمینه(های)	نوع شی
  پرس و جو	فراداده پارامترها برنامه	Query Metadata پارامترها QuerySchedule
  گزارش دهید	کلید فراداده پارامترها	ReportKey گزارش متادیتا پارامترها
  RunQueryRequest	محدوده داده	محدوده داده

• پارامترهای پرس و جو روش زیر اضافه شده است:

  روش	پارامتر(های) پرس و جو
  quries.list	سفارش توسط
  quries.reports.list	سفارش توسط
  query.run	همزمان

• پارامترهای پرس و جو روش زیر حذف شده اند:

  روش	پارامتر(های) پرس و جو
  پرس و جوها.ایجاد	ناهمزمان
  query.run	ناهمزمان

• مقادیر فیلتر زیر اضافه شده است:

  مقدار فیلتر
  FILTER_INVENTORY_MEDIA_COST_TYPE
  FILTER_TARGETING_EXPANSION

• مقادیر فیلتر زیر حذف شده است:

  مقدار فیلتر
  FILTER_TRUEVIEW_IAR_REGION

• مقادیر متریک زیر اضافه شده است:

  مقدار متریک
  METRIC_STORE_VISIT_VIEW_THROUGH_CONVERSIONS
  METRIC_UNIQUE_REACH_AVERAGE_VIEWABLE_IMPRESSION_FREQUENCY
  METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_CROSS_STACK_FCAP
  METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_PG_FMGMT
  METRIC_UNIQUE_REACH_INCREMENTAL_CLICK_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_IMPRESSION_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_TOTAL_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_VIEWABLE_IMPRESSION_REACH
  METRIC_UNIQUE_REACH_VIEWABLE_IMPRESSION_REACH

مسائل شناخته شده

هیچ کدام

نسخه های قبلی

برای مطالعه در مورد نسخه‌های قبلی Bid Manager API برای نسخه‌های غروب، به یادداشت‌های انتشار آرشیو شده ما مراجعه کنید.