Odesílejte události Zinn® Ads do služeb Zapier, Make a vlastních systémů

Zinn® Ads může odesílat své události do vašich vlastních koncových bodů webhooků, takže na ně Zapier, Make nebo váš vlastní systém mohou reagovat v okamžiku, kdy nastanou. Jedná se o události ads.finding.opened, ads.change.applied, ads.alert.started.

Nastavení

1. V ovládacím panelu otevřete Kanály oznámení a přidejte koncový bod webhooku. Musí jít o adresu HTTPS. Vytvoříme pro něj podpisový tajný klíč a jednou vám jej zobrazíme.
2. Ověřte koncový bod: odešleme mu jeden testovací požadavek a ten musí odpovědět stavem 2xx.
3. Otevřete Zinn® Ads, vyhledejte Webhooky pro Zapier, Make a vaše vlastní systémy, zaškrtněte události, které má tento koncový bod přijímat, a zvolte Uložit události. Možnost Odeslat test odešle jeden ukázkový příklad.

Co přichází

Každé doručení je typu JSON POST. Součástí jsou záhlaví X-Zinn-Event (název události) a X-Zinn-Delivery (jedno ID na doručení: doručení, které jste již zpracovali, zahoďte), a také X-Zinn-Signature: sha256=<hex>, což je HMAC-SHA256 řetězce <X-Zinn-Timestamp>.<raw body> vytvořený pomocí tajného klíče vašeho koncového bodu. Než tělu zprávy začnete důvěřovat, zkontrolujte podpis a odmítněte staré časové razítko. Struktura jednotlivých událostí je publikována v naší specifikaci OpenAPI v sekci webhooks.

Když je váš koncový bod nedostupný

O neúspěšné doručení se pokusíme ještě 5krát, a to po 1, 5, 25, 125, 625 minutách, přičemž každý pokus je zaznamenán v protokolu doručení koncového bodu. Do koncového bodu, který není ověřen, se neodesílá nic a prázdná sada událostí pro daný koncový bod Zinn® Ads vypne.

Průvodce krok za krokem

Článek Ovládání Zinn® Ads z MCP a asistentů AI na webu zinnads.com vás celým postupem provede pomocí snímků skutečných obrazovek. Všechny příručky k Zinn® Ads: zinnads.com/kb.