Kirim aktivitas Zinn® Ads ke Zapier, Make, dan sistem Anda sendiri

Zinn® Ads dapat mengirimkan peristiwanya ke endpoint webhook Anda sendiri, sehingga Zapier, Make, atau sistem Anda sendiri dapat menindaklanjutinya saat peristiwa tersebut terjadi. Peristiwa tersebut adalah ads.finding.opened, ads.change.applied, ads.alert.started.

Siapkan

1. Di dasbor, buka Saluran notifikasi dan tambahkan endpoint webhook. Endpoint tersebut harus berupa alamat HTTPS. Kami membuat rahasia penandatanganan untuknya dan menampilkannya kepada Anda satu kali saja.
2. Verifikasi endpoint: kami mengirimkan satu permintaan uji coba, dan endpoint tersebut harus merespons dengan status 2xx.
3. Buka Zinn® Ads, temukan Webhook untuk Zapier, Make, dan sistem Anda sendiri, centang peristiwa yang harus diterima endpoint tersebut, lalu pilih Simpan peristiwa. Kirim pengujian akan mengirimkan satu contoh.

Apa yang diterima

Setiap pengiriman adalah JSON POST. Header X-Zinn-Event (nama peristiwa) dan X-Zinn-Delivery (satu id per pengiriman: abaikan pengiriman yang sudah Anda tangani) disertakan bersamanya, begitu juga dengan X-Zinn-Signature: sha256=<hex>, sebuah HMAC-SHA256 dari <X-Zinn-Timestamp>.<raw body> yang dibuat dengan rahasia endpoint Anda. Periksa tanda tangan, dan tolak tanda waktu yang sudah lama, sebelum Anda memercayai isi pesan. Bentuk dari setiap peristiwa dipublikasikan dalam spesifikasi OpenAPI kami di bawah webhooks.

Ketika endpoint Anda tidak aktif

Pengiriman yang gagal dicoba kembali sebanyak 5 kali lagi, setelah 1, 5, 25, 125, 625 menit, dan setiap percobaan dicatat dalam log pengiriman endpoint. Tidak ada yang dikirimkan ke endpoint yang belum diverifikasi, dan kumpulan peristiwa yang kosong akan menonaktifkan Zinn® Ads untuk endpoint tersebut.

Panduan langkah demi langkah

Kendalikan Zinn® Ads dari MCP dan asisten AI di zinnads.com memandu proses tersebut dengan tangkapan layar tampilan asli. Semua panduan Zinn® Ads: zinnads.com/kb.