إشعارات تحقيق الربح لا تعمل

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

المشكلة

لا تعمل إشعارات تحقيق الربح، وبالتالي لا يتم إرسال الرسائل الإلكترونية إلى المستخدمين المشتركين.

رسالة الخطأ

لن يتم إرسال الرسائل الإلكترونية حول إشعارات تحقيق الربح إلى المشتركين في القناة. ولن تتم ملاحظة أيّ رسائل خطأ.

لمحة عن إشعارات أحداث تحقيق الربح

تتيح ميزة تحقيق الربح تلقّي إشعارات بشأن الأحداث التي تتيح لك ما يلي:

  1. أبلِغ جميع المطوّرين بالأحداث، مثل المنتجات الجديدة أو الإصدارات الجديدة من الأحكام والشروط أو خطط الأسعار الجديدة.
  2. إبلاغ مطوري برامج محددين بأحداث مثل مستند الفوترة الذي يتم نشره أو عند بلوغ نسبة مئوية من عدد المعاملات المستهدفة (في حالة شراء خطة معدل إشعارات قابلة للتعديل).
  3. يجب إبلاغ موفِّر واجهة برمجة التطبيقات بشأن الأحداث ذات الصلة بالمطوّرين، مثلاً عند تسجيل مطوّر برامج للحصول على حساب أو عند اشتراك مطوّر البرامج في خطة أسعار.
  4. يمكنك العثور هنا على مزيد من التفاصيل حول هذا النوع من الإشعارات وكيفية إعداده.

المتطلبات الأساسية

احرص على استيفاء المتطلبات الأساسية التالية:

  1. قبول خطة السعر

    بالنسبة إلى إشعارات تحقيق الربح التالية، يُرجى التحقّق ممّا إذا وافق المطوّرون على خطة السعر المقابلة أم لا :

    1. خطة الأسعار الجديدة
    2. خطة السعر المنقّحة
    3. خطة الأسعار منتهية الصلاحية
    4. خطة السعر المُجدَّدة
    5. تم تجاوز الحد المخصص للمعدل
    6. خطة سعر مستنزف التطبيقات المجانية المحدودة

      إذا لم يقبل المطوّر خطة الأسعار، لن يتم إرسال هذه الإشعارات إلى ذلك المطوِّر المعنيّ.

  2. يجب تشغيل أداة جدولة المهام للإشعار المحدّد

    توفّر ميزة تحقيق الربح أداة لجدولة المهام ومجموعة من الوظائف تمت جدولتها مسبقًا للتشغيل في أوقات محدّدة مسبقًا. يجب تشغيل أداة جدولة المهام لإشعار محدّد. وفي حال عدم تشغيله، لن يتم إرسال الإشعارات.

    1. استخدِم التعليمات المقدَّمة في المستند التالي لمعرفة ما إذا كانت المهمة المُجدوَلة لإشعار معيّن قد تم تنفيذها أم لا:

      جدولة مهام تحقيق الربح

      ملاحظة: يمكنك تغيير الجدول الزمني في أي وقت استنادًا إلى حالة استخدامك.

    2. إذا سبق تنفيذ المهمة المُجدوَلة للإشعار المحدّد ولم تتلقَّ الإشعارات بعد، انتقِل إلى قسم الأسباب المحتملة لتحديد هذه المشكلة وحلّها.
    3. إذا لم يكن الأمر كذلك، انتظِر حتى يتم تنفيذ المهمة المُجدوَلة للإشعارات المحدّدة.

الأسباب المحتملة

في ما يلي بعض الأسباب المحتمَلة لهذه المشكلة:

السبب الوصف تعليمات استكشاف الأخطاء وإصلاحها التي تنطبق على
إعداد SMTP غير صحيح إعداد SMTP الذي تم تقديمه غير صحيح. مستخدمو Edge الخاص على السحابة الإلكترونية

الجدول الزمني لمهمة إرسال الإشعارات

 لم تبدأ مهمة الإشعار. مستخدمو Edge العامون ومستخدمو السحابة الإلكترونية الخاصة

