این سند نحوه شروع استفاده از Google Analytics SDK برای Android نسخه 3 را شرح می دهد.
قبل از اینکه شروع کنی
قبل از اجرای SDK، مطمئن شوید که موارد زیر را دارید:
- توسعه دهنده اندروید SDK (در دسترس برای Windows، Mac OS X و Linux)
- Google Analytics SDK برای Android نسخه 3 (با
libGoogleAnalyticsServices.jar
موجود در فهرست راهنمای/libs
پروژه شما و مسیر ساخت) - یک برنامه اندرویدی که می توانید از آن برای پیاده سازی Google Analytics استفاده کنید
- حداقل یک ویژگی 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
خود مانند مثال زیر اضافه کنید:
package com.example.app; import android.app.Activity; import com.google.analytics.tracking.android.EasyTracker; /** * An example Activity using Google Analytics and EasyTracker. */ 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(this).activityStart(this); // Add this method. } @Override public void onStop() { super.onStop(); ... // The rest of your onStop() code. EasyTracker.getInstance(this).activityStop(this); // Add this method. } }
3. فایل analytics.xml خود را ایجاد کنید
هنگامی که از EasyTracker استفاده می کنید، تنظیمات پیکربندی جهانی با استفاده از منابع تعریف شده در XML مدیریت می شود. یک فایل به نام analytics.xml
در دایرکتوری res/values
پروژه خود ایجاد کنید و منابع زیر را اضافه کنید:
<?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 مراجعه کنید. بسته به نیازهای برنامه های کاربردی خود، ممکن است بخواهید دوره ارسال را تغییر دهید تا تأیید کنید که بازدیدها را به درستی ارسال می کنید. برای مثال اگر میخواهید دادههای زمان واقعی را ببینید، ممکن است بخواهید این مقدار را روی یک مقدار کم مانند 5s تنظیم کنید.
تبریک می گویم! اکنون برنامه شما برای ارسال داده به Google Analytics تنظیم شده است.
مراحل بعدی
با Google Analytics میتوانید کارهای بیشتری انجام دهید، از جمله اندازهگیری کمپینها، پرداختها و تراکنشهای درونبرنامه، و رویدادهای تعامل با کاربر.
راهنمای توسعهدهنده زیر جزئیات بیشتری در مورد نحوه پیادهسازی ویژگیهای Google Analytics در برنامه شما ارائه میدهد:
- اندازهگیری رویدادها – یاد بگیرید که چگونه تعامل کاربر را با محتوای تعاملی مانند دکمهها، ویدیوها و سایر رسانهها با استفاده از رویدادها اندازهگیری کنید.
- اندازه گیری پرداخت های درون برنامه ای – نحوه اندازه گیری پرداخت ها و تراکنش های درون برنامه ای را بیاموزید.
- اندازهگیری کمپینها – نحوه اجرای اندازهگیری کمپین را بیاموزید تا بفهمید کدام کانالها و کمپینها باعث نصب اپلیکیشن میشوند.
- زمانبندی کاربر – نحوه اندازهگیری زمانبندی کاربر در برنامه خود را برای اندازهگیری زمان بارگذاری، تعامل با رسانه و موارد دیگر بیاموزید.
- پیکربندی پیشرفته - درباره گزینه های پیکربندی پیشرفته، از جمله استفاده از ردیاب های متعدد بیشتر بدانید.
- پارامترهای Analytics.xml – لیست کامل پارامترهای پیکربندی
analytics.xml
را ببینید.