Το Zinn® Ads μπορεί να αποστέλλει τα συμβάντα του στα δικά σας τελικά σημεία webhook, ώστε το Zapier, το Make ή το δικό σας σύστημα να μπορούν να ενεργούν σε αυτά τη στιγμή που συμβαίνουν. Τα συμβάντα είναι τα ads.finding.opened, ads.change.applied, ads.alert.started.
Ρύθμιση
- Στον πίνακα ελέγχου ανοίξτε τα Κανάλια ειδοποιήσεων και προσθέστε ένα τελικό σημείο webhook. Πρέπει να είναι μια διεύθυνση HTTPS. Δημιουργούμε ένα μυστικό υπογραφής για αυτό και σας το εμφανίζουμε μία φορά.
- Επαληθεύστε το τελικό σημείο: του στέλνουμε ένα δοκιμαστικό αίτημα, και πρέπει να απαντήσει με μια κατάσταση 2xx.
- Ανοίξτε το Zinn® Ads, βρείτε τα Webhook για 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.