Przesyłaj zdarzenia Zinn® Ads do usług Zapier, Make oraz własnych systemów

Zinn® Ads może przesyłać swoje zdarzenia do Państwa własnych punktów końcowych webhooków, dzięki czemu Zapier, Make lub Państwa własny system mogą reagować na nie w chwili ich wystąpienia. Dostępne zdarzenia to ads.finding.opened, ads.change.applied, ads.alert.started.

Konfiguracja

1. W panelu zarządzania proszę otworzyć Kanały powiadomień i dodać punkt końcowy webhook. Musi to być adres HTTPS. Utworzymy dla niego klucz tajny do podpisywania i wyświetlimy go Państwu tylko raz.
2. Weryfikacja punktu końcowego: wysyłamy do niego jedno żądanie testowe, a on musi odpowiedzieć statusem z zakresu 2xx.
3. Proszę otworzyć Zinn® Ads, znaleźć Webhooki dla platformy Zapier, Make i własnych systemów, zaznaczyć zdarzenia, które dany punkt końcowy ma odbierać, i wybrać Zapisz zdarzenia. Opcja Wyślij test powoduje wysłanie jednego przykładu.

Co jest przesyłane

Każde doręczenie ma postać żądania POST w formacie JSON. Towarzyszą mu nagłówki X-Zinn-Event (nazwa zdarzenia) oraz X-Zinn-Delivery (jeden identyfikator na doręczenie: należy odrzucić doręczenie, które zostało już przetworzone), a także X-Zinn-Signature: sha256=<hex>, czyli skrót HMAC-SHA256 z <X-Zinn-Timestamp>.<raw body> utworzony przy użyciu klucza tajnego Państwa punktu końcowego. Przed uznaniem treści za zaufaną należy zweryfikować podpis i odrzucić nieaktualny znacznik czasu. Struktura każdego zdarzenia została opublikowana w naszej specyfikacji OpenAPI w sekcji webhooks.

Gdy punkt końcowy jest niedostępny

Nieudane doręczenie jest ponawiane jeszcze 5 razy: po 1, 5, 25, 125 i 625 minutach, a każda próba jest odnotowywana w dzienniku doręczeń danego punktu końcowego. Żadne dane nie są przesyłane do punktu końcowego, który nie został zweryfikowany, a pusty zestaw zdarzeń wyłącza Zinn® Ads dla tego punktu końcowego.

Przewodnik krok po kroku

Artykuł Sterowanie Zinn® Ads za pomocą protokołu MCP i asystentów AI w witrynie zinnads.com omawia cały proces wraz ze zrzutami rzeczywistych ekranów. Wszystkie przewodniki Zinn® Ads: zinnads.com/kb.