مستندات فنی سگمنتیک
مسیر مستندات سگمنتیک: شروع، جمعآوری داده، پیامرسانی، تحلیل و مرجع توسعهدهنده.
سگمنتیک رویدادهای محصول را جمع میکند، مخاطب میسازد و پیام را در کانال مناسب به دست هر مخاطب میرساند. اگر برای اولین بار سرویس را متصل میکنید، از راهاندازی سریع شروع کنید.
سه سطح
هر سطح کلید و کاربرد مشخصی دارد:
- ورود داده:
https://in.segmentic.netبا کلیدwk_seg_...، برای ثبت رویداد از سایت، اپ یا سرور - مدیریت:
https://api.segmentic.netبا کلیدsk_seg_...، برای مدیریت مخاطب، کمپین و گزارش از بکاند - پنل:
https://app.segmentic.netبا حساب کاربری، برای تنظیم و مشاهده اطلاعات
کلید نوشتن عمدا عمومی است و ساخته شده که داخل جاوااسکریپت خودتان بنشیند. کاری که میکند این است: رویداد بنویسد، دستگاه ثبت کند، پوش مرورگر را مشترک کند و پیام درونسایتی بگیرد. نه پروفایل میخواند و نه کلید تازه میسازد. کلید مدیریتی درست نقطه مقابلش است: هرچه نقش و مجوزش اجازه بدهد در کل حساب انجام میدهد و هرگز نباید به مرورگر برسد. دو پیشوند برای همین از هم جدا شدهاند که گزارش نشت کلید در یک نگاه تعیین تکلیف شود: دیدن wk_ در یک باندل عمومی یعنی همهچیز طبق طراحی است، دیدن sk_ در همانجا یعنی یک حادثه.
شروع
- راهاندازی سریع: ساخت کلید و ثبت اولین رویداد
- مفهومها: واژههای اصلی محصول و ارتباط آنها
جمعآوری داده
- طراحی رویداد و فرهنگنامه رویدادها: انتخاب نام و ویژگیهای درست
- پیادهسازی رهگیری: جای درست فراخوانی رویداد در محصول
- هویت: اتصال رفتار مهمان به کاربر واردشده
- SDK وب: اتصال سایت و وباپ
- SDK اندروید: رویداد، هویت، پوش و پیام درونبرنامهای در اپ اندروید
- سرور به سرور: ثبت رویدادهای قطعی مثل پرداخت موفق
- ثبت دستگاه: آمادهسازی پوش موبایل و مرورگر
- کاتالوگ محصولات و وبهوکها: همگامسازی داده با سرویسهای دیگر
مخاطب و پیامرسانی
- سگمنتها: ساخت مخاطب بر پایه رفتار و ویژگی
- سناریوها: اجرای جریانهای چندمرحلهای
- پیام تراکنشی: ارسال امن پیامهای فوری
- رضایت و سقف ارسال: رعایت ترجیحات مخاطب
- پیام درونبرنامهای: بنر، مودال، نظرسنجی و صندوق پیام
تحلیل و خروجی
- گزارش و خروجی: قیف، ماندگاری و دریافت فایل داده
مرجع توسعهدهنده
- مرجع API: انتخاب میزبان، کلید و مسیر درست
- نقاط ورود داده و API مدیریتی: جزئیات درخواست و پاسخ
- کدهای خطا و سقفها: رفتار قابل اتکای کلاینت
- OpenAPI: سند ماشینخوان برای ساخت کلاینت
ابزارهای توسعه
- کار با عامل هوش مصنوعی: فایل یکپارچه مستندات و پرامپت آماده
- سرور MCP: اجازه بدهید کلود، کدکس یا کرسر حساب شما را بخوانند و رویش کار کنند
حریم خصوصی و تغییرات
- دادههای شخصی: دسترسی، حذف و نگهداری داده
- نسخهبندی: سازگاری API و شیوه اعلام تغییرها
نسخه ماشینخوان
برای ابزارها و عاملهای هوش مصنوعی، مستندات در قالبهای /llms.txt، /llms-full.txt، /docs-fa.md و /docs-en.md در دسترس است. سند OpenAPI نیز از /openapi.json دریافت میشود.