Zinn® Ads peut envoyer ses événements à vos propres points de terminaison webhook, afin que Zapier, Make ou votre propre système puissent réagir dès qu’ils se produisent. Les événements sont ads.finding.opened, ads.change.applied, ads.alert.started.
Configuration
- Dans le tableau de bord, ouvrez Canaux de notification et ajoutez un point de terminaison webhook. Il doit s’agir d’une adresse HTTPS. Nous créons un secret de signature pour celui-ci et vous l’affichons une seule fois.
- Vérifiez le point de terminaison : nous lui envoyons une requête de test, et il doit répondre avec un statut 2xx.
- Ouvrez Zinn® Ads, trouvez Webhooks pour Zapier, Make et vos propres systèmes, cochez les événements que ce point de terminaison doit recevoir et choisissez Enregistrer les événements. Envoyer un test envoie un exemple.
Ce qui est reçu
Chaque distribution est un POST JSON. Les en-têtes X-Zinn-Event (le nom de l’événement) et X-Zinn-Delivery (un identifiant par distribution : ignorez une distribution que vous avez déjà traitée) sont inclus, tout comme X-Zinn-Signature: sha256=<hex>, un HMAC-SHA256 de <X-Zinn-Timestamp>.<raw body> généré avec le secret de votre point de terminaison. Vérifiez la signature et rejetez un horodatage ancien avant de faire confiance au corps. La structure de chaque événement est publiée dans notre spécification OpenAPI sous webhooks.
Lorsque votre point de terminaison est indisponible
Une distribution ayant échoué fait l’objet de 5 nouvelles tentatives, après 1, 5, 25, 125, 625 minutes, et chaque tentative est répertoriée dans le journal de distribution du point de terminaison. Rien n’est envoyé à un point de terminaison qui n’est pas vérifié, et un ensemble vide d’événements désactive Zinn® Ads pour ce point de terminaison.
Guide étape par étape
Contrôler Zinn® Ads depuis MCP et les assistants IA sur zinnads.com détaille la procédure avec des captures d’écran des interfaces réelles. Tous les guides Zinn® Ads : zinnads.com/kb.