تخطَّ إلى المحتوى

الإشعارات

يستطيع AD80 أن يخبرك حين يفحص إعلاناً، وحين يخالف إعلانٌ قواعدك، وحين يقترب مفتاح من انتهاء صلاحيته. وأنت تختار القناة، والأحداث، والتصفية، واللغة، ومتى نرسل.

القناةما يصلك
بريدرسالة بالعربية أو الإنجليزية (بصيغة HTML ونص عادي)، فيها التطبيق، والقواعد والدرجات، والشبكة، ومكان العرض، ورابط لصورة الإعلان. في كل رسالة رابط لإلغاء الاشتراك، وتستطيع برامج البريد إلغاء الاشتراك بنقرة واحدة.
Webhookطلب POST عبر HTTPS بمحتوى JSON، موقَّع بالسر الخاص بك. راجع أحداث Webhook.

قنوات الإشعارات متاحة في خطتي Starter وEnterprise. تُعدّها من صفحة الإشعارات أو عبر واجهة الإشعارات.

الحدثمتى يحدث
creative.violationالتقييم الجديد لإعلان يخالف قاعدة واحدة على الأقل.
creative.classifiedفحصنا إعلاناً (سواء خالف قاعدة أم لا).
key.expiringمفتاح رفع أو مفتاح API له تاريخ انتهاء، وقد اقترب موعده.

كل إشعار يختار أحداثه، ويمكنك تضييقه بـ التصفية: التطبيقات، والقواعد، وحدّ أدنى للدرجة.

لا يصل أي شيء إلى الإشعار الجديد حتى تثبت أن الوجهة لك:

  • البريد: يرسل AD80 رسالة تأكيد. افتح الرابط واضغط زر التأكيد. يبقى الرابط صالحاً 48 ساعة.
  • Webhook: يرسل AD80 حدث notify.verify إلى عنوانك. فيه الحقل data.code (يبدأ بـ vc_)، وهو رمز يُستخدم مرة واحدة. أعِده إلى POST /v1/notifications/subscriptions/{id}/confirm. وفي لوحة المتابعة تلصقه في خانة الرمز الذي وصل إلى الـ Webhook. راجع قسم التحقق من الوجهة في واجهة الإشعارات.

وإن غيّرت الوجهة فستحتاج إلى تأكيد جديد.

كم مرة: فوراً أو في ملخص

Section titled “كم مرة: فوراً أو في ملخص”
الوضعما يحدث
immediate (فوراً)رسالة لكل حدث.
digest_hourly (ملخص كل ساعة)رسالة كل ساعة، فيها أحداث تلك الساعة.
digest_daily (ملخص يومي)رسالة واحدة كل يوم.

تنبيهات الفحص والمخالفات التي تُرسل إلى إشعار فوراً هي إشعارات سريعة. تشمل خطتك عدداً شهرياً منها، وتصلك في الأحوال العادية خلال دقائق. وحين ينفد رصيد الشهر لا تضيع التنبيهات التالية، بل تصلك في الملخص الذي يُرسل كل ساعة لهذا الإشعار، وتذكر الرسالة أن الرصيد نفد (وتحمل رسائل Webhook "expedited": false). ويتجدّد الرصيد في بداية الشهر الميلادي التالي (بتوقيت UTC).

  • نكرّر محاولة الإرسال حتى تقبله نقطة النهاية عندك أو حتى تمضي 24 ساعة، مع فترات انتظار تتزايد. راجع التسليم وإعادة المحاولة ومنع التكرار.
  • الإرسال يحدث مرة واحدة على الأقل، أي قد تصل الرسالة مرتين أحياناً. مستقبِلات Webhook تمنع التكرار باستخدام معرّف التسليم، أما البريد فلا ضمان فيه لذلك.
  • سجل الإرسال (في لوحة المتابعة أو عبر API) يعرض كل رسالة وكل محاولة، ويتيح لك إعادة الإرسال.

إن فقدت خطتك قناةً ما، تبقى إشعاراتك موجودة لكن لا يُرسل شيء عبر تلك القناة. ولا يمكن إعادة تشغيلها حتى تعود الخطة لتشمل هذه القناة.