Chuyển từ phiên bản 2 sang phiên bản 3

Lần cập nhật gần đây nhất: 31/10/2023

Di chuyển ứng dụng

Để di chuyển từ phiên bản 2 sang phiên bản 3, bạn phải cập nhật URL điểm cuối để gọi phiên bản v3 và cập nhật ứng dụng của bạn cho phù hợp với các thay đổi có thể gây lỗi.

Cập nhật các lệnh gọi API từ phiên bản 2 sang phiên bản 3

Để sử dụng phiên bản 3 thay vì phiên bản 2, bạn cần cập nhật các yêu cầu của mình để sử dụng phiên bản mới điểm cuố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 tới API, hãy sử dụng phiên bản gần đây của thư viện ứng dụng và cập nhật cấu hình của bạn để 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 những nội dung sau và thực hiện những thay đổi cần thiết phù hợp với cách bạn đang sử dụng Hiển thị và API Video 360.

  • Các tài nguyên YoutubeAdGroup và YoutubeAdGroupAd đã được thay thế bằng Các tài nguyên AdGroup và AdGroupAd. Những tài nguyên mới này cung cấp thông tin gần giống với tài nguyên v2 nhưng có thể sử dụng trường đã cập nhật tên hoặc loại enum. Trong quá trình tích hợp, hãy thay thế việc sử dụng Các tài nguyên YoutubeAdGroup hoặc YoutubeAdGroupAd có AdGroup và tài nguyên AdGroupAd và cập nhật các lệnh gọi lên các dịch vụ phiên bản 2 sau đây thành dịch vụ v3 tương ứng:
  • Tham chiếu đến các đối tượng YoutubeAndPartnersBiddingStrategy đã được di chuyển đến trường youtubeAndPartnersBid mới trong đối tượng BiddingStrategy chung. Chiến lược phát hành đĩa đơn Trường biddingStrategy đã bị xoá khỏi Đối tượng YoutubeAndPartnersSettings. Cập nhật chế độ tích hợp thành 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ượng BiddingStrategy trong trường bidStrategy trong Tài nguyên LineItem hoặc AdGroup.
  • Trường thirdPartyMeasurementSettings đã được đổi tên thành thirdPartyMeasurementConfigs trong YoutubeAndPartnersSettings và đối tượng Đối tượng YoutubeAndPartnersThirdPartyMeasurementSettings đã được đổi tên thành ThirdPartyMeasurementConfigs Cập nhật chế độ tích hợp thành truy xuất thông tin về cấu hình đo lường của bên thứ ba bằng trường mới và đối tượng mục tiêu.

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 Advertiser. Cập nhật advertisers.create của bạn để xác minh rằng trường này đã được đặt. Thông tin thanh toán mặc định có thể được truy xuất cho đối tác mẹ thông qua Partner mới trường billingConfig của tài nguyên.

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

Trường boolean enableOptimizedTargeting mới đã thay thế giá trị Trường targetingExpansionLevel trong TargetingExpansionConfig .

Cập nhật chế độ 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 Kpi thay cho đối tượng PerformanceGoal, đồng thời sử dụng các trường và enum mới.

Xoá thông tin tham chiếu đến các trường và dịch vụ không dùng nữa

Nhiều thực thể đã bị xoá trong phiên bản 3 để phù hợp với tính năng trước đây ngừng sử dụ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 AI 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 bản phát hành của chúng tôi ghi chú.

Quản lý danh sách vị trí 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à xóa các vị trí được chỉ định cho TARGETING_LOCATION_TYPE_PROXIMITY LocationList. Vị trí được xác định bằng cách sử dụng ID của TARGETING_TYPE_POI TargetingOption tài nguyên. Đây có thể là truy xuất bằng targetingTypes.targetingOptions.search.

Có thể xây dựng các 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 customBiddingAlgorithms, media, customBiddingAlgorithms.rules dịch vụ.

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 không có trong danh sách cho phép, thì yêu cầu của bạn sẽ trả về lỗi.