Google Analytics SDK สำหรับ Android v3 (เดิม) - เริ่มต้นใช้งาน

เอกสารนี้จะอธิบายวิธีเริ่มต้นใช้งาน Google Analytics SDK สำหรับ Android v3

ก่อนที่คุณจะเริ่ม

ก่อนติดตั้งใช้งาน SDK โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้

เริ่มกระบวนการ

มี 3 ขั้นตอนในการเริ่มต้นใช้งาน 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>

เครื่องมือตรวจสอบ Lint อาจเตือนคุณเกี่ยวกับการใช้เครื่องหมายขีดกลาง ("-") ในรหัสติดตาม คุณระงับคำเตือนดังกล่าวได้โดยเพิ่มแอตทริบิวต์อื่นไปยังแท็ก <resources> ดังนี้

<resources xmlns:tools="http://schemas.android.com/tools"
tools:ignore="TypographyDashes">

ดูข้อมูลอ้างอิงพารามิเตอร์ analytics.xml เพื่อดูรายการพารามิเตอร์ทั้งหมดที่คุณใช้เพื่อกำหนดค่าการใช้งานได้ คุณอาจต้องการเปลี่ยนระยะเวลาการจัดส่งเพื่อยืนยันว่ามีการส่ง Hit อย่างถูกต้อง ทั้งนี้ขึ้นอยู่กับข้อกำหนดของแอปพลิเคชัน ตัวอย่างเช่น หากต้องการดูข้อมูลแบบเรียลไทม์ คุณอาจต้องตั้งค่านี้เป็นค่าต่ำ เช่น 5s

ยินดีด้วย ตอนนี้แอปของคุณได้รับการตั้งค่าให้ส่งข้อมูลไปยัง Google Analytics แล้ว

ขั้นตอนถัดไป

คุณสามารถทำสิ่งต่างๆ ได้มากขึ้นด้วย Google Analytics รวมถึงการวัดผลแคมเปญ การซื้อในแอปและธุรกรรม รวมถึงเหตุการณ์การโต้ตอบของผู้ใช้

คู่มือนักพัฒนาซอฟต์แวร์ต่อไปนี้มีรายละเอียดเพิ่มเติมเกี่ยวกับวิธีนำฟีเจอร์ Google Analytics ไปใช้ในแอป

  • การวัดเหตุการณ์ – ดูวิธีวัดการมีส่วนร่วมของผู้ใช้กับเนื้อหาเชิงโต้ตอบ เช่น ปุ่ม วิดีโอ และสื่ออื่นๆ โดยใช้เหตุการณ์
  • การวัดผล In-App Payments – เรียนรู้วิธี วัดการชำระเงินและธุรกรรมในแอป
  • การวัดผลแคมเปญ – ดูวิธีใช้การวัดผลแคมเปญเพื่อทำความเข้าใจว่าแชแนลและแคมเปญใดทําให้เกิดการติดตั้งแอป
  • ระยะเวลาของผู้ใช้ – ดูวิธีวัดเวลาของผู้ใช้ในแอปเพื่อวัดเวลาที่ใช้ในการโหลด การมีส่วนร่วมกับสื่อ และอื่นๆ
  • การกำหนดค่าขั้นสูง - ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวเลือกการกำหนดค่าขั้นสูง รวมถึงการใช้เครื่องมือติดตามหลายรายการ
  • พารามิเตอร์ Analytics.xml - ดูรายการพารามิเตอร์การกําหนดค่า analytics.xml ทั้งหมด