Lần cập nhật gần đây nhất: 31-10-2023
Di chuyển ứng dụng
Để di chuyển từ v2 sang v3, bạn phải cập nhật URL điểm cuối để gọi v3 và cập nhật ứng dụng để tính đến các thay đổi có thể gây lỗi.
Cập nhật lệnh gọi API từ phiên bản 2 lên phiên bản 3
Để sử dụng v3 thay vì v2, bạn cần cập nhật các yêu cầu để sử dụng các điểm cuối v3 mới.
Ví dụ: để gọi phương thức advertisers.get
bằng v2, bạn sẽ sử dụng URL sau:
GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId
Đối với phiên bản 3, hãy cập nhật URL thành như sau:
GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId
Nếu bạn đang sử dụng thư viện ứng dụng để gửi yêu cầu đến API, hãy sử dụng phiên bản thư viện ứng dụng mới nhất và cập nhật cấu hình để sử dụng phiên bản 3.
Thực hiện các thay đổi bắt buộc
Chúng tôi sẽ ra mắt một số thay đổi có thể gây lỗi trong phiên bản 3. Xem lại các hướng dẫn sau và thực hiện các thay đổi cần thiết có liên quan đến hoạt động sử dụng API Display & Video 360 hiện tại của bạn.
Cập nhật các cuộc gọi truy xuất tài nguyên trên YouTube và tiêu chí nhắm mục tiêu có liên quan
- Các tài nguyên
YoutubeAdGroup
vàYoutubeAdGroupAd
đã được thay thế bằng các tài nguyênAdGroup
vàAdGroupAd
. Các tài nguyên mới này cung cấp thông tin gần giống với tài nguyên phiên bản 2 nhưng có thể sử dụng tên trường hoặc kiểu enum đã cập nhật. Trong quá trình tích hợp, hãy thay thế việc sử dụng tài nguyênYoutubeAdGroup
hoặcYoutubeAdGroupAd
bằng tài nguyênAdGroup
vàAdGroupAd
, đồng thời cập nhật lệnh gọi đến các dịch vụ v2 sau đây thành dịch vụ v3 tương ứng:advertisers.youtubeAdGroupAds
đếnadvertisers.adGroupAds
advertisers.youtubeAdGroups
đếnadvertisers.adGroups
advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions
đếnadvertisers.adGroups.targetingTypes.assignedTargetingOptions
- Mã tham chiếu đến các đối tượng
YoutubeAndPartnersBiddingStrategy
đã được chuyển sang trườngyoutubeAndPartnersBid
mới trong đối tượngBiddingStrategy
chung. TrườngbiddingStrategy
đã bị xoá khỏi đối tượngYoutubeAndPartnersSettings
. Cập nhật chức năng tích hợp của bạn để truy xuất chiến lược đặt giá thầu cho các mục hàng hoặc nhóm quảng cáo trên YouTube từ đối tượngBiddingStrategy
ở trườngbidStrategy
trong tài nguyênLineItem
hoặcAdGroup
. - Trường
thirdPartyMeasurementSettings
đã được đổi tên thànhthirdPartyMeasurementConfigs
trong đối tượngYoutubeAndPartnersSettings
và đối tượngYoutubeAndPartnersThirdPartyMeasurementSettings
đã được đổi tên thànhThirdPartyMeasurementConfigs
. Cập nhật quá trình tích hợp của bạn để truy xuất thông tin cấu hình đo lường của bên thứ ba bằng cách sử dụng trường và đối tượng mới.
Bao gồm các cấu hình thanh toán bắt buộc khi tạo nhà quảng cáo
billingConfig
hiện là một trường bắt buộc trong tài nguyên Advertiser
. Cập nhật các yêu cầu advertisers.create
để xác minh rằng trường này đã được đặt. Bạn có thể truy xuất thông tin thanh toán mặc định cho đối tác mẹ thông qua trường Partner
mới của tài nguyên billingConfig
.
Sử dụng trường mới để kiểm soát tính năng tối ưu hoá tiêu chí nhắm mục tiêu
Một trường boolean enableOptimizedTargeting
mới đã thay thế trường targetingExpansionLevel
trong đối tượng TargetingExpansionConfig
.
Cập nhật tính năng tích hợp đơn đặt hàng quảng cáo để sử dụng trường KPI mới
Trường kpi
mới đã thay thế trường performanceGoal
trong tài nguyên InsertionOrder
. Trường mới này sử dụng một đối tượng Kpi
thay cho đối tượng PerformanceGoal
, đồng thời sử dụng các trường và enum mới.
Xoá mục tham chiếu đến các dịch vụ và trường không dùng nữa
Nhiều thực thể đã bị xoá trong phiên bản 3 để phù hợp với việc ngừng sử dụng tính năng trước đây:
- Dịch vụ
advertisers.manualTriggers
đã bị xoá vì các điều kiện kích hoạt thủ công không còn được dùng nữa. - Trường
billableOutcome
đã bị xoá khỏi tài nguyênInsertionOrder
vì giao dịch mua dựa trên kết quả thu được đã ngừng hoạt động.
Các nội dung thay đổi khác
Ngoài những thay đổi có thể gây lỗi nêu trên, phiên bản 3 cũng giới thiệu các tính năng mới.
Bạn có thể xem các tính năng được thêm vào phiên bản 3 sau lần phát hành đầu tiên trong ghi chú phát hành của chúng tôi.
Quản lý danh sách vị trí vùng lân cận
Trong phiên bản 3, bạn có thể quản lý hoàn toàn danh sách vị trí lân cận, cho phép bạn sử dụng dịch vụ advertisers.locationLists.assignedLocations
để tạo và xoá các vị trí được chỉ định cho tài nguyên TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
. Các vị trí được xác định bằng mã nhận dạng của tài nguyên TARGETING_TYPE_POI
TargetingOption
. Bạn có thể truy xuất các tệp này bằng targetingTypes.targetingOptions.search
.
Khả năng xây dựng thuật toán đặt giá thầu tuỳ chỉnh dựa trên quy tắc
Trong phiên bản 3, bạn có thể tạo và truy xuất các thuật toán đặt giá thầu tuỳ chỉnh dựa trên quy tắc bằng cách sử dụng các dịch vụ customBiddingAlgorithms
, media
, customBiddingAlgorithms.rules
.
Tính năng này đang trong giai đoạn thử nghiệm và chỉ dành cho các đối tác trong danh sách cho phép. Nếu đối tác của bạn không có trong danh sách cho phép, yêu cầu của bạn sẽ trả về một lỗi.