اعلان‌های کسب درآمد کار نمی‌کنند

شما در حال مشاهده مستندات Apigee Edge هستید.
به مستندات Apigee X مراجعه کنید . اطلاعات

علامت

اعلان‌های کسب درآمد کار نمی‌کنند و از این رو ایمیل‌ها برای کاربران مشترک ارسال نمی‌شوند.

پیام خطا

ایمیل‌های مربوط به اعلان کسب درآمد برای مشترکین ارسال نخواهد شد. هیچ پیام خطایی مشاهده نخواهد شد.

درباره اعلان‌های رویداد کسب درآمد

کسب درآمد از اعلان‌های رویداد پشتیبانی می‌کند که شما را قادر می‌سازد:

  1. به همه توسعه‌دهندگان در مورد رویدادهایی مانند محصولات جدید، نسخه‌های جدید شرایط و ضوابط یا طرح‌های نرخ جدید اطلاع دهید.
  2. به توسعه‌دهندگان خاص در مورد رویدادهایی مانند انتشار سند صورتحساب یا زمانی که به درصدی از تعداد تراکنش‌های هدفشان رسیده‌اند (اگر طرح نرخ اعلان قابل تنظیم را خریداری کرده‌اند) اطلاع دهید.
  3. به ارائه‌دهنده API در مورد رویدادهای مربوط به توسعه‌دهنده، مانند زمانی که یک توسعه‌دهنده برای یک حساب کاربری ثبت‌نام می‌کند یا زمانی که یک توسعه‌دهنده برای یک طرح نرخی ثبت‌نام می‌کند، اطلاع دهید.
  4. جزئیات بیشتر در مورد اینکه چه نوع اعلان‌هایی وجود دارد و چگونه می‌توان آن را تنظیم کرد، را می‌توانید اینجا بیابید.

پیش‌نیازها

مطمئن شوید که پیش‌نیازهای زیر رعایت شده‌اند:

  1. پذیرش طرح نرخ

    برای اعلان‌های کسب درآمد زیر، بررسی کنید که آیا توسعه‌دهندگان طرح نرخ مربوطه را پذیرفته‌اند یا خیر:

    1. طرح نرخ جدید
    2. طرح نرخ اصلاح‌شده
    3. طرح نرخ منقضی شده
    4. طرح نرخ تمدید شده
    5. از حد مجاز نرخ تجاوز شد
    6. طرح نرخ فریمیومِ تمام‌شده

      اگر توسعه‌دهنده طرح تعرفه را نپذیرفته باشد، این اعلان‌ها برای آن توسعه‌دهنده خاص فعال نمی‌شوند.

  2. برنامه‌ریز کار باید برای اعلان خاص اجرا شود.

    کسب درآمد، یک زمان‌بند کار و مجموعه‌ای از کارها را فراهم می‌کند که از قبل برای اجرا در زمان‌های از پیش تعیین‌شده برنامه‌ریزی شده‌اند. زمان‌بند کار باید برای یک اعلان خاص اجرا شود. اگر اجرا نشود، اعلان‌ها فعال نمی‌شوند.

    1. برای بررسی اینکه آیا کار برنامه‌ریزی‌شده برای یک اعلان خاص اجرا شده است یا خیر، از دستورالعمل‌های ارائه شده در سند زیر استفاده کنید:

      برنامه‌ریزی برای کسب درآمد از طریق مشاغل

      توجه: شما همیشه می‌توانید برنامه را بر اساس مورد استفاده خود تغییر دهید.

    2. اگر کار برنامه‌ریزی‌شده برای اعلان خاص از قبل اجرا شده است و شما هنوز اعلان‌ها را دریافت نمی‌کنید، برای عیب‌یابی بیشتر این مشکل به بخش علل احتمالی بروید.
    3. اگر اینطور نیست، منتظر بمانید تا کار برنامه‌ریزی‌شده برای اعلان خاص اجرا شود.

علل احتمالی

برخی از علل احتمالی این مشکل عبارتند از:

علت توضیحات دستورالعمل‌های عیب‌یابی قابل اجرا برای
پیکربندی SMTP نادرست است پیکربندی SMTP ارائه شده صحیح نیست. کاربران ابر خصوصی Edge

برنامه کاری اطلاع رسانی

 کار اعلان شروع نشده است. کاربران ابر عمومی و ابر خصوصی Edge

دلیل ۱: پیکربندی 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. با استفاده از دستورالعمل‌های موجود در سند زیر، تنظیمات سرور SMTP و کاربر را به درستی به‌روزرسانی کنید:

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

  4. دوباره بررسی کنید که آیا اعلان‌های کسب درآمد اکنون کار می‌کنند یا خیر. اگر نه، لطفاً به مرحله ۵ بروید.
  5. اگر تنظیمات SMTP صحیح است، برای مشاهده وضعیت اعلان ارسال شده، فراخوانی API مربوط به View notifications sent را اجرا کنید.
    1. این API یک 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. برای مشاهده تمام کارهای کسب درآمد برنامه‌ریزی‌شده فعلی، فراخوانی API زیر را اجرا کنید.

    /کسب درآمد/apis/دریافت/تریگرها

  2. بررسی کنید که آیا شرط اعلان وجود دارد و برای اعلانی که کار نمی‌کند فعال است یا خیر. اگر وجود ندارد، برای ایجاد شرط اعلان به مرحله ۳ بروید و بقیه مراحل را رد کنید.
    1. اگر وجود دارد، بررسی کنید که آیا مقدار آن روی true فعال است یا خیر. اگر نه، API مربوط به Update a notification condition and action را اجرا کنید تا شرط اعلان به‌روزرسانی شود.

      یا

    2. از رابط کاربری برای به‌روزرسانی وضعیت اعلان با استفاده از فرآیند ارائه شده در سند زیر استفاده کنید:

      رابط کاربری رویدادها

    3. برای ایجاد شرط اعلان مناسب و اقدام مربوطه، فراخوانی API مربوط به «ایجاد یک شرط اعلان و اقدام» را اجرا کنید.
      1. پس از ایجاد شرط اعلان، فراخوانی API مربوط به شرایط و اقدامات اعلان لیست را اجرا کنید تا تأیید شود که آیا شرط اعلان ایجاد شده است یا خیر.
      2. همچنین می‌توانید با استفاده از Reprocess a notification API، اعلان را دوباره پردازش کنید.
    4. این مرحله فقط برای کاربران Private Cloud قابل اجرا است. اگر شرایط اعلان از مرحله ۱ برقرار است و ایمیل‌های اعلان هنوز ارسال نمی‌شوند، لاگ سرور مدیریت /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. جزئیات مربوط به بخش‌هایی از این کتابچه راهنما که مورد بررسی قرار گرفته‌اند و هرگونه بینش دیگری که به ما در تسریع حل این مشکل کمک می‌کند.

علاوه بر اطلاعات فوق، کاربران Private Cloud باید اطلاعات زیر را نیز ارائه دهند:

  • گزارش سرور مدیریت

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