تحلیل تعامل توسعهدهندگان با APIهای عمومی در Postman API Network
مدت زمان مطالعه: : 4 دقیقه
بخش Publisher Analytics در Postman API Network به شما نشان میدهد توسعهدهندگان چطور با کالکشنهای عمومی، forkها، updateهای workspace و پروفایل ناشر شما تعامل دارند. این گزارش مسیر کاربر را از کشف API تا استفاده واقعی نشان میدهد و برای فهمیدن میزان دیدهشدن، کاربردپذیری و رشد APIهای عمومی بسیار مفید است.
برای دیدن این دادهها، وارد Postman API Network شوید و در sidebar سمت چپ، در بخش Publish گزینه Analytics را انتخاب کنید. میتوانید فعالیت کاربران را برای بازه شش ماه گذشته به تفکیک هفته یا ماه بررسی کنید.
شاخصهای اصلی #
Analytics چند گروه داده مهم را نمایش میدهد. هر کدام از این شاخصها به شما کمک میکند بفهمید کاربران کجا API شما را پیدا میکنند، کجا شروع میکنند و کجا ممکن است گیر کنند.
Users #
این بخش نشان میدهد چند توسعهدهنده با محتوای شما تعامل داشتهاند و این تعامل چقدر عمیق بوده است.
- Active users: کاربرانی که در بازه انتخابشده محتوا را دیدهاند، کالکشن را fork کردهاند یا API call انجام دادهاند. این شاخص گستردهترین معیار reach است.
- API users: کاربرانی که حداقل یک request به API شما از طریق Postman Collection ارسال کردهاند. این افراد از مرحله علاقه اولیه عبور کردهاند و واقعا API را استفاده کردهاند.
- New API users: کاربرانی که برای اولین بار API شما را صدا زدهاند. این عدد برای سنجش رشد و جذب کاربران جدید کاربرد دارد.
- Successful users: کاربرانی که حداقل یک پاسخ موفق 2XX گرفتهاند. این شاخص نشان میدهد onboarding تا چه حد موفق بوده است.
- Error-only users: کاربرانی که request ارسال کردهاند اما هیچ پاسخ موفقی نگرفتهاند. زیاد بودن این عدد میتواند نشانه مشکل در احراز هویت، مستندات یا تنظیمات اولیه باشد.
Companies #
ناشران verified میتوانند API Calls و API Callers را به تفکیک شرکت ببینند. این داده بر اساس دامنه ایمیل کاربران API محاسبه میشود و برای شناخت مشتریان، صنایع فعال و میزان نفوذ محتوای شما در شبکه API Postman کاربرد دارد.
این داده فقط برای ناشران verified در دسترس است.
Views #
Views نشان میدهد توسعهدهندگان چند بار محتوای شما را دیدهاند. این شاخص برای سنجش دیدهشدن و قابل کشف بودن API مهم است. اگر viewها رشد کنند، معمولا یعنی API بهتر پیدا میشود یا توجه بیشتری جذب کرده است. اگر افت کنند، ممکن است لازم باشد محتوای خود را بهروز، معرفی یا بهتر ترویج کنید.
Viewها شامل کالکشنهای عمومی در workspaceهای عمومی و کالکشنهای forkشده در workspaceهای داخلی کاربران میشود. در نمودارها میتوانید منبعهای مختلف داده را روشن یا خاموش کنید تا نمای دقیقتری از وضعیت بگیرید.
Forks #
Fork نشانه مهمی است که کاربر آماده تست یا ساختن روی API شماست. وقتی کاربر کالکشن را fork میکند، یک نسخه از آن را در workspace خود ذخیره میکند و همچنان میتواند تغییرات کالکشن اصلی را دنبال کند.
Forkها معمولا از دو مسیر میآیند: workspace عمومی شما یا دکمه Run in Postman که در مستندات یا وبسایت قرار دادهاید. اضافه کردن دکمه Run in Postman میتواند onboarding را سریعتر کند، چون کاربر از همان جایی که API را پیدا کرده است شروع میکند.
API calls #
API calls نشان میدهد توسعهدهندگان چند بار API شما را از طریق Postman صدا زدهاند. میتوانید حجم کل callها، کالکشنهایی که بیشترین traffic را ایجاد کردهاند و محل شروع requestها را ببینید؛ برای مثال forkها، workspace عمومی، notebookها یا پیشنهادهای autocomplete.
API errors #
این بخش مشکلاتی را نشان میدهد که ممکن است مانع onboarding موفق یا استفاده درست از API شوند. روند error rate و کالکشنهایی با بیشترین خطاهای 4xx قابل مشاهده هستند. زیاد بودن خطا، مخصوصا برای کاربران جدید، معمولا به معنی نقص در مستندات، احراز هویت یا تنظیمات اولیه است.
تبدیل داده به اقدام #
- اگر کاربران زیادی فقط خطا میگیرند، کالکشن راهنمای احراز هویت یا setup بسازید.
- برای سادهتر شدن تنظیمات، از environment variableها استفاده کنید.
- برای کاهش خطای ورودی کاربر، Guided Auth را فعال کنید.
- با workspace update کاربران را از تغییرات مهم باخبر کنید.
- از دادههای view و fork برای فهمیدن محتوای محبوب و محتوای نیازمند بهبود استفاده کنید.
Publisher analytics فقط برای گزارشگیری نیست؛ باید از آن برای رشد API، بهتر کردن تجربه توسعهدهنده و پیدا کردن نقاط اصطکاک استفاده کنید.
منبع آموزشی: Postman Docs، بازنویسی و سادهسازیشده برای کاربران فارسیزبان.
