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

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

پیش‌نیازها و مراحل راه‌اندازی

گام ۱: درخواست دمو و فعال‌سازی سازمان (Organization)

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

• درخواست دمو متریکس

توجه: معمولا این مرحله توسط تیم محصول، مارکتینگ یا مدیر سازمان شما انجام می شود.

گام ۲: ایجاد پروژه یا اپلیکیشن در پنل متریکس

پس از فعال‌سازی سازمان، وارد پنل متریکس خود شوید. در اینجا، باید یک “اپ ها” یا “Apps” جدید برای سرویس خود (مانند اپلیکیشن موبایل، وب‌سایت و…) ایجاد کنید.

توجه: سایر گام ها را در بخش “راهنمای شروع” یا “Onboarding” در پنل ادامه دهید.

گام ۳: تعریف رویدادها (اختیاری)

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

گام ۴: دریافت App ID و API Key

برای اینکه SDK یا API متریکس بتواند داده‌ها را به پروژه شما ارسال کند، به دو شناسه حیاتی نیاز دارید: App ID و API Key. این شناسه‌ها را می‌توانید پس از ایجاد پروژه/اپلیکیشن، از پنل متریکس دریافت کنید.

گام ۵: پیاده‌سازی اولیه متریکس از طریق SDK/API

اکنون زمان آن رسیده که متریکس را به پروژه خود اضافه کنید. بسته به نوع سرویس شما (Android, iOS, Web, REST API و…) باید از SDK یا API مناسب استفاده کنید.

1. انتخاب SDK/API مناسب: به بخش “یکپارچه‌سازی‌های فنی” در مستندات ما مراجعه کنید تا مناسب‌ترین SDK یا API را برای پلتفرم خود انتخاب کنید.
2. نصب و مقداردهی اولیه: طبق راهنمای داکیومنت، SDK مربوطه را نصب کرده و با استفاده از App ID و API Key که در گام قبل دریافت کردید، آن را مقداردهی اولیه (Initialize) کنید.

گام ۶: ارسال اولین رویداد و بررسی در پنل

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

• پیاده‌سازی: به بخش “ردیابی رویدادها” در مستندات SDK/API خود مراجعه کرده و یک رویداد ساده (مانند app_opened برای اپلیکیشن یا page_viewed برای وب‌سایت) را ارسال کنید.
• بررسی در پنل:
  1. به بخش “تست” در قسمت “یکپارچه سازی داده ها” در صفحه “راهنمای شروع” بروید.
  2. رویداد تستی خود را ارسال کنید.
  3. آمدن رویداد را بررسی کنید. باید رویداد ارسالی خود را در اینجا مشاهده کنید، که نشان‌دهنده موفقیت‌آمیز بودن ارتباط است!

توجه: حتما قبل از ارسال ایونت صفحه تست در مرورگر شما باید باز باشد!

گام ۷: پیاده‌سازی و بررسی ارسال کاربران (در صورت استفاده از سرویس اتومیشن)

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

• پیاده‌سازی: به بخش “مدیریت کاربران” در مستندات SDK/API خود مراجعه کرده و متدهای مربوط به شناسایی کاربر و ارسال ویژگی‌های پروفایل (مانند setCustomUserId, setUserAttributes) را پیاده‌سازی کنید.
• بررسی در پنل:
  1. در همان بخش “تست” مانند گام قبل دریافت اطلاعات کاربر را بررسی کنید.
  2. به بخش “کاربران” (User Lookup) در پنل متریکس بروید. کاربرانی که اطلاعاتشان را ارسال کرده‌اید، به همراه ویژگی‌هایشان، باید در اینجا قابل مشاهده باشند.

گام ۸: تست کانال‌های ارتباطی (در صورت استفاده از سرویس اتومیشن)

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

• مراحل:
  1. تنظیم کانال: به بخش “کانال‌ها” در مستندات مراجعه کرده و کانال مورد نظر خود (مثلاً پوش نوتیفیکیشن) را طبق دستورالعمل‌ها (مانند تنظیم FCM برای اندروید) تنظیم کنید.
  2. ارسال تست: از بخش “Onboarding” پنل یا بخش‌های مربوط به ارسال پیام، یک پیام تستی از طریق کانال مورد نظر به دستگاه خود ارسال کنید.
• بررسی: تأیید کنید که پیام به دستگاه شما رسیده باشد.

گام‌های بعدی شما

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

• ردیابی پیشرفته رویدادها: برای یادگیری نحوه ردیابی رویدادهای سفارشی با ویژگی‌های دقیق.
• پیاده‌سازی اتریبیوشن: برای درک و پیاده‌سازی دقیق ردیابی کمپین‌ها و منشأ نصب/بازدیدها.
• کاوش قابلیت‌های اتومیشن: برای ساخت سفر مشتری و کمپین‌های تعاملی پیچیده.
• سوالات متداول و عیب‌یابی: برای یافتن پاسخ سوالات رایج و حل مشکلات احتمالی در طول مسیر.