السبب 1: إعداد SMTP غير صحيح

التشخيص

  1. تحقَّق من ملف /opt/apigee/edge-mint-management-server/conf/apix-mint.properties وتحقَّق من إعداد خصائص SMTP التالية بشكلٍ صحيح. 
    mint.notification.javaMail.properties={"mail.smtp.host": "smtp.gmail.com",
"mail.smtp.port": "465", "mail.smtp.starttls.enable": "true", "mail.smtp.auth": "true", "mail.smtp.username": "blah@gmail.com", "mail.smtp.password": "blah" }
  2. تحقَّق من صحة إعدادات المستخدم وخادم SMTP. إذا كانت هذه الإعدادات غير صحيحة أو لم يتم ضبطها، انتقِل إلى الخطوة رقم 3. إذا كان ذلك صحيحًا، فتابع إلى الخطوة رقم 4.
  3. حدِّث خادم SMTP وإعدادات المستخدم بشكل صحيح باستخدام الإرشادات الواردة في المستند التالي:

    /private-cloud/latest/configuring-edge-smtp-server

  4. تأكَّد مجددًا من أنّ إشعارات تحقيق الربح أصبحت تعمل الآن. وإذا لم يكن الأمر كذلك، يُرجى المتابعة إلى الخطوة 5.
  5. إذا كانت إعدادات SMTP صحيحة، يمكنك تشغيل عرض الإشعارات المُرسَلة من واجهة برمجة التطبيقات للاطِّلاع على حالة الإشعار المُرسَل.
    1. تعرض واجهة برمجة التطبيقات هذه ملف JSON يتضمّن كل الإشعارات التي تم تنشيطها وحالة كل إشعار.
    2. يتم توفير نموذج JSON أدناه: 
      {
        "hasMoreItems" : false,
        "notifications" : [ {
        "fromAlias" : "No Reply",
        "fromEmail" : "****@apigee.com",
        "id" : "4e2d0d9a-69a4-4430-957d-02fa2a3cb581",
        "notificationType" : "EMAIL",
        "orgId" : "myorg",
        "rawMessage" : "...",
        "retryCount" : 0,
        "retryStatuses" : [ {
             "responseCode" : 0,
             "responseMessage" : "{\"Headers\":null,\"Content : \":null,\"StatusCode\":\"0\"}",
             "retriedAt" : 1518605291092,
             "retryAttempt" : 0
        } ],
        "source" : "MailTo: [****@blah.com], Org: [myorg], EventType: [UPDATE_DEVELOPER]",
        "status" : "FAILED",
        "subject" : "Notification of developer changing company details",
        "templateId" : "814315c8-d8ca-4b3e-90bb-a8366600e625",
        "templateName" : "DEFAULT_UPDATE_DEVELOPER_TEMPLATE",
        "templateParametersJSON" : "{\"developer.legalName\":\"\",\"developer.name\":\"John Smith\"}",
        "toAlias" : "***@blah.com",
        "toEmail" : "***@blah.com",
        "unsubscribeURL" : "..."
}

      إذا تحقّقت من ملف JSON، يتم عرض الحالة "تعذّر" للإشعار المحدد أعلاه "تحديث المطوِّر".

  6. قد يرجع ذلك إلى عدم إمكانية الوصول إلى خادم ومنفذ SMTP من خادم الإدارة. استخدم الأمر telnet للتحقق مما إذا كان بإمكانك الاتصال بخادم SMTP المحدد في المنفذ المحدد. 
    telnet <SMTP-server-IP-address> <SMTP-Port#>

    إذا ظهرت لك رسالة الخطأ "انتهت مهلة الاتصال" أو "تم رفض الاتصال" لإخراج telnet، فيمكنك المتابعة إلى الحل.

درجة الدقّة

  1. اعمل مع مسؤول الشبكة وتأكد من أن خادم SMTP قادر على قبول الاتصالات من الأجهزة الأخرى وأيضًا فتح المنفذ المحدد للاتصال بالعالم الخارجي.
  2. في حال استمرار المشكلة، يُرجى المتابعة إلى صفحة "يجب جمع معلومات التشخيص" مع

السبب الثاني: الجدول الزمني لمهمة الإشعارات

لم تبدأ مهمة الإشعار.

التشخيص

  1. نفِّذ طلب البيانات من واجهة برمجة التطبيقات التالي لعرض جميع مهام تحقيق الربح المُجدوَلة حاليًا.

    /monetize/apis/get/triggers

  2. تحقَّق مما إذا كان شرط الإشعار متوفّرًا ومفعّلاً للإشعار الذي لا يعمل. إذا لم يكن موجودًا، فانتقل إلى الخطوة رقم 3 لإنشاء شرط الإشعار وتخطي بقية الخطوات.
    1. إذا كانت موجودة، فتحقق مما إذا تم تفعيلها على "true". إذا لم يكن الأمر كذلك، يُرجى تشغيل Update a notifications condition and action API (تعديل حالة الإشعار وواجهة برمجة تطبيقات الإجراءات) لتعديل حالة الإشعار.

      أو

    2. يمكنك استخدام واجهة المستخدم لتحديث حالة الإشعار باستخدام العملية الواردة في المستند أدناه:

      واجهة مستخدم الأحداث

    3. قم بتشغيل طلب البيانات Create a notifications condition and action API (إنشاء شرط إشعار وواجهة برمجة تطبيقات الإجراء) لإنشاء شرط الإشعار المناسب والإجراء المقابل.
      1. بعد إنشاء شرط الإشعار، شغِّل طلب واجهة برمجة التطبيقات لشروط الإشعارات والإجراءات للتحقّق من إنشاء شرط الإشعار.
      2. يمكنك أيضًا إعادة معالجة الإشعار باستخدام Reprocess a notifications API.
    4. لا تنطبق هذه الخطوة إلا على مستخدمي Google Cloud الخاصين. في حال توفّر شرط الإشعار من الخطوة رقم 1 وعدم تلقّي الرسائل الإلكترونية الخاصة بالإشعارات، تحقَّق من سجلّ خادم الإدارة /opt/apigee/var/log/edge-management-server/logs/system.log لمعرفة ما إذا كان قد تم تشغيل شرط الإشعار. 
      grep "Executing Mint Scheduler" /opt/apigee/var/log/edge-management-server/logs/system.log | grep  -o  "Executing Mint Scheduler : \[.*\]" | grep -v "for org : \[null\]" |sort | uniq -c
    5. إذا تم تفعيل حالة الإشعار ولم تتلقَّ الإشعارات بعد، انتقِل إلى ضرورة جمع معلومات التشخيص مع إدراج المعلومات والنتائج من الخطوات المذكورة أعلاه.

الحلّ

  1. إعادة معالجة الإشعار باستخدام Reprocess a notifications API

ضرورة جمع معلومات التشخيص

في حال استمرار المشكلة حتى بعد اتّباع التعليمات الواردة أعلاه، يُرجى التواصل مع فريق دعم Apigee Edge وتقديم معلومات التشخيص التالية.

على مستخدمي السحابة الإلكترونية العامة والخاصة تقديم المعلومات التالية:

  1. اسم المؤسسة
  2. اسم البيئة
  3. شرط عدم نجاح إشعار تحقيق الربح
  4. تتوفّر تفاصيل حول الأقسام التي تمت تجربتها في هذا "الدليل الإرشادي" وأي إحصاءات أخرى ستساعدنا في حلّ هذه المشكلة بسرعة.

بالإضافة إلى المعلومات المذكورة أعلاه، على مستخدمي السحابة الإلكترونية الخاصة أيضًا تقديم المعلومات التالية:

  • سجلّ خادم الإدارة

    /opt/apigee/var/log/edge-management-server/logs/system.log