Menerima notifikasi tayangan

Anda dapat menerima notifikasi tayangan iklan setiap kali Google mendeteksi bahwa segmen data Anda digunakan dalam bid yang menang dalam lelang Bidding Real-time, dan menghasilkan tayangan iklan. Google merekomendasikan agar Anda berintegrasi dengan notifikasi tayangan iklan untuk mempelajari lebih lanjut cara segmen data Anda digunakan. Hubungi Account Manager Anda untuk mengaktifkan notifikasi tayangan iklan.

Mengonfigurasi endpoint notifikasi tayangan iklan

Anda harus membuat endpoint HTTP dan membagikan URL-nya kepada Google untuk menerima notifikasi tayangan iklan. Anda dapat menyetel URL tempat notifikasi tayangan iklan dikirim dengan salah satu opsi berikut:

  1. Tetapkan URL endpoint notifikasi tayangan untuk setiap info singkat Kurasi Real-time.
    • Anda dapat menetapkan URL yang digunakan untuk notifikasi tayangan iklan secara dinamis untuk setiap info Real-time Curation yang Anda terima dengan mengisi kolom SegmentResponse.burl.
    • Untuk info detail Real-time Curation tertentu, Anda harus menyetel kolom SegmentResponse.burl untuk menerima notifikasi tayangan iklan untuk info detail tersebut. Jika kolom SegmentResponse.burl tidak diisi, tidak ada notifikasi yang akan dikirim untuk info tersebut meskipun kolom SegmentResponse.burl telah disetel di info sebelumnya.
  2. Tetapkan URL endpoint notifikasi tayangan iklan tingkat akun.
    • Anda dapat menetapkan URL endpoint notifikasi tayangan iklan tingkat akun untuk akun Anda dengan menghubungi Account Manager Anda. Cara ini ideal jika URL endpoint Anda jarang berubah.
    • Semua info singkat Kurasi Real-time akan menggunakan URL notifikasi tayangan iklan tingkat akun yang Anda konfigurasi untuk akun Anda, kecuali jika Anda mengganti URL tingkat akun dengan menetapkan kolom SegmentResponse.burl untuk info singkat Kurasi Real-time tertentu.

Mengurai notifikasi tayangan

Informasi yang dikirim dalam notifikasi tayangan iklan bergantung pada konfigurasi URL endpoint notifikasi tayangan iklan Anda. URL endpoint Anda dapat menyertakan parameter kueri dan menggunakan makro untuk menyertakan konteks tambahan tentang cara segmen data Anda digunakan oleh bid yang menang yang menghasilkan tayangan iklan.

Memahami cara perluasan makro

Jika Anda mengonfigurasi URL endpoint agar berisi satu atau beberapa parameter kueri yang ditetapkan ke makro, notifikasi tayangan iklan yang dikirim ke endpoint Anda akan memperluas makro tersebut, mengganti makro dengan nilai yang sesuai.

Misalnya, Anda dapat mengonfigurasi URL endpoint notifikasi tayangan iklan agar terlihat seperti berikut:

https://testendpoint.com/impressions?segmentReqId=${SR_ID}&segmentIds=${SEGMENT_IDS}

Saat menerima notifikasi tayangan iklan, makro akan diganti, sehingga URL akan terlihat seperti berikut:

https://testendpoint.com/impressions?segmentReqId=8Mbl39sMOX5yg1NZgS35ET&segmentIds=test-ds-1|test-ds-2

Mempelajari makro yang didukung

Berikut adalah makro yang dapat Anda sertakan dalam parameter kueri URL endpoint notifikasi tayangan iklan. Makro ini diganti dengan nilai yang terkait dengan bid yang menang yang berkontribusi pada satu atau beberapa segmen data Anda.

Makro Deskripsi
${SR_ID} ID string unik yang setara dengan kolom SegmentRequest.segment_request_id untuk info singkat Kurasi Real-time yang sesuai. Ini merujuk pada permintaan segmen yang Anda respons dengan satu atau beberapa ID segmen data yang berkontribusi pada bid yang menang.
${SEGMENT_IDS} Daftar ID segmen data string yang berkontribusi pada bid pemenang. Setiap item dalam daftar dipisahkan oleh karakter "|". Misalnya, ini dapat diperluas menjadi daftar nilai seperti: "segmentId1|segmentId2|segmentId3" Setiap ID segmen data yang mengisi daftar merujuk ke ID resource dari resource curators.dataSegments yang sesuai di Marketplace API.
${AUCTION_PRICE} String yang mewakili harga kemenangan lelang. Harga adalah biaya satu tayangan iklan (CPI) yang dinyatakan dalam mikro USD. Misalnya, bid Bidding Real-time sebesar $5 USD CPM akan menghasilkan makro ${AUCTION_PRICE} yang diperluas menjadi 5.000 CPI micro-USD dalam notifikasi tayangan iklan Kurasi Real-time.
${DEAL_ID} ID transaksi atau paket yang memenangkan lelang. Ini adalah penawaran atau paket yang menargetkan satu atau beberapa ID segmen data Anda, yang dapat diidentifikasi dengan makro ${SEGMENT_IDS}.
${BUYER_SEAT_ID} ID slot pembeli yang memenangkan tayangan iklan, sebagaimana ditentukan oleh bidder dalam bid yang menang. Misalnya, kursi pembeli dapat berupa agensi atau pengiklan.

Langkah berikutnya