Google Analytics SDK for Android v3 (Legacy) - شروع به کار

این سند نحوه شروع استفاده از Google Analytics SDK برای Android نسخه 3 را شرح می دهد.

قبل از اینکه شروع کنی

قبل از اجرای SDK، مطمئن شوید که موارد زیر را دارید:

شروع شدن

سه مرحله برای شروع کار با SDK وجود دارد:

  1. AndroidManifest.xml را به روز کنید
  2. روش های EasyTracker را اضافه کنید
  3. فایل 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 را ببینید.