این راهنما نشان میدهد که چگونه میتوانید 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;
}
}
فعالیت یا قطعه
فعالیتی را که می خواهید پیگیری کنید باز کنید. همچنین میتوانید یک Fragment
ردیابی کنید، اما مطمئن شوید که نمای صفحه را به درستی نشان میدهد.
برای به دست آوردن نمونه اشتراکگذاری شده Tracker
، روش onCreate
از Activity
یا Fragment
را که میخواهید ردیابی کنید لغو کنید:
// Obtain the shared Tracker instance.
AnalyticsApplication application = (AnalyticsApplication) getApplication();
mTracker = application.getDefaultTracker();
روش مناسب را نادیده بگیرید، مانند onResume
برای یک Activity
یا onPageSelected
برای ViewPager
تا هنگام تغییر صفحه، وارد سیستم شوید.
Log.i(TAG, "Setting screen name: " + name);
mTracker.setScreenName("Image~" + name);
mTracker.send(new HitBuilders.ScreenViewBuilder().build());
کد ردیابی را به هر Activity
یا Fragment
که نمایشگر یک صفحه است اضافه کنید. اگر میخواهید بین نمایشهای صفحه برنامه خود در Analytics تفاوت قائل شوید، حتماً یک نام در داخل هر Activity
یا Fragment
تنظیم کنید. تمام فعالیتهای ثبتشده در ردیاب مشترک، جدیدترین نام صفحه نمایش را تا زمانی که جایگزین یا پاک شود ارسال میکند (تنظیم به null
).
یک رویداد ارسال کنید
برای ارسال یک رویداد، مقادیر فیلد صفحه را روی ردیاب تنظیم کنید، سپس ضربه را ارسال کنید. مثال زیر از HitBuilders.EventBuilder
برای ارسال یک Event
استفاده می کند:
mTracker.send(new HitBuilders.EventBuilder()
.setCategory("Action")
.setAction("Share")
.build());
مراحل بعدی
راهنمای پیادهسازی اپلیکیشن موبایل را بخوانید تا نحوه استفاده از Google Analytics برای اندازهگیری تعاملات کاربر و پاسخ به سؤالات مربوط به استفاده از برنامه را بیاموزید.
گزینه های پیکربندی اضافی مانند نمونه برداری، آزمایش و اشکال زدایی، تنظیمات انصراف و غیره را مرور کنید.
اگر برنامه شما نیاز به جمع آوری شناسه های تبلیغاتی دارد، ویژگی های تبلیغاتی را برای برنامه فعال کنید.