API Thị trường

Tổng quan

API Authorized Buyers Marketplace là tập hợp các tài nguyên mà người mua có thể sử dụng để quản lý các mục sau theo phương thức lập trình:

  • Thương lượng với nhà xuất bản
  • Gói đấu giá
  • Quyền truy cập của khách hàng vào giao diện người dùng Marketplace của Authorized Buyers

Hướng dẫn này giới thiệu về API Marketplace và giải thích cách các tài nguyên API Marketplace liên kết với các tính năng của Marketplace trong giao diện người dùng của Authorized Buyers.

Bên đặt giá thầu và người mua

API Marketplace nhất quán với cấu trúc của API Đặt giá thầu theo thời gian thực. Cả hai API đều sử dụng bidders và buyers làm tài nguyên cấp cơ sở cho các hoạt động của bên đặt giá thầu và người mua. Bạn có thể sử dụng cùng tên người đặt giá thầu và người mua trong đường dẫn tài nguyên cho API Đặt giá thầu theo thời gian thực và API Thị trường.

Khách hàng và người dùng khách hàng

Bạn có thể sử dụng API Marketplace để tạo và quản lý khách hàng và người dùng của khách hàng, cũng như để cấp cho các công ty quảng cáo hoặc nhà quảng cáo quyền truy cập vào thẻ Trang web thương mại theo phương thức lập trình trong giao diện người dùng của Authorized Buyers.

Client đại diện cho khách hàng, công ty quảng cáo hoặc nhà quảng cáo liên kết với tài khoản Người mua được uỷ quyền của bạn.

ClientUser đại diện cho một cá nhân cụ thể có quyền truy cập vào giao diện người dùng trong một Client. Người dùng khách hàng không thể truy cập vào API Marketplace. Người dùng là khách hàng bị hạn chế quyền truy cập vào thẻ Trang web thương mại trong tài khoản của bạn. Quyền của người dùng ứng dụng được xác định bởi role được chỉ định trong Client mẹ.

Các tài nguyên khác trong API Marketplace tham chiếu đến ứng dụng theo tên được chỉ định trong tài nguyên Clients.

Để tìm hiểu thêm về khách hàng và người dùng của khách hàng trong giao diện người dùng Marketplace của Authorized Buyers, hãy xem các bài viết sau trong Trung tâm trợ giúp:

Chuyên viên hoạch định truyền thông

Chuyên viên lập kế hoạch truyền thông là một công ty quảng cáo hoặc pháp nhân khác thương lượng độc lập các giao dịch với nhà xuất bản và cho phép một hoặc nhiều bên đặt giá thầu đặt giá thầu thay mặt cho giao dịch đã chốt của họ. Các giao dịch này có thể là phiên đấu giá kín hoặc giao dịch ưu tiên và bạn sẽ không thể xem hoặc tương tác với các giao dịch đó cho đến khi các giao dịch đó hoàn tất. Sau đó, các giao dịch đó sẽ xuất hiện trong phản hồi bidders.finalizedDeals.list.

Để xác định xem một nhà lập kế hoạch truyền thông có thương lượng một thoả thuận đã chốt hay không, bạn có thể kiểm tra xem trường mediaPlanner của giao dịch đó đã được điền hay chưa. Các nhà lập kế hoạch truyền thông sẽ lập một danh sách mã chỗ ngồi dành riêng cho DSP đủ điều kiện để giao dịch theo thoả thuận. Bạn có thể xem danh sách này bằng trường eligibleSeatIds. Trong yêu cầu giá thầu Đặt giá thầu theo thời gian thực, các mã giấy phép này có thể xuất hiện trong danh sách cho phép hoặc danh sách chặn do nhà xuất bản đặt. Việc này giúp xác định xem giá thầu có bị lọc khỏi phiên đấu giá hay không. Chúng có thể xuất hiện trong các trường BidRequest sau:

  • giao thức OpenRTB
    • BidRequest.wseat
    • BidRequest.bseat
    • BidRequest.imp.pmp.deals.wseat
  • Giao thức RTB của Google
    • BidRequest.adslot.allowed_seat_ids
    • BidRequest.adslot.blocked_seat_ids
    • BidRequest.adslot.matching_ad_data.direct_deal.allowed_seat_ids

Gói đấu giá

Bạn có thể sử dụng API Marketplace để đăng ký và huỷ đăng ký cho người mua và khách hàng khỏi các gói đấu giá, cũng như để xem các gói đấu giá mà bạn đã đăng ký.

AuctionPackage tương tự như một gói tiêu chí nhắm mục tiêu cho khoảng không quảng cáo trên trang web thương mại. Ví dụ: một gói đấu giá có thể nhắm đến một tập hợp URL và mã ứng dụng dành cho thiết bị di động liên quan đến mối quan tâm kinh doanh của người mua.

Bạn không thể tạo gói đấu giá mới bằng API Thị trường. Bạn có thể sử dụng giao diện người dùng Marketplace của Authorized Buyers để tạo gói đấu giá. API Marketplace không bao gồm thông tin nhắm mục tiêu cụ thể liên kết với các gói đấu giá.

Bạn có thể chia sẻ gói đấu giá với những người mua và khách hàng khác, đồng thời có thể chia sẻ các gói đấu giá do Google hoặc những người mua khác tạo với bạn.

Xem Gói đấu giá để biết thêm thông tin.

Hồ sơ nhà xuất bản

Bạn có thể sử dụng API Marketplace để xem hồ sơ của các nhà xuất bản mà bạn có thể thương lượng.

PublisherProfile đại diện cho một nhà xuất bản trong API Marketplace. Các tài nguyên khác trong Marketplace API tham chiếu đến nhà xuất bản có tên được chỉ định trong PublisherProfile của họ.

Hồ sơ nhà xuất bản có thông tin tương tự như Nhà xuất bản trong thẻ Khám phá trên giao diện người dùng Marketplace của Authorized Buyers.

Xem Cách khám phá nhà xuất bản để biết thêm thông tin.

Đề xuất và giao dịch

Bạn có thể sử dụng API Thị trường để thương lượng giao dịch với nhà xuất bản. Dưới đây là một số cách bạn có thể sử dụng API Marketplace để quản lý giao dịch:

Đề xuất thể hiện trạng thái thương lượng mới nhất của một hoặc nhiều giao dịch giữa người mua hoặc khách hàng và nhà xuất bản, đồng thời cũng tương tự như thẻ Thương lượng trên giao diện người dùng của Authorized Buyers.

Giao dịch thể hiện các điều khoản mới nhất của một giao dịch đang được thương lượng theo một đề xuất nhất định và tương đương với danh sách các giao dịch được gắn nhãn QUY ĐỊNH HIỆN TẠI trên giao diện người dùng Authorized Buyers cho một đề xuất nhất định.

Giao dịch đã chốt đại diện cho những giao dịch đã hoàn tất giai đoạn thương lượng và sẵn sàng phân phát. Điều này bao gồm các giao dịch đang phân phát. Giao dịch đã chốt tương tự như thẻ Giao dịch trên giao diện người dùng của Authorized Buyers Marketplace.

Tuỳ thuộc vào loại giao dịch mà bạn đang thương lượng, hành vi có thể khác nhau giữa các tài nguyên API Marketplace. Ví dụ: người mua không thể bắt đầu thương lượng cho tất cả các loại giao dịch. Để tìm hiểu thêm về cách triển khai API Marketplace cho quy trình thương lượng, hãy xem các tài nguyên sau:

Để tìm hiểu thêm về quá trình thương lượng trong giao diện người dùng Thị trường của Authorized Buyers, hãy xem các mục sau: