این راهنمای انتقال موارد جدید را در نسخه 2 SDK توضیح می‌دهد و نکاتی را در اختیار توسعه‌دهندگان قرار می‌دهد تا از پیاده‌سازی v1.x مهاجرت کنند. توسعه دهندگانی که نیازی به مهاجرت از پیاده سازی v1.x ندارند، می توانند اکنون با نسخه 2 شروع کنند .
معرفی
Google Analytics اخیراً Google Analytics SDK به روز شده را برای نسخه 2 اندروید منتشر کرده است. نسخه 2 SDK شامل پشتیبانی از ویژگی های جدید و یک رابط گزارش جدید است که به طور خاص برای توسعه دهندگان برنامه طراحی شده است.
ما توصیه می کنیم که همه توسعه دهندگان Google Analytics موجود به نسخه 2 Google Analytics SDK برای Android مهاجرت کنند تا از ویژگی ها و گزارش های جدید استفاده کنند.
موارد جدید در نسخه 2
Google Analytics SDK برای نسخه 2 اندروید یک تجربه گزارش جدید طراحی شده برای توسعه دهندگان برنامه، ابعاد و معیارهای جدید قدرتمند و موارد دیگر را معرفی می کند. در اینجا نگاهی داریم به آنچه که توسعه دهندگان با نسخه 2 دریافت می کنند:
- گزارش های قدرتمندتر برای توسعه دهندگان برنامه
- گزارش‌های استاندارد برای توسعه‌دهندگان برنامه‌ها دوباره طراحی شده‌اند و گزارش‌های جدیدی مانند جریان تعامل و منابع Google Play را اضافه می‌کنند تا به توسعه‌دهندگان کمک کنند تا بینش جدیدی در مورد جذب کاربر و تجربه کسب کنند. بهترین روش‌های پیکربندی حساب ما را بخوانید تا درباره بهترین روش پیکربندی دارایی خود برای نسخه 2 بیشتر بدانید.
- ابعاد و معیارهای برنامه جدید
- ابعاد و معیارهای جدید ویژه برنامه با نسخه 2 SDK معرفی شده است، از جمله نام صفحه و نماهای صفحه، نام برنامه، نسخه برنامه و بسیاری موارد دیگر.
- خرابی ها و استثناها را اندازه گیری کنید
- Google Analytics SDK برای اندروید اندازه‌گیری استثنا و نوع ضربه استثنا را معرفی می‌کند. با استفاده از اندازه‌گیری استثنا، می‌توانید تعداد و نوع خرابی‌ها و استثناهای غیرکشنده را اندازه‌گیری کنید. برای یادگیری نحوه اجرای اندازه‌گیری استثنا، به راهنمای توسعه‌دهنده استثناها مراجعه کنید.
- ابعاد و معیارهای سفارشی
- برای تقسیم بندی داده های خود به روش های جدید، ابعاد سفارشی ایجاد کنید. درباره ابعاد و معیارهای سفارشی بیشتر بدانید.
- تعاملات اجتماعی را اندازه گیری کنید
- با اندازه‌گیری تعاملات کاربر با افزونه‌ها و ویجت‌های اجتماعی تعبیه‌شده، بینش جدیدی در مورد ارزش اجتماعی در برنامه خود به دست آورید. درباره اندازه گیری تعاملات اجتماعی بیشتر بیاموزید.
قبل از اینکه شروع کنی
همه توسعه دهندگان می خواهند قبل از شروع مهاجرت خود این دو مرحله را انجام دهند:
- Google Analytics SDK را برای اندروید نسخه ۲ دانلود کنید
- یک نمای برنامه (نمایه) ایجاد کنید که از آن برای دسترسی به گزارش ها و داده های برنامه جدید خود استفاده کنید.
پس از انجام مراحل بالا، مراحل زیر را برای مسیر مهاجرت خود دنبال کنید.
مهاجرت از EasyTracker
برای انتقال برنامه خود از نسخه 1 به نسخه 2 کتابخانه EasyTracker، سه مرحله وجود دارد:
- پارامترها را در فایل منبع GoogleAnalytics.xml خود به روز کنید
- نام روش ها را به روز کنید
- گیرنده پخش خود را به روز کنید (ردیابی کمپین Google Play)
1. پارامترها را در GoogleAnalytics.xml به روز کنید
هنگام مهاجرت به نسخه 2، پارامترها را در فایل منبع GoogleAnalytics.xml خود به روز کنید، زیرا برخی از آنها از نسخه 1.x تغییر کرده و پارامترهای جدیدی در نسخه 2 اضافه شده است.
جدول زیر پارامترهای به روز شده در نسخه 2 را نشان می دهد:
| نام پارامتر v1.x | نام پارامتر v2.x |
|---|---|
| ga_api_key | ga_trackingId |
| ga_auto_activity_tracking | ga_autoActivityTracking |
| ga_dryRun | منسوخ |
برای کسب اطلاعات بیشتر، پارامترهای EasyTracker جدید و به روز شده را ببینید .
2. به روز رسانی نام روش
اگرچه بسیاری از نحو در نسخه 2 EasyTracker یکسان باقی می ماند، اما تفاوت های قابل توجهی در نام روش و نحو وجود دارد که شما را ملزم می کند پیاده سازی خود را به روز کنید:
-
trackPageView()sendView()در نسخه 2 است. برای اطلاعات بیشتر، راهنمای توسعه دهنده ردیابی صفحه را ببینید. - پیاده سازی تجارت الکترونیک ساده شده است. نحوه پیاده سازی اندازه گیری تجارت الکترونیک را در نسخه 2 بیاموزید .
- متغیرهای سفارشی با ابعاد سفارشی و متریک جایگزین شده‌اند. هر تماسی با
setCustomVar()باید برای استفاده از ویژگی جدید به روز شود. نحوه پیاده سازی ابعاد و متریک های سفارشی را بیاموزید.
3. به‌روزرسانی گیرنده پخش (ردیابی کمپین Google Play)
برنامه‌نویسانی که ردیابی کمپین Google Play را با استفاده از v1.x پیاده‌سازی کرده‌اند، باید توجه داشته باشند که مسیر کلاس گیرنده تغییر کرده است. برای اطلاعات بیشتر به راهنمای ردیابی کمپین Google Play مراجعه کنید.
مهاجرت از یک پیاده سازی سفارشی
اگر از کتابخانه EasyTracker در نسخه 1.x Analytics SDK برای Android استفاده نمی‌کردید، توصیه می‌کنیم از EasyTracker در نسخه 2 استفاده کنید.
کتابخانه EasyTracker اکنون با SDK گنجانده شده است و برای همه توسعه دهندگان توصیه می شود. شروع به استفاده از EasyTracker در Google Analytics SDK v2 کنید .
اگر نیازهای پیشرفته‌ای برای جمع‌آوری داده‌ها دارید، مانند استفاده از چندین شناسه ویژگی در یک پیاده‌سازی، راهنمای پیکربندی پیشرفته را بخوانید تا درباره استفاده از ویژگی‌های پیشرفته v2.x SDK بیشتر بدانید.