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ọcCá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.typeYOUTUBE 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 QueryReport 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ấnBá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ô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

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.