راهنمای شروع سریع متریکس: اولین گام‌ها برای پیاده‌سازی
این راهنما برای کمک به شما در راه‌اندازی سریع و آسان پلتفرم متریکس طراحی شده است. ما شما را در مراحل اولیه از فعال‌سازی حساب کاربری تا مشاهده اولین داده‌های خود در پنل متریکس همراهی خواهیم کرد.
پیش‌نیازها و مراحل راه‌اندازی
گام 0: آشنایی با مفاهیم کلیدی و قابلیت‌های متریکس (توصیه می‌شود)
اگر تجربه قبلی در پیاده‌سازی متریکس یا پلتفرم‌های تحلیل و اتوماسیون مشابه ندارید، به شدت توصیه می‌کنیم قبل از شروع مراحل فنی، با مفاهیم بنیادی و قابلیت‌های اصلی متریکس آشنا شوید. این به شما کمک می‌کند تا درک عمیق‌تری از نحوه عملکرد متریکس داشته باشید، داده‌های خود را به طور مؤثرتری ساختاربندی کنید و از پتانسیل کامل این پلتفرم بهره‌مند شوید.
گام 1: درخواست دمو و فعال‌سازی سازمان شما
اولین گام برای شروع کار با متریکس، درخواست دمو از طریق وب‌سایت ما است. پس از ارسال درخواست، تیم متریکس با شما تماس گرفته و یک سازمان (Organization) اختصاصی را برای شما در پنل متریکس فعال خواهد کرد.
توجه: این مرحله معمولاً توسط تیم محصول، تیم بازاریابی یا مدیر سازمان شما انجام می‌شود.
گام 2: ایجاد یک پروژه یا اپلیکیشن در پنل متریکس
پس از فعال‌سازی سازمان شما، وارد پنل متریکس شوید. در اینجا، باید یک “App” جدید برای سرویس خود (مانند اپلیکیشن موبایل، وب‌سایت و غیره) ایجاد کنید.
توجه: مراحل باقیمانده را در بخش “راهنمای شروع سریع” یا “Onboarding” در پنل ادامه دهید.
گام 3: تعریف ایونت ها (اختیاری)
برای حفظ یک ساختار داده سازمان‌یافته‌تر، می‌توانید ایونت های خود را در بخش “Onboarding” پنل متریکس قبل از ارسال آن‌ها تعریف کنید. اما نگران نباشید – اگر ایونت ها را از قبل تعریف نکنید، پس از اولین ارسال، آن‌ها به طور خودکار با نام مربوطه در پنل شما ایجاد خواهند شد.
گام 4: دریافت App ID و API Key
برای اینکه SDK یا API متریکس بتواند داده‌ها را به پروژه شما ارسال کند، به دو شناسه حیاتی نیاز دارید: App ID و API Key. می‌توانید این شناسه‌ها را پس از ایجاد پروژه/اپلیکیشن خود، از پنل متریکس دریافت کنید.
گام 5: پیاده‌سازی اولیه متریکس از طریق SDK/API
اکنون زمان آن است که متریکس را در پروژه خود ادغام کنید. بسته به نوع سرویس شما (اندروید، وب، REST API و غیره)، باید از SDK یا API مناسب استفاده کنید.
- انتخاب SDK/API مناسب: به بخش “مستندات فنی” در مستندات ما مراجعه کنید تا مناسب‌ترین SDK یا API را برای پلتفرم خود انتخاب کنید.
- نصب و راه‌اندازی: راهنمای مستندات را برای نصب SDK مربوطه دنبال کنید و آن را با استفاده از App ID و API Key که در مرحله قبل به دست آوردید، راه‌اندازی کنید.
//: # ’ - (و سایر لینک‌های SDK/API مربوطه بر اساس پلتفرم‌های موجود)’
گام 6: ارسال اولین ایونت و تأیید آن در پنل
پس از پیاده‌سازی اولیه، یک ایونت تستی از اپلیکیشن یا وب‌سایت خود ارسال کنید. سپس به پنل متریکس بازگردید تا از موفقیت‌آمیز بودن ارسال آن اطمینان حاصل کنید.
- پیاده‌سازی: به بخش “ردیابی ایونت ” در مستندات SDK/API خود مراجعه کرده و یک ایونت ساده (مانند
app_openedبرای اپلیکیشن‌ها یاpage_viewedبرای وب‌سایت‌ها) ارسال کنید. - تأیید در پنل:
- به بخش “تست” در قسمت “ادغام داده” در صفحه “راهنمای شروع سریع” بروید.
- ایونت تستی خود را ارسال کنید.
- ایونت ورودی را بررسی کنید. باید ایونت ارسالی شما در اینجا مشاهده شود که نشان‌دهنده اتصال موفقیت‌آمیز است!
توجه: قبل از ارسال ایونت ، مطمئن شوید که صفحه تست در مرورگر شما باز است!
گام 7: پیاده‌سازی و تأیید ارسال داده‌های کاربر (در صورت استفاده از خدمات اتوماسیون)
اگر قصد استفاده از قابلیت‌های اتوماسیون متریکس را دارید، علاوه بر ایونت ها، باید شناسایی و ارسال داده‌های کاربر را نیز پیاده‌سازی کنید.
- پیاده‌سازی: به بخش “مدیریت کاربران” در مستندات SDK/API خود مراجعه کرده و متدهای مربوط به شناسایی کاربر و ارسال ویژگی‌های پروفایل (مانند
setCustomUserId،setUserAttributes) را پیاده‌سازی کنید. - تأیید در پنل:
- در همان بخش “تست” مرحله قبل، دریافت اطلاعات کاربر را بررسی کنید.
- به بخش “کاربران” (User Lookup) در پنل متریکس بروید. کاربرانی که اطلاعاتشان را ارسال کرده‌اید، به همراه ویژگی‌هایشان، باید در اینجا قابل مشاهده باشند.
گام 8: آزمایش کانال‌های ارتباطی (در صورت استفاده از خدمات اتوماسیون)
برای اطمینان از عملکرد صحیح کانال‌های ارتباطی متریکس (مانند اعلان‌های پوش یا SMS)، آن‌ها را مطابق با راهنماهای مستندات و از طریق پنل آزمایش کنید.
- مراحل:
- راه‌اندازی کانال: به بخش “کانال‌ها” در مستندات مراجعه کرده و کانال مورد نظر خود (به عنوان مثال، اعلان‌های پوش) را مطابق با دستورالعمل‌ها (مانند پیکربندی FCM برای اندروید) راه‌اندازی کنید.
- ارسال تست: از بخش “Onboarding” پنل یا مناطق مربوط به ارسال پیام، یک پیام تستی را از طریق کانال انتخاب شده به دستگاه خود ارسال کنید.
- تأیید: تأیید کنید که پیام به دستگاه شما تحویل داده شده است.
//: # ’ - (و سایر لینک‌های کانال‌های ارتباطی)‘
عیب‌یابی مشکلات رایج
اگر در طول راه‌اندازی با مشکلی مواجه شدید، در اینجا برخی از راه‌حل‌های رایج آورده شده است:
ایونت ها در پنل ظاهر نمی‌شوند:
- بررسی کنید که App ID و API Key شما صحیح هستند
- اطمینان حاصل کنید که SDK قبل از ارسال ایونت ها به درستی راه‌اندازی شده است
- کنسول اپلیکیشن/وب‌سایت خود را برای هرگونه پیام خطا بررسی کنید
- اتصال اینترنت خود را تأیید کنید که پایدار است
داده‌های کاربر همگام‌سازی نمی‌شوند:
- مطمئن شوید که متدهای شناسایی کاربر قبل از ارسال ایونت ها فراخوانی شده‌اند
- بررسی کنید که ویژگی‌های کاربر به درستی فرمت شده‌اند
- بررسی کنید که اپلیکیشن شما مجوزهای لازم برای انتقال داده را دارد
اعلان‌های پوش دریافت نمی‌شوند:
- تأیید کنید که اعتبارنامه‌های FCM (اندروید) یا APNs (iOS) به درستی پیکربندی شده‌اند
- بررسی کنید که کاربران مجوزهای اعلان را اعطا کرده‌اند
- بررسی کنید که دستگاه/مرورگر شما در حالت Do Not Disturb نباشد
- مطمئن شوید که اپلیکیشن/وب‌سایت تست شما در حین آزمایش فعال باقی می‌ماند
برای کمک بیشتر، به مرکز پشتیبانی ما مراجعه کنید یا با تیم متریکس تماس بگیرید.
گام‌های بعدی شما
تبریک می‌گوییم! شما مراحل اولیه راه‌اندازی متریکس را با موفقیت به پایان رسانده‌اید. اکنون، برای استفاده کامل از قابلیت‌های قدرتمند متریکس، این مباحث پیشرفته را کاوش کنید:
- ردیابی پیشرفته ایونت ها: برای یادگیری نحوه ردیابی ایونت های سفارشی با ویژگی‌های دقیق.
- پیاده‌سازی اتریبیوشن: برای درک و پیاده‌سازی دقیق ردیابی کمپین‌ها و منشأ نصب/بازدیدها.
- کاوش قابلیت‌های اتومیشن: برای ساخت سفر مشتری و کمپین‌های تعاملی پیچیده.
- سوالات متداول و عیب‌یابی: برای یافتن پاسخ سوالات رایج و حل مشکلات احتمالی در طول مسیر.
مرجع سریع
شناسه‌های کلیدی که به آن‌ها نیاز خواهید داشت:
- App ID - شناسه منحصر به فرد برای اپلیکیشن/پروژه شما
- API Key - کلید محرمانه برای درخواست‌های API (آن را محرمانه نگه دارید)
- Tracker Token - برای ردیابی وب (در صورت لزوم)
مفاهیم کلیدی:
- ایونت (Event) - هر اقدامی که کاربران انجام می‌دهند (مثلاً خرید، مشاهده صفحه، کلیک روی دکمه)
- کاربر (User) - فردی که از اپلیکیشن/وب‌سایت شما استفاده می‌کند
- اتوماسیون (Automation) - اقدامات فعال‌شونده بر اساس رفتار کاربر
- اتریبیوشن (Attribution) - ردیابی منبع جذب کاربر
نیاز به کمک دارید؟
- برای درک بنیادی، راهنمای مفاهیم کلیدی را بررسی کنید
- برای پیاده‌سازی دقیق، مستندات خاص SDK را مرور کنید
- برای ناوبری پنل، به مرکز راهنمایی متریکس مراجعه کنید
- برای سوالات متداول، سوالات متداول ما را بررسی کنید