API Marketplace

Ringkasan

Authorized Buyers Marketplace API adalah kumpulan resource yang dapat digunakan pembeli untuk mengelola hal berikut secara terprogram:

  • Negosiasi dengan penayang
  • Paket lelang
  • Akses klien ke UI Marketplace Authorized Buyers

Panduan ini memperkenalkan Marketplace API dan menjelaskan cara resource Marketplace API dipetakan ke fitur Marketplace di UI Authorized Buyers.

Bidder dan pembeli

Marketplace API konsisten dengan struktur API Bidding Real-time. Kedua API menggunakan bidders dan buyers sebagai resource level root untuk operasi bidder dan pembeli. Anda dapat menggunakan nama bidder dan pembeli yang sama di jalur resource untuk API Bidding Real-time dan Marketplace.

Klien dan pengguna klien

Anda dapat menggunakan Marketplace API untuk membuat serta mengelola klien dan pengguna klien, serta untuk memberi agensi atau pengiklan akses ke tab Marketplace Anda secara terprogram di UI Authorized Buyers.

Client mewakili klien, agensi, atau pengiklan yang terkait dengan akun Authorized Buyer Anda.

ClientUser mewakili individu tertentu yang memiliki akses UI di Client. Pengguna klien tidak dapat mengakses Marketplace API. Pengguna klien memiliki akses terbatas ke tab Marketplace akun Anda. Izin pengguna klien ditentukan oleh role yang ditentukan di Client induknya.

Resource lain di Marketplace API merujuk ke klien berdasarkan nama yang ditentukan dalam resource Clients.

Untuk mempelajari klien dan pengguna klien lebih lanjut di UI Marketplace Authorized Buyers, lihat artikel Pusat Bantuan berikut:

Perencana Media

Media planner adalah agensi atau entitas lain yang menegosiasikan transaksi secara independen dengan penayang, dan mengizinkan satu atau beberapa bidder mengajukan bid atas transaksi akhir mereka. Transaksi ini merupakan lelang pribadi atau transaksi pilihan, dan Anda tidak akan dapat melihat atau berinteraksi dengan transaksi tersebut sampai transaksi diselesaikan–setelah itu, transaksi akan muncul di respons bidders.finalizedDeals.list.

Untuk menentukan apakah transaksi akhir tertentu dinegosiasikan oleh media planner, Anda dapat memeriksa apakah kolom mediaPlanner transaksi telah diisi. Media planner menetapkan daftar ID slot khusus DSP yang memenuhi syarat untuk bertransaksi pada transaksi, yang dapat dilihat dengan kolom eligibleSeatIds. Dalam permintaan bid Bidding Real-Time, ID slot ini dapat muncul di daftar yang diizinkan atau tidak diizinkan yang ditetapkan oleh penayang, yang akan menentukan apakah bid difilter dari lelang. Kolom tersebut dapat muncul di kolom BidRequest berikut:

  • Protokol OpenRTB
    • BidRequest.wseat
    • BidRequest.bseat
    • BidRequest.imp.pmp.deals.wseat
  • Protokol Google RTB
    • BidRequest.adslot.allowed_seat_ids
    • BidRequest.adslot.blocked_seat_ids
    • BidRequest.adslot.matching_ad_data.direct_deal.allowed_seat_ids

Paket lelang

Anda dapat menggunakan Marketplace API untuk membuat pembeli dan klien berlangganan dan berhenti berlangganan dari paket lelang, serta untuk melihat paket lelang langganan Anda.

AuctionPackage mirip dengan paket penargetan untuk inventaris Marketplace. Misalnya, paket lelang dapat menargetkan kumpulan URL dan ID aplikasi seluler yang relevan dengan kepentingan bisnis pembeli.

Anda tidak dapat membuat paket lelang baru dengan Marketplace API. Anda dapat menggunakan UI Marketplace Authorized Buyers untuk membuat paket lelang. Marketplace API tidak menyertakan informasi penargetan spesifik yang terkait dengan paket lelang.

Anda dapat berbagi paket lelang dengan pembeli dan klien lain, serta dapat membagikan paket lelang yang dibuat oleh Google atau pembeli lain kepada Anda.

Lihat Paket lelang untuk mengetahui informasi selengkapnya.

Profil penayang

Anda dapat menggunakan Marketplace API untuk melihat profil bagi penayang yang dapat bernegosiasi dengan Anda.

PublisherProfile mewakili penayang di Marketplace API. Referensi lain di Marketplace API merujuk pada penayang dengan nama yang ditentukan di PublisherProfile mereka.

Profil penayang memiliki informasi yang serupa dengan Penayang di tab Discovery di UI Marketplace Authorized Buyers.

Lihat Cara menemukan penayang untuk mengetahui informasi selengkapnya.

Proposal dan transaksi

Anda dapat menggunakan Marketplace API untuk menegosiasikan transaksi dengan penayang. Berikut beberapa cara penggunaan Marketplace API untuk mengelola transaksi:

Proposal mewakili status negosiasi terbaru dari satu atau beberapa transaksi antara pembeli atau klien dan penayang, dan serupa dengan tab Negosiasi di UI Authorized Buyers Marketplace.

Transaksi mewakili persyaratan transaksi terbaru yang sedang dinegosiasikan berdasarkan proposal tertentu, dan sebanding dengan daftar transaksi di UI Authorized Buyers Marketplace yang berlabel NEGOTIASI saat ini untuk proposal tertentu.

Transaksi akhir mewakili transaksi yang telah menyelesaikan fase negosiasi dan siap ditayangkan. Hal ini termasuk promo yang sudah ditayangkan. Transaksi final serupa dengan tab Transaksi di UI Authorized Buyers Marketplace.

Bergantung pada jenis transaksi yang sedang Anda negosiasikan, perilaku setiap resource Marketplace API mungkin berbeda. Misalnya, pembeli tidak dapat memulai negosiasi untuk semua jenis transaksi. Untuk mempelajari lebih lanjut implementasi Marketplace API untuk negosiasi, lihat referensi berikut:

Untuk mempelajari lebih lanjut negosiasi di UI Marketplace Authorized Buyers, lihat hal berikut: