Alur Kerja API

Membuat Kesepakatan

1. Lihat apakah produk telah dibuat oleh produk LIST dengan filter external_deal_id. External_deal_id harus unik di semua produk.

   GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*/orders/*}/products?filter=externalDealId="{external_deal_id}"
   

2. Buat Pesanan. Nama dibuat oleh DV3, dan sebaiknya simpan ID ini di suatu tempat dalam sistem Anda untuk pengambilan di masa mendatang.

3. Buat Produk dalam Pesanan. Nama produk dibuat oleh DV3, dan sebaiknya simpan ID ini di suatu tempat dalam sistem Anda untuk pengambilan di masa mendatang.

   Atau, Anda selalu dapat melakukan LIST dengan external_deal_id. Kolom nama berisi ID Pesanan dan ID Produk, sehingga Anda dapat dengan mudah mengidentifikasi induk dengan cara ini.

Membatalkan Promo

1. Perbarui status Pesanan menjadi Dibatalkan Hanya Mendukung Pembatalan jika pesanan belum disetujui. Dibatalkan adalah status akhir. Tidak dapat mengaktifkan kembali Pesanan setelah dibatalkan.

Mendapatkan detail Penawaran

1. Mendapatkan detail pesanan. Status akan diperbarui setelah pengguna Menerima, Mengarsipkan, atau Membatalkan Pesanan.
2. Mendapatkan detail Produk.

Mendapatkan daftar Penawaran

1. Pesanan LIST dengan filter status untuk mendapatkan semua pesanan yang disetujui/menunggu persetujuan.
2. Produk LIST dengan filter external_deal_id.
3. LIST semua produk dalam Pesanan.

Memperbarui promo

1. Perbarui Pesanan untuk informasi kontak Penerbit.
   1. name, tidak mengizinkan pembaruan(tidak dapat ditetapkan di field_mask). Status hanya dapat disetel ke Dibatalkan melalui API.
   2. partner_id tidak mengizinkan pembaruan.
2. Perbarui Produk untuk pembaruan persyaratan promo tertentu.
   1. name, externalDealId, transactionType, pricingType, updateTime tidak dapat diperbarui.
   2. Update displayName tidak memerlukan persetujuan pengguna.
   3. Update rateDetails, creativeConfig akan mengubah status Induk pesanan menjadi Menunggu Persetujuan. Pengiklan DV3 akan diminta untuk menyetujui persyaratan baru di halaman negosiasi, terlepas dari apakah Pesanan sebelumnya diterima atau tidak.

Melihat apakah pengguna telah menerima promo

1. Get Order jika Anda mengetahui ID pesanan yang sesuai. Periksa kolom status.
2. Jika ID pesanan tidak dilacak: List Products with external_deal_id filter, figure out order name from product name, lalu Get Order. Periksa kolom status.

Melihat apakah pengguna telah mengonfigurasi penawaran(Khusus PG)

1. Dapatkan Sumber Inventaris. Nama ini adalah 'exchanges/{exchangeId}/inventorysources/{external_deal_id}’. Periksa Status Pembeli.
   1. Promo reservasi
      1. BUYER_STATUS_ACTIVE berarti transaksi telah disetujui & dikonfigurasi. Transaksi diperkirakan akan berbelanja dalam status ini saat DV360 menerima permintaan bid yang cocok dengan persyaratan transaksi. Item baris dibuat secara otomatis selama langkah Konfigurasi Kesepakatan. Lihat Konfigurasi Promo untuk mengetahui detail selengkapnya.
      2. BUYER_STATUS_PENDINGberarti Pesanan telah diterima, tetapi transaksi belum dikonfigurasi. Tidak ada pembelanjaan yang akan terjadi dalam status ini.
      3. BUYER_STATUS_PAUSEDberarti Kesepakatan telah dijeda secara eksplisit oleh pengiklan. Tidak ada pembelanjaan yang akan terjadi dalam status ini.
   2. Penawaran Tanpa Reservasi
      1. BUYER_STATUS_ACTIVE berarti kesepakatan telah disetujui. Transaksi diharapkan berbelanja dalam status ini saat DV3 menerima permintaan bid yang cocok dengan persyaratan transaksi DAN ada item baris Aktif yang menargetkan transaksi ini DAN permintaan bid cocok dengan kriteria penargetan item baris. Lihat item baris untuk mengetahui detail selengkapnya.** TIDAK ADA Seller API untuk mengkueri apakah transaksi telah ditargetkan oleh item baris. **
      2. BUYER_STATUS_PENDINGtidak berlaku.
      3. BUYER_STATUS_PAUSEDberarti bahwa Kesepakatan telah dijeda secara eksplisit oleh pengiklan. Tidak ada pembelanjaan yang akan terjadi dalam status ini.

Menjeda/Melanjutkan transaksi setelah penawaran diterima

1. Perbarui Sumber Inventaris Status Penjual.
   1. Menjeda/melanjutkan tidak memengaruhi penayangan kesepakatan. Penjual yang menjeda kesepakatan hanya menampilkan pesan string kepada pengiklan sebagai info. Hal ini membantu pengiklan memecahkan masalah transaksi yang tidak berbelanja.

Negosiasi ulang (Perbarui kesepakatan setelah disetujui)

Negosiasi ulang mengacu pada pembaruan yang dilakukan pada kesepakatan setelah disetujui oleh pembeli. Hal ini dapat sangat berguna bagi bursa dan pembeli untuk mendorong perubahan baru pada kesepakatan yang disetujui. Misalnya, Exchange mungkin menemukan bahwa waktu berakhir kesepakatan untuk kesepakatan yang diterima tidak benar dan Exchange dapat menggunakan produk Update DV3 untuk mengirimkan pembaruan kepada pembeli DV3 jika kesepakatan belum dimulai.

Perubahan yang diizinkan dan tidak diizinkan.

Kami mengizinkan perubahan pada semua kolom, kecuali beberapa kolom penting penayangan seperti: startTime, endTime, rateDetails, creativeConfig, dan sebagainya. Kami memiliki validasi di sekitar kolom penting penayangan ini. Secara umum, pembaruan pada kolom ini, kecuali creativeConfig, diizinkan jika waktu mulai promo setidaknya 1 hari lebih lambat di masa mendatang. Hanya update inkremental yang diizinkan untuk penawaran yang sedang berlangsung, yang waktu mulainya sudah lewat, tetapi waktu berakhirnya masih di masa mendatang. Tidak ada perubahan yang diizinkan untuk transaksi yang telah selesai, yang waktu berakhirnya sudah lewat. Misalnya, memperbarui rateDetails kesepakatan yang diselesaikan setahun yang lalu tidak diizinkan. Dalam kasus seperti ini, Perbarui Produk DV3 akan menampilkan error validasi.