تجزیه و تحلیل را به برنامه اندروید خود اضافه کنید

این راهنما نشان می‌دهد که چگونه می‌توانید Analytics را به برنامه اندروید خود اضافه کنید تا فعالیت کاربر را در صفحه‌های نمایش نام‌گذاری شده اندازه‌گیری کنید. اگر هنوز برنامه ای ندارید و فقط می خواهید ببینید که Analytics چگونه کار می کند، به برنامه نمونه ما نگاهی بیندازید.

مورد نیاز : آخرین نسخه های:

پروژه خود را تنظیم کنید

فایل AndroidManifest.xml پروژه خود را به‌روزرسانی کنید تا شامل مجوزهای INTERNET و ACCESS_NETWORK_STATE باشد:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          package="com.example.analytics">

  <uses-permission android:name="android.permission.INTERNET"/>
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

  <application android:name="AnalyticsApplication">
    ...
  </application>
</manifest>

وابستگی زیر را به build.gradle در سطح پروژه خود اضافه کنید:

dependencies {
  // ...
  classpath 'com.google.gms:google-services:3.0.0'
}

وابستگی زیر را به خدمات Google Play به app/build.gradle اضافه کنید:

dependencies {
  // ...
  compile 'com.google.android.gms:play-services-analytics:10.2.4'
}

global_tracker.xml را ایجاد کنید

فایل app/src/res/xml/global_tracker.xml را با محتوای زیر ایجاد کنید:

<?xml version="1.0" encoding="utf-8"?>
<resources>
  <string name="ga_trackingId" translatable="false">${YOUR_TRACKING_ID}</string>
</resources>

شناسه ردیابی خود را جایگزین ${YOUR_TRACKING_ID} کنید.

ردیابی صفحه را اضافه کنید

در اینجا هر زمان که کاربر صفحه های برنامه شما را باز می کند یا تغییر می دهد، یک نمای صفحه با نام را برای Analytics ارسال می کنید. کد شما باید موارد زیر را انجام دهد:

  • ردیاب مشترک را از طریق یک زیر کلاس Application ارائه دهید.
  • روش برگشت به تماس را برای فعالیت پیش زمینه لغو کنید.
  • یک نام برای صفحه نمایش داده و ردیابی را اجرا کنید.

کاربرد

شما باید Application را زیر کلاس قرار دهید و یک روش کمکی ارائه کنید که ردیاب برنامه شما را برمی گرداند.</>

/*
 * Copyright Google Inc. All Rights Reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.google.samples.quickstart.analytics;

import android.app.Application;

import com.google.android.gms.analytics.GoogleAnalytics;
import com.google.android.gms.analytics.Tracker;

/**
 * This is a subclass of {@link Application} used to provide shared objects for this app, such as
 * the {@link Tracker}.
 */
public class AnalyticsApplication extends Application {

  private static GoogleAnalytics sAnalytics;
  private static Tracker sTracker;

  @Override
  public void onCreate() {
    super.onCreate();

    sAnalytics = GoogleAnalytics.getInstance(this);
  }

  /**
   * Gets the default {@link Tracker} for this {@link Application}.
   * @return tracker
   */
  synchronized public Tracker getDefaultTracker() {
    // To enable debug logging use: adb shell setprop log.tag.GAv4 DEBUG
    if (sTracker == null) {
      sTracker = sAnalytics.newTracker(R.xml.global_tracker);
    }

    return sTracker;
  }
}

AnalyticsApplication.java

فعالیت یا قطعه

فعالیتی را که می خواهید پیگیری کنید باز کنید. همچنین می‌توانید یک Fragment ردیابی کنید، اما مطمئن شوید که نمای صفحه را به درستی نشان می‌دهد.

برای به دست آوردن نمونه اشتراک‌گذاری شده Tracker ، روش onCreate از Activity یا Fragment را که می‌خواهید ردیابی کنید لغو کنید:

// Obtain the shared Tracker instance.
AnalyticsApplication application = (AnalyticsApplication) getApplication();
mTracker = application.getDefaultTracker();
MainActivity.java

روش مناسب را نادیده بگیرید، مانند onResume برای یک Activity یا onPageSelected برای ViewPager تا هنگام تغییر صفحه، وارد سیستم شوید.

Log.i(TAG, "Setting screen name: " + name);
mTracker.setScreenName("Image~" + name);
mTracker.send(new HitBuilders.ScreenViewBuilder().build());
MainActivity.java

کد ردیابی را به هر Activity یا Fragment که نمایشگر یک صفحه است اضافه کنید. اگر می‌خواهید بین نمایش‌های صفحه برنامه خود در Analytics تفاوت قائل شوید، حتماً یک نام در داخل هر Activity یا Fragment تنظیم کنید. تمام فعالیت‌های ثبت‌شده در ردیاب مشترک، جدیدترین نام صفحه نمایش را تا زمانی که جایگزین یا پاک شود ارسال می‌کند (تنظیم به null ).

یک رویداد ارسال کنید

برای ارسال یک رویداد، مقادیر فیلد صفحه را روی ردیاب تنظیم کنید، سپس ضربه را ارسال کنید. مثال زیر از HitBuilders.EventBuilder برای ارسال یک Event استفاده می کند:

mTracker.send(new HitBuilders.EventBuilder()
    .setCategory("Action")
    .setAction("Share")
    .build());
MainActivity.java

مراحل بعدی