الإشعارات
يستطيع AD80 أن يخبرك حين يفحص إعلاناً، وحين يخالف إعلانٌ قواعدك، وحين يقترب مفتاح من انتهاء صلاحيته. وأنت تختار القناة، والأحداث، والتصفية، واللغة، ومتى نرسل.
القنوات
Section titled “القنوات”| القناة | ما يصلك |
|---|---|
| بريد | رسالة بالعربية أو الإنجليزية (بصيغة HTML ونص عادي)، فيها التطبيق، والقواعد والدرجات، والشبكة، ومكان العرض، ورابط لصورة الإعلان. في كل رسالة رابط لإلغاء الاشتراك، وتستطيع برامج البريد إلغاء الاشتراك بنقرة واحدة. |
| Webhook | طلب POST عبر HTTPS بمحتوى JSON، موقَّع بالسر الخاص بك. راجع أحداث Webhook. |
قنوات الإشعارات متاحة في خطتي Starter وEnterprise. تُعدّها من صفحة الإشعارات أو عبر واجهة الإشعارات.
الأحداث
Section titled “الأحداث”| الحدث | متى يحدث |
|---|---|
creative.violation | التقييم الجديد لإعلان يخالف قاعدة واحدة على الأقل. |
creative.classified | فحصنا إعلاناً (سواء خالف قاعدة أم لا). |
key.expiring | مفتاح رفع أو مفتاح API له تاريخ انتهاء، وقد اقترب موعده. |
كل إشعار يختار أحداثه، ويمكنك تضييقه بـ التصفية: التطبيقات، والقواعد، وحدّ أدنى للدرجة.
أكّد الوجهة
Section titled “أكّد الوجهة”لا يصل أي شيء إلى الإشعار الجديد حتى تثبت أن الوجهة لك:
- البريد: يرسل AD80 رسالة تأكيد. افتح الرابط واضغط زر التأكيد. يبقى الرابط صالحاً 48 ساعة.
- Webhook: يرسل AD80 حدث
notify.verifyإلى عنوانك. فيه الحقلdata.code(يبدأ بـvc_)، وهو رمز يُستخدم مرة واحدة. أعِده إلىPOST /v1/notifications/subscriptions/{id}/confirm. وفي لوحة المتابعة تلصقه في خانة الرمز الذي وصل إلى الـ Webhook. راجع قسم التحقق من الوجهة في واجهة الإشعارات.
وإن غيّرت الوجهة فستحتاج إلى تأكيد جديد.
كم مرة: فوراً أو في ملخص
Section titled “كم مرة: فوراً أو في ملخص”| الوضع | ما يحدث |
|---|---|
immediate (فوراً) | رسالة لكل حدث. |
digest_hourly (ملخص كل ساعة) | رسالة كل ساعة، فيها أحداث تلك الساعة. |
digest_daily (ملخص يومي) | رسالة واحدة كل يوم. |
الإشعارات السريعة
Section titled “الإشعارات السريعة”تنبيهات الفحص والمخالفات التي تُرسل إلى إشعار فوراً هي إشعارات سريعة. تشمل خطتك
عدداً شهرياً منها، وتصلك في الأحوال العادية خلال دقائق. وحين ينفد رصيد الشهر لا تضيع التنبيهات التالية، بل تصلك في
الملخص الذي يُرسل كل ساعة لهذا الإشعار، وتذكر الرسالة أن الرصيد نفد (وتحمل رسائل Webhook "expedited": false).
ويتجدّد الرصيد في بداية الشهر الميلادي التالي (بتوقيت UTC).
الإرسال
Section titled “الإرسال”- نكرّر محاولة الإرسال حتى تقبله نقطة النهاية عندك أو حتى تمضي 24 ساعة، مع فترات انتظار تتزايد. راجع التسليم وإعادة المحاولة ومنع التكرار.
- الإرسال يحدث مرة واحدة على الأقل، أي قد تصل الرسالة مرتين أحياناً. مستقبِلات Webhook تمنع التكرار باستخدام معرّف التسليم، أما البريد فلا ضمان فيه لذلك.
- سجل الإرسال (في لوحة المتابعة أو عبر API) يعرض كل رسالة وكل محاولة، ويتيح لك إعادة الإرسال.
بعد تغيير الخطة
Section titled “بعد تغيير الخطة”إن فقدت خطتك قناةً ما، تبقى إشعاراتك موجودة لكن لا يُرسل شيء عبر تلك القناة. ولا يمكن إعادة تشغيلها حتى تعود الخطة لتشمل هذه القناة.