Zinn® Ads có thể gửi các sự kiện của nó tới các điểm cuối webhook của riêng bạn, để Zapier, Make hoặc hệ thống của riêng bạn có thể xử lý chúng ngay khi chúng xảy ra. Các sự kiện gồm ads.finding.opened, ads.change.applied, ads.alert.started.
Thiết lập
- Trong bảng điều khiển, hãy mở Kênh thông báo và thêm một điểm cuối webhook. Điểm cuối này phải là một địa chỉ HTTPS. Chúng tôi tạo một khóa bí mật ký cho nó và chỉ hiển thị cho bạn một lần.
- Xác minh điểm cuối: chúng tôi gửi một yêu cầu thử nghiệm tới điểm cuối đó, và nó phải phản hồi bằng trạng thái 2xx.
- Mở Zinn® Ads, tìm mục Webhook cho Zapier, Make và các hệ thống của riêng bạn, đánh dấu các sự kiện mà điểm cuối đó sẽ nhận và chọn Lưu sự kiện. Nút Gửi thử nghiệm sẽ gửi một ví dụ.
Những gì được gửi đến
Mỗi lượt gửi là một yêu cầu JSON POST. Các tiêu đề X-Zinn-Event (tên sự kiện) và X-Zinn-Delivery (một mã định danh cho mỗi lượt gửi: hãy bỏ qua nếu bạn đã xử lý lượt gửi này) sẽ đi kèm, và X-Zinn-Signature: sha256=<hex> cũng vậy, vốn là một mã HMAC-SHA256 của <X-Zinn-Timestamp>.<raw body> được tạo bằng khóa bí mật của điểm cuối của bạn. Hãy kiểm tra chữ ký và từ chối mốc thời gian cũ trước khi bạn tin cậy nội dung phần thân. Cấu trúc của từng sự kiện được công bố trong thông số kỹ thuật OpenAPI của chúng tôi tại mục webhooks.
Khi điểm cuối của bạn ngừng hoạt động
Lượt gửi thất bại sẽ được thử lại thêm 5 lần nữa, sau 1, 5, 25, 125, 625 phút, và mỗi lần thử đều được liệt kê trong nhật ký gửi của điểm cuối. Không có nội dung nào được gửi tới một điểm cuối chưa được xác minh, và tập hợp sự kiện trống sẽ tắt Zinn® Ads đối với điểm cuối đó.
Hướng dẫn từng bước
Bài viết Điều khiển Zinn® Ads từ MCP và trợ lý AI trên zinnads.com sẽ hướng dẫn chi tiết qua ảnh chụp màn hình thực tế. Mọi hướng dẫn về Zinn® Ads: zinnads.com/kb.