Alur Kerja API

Panduan ini menjelaskan alur kerja API umum untuk membuat, membatalkan, mengambil, memperbarui, dan menegosiasikan transaksi menggunakan Deal Sync API.

Membuat Transaksi

  1. Periksa apakah produk telah dibuat dengan memanggil LIST produk menggunakan filter externalDealId. Perhatikan bahwa externalDealId camelCase dan external_deal_id snake_case didukung dalam string filter. 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 Pesanan dibuat oleh DV360, dan sebaiknya simpan ID ini di sistem Anda untuk pengambilan di masa mendatang.

  3. Buat Produk di bagian Pesanan. Nama Produk dibuat oleh DV360, dan sebaiknya simpan ID ini di sistem Anda untuk pengambilan di masa mendatang.

Atau, Anda dapat memanggil LIST dengan external_deal_id. Nama resource berisi ID Pesanan dan ID Produk, sehingga Anda dapat mengidentifikasi Pesanan induk.

Membatalkan Transaksi

  1. Perbarui status Pesanan menjadi DIBATALKAN. Pembatalan hanya didukung jika pesanan belum diterima. Dibatalkan adalah status akhir; Pesanan tidak dapat diaktifkan kembali setelah dibatalkan. Jika Pesanan berisi produk, external_deal_id-nya tidak dapat digunakan kembali.

Mendapatkan detail Transaksi

  1. Dapatkan detail Pesanan. Status akan diperbarui setelah pengguna menerima, mengarsipkan, atau membatalkan Pesanan.
  2. Dapatkan detail Produk.

Mendapatkan daftar Transaksi

  1. LIST pesanan dengan filter status untuk mendapatkan semua pesanan yang diterima atau menunggu penerimaan pesanan.
  2. LIST produk dengan filter external_deal_id.
  3. LIST semua produk dalam Pesanan.

Memperbarui transaksi

  1. Perbarui Pesanan untuk informasi kontak penayang.
    1. name tidak dapat diperbarui (tidak dapat ditetapkan di updateMask). Status hanya dapat ditetapkan ke CANCELED menggunakan API.
    2. partner_id tidak dapat diperbarui.
  2. Perbarui Produk untuk pembaruan persyaratan transaksi tertentu.
    1. name, externalDealId, transactionType, pricingType, dan updateTime tidak dapat diperbarui.
    2. Memperbarui displayName tidak memerlukan penerimaan ulang pengguna.
    3. Memperbarui rateDetails atau creativeConfig akan mengubah status Pesanan induk menjadi PENDING_ACCEPTANCE. Pengiklan DV360 akan diminta untuk menyetujui persyaratan baru di halaman Negosiasi, terlepas dari apakah Pesanan sebelumnya telah diterima atau belum.

Memeriksa apakah pengguna telah menerima transaksi

  1. Dapatkan Pesanan jika Anda mengetahui Nama Pesanan yang sesuai. Periksa kolom status.
  2. Jika Nama Pesanan tidak dilacak: Cantumkan Produk dengan filter external_deal_id, identifikasi Nama Pesanan dari Nama Produk, lalu panggil Dapatkan Pesanan. Periksa kolom status.

Memeriksa apakah pengguna telah mengonfigurasi transaksi (hanya Dijamin Terprogram)

  1. Dapatkan Inventaris Sumber. Nama resource adalah exchanges/{exchangeId}/inventorysources/{external_deal_id}. Periksa Status Pembeli.
    1. Transaksi reservasi:
      1. BUYER_STATUS_ACTIVE: Transaksi telah diterima dan dikonfigurasi. Transaksi akan mulai berbelanja saat DV360 menerima permintaan bid yang sesuai dengan persyaratan transaksi. Item baris dibuat secara otomatis selama konfigurasi transaksi. Lihat Konfigurasi Transaksi untuk mengetahui detailnya.
      2. BUYER_STATUS_PENDING: Pesanan telah diterima, tetapi transaksi belum dikonfigurasi. Tidak ada pembelanjaan yang terjadi dalam status ini.
      3. BUYER_STATUS_PAUSED: Transaksi telah dijeda oleh pengiklan. Tidak ada pembelanjaan yang terjadi dalam status ini.
    2. Transaksi non-reservasi:
      1. BUYER_STATUS_ACTIVE: Transaksi telah diterima. Transaksi akan mulai berbelanja saat DV360 menerima permintaan bid yang cocok, item baris aktif menargetkan transaksi, dan permintaan bid cocok dengan kriteria penargetan item baris. Lihat Item Baris untuk mengetahui detailnya. (Catatan: Tidak ada Seller API untuk mengkueri apakah transaksi ditargetkan oleh item baris).
      2. BUYER_STATUS_PENDING: Tidak berlaku untuk transaksi non-reservasi.
      3. BUYER_STATUS_PAUSED: Transaksi telah dijeda secara eksplisit oleh pengiklan. Tidak ada pembelanjaan yang terjadi dalam status ini.

Menjeda dan melanjutkan transaksi setelah diterima

  1. Perbarui Status Penjual Sumber Inventaris.
    1. Menjeda atau melanjutkan tidak akan menghentikan penayangan transaksi. Penjual yang menjeda transaksi akan menampilkan pesan informasi kepada pengiklan di UI DV360 untuk membantu memecahkan masalah transaksi yang tidak berbelanja.

Negosiasi ulang (memperbarui transaksi setelah diterima)

Negosiasi ulang mengacu pada pembaruan yang dilakukan pada transaksi setelah diterima oleh pembeli. Hal ini memungkinkan platform dan pembeli menyesuaikan persyaratan pada transaksi yang ada. Misalnya, platform mungkin menemukan bahwa waktu akhir penayangan untuk transaksi yang diterima salah; platform dapat menggunakan Patch Produk untuk mendorong pembaruan ke pembeli DV360 sebelum transaksi mulai ditayangkan.

Perubahan yang diizinkan dan tidak diizinkan

Lihat artikel Pusat Bantuan Display &Video 360 untuk mengetahui perincian lengkap tentang negosiasi transaksi dan aturan negosiasi ulang:

Sebelumnya
Struktur Entitas
Berikutnya
Proses Beta