شمارش نصب و ردیابی نشست کاربران(مختص سرویس اتریبیوشن)

برای فعال‌سازی ردیابی نشست کاربران از طریق SDK متریکس، کافی است در پارامتر config (که به‌عنوان پارامتر سوم در متد init استفاده می‌شود)، پیکربندی زیر را قرار دهید:

{
  sessionTracking: {
    enabled: true; // default is false.
    packageName: 'YOUR_APP_PACKAGE_NAME';
  }
}

شمارش نصب در اپ‌های TWA

با توجه به این‌که شناسه‌های موردنیاز برای فرایند اتریبیوشن (مانند Google Advertising ID) در محیط وب قابل دسترسی نیستند، و در حال حاضر تنها راه ارتباطی میان اپلیکیشن اندروید نیتیو و وب‌اپلیکیشن، در حالت TWA، آدرس لانچ (Launch URL) وب‌اپ است؛ بنابراین برای افزایش دقت در فرایند اتریبیوشن و شمارش صحیح نصب‌ها، ضروری است که اپلیکیشن اندرویدی مشتری، شناسه موردنظر را از طریق کتابخانه‌های گوگل دریافت کرده و آن را به‌صورت Query Parameter به آدرس وب‌اپلیکیشن اضافه کند. در ادامه، دستورالعمل‌های موردنیاز برای انجام این فرایند به همراه لینک مستندات لازم جهت پیاده‌سازی ارائه شده‌اند.

وابستگی مورد نیاز که باید برای دریافت این id به پروژه اضافه شود:

com.google.android.gms:play-services-ads-identifier:18.0.1

و همینطور مستندات مربوط به پیاده‌سازی جهت دریافت Google Advertising Id از طریق این لینک در دسترس است.

این آی‌دی باید با کلید gps_adid به کوئری پارامترهای آدرس لانچ‌شدن وب‌اپ مانند مثال زیر اضافه شود:
https://domain.example?gps_adid=DEVICE_ADVERTISING_ID

نمونه کد TWA که پیاده‌سازی دریافت Google Advertising Id در آن انجام شده است برای Java و Kotlin از طریق این لینک‌ها در دسترس است.

شمارش نصب در اپ‌های PWA

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

دریافت شناسه

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

onMetrixUserIdReceived().then((metrixUserId: string) => {
  // todo
});