ارسال رویدادهای ⁦Zinn® Ads⁩ به Zapier، Make و سیستم‌های خودتان

سرویس ⁦Zinn® Ads⁩ می‌تواند رویدادهای خود را به نقطه پایانی وبهوک اختصاصی شما ارسال کند، تا Zapier، Make یا سامانه اختصاصی شما بتوانند در همان لحظه وقوع رویدادها، نسبت به آن‌ها واکنش نشان دهند. این رویدادها عبارت‌اند از ads.finding.opened، ads.change.applied، ads.alert.started.

راه‌اندازی

۱. در پیشخوان، کانال‌های اعلان را باز کنید و یک نقطه پایانی وبهوک بیفزایید. این نشانی باید حتماً HTTPS باشد. ما یک رمز امضا برای آن ایجاد می‌کنیم و آن را تنها یک بار به شما نمایش می‌دهیم. ۲. تأیید نقطه پایانی: ما یک درخواست آزمایشی به آن ارسال می‌کنیم و آن نقطه پایانی باید با وضعیت 2xx پاسخ دهد. ۳. وارد ⁦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 منتشر شده است.

در صورت از دسترس خارج شدن نقطه پایانی شما

یک تحویل ناموفق ۵ بار دیگر مجدداً تلاش می‌شود، پس از ۱، ۵، ۲۵، ۱۲۵، ۶۲۵ دقیقه، و هر تلاش در گزارش تحویل نقطه پایانی ثبت می‌گردد. هیچ موردی به نقطه پایانی که تأیید نشده است ارسال نمی‌شود، و یک مجموعه خالی از رویدادها ⁦Zinn® Ads⁩ را برای آن نقطه پایانی غیرفعال می‌کند.

راهنمای گام‌به‌گام

مطلب کنترل ⁦Zinn® Ads⁩ از طریق MCP و دستیاران هوش مصنوعی در zinnads.com مراحل را به همراه تصاویر واقعی صفحات توضیح می‌دهد. تمامی راهنماهای ⁦Zinn® Ads⁩: zinnads.com/kb.