Ghi chú phát hành

Trang này cung cấp ghi chú phát hành cho Google Bid Manager API.

Phiên bản API mới nhất: v2

Ngày 1 tháng 3 năm 2025

Tính năng mới

Vấn đề đã biết

Ngừng cung cấp báo cáo về tình trạng sẵn có của khoảng không quảng cáo TrueView trên YouTube và các phương diện liên quan như đã thông báo trước đó trong trung tâm trợ giúp của Display & Video 360.

phiên bản 2

• Các giá trị enum sau đây không còn được dùng nữa:

  Enum	(Các) giá trị
  ReportType	INVENTORY_AVAILABILITY

• Các bộ lọc sau đây không còn được dùng nữa:

  (Các) giá trị bộ lọc

  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

• Các chỉ số sau đây không còn được dùng nữa:

  (Các) giá trị chỉ số
  METRIC_POTENTIAL_VIEWS METRIC_TEA_TRUEVIEW_IMPRESSIONS METRIC_TEA_TRUEVIEW_UNIQUE_COOKIES

Ngày 20 tháng 11 năm 2024

Tính năng mới

FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID được khởi chạy. Điều này cho phép đưa dữ liệu có độ tin cậy thấp hơn vào các chỉ số có tiền tố sau:

• METRIC_UNIQUE_REACH_
• METRIC_VIRTUAL_PEOPLE_DUPLICATE_
• METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_
• METRIC_VIRTUAL_PEOPLE_OVERLAP_

Bạn phải thêm một trong các chỉ số có liên quan khi sử dụng bộ lọc này.

Khi khởi chạy, các cụm từ tìm kiếm không có bộ lọc này sẽ mặc định sử dụng hành vi mặc định trước đó là chỉ bao gồm dữ liệu có độ tin cậy cao. Kể từ ngày 4 tháng 2 năm 2025, các cụm từ tìm kiếm không có bộ lọc này sẽ mặc định bao gồm dữ liệu có độ tin cậy thấp hơn.

phiên bản 2

• Chúng tôi đã thêm các bộ lọc sau:

  Loại bộ lọc	Các giá trị có sẵn
  FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID	0: Bao gồm dữ liệu có độ tin cậy thấp hơn. (Mặc định sau ngày 4 tháng 2 năm 2025) 1: Chỉ bao gồm dữ liệu có độ tin cậy cao. (Mặc định trước ngày 4 tháng 2 năm 2025)

Ngày 1 tháng 10 năm 2024

Tính năng mới

Không có.

Vấn đề đã biết

phiên bản 2

Ngừng sử dụng phương diện báo cáo Lập mô hình khoảng không quảng cáo ẩn danh (AIM)

Phương diện FILTER_ANONYMOUS_INVENTORY_MODELING là mặt trời lặn.

Việc tạo hoặc chạy tài nguyên Query bằng cách sử dụng các giá trị ngừng hoạt động trong params.groupBy sẽ trả về lỗi 400.

Các chỉ số DST/ROC (Chi phí vận hành theo luật định) và Tổng chi phí truyền thông không tương thích với báo cáo YOUTUBE.

Bạn không thể sử dụng các giá trị chỉ số sau đây trong báo cáo 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

Việc tạo hoặc chạy tài nguyên Query với params.type là YOUTUBE và giá trị chỉ số có liên quan trong params.metrics sẽ trả về lỗi 400.

Ngày 1 tháng 5 năm 2024

Tính năng mới

Không có.

Vấn đề đã biết

phiên bản 2

Ngừng cung cấp Báo cáo phân bổ theo đường dẫn đầy đủ và báo cáo phân bổ theo đường dẫn

Chúng tôi sẽ ngừng cung cấp báo cáo Lộ trình đầy đủ và báo cáo Phân bổ theo lộ trình. Việc truy xuất hoặc tạo các loại tài nguyên Query và Report này sẽ dẫn đến lỗi.

Các giá trị ReportType sau đây sẽ ngừng hoạt động:

• FULL_PATH
• PATH_ATTRIBUTION

Trường pathQueryOptions của đối tượng Options cũng sẽ ngừng hoạt động.

Ngày 28 tháng 2 năm 2024

Tính năng mới

Không có.

Vấn đề đã biết

phiên bản 2

Ngừng cung cấp giá trị chỉ số lượt chuyển đổi trên nhiều thiết bị

Các chỉ số lượt chuyển đổi trên nhiều thiết bị sẽ ngừng hoạt động. Báo cáo này bao gồm các giá trị chỉ số sau đây của API Bid Manager:

