เริ่มต้นกับ Google Analytics

การเริ่มต้นอย่างรวดเร็วนี้แสดงวิธีเพิ่ม Google Analytics ลงในแอปของคุณและเริ่มบันทึกเหตุการณ์

เว็บ iOS Android

Google Analytics รวบรวมข้อมูลการใช้งานและพฤติกรรมสำหรับแอปของคุณ SDK บันทึกข้อมูลหลักสองประเภท:

• เหตุการณ์: สิ่งที่เกิดขึ้นในแอปของคุณเช่นการกระทำของผู้ใช้เหตุการณ์ของระบบหรือข้อผิดพลาด
• คุณสมบัติของผู้ใช้: แอตทริบิวต์ที่คุณกำหนดเพื่ออธิบายกลุ่มของฐานผู้ใช้ของคุณเช่นค่ากำหนดภาษาหรือตำแหน่งทางภูมิศาสตร์

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

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

หากคุณยังไม่ได้ดำเนินการให้ เพิ่ม Firebase ในโครงการ Android ของคุณ และตรวจสอบให้แน่ใจว่าได้เปิดใช้ Google Analytics ในโครงการ Firebase ของคุณแล้ว:

• หากคุณกำลังสร้างโปรเจ็กต์ Firebase ใหม่ให้เปิดใช้ Google Analytics ในระหว่างขั้นตอนการสร้างโปรเจ็กต์

• หากคุณใช้โปรเจ็กต์ Firebase ที่มีอยู่ซึ่งไม่ได้เปิดใช้งาน Google Analytics ให้ไปที่แท็บ การผสานรวม ของ ของคุณ> การตั้งค่าโปรเจ็กต์ เพื่อเปิดใช้งาน

หมายเหตุ: โปรเจ็กต์ Firebase ที่สร้างก่อนวันที่ 31 กรกฎาคม 2019 สามารถอัปเกรดเป็นประสบการณ์ Google Analytics เต็มรูปแบบได้ฟรีจากแท็บ การผสานรวม ของ > การตั้งค่าโปรเจ็ก ต์ การอัพเกรดนี้เป็นทางเลือก แต่แนะนำ

เมื่อคุณเปิดใช้งาน Google Analytics ในโครงการของคุณแอป Firebase ของคุณจะเชื่อมโยงกับสตรีมข้อมูล Google Analytics

เพิ่ม Analytics SDK ลงในแอปของคุณ

1. ใช้ Firebase Android BoM ประกาศการอ้างอิงสำหรับไลบรารี Android Analytics ใน ไฟล์ Gradle ของ โมดูล ของคุณ (ระดับแอป) (โดยทั่วไปคือ app/build.gradle )

   Java

   dependencies {
       // Import the BoM for the Firebase platform
       implementation platform('com.google.firebase:firebase-bom:26.6.0')
   
       // Declare the dependency for the Analytics library
       // When using the BoM, you don't specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-analytics'
   }
   

   เมื่อใช้ Firebase Android BoM แอปของคุณจะใช้ไลบรารี Firebase Android เวอร์ชันที่เข้ากันได้เสมอ

   (ทางเลือก) ประกาศการอ้างอิงไลบรารี Firebase โดยไม่ต้อง ใช้ BoM

   หากคุณเลือกที่จะไม่ใช้ Firebase BoM คุณต้องระบุไลบรารี Firebase แต่ละเวอร์ชันในบรรทัดการอ้างอิง

   โปรดทราบว่าหากคุณใช้ไลบรารี Firebase หลาย ไลบรารีในแอปของคุณเราขอแนะนำอย่างยิ่งให้ใช้ BoM เพื่อจัดการเวอร์ชันไลบรารีซึ่งจะช่วยให้มั่นใจได้ว่าทุกเวอร์ชันจะเข้ากันได้

   dependencies {
       // Declare the dependency for the Analytics library
       // When NOT using the BoM, you must specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-analytics:18.0.2'
   }
   

   โคตรลิน + KTX

   dependencies {
       // Import the BoM for the Firebase platform
       implementation platform('com.google.firebase:firebase-bom:26.6.0')
   
       // Declare the dependency for the Analytics library
       // When using the BoM, you don't specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-analytics-ktx'
   }
   

   เมื่อใช้ Firebase Android BoM แอปของคุณจะใช้ไลบรารี Firebase Android เวอร์ชันที่เข้ากันได้เสมอ

   (ทางเลือก) ประกาศการอ้างอิงไลบรารี Firebase โดยไม่ต้อง ใช้ BoM

   หากคุณเลือกที่จะไม่ใช้ Firebase BoM คุณต้องระบุไลบรารี Firebase แต่ละเวอร์ชันในบรรทัดการอ้างอิง

   โปรดทราบว่าหากคุณใช้ไลบรารี Firebase หลาย ไลบรารีในแอปของคุณเราขอแนะนำอย่างยิ่งให้ใช้ BoM เพื่อจัดการเวอร์ชันไลบรารีซึ่งจะช่วยให้มั่นใจได้ว่าทุกเวอร์ชันจะเข้ากันได้

   dependencies {
       // Declare the dependency for the Analytics library
       // When NOT using the BoM, you must specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-analytics-ktx:18.0.2'
   }
   

2. ประกาศออบเจ็กต์ com.google.firebase.analytics.FirebaseAnalytics ที่ด้านบนของกิจกรรมของคุณ:

   Java

   private FirebaseAnalytics mFirebaseAnalytics;
   MainActivity.java

   โคตรลิน + KTX

   private lateinit var firebaseAnalytics: FirebaseAnalytics
   MainActivity.kt

3. เริ่มต้นใน onCreate() :

   Java

   // Obtain the FirebaseAnalytics instance.
   mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
   MainActivity.java

   โคตรลิน + KTX

   // Obtain the FirebaseAnalytics instance.
   firebaseAnalytics = Firebase.analytics
   MainActivity.kt

เริ่มบันทึกเหตุการณ์

หลังจากที่คุณสร้างอินสแตนซ์ FirebaseAnalytics คุณสามารถเริ่มบันทึกเหตุการณ์ด้วย logEvent()

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

รหัสต่อไปนี้บันทึกเหตุการณ์ SELECT_CONTENT เมื่อผู้ใช้คลิกที่องค์ประกอบเฉพาะในแอปของคุณ

Java

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
MainActivity.java

โคตรลิน + KTX

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}
MainActivity.kt

คุณสามารถเปิดใช้งานการบันทึกแบบละเอียดเพื่อตรวจสอบการบันทึกเหตุการณ์โดย SDK เพื่อช่วยตรวจสอบว่ามีการบันทึกเหตุการณ์อย่างถูกต้อง ซึ่งรวมถึงเหตุการณ์ที่บันทึกโดยอัตโนมัติและด้วยตนเอง

คุณสามารถเปิดใช้งานการบันทึกแบบละเอียดด้วยชุดคำสั่ง adb :

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

คำสั่งนี้แสดงเหตุการณ์ของคุณใน Android Studio logcat ช่วยให้คุณตรวจสอบได้ทันทีว่ามีการส่งเหตุการณ์

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

• ใช้ DebugView เพื่อตรวจสอบเหตุการณ์ของคุณ
• สำรวจข้อมูลของคุณใน คอนโซล Firebase
• สำรวจคำแนะนำเกี่ยวกับ เหตุการณ์ และ คุณสมบัติของผู้ใช้
• เรียนรู้วิธีส่งออกข้อมูลไปยัง BigQuery