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

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

علامت

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

پیغام خطا

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

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

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

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

پیش نیازها

مطمئن شوید که پیش نیازهای زیر برآورده شده است:

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

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

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

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

  2. Job Scheduler باید برای اعلان خاص اجرا شود

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

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

      کارهای کسب درآمد را برنامه ریزی کنید

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

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

علل احتمالی

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

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

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

 کار اطلاع رسانی شروع نشده است. Edge Public Cloud و Private Cloud Users

علت 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 درست است، برای مشاهده وضعیت اعلان ارسال شده ، View notifications sented API call را اجرا کنید.
    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#>

    اگر با خطای «زمان اتصال تمام شد» یا «اتصال رد شد» برای خروجی تلنت دریافت کردید، سپس به Resolution بروید.

قطعنامه

  1. با مدیر شبکه خود کار کنید و اطمینان حاصل کنید که سرور SMTP قادر به پذیرش اتصالات از سایر ماشین ها است و همچنین پورت خاص برای ارتباط به دنیای خارج باز است.
  2. اگر مشکل همچنان پابرجاست، سپس با استفاده از آن، به اطلاعات تشخیصی باید جمع آوری شود

علت 2: برنامه کاری اعلان

کار اطلاع رسانی شروع نشده است.

تشخیص

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

    /کسب درآمد/apis/get/triggers

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

      یا

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

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

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

کاربران عمومی و خصوصی Cloud باید اطلاعات زیر را ارائه دهند:

  1. نام سازمان
  2. نام محیطی
  3. شرایط اعلان کسب درآمد که کار نکرد
  4. جزئیات مربوط به بخش‌هایی که در این کتاب راهنما امتحان شده‌اند و هر بینش دیگری که به ما در حل سریع این مشکل کمک می‌کند.

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

  • ورود به سیستم سرور مدیریت

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