Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Quy trình làm việc của API

Hướng dẫn này mô tả các quy trình API phổ biến để tạo, huỷ, truy xuất, cập nhật và thương lượng các giao dịch bằng Deal Sync API.

Tạo giao dịch

Kiểm tra xem một sản phẩm đã được tạo hay chưa bằng cách gọi sản phẩm LIST bằng bộ lọc externalDealId. Xin lưu ý rằng cả camelCase externalDealId và snake_case external_deal_id đều được hỗ trợ trong chuỗi bộ lọc. external_deal_id phải là duy nhất trên tất cả các sản phẩm.
```
GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*/orders/*}/products?filter=externalDealId="{external_deal_id}"
```
Tạo đơn đặt hàng. Tên đơn đặt hàng do DV360 tạo và bạn nên lưu trữ mã nhận dạng này trong hệ thống của mình để truy xuất sau này.
Tạo Sản phẩm trong Đơn đặt hàng. Tên sản phẩm do DV360 tạo và bạn nên lưu trữ mã nhận dạng này trong hệ thống để truy xuất sau này.

Ngoài ra, bạn có thể gọi LIST bằng external_deal_id. Tên tài nguyên chứa cả Mã đơn đặt hàng và Mã sản phẩm, vì vậy, bạn có thể xác định Đơn đặt hàng gốc.

Huỷ ưu đãi

Cập nhật trạng thái đơn đặt hàng thành ĐÃ HUỶ. Bạn chỉ có thể huỷ nếu đơn đặt hàng chưa được chấp nhận. Đã huỷ là trạng thái cuối cùng; bạn không thể kích hoạt lại Đơn đặt hàng sau khi đã huỷ. Nếu Đơn đặt hàng có chứa bất kỳ sản phẩm nào, thì bạn không thể sử dụng lại external_deal_id của sản phẩm đó.

Lấy thông tin chi tiết về một Thoả thuận

Lấy thông tin chi tiết về một Đơn đặt hàng. Trạng thái này sẽ được cập nhật sau khi người dùng chấp nhận, lưu trữ hoặc huỷ Đơn đặt hàng.
Lấy thông tin chi tiết về một Sản phẩm.

Lấy danh sách ưu đãi

LIST các đơn đặt hàng có bộ lọc trạng thái để nhận tất cả các đơn đặt hàng đã được chấp nhận hoặc đang chờ chấp nhận.
LIỆT KÊ sản phẩm bằng bộ lọc external_deal_id.
LIST tất cả sản phẩm trong một Đơn đặt hàng.

Cập nhật giao dịch

Cập nhật Thứ tự thông tin liên hệ của nhà xuất bản.
1. Không thể cập nhật name (không thể đặt trong updateMask). Bạn chỉ có thể đặt trạng thái thành CANCELED bằng API.
2. Không thể cập nhật partner_id.
Cập nhật Sản phẩm để cập nhật điều khoản cụ thể của giao dịch.
1. name, externalDealId, transactionType, pricingType và updateTime không thể cập nhật.
2. Bạn không cần phải yêu cầu người dùng chấp nhận lại khi cập nhật displayName.
3. Việc cập nhật rateDetails hoặc creativeConfig sẽ thay đổi trạng thái Đơn đặt hàng của cấp trên thành PENDING_ACCEPTANCE. Nhà quảng cáo DV360 sẽ được yêu cầu chấp nhận các điều khoản mới trên trang Thương lượng, bất kể Đơn đặt hàng trước đó đã được chấp nhận hay chưa.

Kiểm tra xem người dùng đã chấp nhận ưu đãi hay chưa

GetOrder nếu bạn biết Order Name (Tên đơn đặt hàng) tương ứng. Kiểm tra trường status.
Nếu bạn không theo dõi Tên đơn đặt hàng: Liệt kê sản phẩm bằng bộ lọc external_deal_id, xác định Tên đơn đặt hàng từ Tên sản phẩm, sau đó gọi Lấy đơn đặt hàng. Kiểm tra trường status.

Kiểm tra xem người dùng đã định cấu hình giao dịch hay chưa (chỉ dành cho giao dịch Đảm bảo có lập trình)

Get Inventory Source (Nhận nguồn khoảng không quảng cáo). Tên tài nguyên là exchanges/{exchangeId}/inventorysources/{external_deal_id}. Kiểm tra Trạng thái người mua.
1. Ưu đãi đặt trước:
  1. BUYER_STATUS_ACTIVE: Thỏa thuận đã được chấp nhận và định cấu hình. Thoả thuận sẽ bắt đầu chi tiêu khi DV360 nhận được các yêu cầu đặt giá thầu phù hợp với các điều khoản của thoả thuận. Mục hàng được tạo tự động trong quá trình định cấu hình giao dịch. Hãy xem phần Cấu hình giao dịch để biết thông tin chi tiết.
  2. BUYER_STATUS_PENDING: Đơn đặt hàng đã được chấp nhận nhưng bạn chưa định cấu hình thoả thuận. Không có mức chi tiêu nào ở trạng thái này.
  3. BUYER_STATUS_PAUSED: Nhà quảng cáo đã tạm dừng thoả thuận. Không có mức chi tiêu nào ở trạng thái này.
2. Ưu đãi không cần đặt trước:
  1. BUYER_STATUS_ACTIVE: Thỏa thuận đã được chấp nhận. Thoả thuận sẽ bắt đầu chi tiêu khi DV360 nhận được các yêu cầu giá thầu phù hợp, một mục hàng đang hoạt động nhắm đến thoả thuận và các yêu cầu giá thầu phù hợp với tiêu chí nhắm mục tiêu của mục hàng. Hãy xem Mục hàng để biết thông tin chi tiết. (Lưu ý: Không có Seller API để truy vấn xem một giao dịch có được nhắm đến theo các mục hàng hay không).
  2. BUYER_STATUS_PENDING: Không áp dụng cho các ưu đãi không cần đặt trước.
  3. BUYER_STATUS_PAUSED: Nhà quảng cáo đã tạm dừng giao dịch một cách rõ ràng. Không có mức chi tiêu nào ở trạng thái này.

Tạm dừng và bỏ tạm dừng giao dịch sau khi chấp nhận

Cập nhật Trạng thái của người bán Nguồn khoảng không quảng cáo.
1. Việc tạm dừng hoặc huỷ tạm dừng không làm ngừng phân phát ưu đãi. Khi người bán tạm dừng một thoả thuận, họ sẽ thấy một thông báo mang tính thông tin trong giao diện người dùng DV360 để giúp khắc phục sự cố về những thoả thuận không chi tiêu.

Thương lượng lại (cập nhật giao dịch sau khi chấp nhận)

Thương lượng lại là việc cập nhật một giao dịch sau khi người mua chấp nhận giao dịch đó. Điều này cho phép các sàn giao dịch và người mua điều chỉnh các điều khoản trong giao dịch hiện có. Ví dụ: một sàn giao dịch có thể nhận thấy thời gian kết thúc chuyến bay của một thoả thuận được chấp nhận là không chính xác; sàn giao dịch có thể sử dụng Bản vá sản phẩm để gửi thông tin cập nhật cho người mua trên DV360 trước khi thoả thuận bắt đầu phân phát.

Những thay đổi được phép và không được phép

Hãy xem các bài viết trên Trung tâm trợ giúp Display & Video 360 để biết thông tin chi tiết về các quy tắc thương lượng và thương lượng lại giao dịch:

Cấu trúc của thực thể

Tiếp

Quy trình beta

Quy trình làm việc của API Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.