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

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

قبل از شروع

قبل از شروع استفاده از کسب درآمد با سازمان Apigee خود، باید وظایف پیش نیاز زیر را انجام دهید:

  • همانطور که در ایجاد حساب Apigee Edge توضیح داده شده است، یک حساب Apigee Edge ایجاد کنید.
  • خرید درآمدزایی Edge در ابتدا شامل API کسب درآمد یا ادغام کسب درآمد در رابط کاربری مدیریت نمی شود. باید ویژگی کسب درآمد را خریداری کنید تا API کسب درآمد و مؤلفه‌های رابط کاربری کسب درآمد را در Edge برای سازمان Apigee خود بگنجانید.

پس از خرید کسب درآمد، باید کارهای زیر را انجام دهید:

راه اندازی اولیه با Apigee

برای تکمیل تنظیمات اولیه کسب درآمد، با تیم پیکربندی Apigee Edge کار کنید. بر اساس ورودی شما، تیم پیکربندی موارد زیر را تنظیم می کند:

  • این که آیا سازمان شما یک شرکت مخابراتی است.
  • کدام نوع صورت‌حساب را می‌خواهید برای برنامه‌نویسانی که طرح‌های نرخ شما را خریداری می‌کنند پشتیبانی کنید: پیش‌پرداخت، پس‌پرداخت یا هر دو. به حساب های پیش پرداخت در مقابل پس پرداخت مراجعه کنید.
  • این که آیا می خواهید داده های جزئی یا خلاصه از درآمدزایی در سیستم حسابداری خود و فرمت داده های مورد نیاز استخراج شود .
  • آدرس پاسخ ایمیل سفارشی برای اعلان‌های ایمیل کسب درآمد که به شرکت‌ها و توسعه‌دهندگان ارسال می‌شود، یک آدرس پیش‌فرض noreply@apigee.com پیکربندی شده است. شما باید یک نام و آدرس پاسخ سفارشی برای سازمان خود درخواست کنید.

تیم پیکربندی Apigee اسکریپتی را برای همگام سازی درآمدزایی با سازمان شما و هر برنامه‌نویس، برنامه‌ها و محصولات API که با استفاده از Apigee Edge ایجاد کرده‌اید اجرا می‌کند. پشتیبانی Apigee ممکن است از شما درخواست کند که در آینده سازمان خود را همگام کنید، همانطور که برای جزئیات در همگام سازی داده های Apigee Edge با کسب درآمد توضیح داده شده است. داده های کسب درآمد را همگام سازی نکنید مگر اینکه توسط Apigee دستور داده شده باشد.

کسب درآمد را پیکربندی کنید

جدول زیر مراحل مورد نیاز برای پیکربندی کسب درآمد برای سازمان Apigee شما را خلاصه می کند.
مرحله توضیحات
نمایه سازمان خود را ویرایش کنید به عنوان بخشی از راه اندازی اولیه کسب درآمد ، تیم پیکربندی Apigee Edge نمایه سازمان شما را تنظیم می کند.

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

ارزهای پشتیبانی شده را مدیریت کنید به عنوان بخشی از راه‌اندازی اولیه کسب درآمد ، تیم پیکربندی Apigee Edge ارزهای پشتیبانی شده توسط سازمان شما را مشخص می‌کند و ارز پیش‌فرض را تعیین می‌کند.

می‌توانید ارزهایی را که سازمانتان پشتیبانی می‌کند بازیابی کنید و ارزهای پشتیبانی شده را اضافه یا حذف کنید (برای منعکس کردن ارزهای استفاده شده توسط برنامه‌نویس یا یک طرح نرخ).

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

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

توجه : شرایط و ضوابط خارج از نمایه سازمان شما هستند. در نمایه سازمان خود، مکان (URL عمومی) شرایط و ضوابط را مشخص می‌کنید. می‌توانید چندین نسخه از شرایط و ضوابط اضافه کنید تا تغییرات در طول زمان منعکس شود.

محدودیت های کسب درآمد را اعمال کنید برای اعمال محدودیت های کسب درآمد، خط مشی MonetizationLimitsCheck را به پراکسی های API ضمیمه کنید.

به طور خاص، سیاست تحت شرایط زیر فعال می شود:

  • برنامه‌نویسی که به API درآمدزایی دسترسی دارد، ثبت نام نکرده است یا در طرح نرخ مشترک نشده است.
  • برنامه‌نویس از حجم تراکنش برای طرح نرخ مشترک فراتر رفته است.
  • موجودی حساب پیش‌پرداخت توسعه‌دهنده یا سقف اعتبار پس‌پرداخت تکمیل شده است.
اعلان ها را تنظیم کنید اعلان‌ها را برای اطلاع دادن به توسعه‌دهندگان یا ارائه‌دهندگان API از یک رویداد خاص، مانند طرح نرخ جدید منتشر شده، پیکربندی کنید.

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

وقتی از APIها کسب درآمد می کنید، یک یا چند محصول API را در یک بسته محصول API قرار می دهید و طرح نرخ مرتبط را تعریف می کنید.

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

جدول زیر مراحل لازم برای کسب درآمد از API های شما را خلاصه می کند.

مرحله توضیحات
بسته‌های محصول API را مدیریت کنید

بسته‌های محصول API را برای گروه‌بندی محصولات API خود ایجاد کنید.

توجه : در رابط کاربری Classic Edge و API کسب درآمد، بسته‌های محصول به عنوان بسته‌های API شناخته می‌شوند.

