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:
- Kirim proposal baru.
- Bernegosiasi dengan penayang.
- Menyelesaikan transaksi.
- Menayangkan transaksi yang sudah selesai.
- Memulai negosiasi ulang transaksi yang diselesaikan.
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: