Maaaring ipadala ng Zinn® Ads ang mga event nito sa sarili ninyong mga webhook endpoint, upang ang Zapier, Make o ang sarili ninyong system ay makakilos agad sa sandaling mangyari ang mga ito. Ang mga event ay ads.finding.opened, ads.change.applied, ads.alert.started.
I-set up ito
- Sa dashboard, buksan ang Mga channel ng notification at magdagdag ng webhook endpoint. Dapat itong isang HTTPS address. Gumagawa kami ng signing secret para dito at ipinapakita ito sa inyo nang isang beses.
- I-verify ang endpoint: nagpapadala kami rito ng isang pansubukang kahilingan, at dapat itong sumagot gamit ang isang 2xx na status.
- Buksan ang Zinn® Ads, hanapin ang Mga webhook para sa Zapier, Make at sa sarili ninyong mga system, lagyan ng tsek ang mga event na dapat matanggap ng naturang endpoint at piliin ang I-save ang mga event. Ang Magpadala ng pagsubok ay nagpapadala ng isang halimbawa.
Kung ano ang dumarating
Bawat paghahatid ay isang JSON POST. Kasama nitong dumarating ang mga header na X-Zinn-Event (ang pangalan ng event) at X-Zinn-Delivery (isang id bawat paghahatid: ibasura ang paghahatid na naproseso na ninyo), pati na rin ang X-Zinn-Signature: sha256=<hex>, isang HMAC-SHA256 ng <X-Zinn-Timestamp>.<raw body> na ginawa gamit ang secret ng inyong endpoint. Suriin ang lagda, at tanggihan ang lumang timestamp, bago ninyo pagkatiwalaan ang body. Ang hugis ng bawat event ay nakalathala sa aming spec ng OpenAPI sa ilalim ng webhooks.
Kapag down ang inyong endpoint
Ang isang nabigong paghahatid ay sinusubukang muli nang 5 pang beses, pagkalipas ng 1, 5, 25, 125, 625 minuto, at bawat pagsubok ay nakatala sa log ng paghahatid ng endpoint. Walang ipinapadala sa isang endpoint na hindi pa nabe-verify, at ang walang lamang hanay ng mga event ay nagpapatay sa Zinn® Ads para sa endpoint na iyon.
Gabay na hakbang-hakbang
Ang Kontrolin ang Zinn® Ads mula sa MCP at mga AI assistant sa zinnads.com ay nagpapaliwanag nito nang sunod-sunod gamit ang mga screenshot ng mga totoong screen. Bawat gabay sa Zinn® Ads: zinnads.com/kb.