برای استفاده از API برای مدیریت بسته‌های محصول API، ببینید:

سیاست ثبت تراکنش را پیکربندی کنید

خط مشی ضبط تراکنش را برای هر یک از محصولات API خود پیکربندی کنید. خط مشی ضبط تراکنش، آنچه را که می خواهید در سوابق تراکنش یک محصول API ثبت کنید، از جمله هر ویژگی سفارشی را مشخص می کند.

برای استفاده از API برای پیکربندی خط مشی ضبط تراکنش، نگاه کنید به:

برنامه های نرخ را مدیریت و منتشر کنید

یک برنامه نرخ برای تعریف رویکرد کسب درآمد برای API های خود ایجاد کنید. برای مثال، اینکه آیا برای استفاده از API خود نرخ ثابت یا متغیری را شارژ می کنید.

برای مدیریت برنامه‌های نرخ با استفاده از API، ببینید:

یک طرح نرخ منتشر شده را خریداری کنید یک طرح نرخ منتشر شده را خریداری کنید، و در صورت تمایل، با استفاده از API، طرح نرخ خریداری شده را منقضی یا لغو کنید.
کسب درآمد را در پورتال توسعه دهنده پیکربندی کنید کسب درآمد را در پورتال برنامه‌نویس خود پیکربندی کنید تا به برنامه‌نویسان دسترسی خودسرویس به اشتراک طرح نرخ، پردازش و صورت‌حساب پرداخت خودکار، گزارش‌ها، کاتالوگ‌های محصول و سایر تنظیمات خاص کسب درآمد را ارائه دهید.

مدیریت درآمدزایی

پس از پیکربندی کسب درآمد و کسب درآمد API خود، می توانید یک یا چند مرحله از مراحل خلاصه شده در جدول زیر را انجام دهید:

مرحله توضیحات
شرکت ها و توسعه دهندگان را مدیریت کنید مدیریت شرکت ها و توسعه دهندگانی که از API های شما استفاده می کنند. توسعه دهنده یک موجودیت واحد است که به طور منحصر به فرد با آدرس ایمیل شناسایی می شود. یک شرکت مجموعه ای از توسعه دهندگان است که به عنوان یک موجودیت واحد مدیریت می شوند.
ایجاد گزارش گزارش های موجودی پیش پرداخت، درآمد و واریانس ایجاد کنید. برای توسعه دهندگان پیش پرداخت، می توانید گزارش های موجودی پیش پرداخت را با سپرده های بانکی تطبیق دهید.
اصلاحات صورتحساب را انجام دهید به عنوان مثال، اصلاحات صورتحساب را برای اصلاح اختلافات در سوابق خود انجام دهید.
صدور اعتبار در صورت لزوم اعتبار توسعه دهنده را صادر کنید. برای یک برنامه‌نویس پیش‌پرداخت، اعتبار به‌عنوان کاهش استفاده ظاهر می‌شود که موجودی پیش‌پرداخت توسعه‌دهنده را در آینده افزایش می‌دهد. برای یک برنامه‌نویس پس‌پرداخت، اعتبار به‌عنوان یک خط جداگانه در فاکتور ظاهر می‌شود و هزینه را در فاکتور کاهش می‌دهد.
موجودی حساب های پیش پرداخت را مدیریت کنید موجودی حساب پیش‌پرداخت فعلی را مشاهده کنید و حساب‌های پیش‌پرداخت را مجدداً بارگیری کنید یا با راه‌اندازی بارگیری مجدد خودکار با استفاده از ارائه‌دهنده پرداخت شخص ثالث.
موجودی پس پرداخت را با استفاده از محدودیت های اعتباری مدیریت کنید وقتی یک ارز پشتیبانی شده را برای یک سازمان اضافه می‌کنید، می‌توانید محدودیت اعتباری برای یک توسعه‌دهنده پس‌پرداخت تعیین کنید. محدودیت اعتبار برای همه توسعه دهندگان پس پرداخت در سازمان اعمال می شود. علاوه بر این، می توانید حد اعتبار را برای یک توسعه دهنده پس پرداخت جداگانه تعیین کنید. در این مورد، محدودیت اعتباری، محدودیت تعیین شده برای ارز را فقط برای توسعه دهنده مشخص شده لغو می کند.
ارسال بازپرداخت ارسال بازپرداخت به توسعه دهندگان برای تراکنش های خرید.
کارهای کسب درآمد را برنامه ریزی کنید کسب درآمد یک زمانبندی کار و مجموعه ای از مشاغل را ارائه می دهد که از قبل برنامه ریزی شده اند تا در زمان های تعیین شده اجرا شوند. برنامه کاری کسب درآمد را با استفاده از API مدیریت کنید.
مشاهده وضعیت معاملات وضعیت تراکنش هایی را که در یک بازه زمانی مشخص با استفاده از API رخ داده اند، مشاهده کنید.
داده های Apigee Edge را با کسب درآمد همگام کنید اگر Apigee دستور انجام این کار را داده است، داده‌ها را دوباره با کسب درآمد همگام‌سازی کنید تا اطمینان حاصل کنید که داده‌ها همگام هستند. می توانید موارد زیر را همگام سازی کنید: سازمان، محصولات API، توسعه دهندگان و برنامه ها.
داده های کسب درآمد را از سازمان خود حذف کنید ممکن است بخواهید برای پاک کردن یک سازمان آزمایشی یا حذف یک سازمان، داده‌های کسب درآمد را از سازمان خود حذف کنید.