Надсилайте події Zinn® Ads до Zapier, Make та власних систем

Zinn® Ads може надсилати свої події на ваші власні кінцеві точки вебхуків, щоб Zapier, Make або ваша власна система могли реагувати на них у момент їх виникнення. Події: ads.finding.opened, ads.change.applied, ads.alert.started.

Налаштування

1. На інформаційній панелі відкрийте Канали сповіщень і додайте кінцеву точку вебхука. Це має бути адреса HTTPS. Ми створимо для неї секретний ключ підпису та покажемо його вам один раз.
2. Підтвердьте кінцеву точку: ми надішлемо на неї один тестовий запит, і вона має відповісти зі статусом 2xx.
3. Відкрийте Zinn® Ads, знайдіть Вебхуки для Zapier, Make та ваших власних систем, позначте події, які має отримувати ця кінцева точка, і виберіть Зберегти події. Кнопка Надіслати тест надсилає один приклад.

Що надходить

Кожна доставка — це запит JSON POST. Разом із нею надходять заголовки X-Zinn-Event (назва події) та X-Zinn-Delivery (один ідентифікатор на доставку: відхиляйте доставку, яку ви вже обробили), а також X-Zinn-Signature: sha256=<hex>, тобто HMAC-SHA256 від <X-Zinn-Timestamp>.<raw body>, створений за допомогою секретного ключа вашої кінцевої точки. Перш ніж довіряти тілу запиту, перевірте підпис і відхиліть застарілу мітку часу. Формат кожної події опубліковано в нашій специфікації OpenAPI у розділі webhooks.

Якщо ваша кінцева точка недоступна

Невдала доставка повторюється ще 5 разів через 1, 5, 25, 125, 625 хвилин, і кожна спроба відображається в журналі доставок кінцевої точки. На непідтверджену кінцеву точку нічого не надсилається, а порожній набір подій вимикає Zinn® Ads для цієї кінцевої точки.

Покрокова інструкція

Стаття Керування Zinn® Ads за допомогою MCP та помічників ШІ на сайті zinnads.com детально описує процес зі знімками реальних екранів. Усі інструкції Zinn® Ads: zinnads.com/kb.