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ừ 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ác tài nguyên YoutubeAdGroup và YoutubeAdGroupAd đã được thay thế bằng các tài nguyên AdGroup 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ên YoutubeAdGroup hoặc YoutubeAdGroupAd bằng tài nguyên AdGroup 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:
  • Mã tham chiếu đến các đối tượng YoutubeAndPartnersBiddingStrategy đã được chuyển sang trường youtubeAndPartnersBid mới trong đối tượng BiddingStrategy chung. Trường biddingStrategy đã bị xoá khỏi đối tượng YoutubeAndPartnersSettings. 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ượng BiddingStrategy ở trường bidStrategy trong tài nguyên LineItem hoặc AdGroup.
  • Trường thirdPartyMeasurementSettings đã được đổi tên thành thirdPartyMeasurementConfigs trong đối tượng YoutubeAndPartnersSettings và đối tượng YoutubeAndPartnersThirdPartyMeasurementSettings đã được đổi tên thành ThirdPartyMeasurementConfigs. 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:

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.