Trang này được dịch bởi Cloud Translation API.

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

Tạo giao dịch

Xem liệu một sản phẩm đã được tạo bằng cách LIỆT KÊ các sản phẩm có bộ lọc external_deal_id hay chưa. External_deal_id không được trùng lặp 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 do DV3 tạo và bạn nên lưu trữ mã nhận dạng này ở đâu đó 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 DV3 tạo và bạn nên lưu trữ mã nhận dạng này ở đâu đó trong hệ thống của mình để truy xuất sau này.

Ngoài ra, bạn luôn có thể sử dụng LIST với external_deal_id. Trường tên chứa cả Mã đơn đặt hàng và Mã sản phẩm, vì vậy, bạn có thể dễ dàng xác định đối tượng chính theo cách này.

Huỷ ưu đãi

Cập nhật trạng thái đơn đặt hàng thành Đã huỷ Chỉ hỗ trợ huỷ nếu đơn đặt hàng chưa được chấp nhận. Đã huỷ là trạng thái cuối cùng. Không thể kích hoạt lại Đơn đặt hàng sau khi đã huỷ.

Xem 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 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.
Xem thông tin chi tiết về 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/đang chờ chấp nhận.
LIST các 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. name, không cho phép cập nhật(không thể đặt trong field_mask). Bạn chỉ có thể đặt trạng thái thành Đã huỷ thông qua API.
2. partner_id không cho phép cập nhật.
Cập nhật Sản phẩm để cập nhật một điều khoản cụ thể của giao dịch.
1. Bạn không thể cập nhật name, externalDealId, transactionType, pricingType, updateTime.
2. Phương thức updateDisplayName không yêu cầu người dùng chấp nhận.
3. Update rateDetails, creativeConfig sẽ thay đổi trạng thái Đơn đặt hàng gốc thành Đang chờ chấp nhận. Nhà quảng cáo DV3 sẽ được yêu cầu chấp nhận điều khoản mới trong trang thương lượng, bất kể Đơn đặt hàng trước đó đã được chấp nhận hay chưa.

Xem người dùng đã chấp nhận ưu đãi hay chưa

Get Order (Lấy đơn đặt hàng) nếu bạn biết mã đơn đặt hàng tương ứng. Kiểm tra trường trạng thái.
Nếu không theo dõi được mã đơ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, rồi Lấy đơn đặt hàng. Kiểm tra trường trạng thái.

Xem người dùng đã định cấu hình ưu đãi hay chưa(Chỉ dành cho PG)

Nhận nguồn khoảng không quảng cáo. Tên là "exchanges/{exchangeId}/inventorysources/{external_deal_id}". Hãy kiểm tra Trạng thái người mua.
1. Ưu đãi đặt chỗ
  1. BUYER_STATUS_ACTIVE có nghĩa là bạn đã chấp nhận và thiết lập một giao dịch. Thỏa thuận dự kiến sẽ chi tiêu ở trạng thái này khi DV3 nhận được yêu cầu 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 bước Cấu hình giao dịch. Hãy xem phần Cấu hình giao dịch để biết thêm thông tin chi tiết.
  2. BUYER_STATUS_PENDINGcó nghĩa là Đơn đặt hàng đã được chấp nhận nhưng giao dịch chưa được thiết lập. Bạn sẽ không chi tiêu ở trạng thái này.
  3. BUYER_STATUS_PAUSEDcó nghĩa là Nhà quảng cáo đã tạm dừng một cách rõ ràng. Bạn sẽ không chi tiêu ở trạng thái này.
2. Ưu đãi không cần đặt trước
  1. BUYER_STATUS_ACTIVE có nghĩa là một giao dịch đã được chấp nhận. Giao dịch dự kiến sẽ chi tiêu ở trạng thái này khi DV3 nhận được yêu cầu giá thầu phù hợp với các điều khoản của giao dịch VÀ có một mục hàng Đang hoạt động nhắm đến giao dịch này VÀ yêu cầu giá thầu phù hợp với các 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êm thông tin chi tiết.** KHÔNG có Seller API để truy vấn xem một giao dịch có được nhắm đến bởi các mục hàng hay không. **
  2. BUYER_STATUS_PENDINGkhông áp dụng.
  3. BUYER_STATUS_PAUSEDcó nghĩa là Nhà quảng cáo đã tạm dừng một cách rõ ràng. Bạn sẽ không chi tiêu ở trạng thái này.

Tạm dừng/Tiếp tục ưu đãi sau khi chấp nhận

Cập nhật Trạng thái người bán của Nguồn khoảng không quảng cáo.
1. Việc tạm dừng/tiếp tục không ảnh hưởng đến việc phân phát giao dịch. Khi người bán tạm dừng một thoả thuận, nhà quảng cáo sẽ chỉ thấy một thông báo dạng chuỗi để biết thông tin. Điều này giúp nhà quảng cáo khắc phục sự cố về thoả thuận không chi tiêu.

Thương lượng lại (Cập nhật thoả thuận sau khi chấp nhận)

Đàm phán lại là những nội dung cập nhật đối với một thoả thuận sau khi người mua chấp nhận thoả thuận đó. Điều này có thể rất hữu ích cho cả sàn giao dịch và người mua để đẩy các thay đổi mới đối với những giao dịch đã được chấp nhận. Ví dụ: sàn giao dịch có thể nhận thấy thời gian kết thúc giao dịch của một giao dịch đã được chấp nhận là không chính xác và sàn giao dịch có thể sử dụng sản phẩm Cập nhật của DV3 để gửi thông tin cập nhật cho người mua DV3 nếu giao dịch chưa bắt đầu.

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

Chúng tôi cho phép thay đổi tất cả các trường, ngoại trừ một số trường quan trọng để phân phát như: startTime, endTime, rateDetails, creativeConfig, v.v. Chúng tôi có các quy trình xác thực đối với những trường quan trọng để phân phát này. Nói chung, bạn có thể cập nhật các trường này (ngoại trừ creativeConfig) nếu thời gian bắt đầu của ưu đãi cách thời điểm hiện tại ít nhất 1 ngày. Bạn chỉ được phép cập nhật tăng dần cho các ưu đãi đang diễn ra, trong đó thời gian bắt đầu là trong quá khứ nhưng thời gian kết thúc là trong tương lai. Bạn không được phép thay đổi những thoả thuận đã hoàn tất (thời gian kết thúc đã qua). Ví dụ: bạn không được phép cập nhật rateDetails của một giao dịch đã hoàn tất cách đây một năm. Trong những trường hợp như thế này, sản phẩm Cập nhật DV3 sẽ gặp lỗi xác thực.

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.