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

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

المشكلة

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

رسالة الخطأ

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

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

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

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

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

تأكد من استيفاء المتطلبات الأساسية التالية:

1. معدّل قبول الخطة

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

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

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

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

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

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

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

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

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

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

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

السبب	الوصف	تعليمات استكشاف الأخطاء وإصلاحها التي تنطبق على
ضبط SMTP غير صحيح	إعداد SMTP الذي تم تقديمه غير صحيح.	مستخدمو Edge Private Cloud
الجدول الزمني لمهام الإشعارات	لم تبدأ مهمة الإشعار.	مستخدمو 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. في حال استمرار المشكلة، يمكنك المتابعة إلى صفحة "يجب جمع معلومات التشخيص" باستخدام

السبب 2: جدول وظائف الإشعارات

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

التشخيص

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

   /monetize/apis/get/triggers

2. تحقَّق مما إذا كان شرط الإشعار متوفّرًا وأنّه مفعَّل للإشعار الذي لا يعمل. إذا لم يكن متوفّرًا، انتقِل إلى الخطوة رقم 3 لإنشاء شرط الإشعار وتخطَّ بقية الخطوات.
   1. إذا كانت متوفرة، تحقَّق مما إذا كانت مفعَّلة. وإذا لم يكن الأمر كذلك، عليك تشغيل واجهة تعديل حالة الإشعار والإجراءات لواجهة برمجة التطبيقات لتعديل شرط الإشعار.

      أو

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

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

   3. شغِّل طلب إنشاء شرط الإشعار والإجراءات من واجهة برمجة التطبيقات لإنشاء شرط الإشعار المناسب والإجراء المقابل.
      1. بعد إنشاء شرط الإشعار، شغِّل استدعاء List notifications terms and actions API للتحقّق مما إذا تم إنشاء شرط الإشعار.
      2. يمكنك أيضًا إعادة معالجة الإشعار باستخدام واجهة برمجة تطبيقات إعادة معالجة الإشعارات.
   4. لا تنطبق هذه الخطوة إلا على مستخدمي السحابة الإلكترونية الخاصة. في حال توفّر شرط الإشعار من الخطوة رقم 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 Notification API

يجب جمع معلومات التشخيص

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

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

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

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

• سجل خادم الإدارة
  
  /opt/apigee/var/log/edge-management-server/logs/system.log