Google Analytics SDK برای Android جمعآوری دادههای تعامل کاربر را از برنامههای خود برای توسعهدهندگان آسان میکند. این سند یک نمای کلی از ارزش SDK و همچنین راهنمایی برای شروع اندازهگیری برنامه شما با استفاده از یک شناسه دارایی واحد و EasyTracker ارائه میکند.
معرفی
Google Analytics SDK برای Android جمعآوری دادههای تعامل کاربر را از برنامههای خود برای توسعهدهندگان آسان میکند. سپس توسعهدهندگان میتوانند از گزارشهای Google Analytics برای اندازهگیری استفاده کنند:
- تعداد کاربران فعالی که از برنامه های خود استفاده می کنند.
- از کجای دنیا این اپلیکیشن در حال استفاده است.
- پذیرش و استفاده از ویژگی های خاص.
- خریدها و تراکنش های درون برنامه ای
- تعداد و نوع برنامه از کار می افتد.
- و بسیاری از معیارهای مفید دیگر.
علاوه بر این، Google Analytics SDK برای Android ابزارهایی را برای نظارت بر موفقیت کمپین بازاریابی تلفن همراه با ارائه دید سرتاسر عملکرد کانالهای بازاریابی شما، از نصبهای Google Play از طریق خریدهای درونبرنامه و تراکنشها در اختیار شما قرار میدهد.
قبل از اینکه شروع کنی
قبل از شروع اجرای SDK، مطمئن شوید که موارد زیر را دارید:
- توسعه دهنده اندروید SDK (در دسترس برای Windows، Mac OS X و Linux)
- Google Analytics SDK برای Android نسخه 2 (با
libGoogleAnalyticsV2.jar
موجود در فهرست راهنمای/libs
پروژه شما و مسیر ساخت) - یک برنامه اندروید که می توانید از آن برای پیاده سازی Google Analytics SDK برای اندروید نسخه ۲ استفاده کنید
- ویژگی و نمای (نمایه) جدید برنامه Google Analytics .
شروع شدن
سه مرحله برای شروع کار با SDK وجود دارد:
- AndroidManifest.xml را به روز کنید
- روش های EasyTracker را اضافه کنید
- فایل analytics.xml خود را ایجاد کنید
پس از انجام این مراحل، میتوانید موارد زیر را با Google Analytics اندازهگیری کنید:
- نصب برنامه
- کاربران فعال و جمعیت شناسی
- صفحه نمایش و تعامل کاربر
- خرابی ها و استثناها
1. به روز رسانی AndroidManifest.xml
فایل AndroidManifest.xml خود را با افزودن مجوزهای زیر به روز کنید:
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
2. اضافه کردن روش های EasyTracker
متدهای ارسال را به متدهای onStart()
و onStop()
هر یک از Activities
خود مانند مثال زیر اضافه کنید:
/** * An example Activity in your app with Analytics * implemented. */ public class myTrackedActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); } @Override public void onStart() { super.onStart(); ... // The rest of your onStart() code. EasyTracker.getInstance().activityStart(this); // Add this method. } @Override public void onStop() { super.onStop(); ... // The rest of your onStop() code. EasyTracker.getInstance().activityStop(this); // Add this method. } }
توجه داشته باشید که EasyTracker قبل از اینکه بتوانید متدهای آن را فراخوانی کنید به Context
نیاز دارد. در مثال بالا، این خط:
EasyTracker.getInstance.activityStart(this);
از تنظیم زمینه مراقبت می کند. اما اگر نیاز به برقراری تماس EasyTracker در کلاسها یا روشهای دیگر دارید، ابتدا باید متد setContext(Context ctx)
EasyTracker را فراخوانی کنید:
// Set Context before using EasyTracker. Note that the SDK will // use the application context. EasyTracker.getInstance().setContext(this); // EasyTracker is now ready for use.
3. فایل analytics.xml خود را ایجاد کنید
در نسخه 2 Google Analytics SDK برای Android، گزینههای پیکربندی از یک فایل منبع xml، به نام analytics.xml
در این راهنما مدیریت میشوند. شما باید این فایل را در دایرکتوری res/values
پروژه خود ایجاد کنید و شناسه پیگیری خود را اضافه کنید. مثال زیر نشان می دهد که چگونه می توانید شناسه ردیابی خود را اضافه کنید و اندازه گیری Activity
و استثنا را فعال کنید:
<?xml version="1.0" encoding="utf-8" ?> <resources> <!--Replace placeholder ID with your tracking ID--> <string name="ga_trackingId">UA-XXXX-Y</string> <!--Enable automatic activity tracking--> <bool name="ga_autoActivityTracking">true</bool> <!--Enable automatic exception tracking--> <bool name="ga_reportUncaughtExceptions">true</bool> </resources>
بررسی کننده پرز شما ممکن است به شما در مورد استفاده از خط تیره ('-') در شناسه ردیابی خود هشدار دهد. میتوانید با افزودن ویژگیهای اضافی به تگ <resources>
خود، آن هشدار را سرکوب کنید:
<resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="TypographyDashes">
برای لیست کامل پارامترهایی که می توانید برای پیکربندی پیاده سازی خود از آنها استفاده کنید، به مرجع پارامترهای analytics.xml مراجعه کنید.
تبریک می گویم! اکنون برنامه شما برای ارسال داده به Google Analytics تنظیم شده است.
مراحل بعدی
با Google Analytics میتوانید کارهای بیشتری انجام دهید، از جمله اندازهگیری کمپینها، پرداختها و تراکنشهای درونبرنامه، و رویدادهای تعامل با کاربر. برای یادگیری نحوه افزودن این ویژگی ها به پیاده سازی خود، به راهنمای توسعه دهنده زیر مراجعه کنید:
- پیکربندی پیشرفته - درباره گزینه های پیکربندی پیشرفته، از جمله استفاده از ردیاب های متعدد بیشتر بدانید.
- اندازهگیری کمپینها – نحوه اجرای اندازهگیری کمپین را بیاموزید تا بفهمید کدام کانالها و کمپینها باعث نصب اپلیکیشن میشوند.
- اندازهگیری رویدادها – یاد بگیرید که چگونه تعامل کاربر را با محتوای تعاملی مانند دکمهها، ویدیوها و سایر رسانهها با استفاده از رویدادها اندازهگیری کنید.
- اندازه گیری پرداخت های درون برنامه ای – نحوه اندازه گیری پرداخت ها و تراکنش های درون برنامه ای را بیاموزید.
- زمانبندی کاربر – نحوه اندازهگیری زمانبندی کاربر در برنامه خود را برای اندازهگیری زمان بارگذاری، تعامل با رسانه و موارد دیگر بیاموزید.
- پارامترهای Analytics.xml – لیست کامل پارامترهای پیکربندی
analytics.xml
را ببینید.