کتابخانه متریکس برای React-Native
- اضافه کردن پکیج متریکس به پروژه
- راهاندازی کتابخانه در اپلیکیشن
- راهاندازی برای اپلیکیشن Android
- راهاندازی برای اپلیکیشن iOS
- امکانات و قابلیتها
- نشست (session)
- شناسه نشست
- شماره نشست جاری
- رویداد (event)
- ساختن یک رویداد سفارشی
- مشخص کردن Attributeهای پیشفرض همهی رویدادها
- ساختن رویداد درآمدی
- دریافت شناسه دستگاههای متریکس
- امضاء کتابخانه
- فعالسازی برای اپلیکیشن Android
- فعالسازی برای اپلیکیشن iOS
- شمارش پاک کردن اپلیکیشن Android
- دریافت اطلاعات کمپین
- Deep Linking در اپلیکیشن Android
- سناریو استاندارد
- سناریو deferred
- مشخص کردن tracker پیشفرض
- فعالسازی برای اپلیکیشن Android
- فعالسازی برای اپلیکیشن iOS
- تفکیک نصبهای organic براساس استورهای مختلف
- فعالسازی برای اپلیکیشن Android
- فعالسازی برای اپلیکیشن iOS
به محل پروژه react-native خود بروید و دستور زیر را وارد کنید:
npm install @metrixorg/[email protected]
بسته به پلتفرم هدف برنامه خود مراحل زیر را جهت فعالسازی انجام دهید:
شناسه اپلیکیشن خود را به صورت meta-data
در فایل AndroidManifest.xml
اپلیکیشن خود قرار دهید:
<manifest>
...
<application>
...
<!-- خطوط زیر را اضافه کنید و کلید اپلیکیشن خود را جایگزین نمایید -->
<meta-data
android:name="metrix_appId"
android:value="APP_ID" />
</application>
</manifest>
فایل AndroidManifest.xml
در مسیر android -> app -> src -> main
قرار دارد.
APP_ID
: کلید اپلیکیشن شما که از پنل متریکس دریافت میکنید.
۱. جهت دریافت وابستگیهای متریکس به مسیر اپلیکیشن iOS در پروژه خود رفته و دستور نصب پاد را اجرا نمایید:
cd ios
pod install
۲. در constructor کلاس اصلی برنامه خود، مطابق قطعه کد زیر، با فراخوانی متد initialize
، کتابخانه متریکس را راهاندازی کنید:
Metrix.initialize("APP_ID");
APP_ID
: کلید اپلیکیشن شما که از پنل متریکس دریافت میکنید.
هر تعاملی که کاربر با یک اپلیکیشن دارد، در قالب یک نشست صورت میگیرد. کتابخانه متریکس اطلاعات مربوط به نشستهای مختلف کاربر در اپلیکیشن شما و بازه زمانی آنها را جمعآوری میکند و در اختیار شما میگذارد.
کتابخانه متریکس برای هر نشست یک شناسه منحصر به فرد تولید میکند که میتوانید این شناسه را دریافت نمایید. برای دریافت این شناسه متد زیر را فراخوانی کنید.
Metrix.setSessionIdListener(sessionId => {
// TODO
});
با استفاده از متد زیر میتوانید از شماره نشست جاری کاربر در تمام مدت استفاده خود از اپلیکیشن شما اطلاع پیدا کنید:
Metrix.setSessionNumberListener(sessionNum => {
// TODO
});
هرگونه تعاملی که کاربر با اپلیکیشن شما دارد میتواند به عنوان یک رویداد در پنل و اپلیکیشن شما تعریف شود تا کتابخانه متریکس اطلاعات آماری مربوط به آن را در اختیار شما قرار دهد.
در کتابخانه متریکس دو نوع رویداد قابل تعریف است:
- سفارشی (custom): وابسته به منطق اپلیکیشن شما و تعاملی که کاربر با اپلیکیشن شما دارد میتوانید رویدادهای سفارشی خود را در قالبی که در ادامه شرح داده خواهد شد بسازید و ارسال کنید.
- درآمدی (revenue): نوع خاصی از رویدادهای سفارشی قابل تعریف است که مربوط به میزان درآمد کسب شده در اپلیکیشن شما میباشد و دارای یک مقدار قابل اندازهگیری از جنس درآمد مالی است.