• 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

Ngày 6 tháng 7 năm 2022

Tính năng mới

Phát hành Bid Manager API phiên bản 2.

Đã thực hiện các thay đổi về cấu trúc cho API, bao gồm cả việc cập nhật điểm cuối của dịch vụ và đổi tên các dịch vụ và phương thức.

Cập nhật đáng kể các tài nguyên Truy vấn và Báo cáo bằng cách xoá các trường không cần thiết, sắp xếp lại các trường hiện có và thay đổi loại trường. Điều này bao gồm việc thay đổi loại trường để sử dụng các đối tượng được đặt tên thay vì định nghĩa "đối tượng lồng nhau" chung.

Bắt buộc phải chạy các truy vấn đặc biệt bằng phương thức queries.run thay vì tự động chạy các truy vấn đó sau khi tạo.

Thay thế tham số truy vấn queries.run asynchronous bằng synchronous.

Đơn giản hoá việc truy xuất báo cáo thông qua các thay đổi sau:

• Thêm phương thức queries.reports.get.
• Thêm tham số truy vấn orderBy vào queries.reports.list.
• Nội dung cập nhật của nội dung phản hồi queries.run từ một đối tượng trống thành một thực thể của tài nguyên Report đã tạo.

Thông báo lỗi được cập nhật do API trả về để cụ thể hơn và cung cấp nhiều giải pháp theo hướng dẫn hơn.

Làm theo hướng dẫn trong Hướng dẫn di chuyển sang phiên bản 2 để di chuyển từ phiên bản 1.1 sang phiên bản 2.

phiên bản 2

• Điểm cuối của dịch vụ đã thay đổi:

  Điểm cuối dịch vụ v1	Điểm cuối dịch vụ v2
  https://www.googleapis.com/doubleclickbidmanager	https://doubleclickbidmanager.googleapis.com

• Các dịch vụ đã được đổi tên như sau:

  Dịch vụ v1	Dịch vụ v2
  Cụm từ tìm kiếm	cụm từ tìm kiếm
  Báo cáo	queries.reports

• Các phương thức đã được đổi tên như sau:

  Phương thức v1	Phương thức v2
  Queries.createquery	queries.create
  Queries.deletequery	queries.delete
  Queries.getquery	queries.get
  Queries.listqueries	queries.list
  Queries.runquery	queries.run
  Reports.listreports	queries.reports.list

• Các phương thức sau đã được thêm:

  Dịch vụ	(Các) phương thức
  queries.reports	get

• Các phương thức sau đây có nội dung phản hồi mới:

  Phương thức	Đối tượng nội dung phản hồi mới
  queries.run	Báo cáo

• Các trường sau đây đã bị xoá:

  Tài nguyên	(Các) trường
  Nội dung phản hồi queries.list	loại
  Nội dung phản hồi queries.reports.list	loại
  Cụm từ tìm kiếm	loại reportDataEndTimeMs reportDataStartTimeMs timezoneCode
  RunQueryRequest	reportDataEndTimeMs reportDataStartTimeMs timezoneCode

• Loại đối tượng của các trường sau đây đã được thay đổi như sau:

  Tài nguyên	(Các) trường	Loại đối tượng
  Cụm từ tìm kiếm	metadata params lịch biểu	QueryMetadata Tham số QuerySchedule
  Báo cáo	key metadata params	ReportKey ReportMetadata Tham số
  RunQueryRequest	dataRange	DataRange

• Các tham số truy vấn phương thức sau đã được thêm:

  Phương thức	(Các) tham số truy vấn
  queries.list	orderBy
  queries.reports.list	orderBy
  queries.run	đồng bộ

• Các tham số truy vấn phương thức sau đây đã bị xoá:

  Phương thức	(Các) tham số truy vấn
  queries.create	không đồng bộ
  queries.run	không đồng bộ

• Các giá trị Bộ lọc sau đây đã được thêm:

  Giá trị bộ lọc
  FILTER_INVENTORY_MEDIA_COST_TYPE
  FILTER_TARGETING_EXPANSION

• Các giá trị Bộ lọc sau đây đã bị xoá:

  Giá trị bộ lọc
  FILTER_TRUEVIEW_IAR_REGION

• Các giá trị Chỉ số sau đây đã được thêm:

  Giá trị chỉ số
  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

Vấn đề đã biết

Không có.

Bản phát hành trước

Để đọc về các bản phát hành API Bid Manager trước đây cho các phiên bản ngừng hoạt động, hãy xem ghi chú phát hành đã lưu trữ của chúng tôi.