Invia gli eventi di Zinn® Ads a Zapier, Make e ai Suoi sistemi

Zinn® Ads può inviare i propri eventi ai Suoi endpoint webhook personali, consentendo a Zapier, Make o al Suo sistema di intervenire non appena si verificano. Gli eventi sono ads.finding.opened, ads.change.applied, ads.alert.started.

Configurazione

1. Nel pannello di controllo apra Canali di notifica e aggiunga un endpoint webhook. Deve essere un indirizzo HTTPS. Creiamo un segreto di firma dedicato e Glielo mostriamo una sola volta.
2. Verifichi l'endpoint: inviamo una richiesta di prova, alla quale deve rispondere con uno stato 2xx.
3. Apra Zinn® Ads, individui Webhook per Zapier, Make e i propri sistemi, selezioni gli eventi che tale endpoint deve ricevere e scelga Salva eventi. Invia un test invia un esempio.

Cosa viene recapitato

Ogni invio è una richiesta POST JSON. Le intestazioni X-Zinn-Event (il nome dell'evento) e X-Zinn-Delivery (un ID per ciascun invio: scarti un invio già gestito) sono incluse, così come X-Zinn-Signature: sha256=<hex>, un HMAC-SHA256 di <X-Zinn-Timestamp>.<raw body> generato con il segreto del Suo endpoint. Verifichi la firma e rifiuti una marcatura temporale obsoleta prima di ritenere attendibile il corpo del messaggio. La struttura di ciascun evento è pubblicata nella nostra specifica OpenAPI alla voce webhooks.

Quando l'endpoint non è raggiungibile

In caso di mancato recapito vengono effettuati altri 5 tentativi, dopo 1, 5, 25, 125, 625 minuti, e ciascun tentativo è registrato nel registro degli invii dell'endpoint. Nulla viene inviato a un endpoint non verificato, e un insieme vuoto di eventi disattiva Zinn® Ads per quell'endpoint.

Guida dettagliata

Controllare Zinn® Ads da MCP e assistenti IA su zinnads.com illustra la procedura passo dopo passo con schermate reali. Tutte le guide di Zinn® Ads: zinnads.com/kb.