เอกสารนี้จะอธิบายวิธีเริ่มต้นใช้งาน Google Analytics SDK สำหรับ Android v3
ก่อนที่คุณจะเริ่ม
ก่อนติดตั้งใช้งาน SDK โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้
- SDK สำหรับนักพัฒนาซอฟต์แวร์ Android (ใช้ได้กับ Windows, Mac OS X และ Linux)
- Google Analytics SDK สำหรับ Android v3 (ที่มี
libGoogleAnalyticsServices.jar
รวมอยู่ในไดเรกทอรี/libs
และเส้นทางบิลด์ของโปรเจ็กต์) - แอป Android ที่คุณสามารถใช้เพื่อนำ Google Analytics มาใช้
- พร็อพเพอร์ตี้ Google Analytics และข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ของ Google Analytics อย่างน้อย 1 รายการที่จะส่งข้อมูลจากแอป
เริ่มกระบวนการ
มี 3 ขั้นตอนในการเริ่มต้นใช้งาน SDK ดังนี้
หลังจากทำตามขั้นตอนเหล่านี้เสร็จแล้ว คุณจะวัดสิ่งต่อไปนี้ได้ด้วย 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
ทั้งหมด