เพิ่ม Google Analytics สำหรับ Firebase ลงใน Instant App

คำเตือน: Google Play Instant จะไม่มีให้บริการอีกต่อไป ตั้งแต่เดือนธันวาคม 2025 เป็นต้นไป คุณจะไม่สามารถเผยแพร่ Instant Apps ผ่าน Google Play ได้ และInstant API ของบริการ Google Play ทั้งหมดจะหยุดทำงาน Play จะไม่แสดงแอปด่วนต่อผู้ใช้โดยใช้กลไกใดๆ อีกต่อไป

เราทำการเปลี่ยนแปลงนี้ตามความคิดเห็นของนักพัฒนาแอปและการลงทุนอย่างต่อเนื่อง เพื่อปรับปรุงระบบนิเวศตั้งแต่เปิดตัว Google Play Instant

เราขอแนะนำให้นักพัฒนาแอปนำผู้ใช้ไปยัง แอปหรือเกมปกติของตนโดยใช้ Deep Link เพื่อเปลี่ยนเส้นทางผู้ใช้ไปยังเส้นทางหรือฟีเจอร์ที่เฉพาะเจาะจงเมื่อเกี่ยวข้อง เพื่อเพิ่มประสิทธิภาพในการเพิ่มผู้ใช้อย่างต่อเนื่อง

การติดตามความสำเร็จของแอป ไม่ว่าจะเป็น Instant App หรือแอปที่ติดตั้งแล้วถือเป็นสิ่งสำคัญสำหรับนักพัฒนาแอปทุกคน ไลบรารีข้อมูลวิเคราะห์หลายรายการใช้ได้กับ Google Play Instant ซึ่งรวมถึง Fabric Answers Localytics และ Mixpanel

หากโซลูชันการวิเคราะห์ปัจจุบันของคุณไม่อยู่ในรายการ หรือหากพบว่าโซลูชันดังกล่าวใช้กับ Google Play Instant ไม่ได้ ให้ลองใช้ Google Analytics สําหรับ Firebase เป็นโซลูชันการวัดและส่งข้อมูลของคุณ หน้านี้อธิบายวิธีตั้งค่า Google Analytics สำหรับ Firebase ในโปรเจ็กต์ Instant App

การเพิ่ม Google Analytics สำหรับ Firebase ลงในโปรเจ็กต์ Instant App

1. เพิ่ม Firebase SDK ลงในแอปโดยทําตามวิธีการ ที่อธิบายไว้ในคู่มือเริ่มต้นใช้งาน Google Analytics สําหรับ Firebase
2. ใช้ปลั๊กอิน google-services เวอร์ชันล่าสุด
3. วางgoogle-services.jsonในแต่ละโมดูล

4. เพิ่มบรรทัดต่อไปนี้ลงในไฟล์ build.gradle ของแต่ละโมดูล

   Groovy

   // android { ... }
   // dependencies { ... }
   plugins {
       id 'com.google.gms.google-services'
   }

   Kotlin

   // android { ... }
   // dependencies { ... }
   plugins {
       id("com.google.gms.google-services")
   }

เมื่อเพิ่ม Google Analytics สําหรับ Firebase ลงในโปรเจ็กต์ Instant App แล้ว คุณจะใช้ API ของ Google Analytics สําหรับ Firebase ได้เหมือนกับในโปรเจ็กต์แอปที่ติดตั้งได้

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้ API ของ Google Analytics สำหรับ Firebase ได้ใน เอกสารประกอบการเริ่มต้นใช้งาน Google Analytics สำหรับ Firebase

แยกความแตกต่างระหว่างข้อมูลแอปที่ติดตั้งและ Instant App

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

หมายเหตุ: ทั้งแอปด่วนและแอปที่ติดตั้งต้องใช้พร็อพเพอร์ตี้ผู้ใช้ app_type นอกจากนี้ คุณต้องเผยแพร่แอปที่ติดตั้งซึ่งมี app_type ก่อน Instant App ไม่เช่นนั้น Analytics จะบันทึกเหตุการณ์ของแอปที่ติดตั้งไปยัง Instant App เมื่อผู้ใช้ติดตั้งแอป

ข้อมูลโค้ดต่อไปนี้แสดงกิจกรรมที่รับอินสแตนซ์ Analytics แล้วตั้งค่าพร็อพเพอร์ตี้ผู้ใช้ โปรดทราบว่า โค้ดใช้ PackageManagerCompat.isInstantApp() ในเมธอด onCreate(android.os.Bundle) เพื่อกำหนดบริบทของแอป

Kotlin

val STATUS_INSTALLED = "installed"
val STATUS_INSTANT = "instant"
val ANALYTICS_USER_PROP = "app_type"

private lateinit var firebaseAnalytics: FirebaseAnalytics

protected fun onCreate(savedInstanceState: Bundle?) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this)

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT)
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED)
    }
}

Java

final String STATUS_INSTALLED = "installed";
final String STATUS_INSTANT = "instant";
final String ANALYTICS_USER_PROP = "app_type";

private FirebaseAnalytics firebaseAnalytics;

@Override
protected void onCreate(Bundle savedInstanceState) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this);

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT);
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED);
    }

}

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

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

การตีความเหตุการณ์ Analytics

Analytics ช่วยให้คุณติดตามเมตริกต่างๆ ที่มีประโยชน์ ต่อ Instant App ได้ ตารางต่อไปนี้อธิบายเมตริกที่เกี่ยวข้องสําหรับ Instant App รวมถึงชื่อเหตุการณ์หรือพร็อพเพอร์ตี้ที่เกี่ยวข้องใน Analytics

ชื่อ	มูลค่า Analytics	คำจำกัดความ
การพบแพทย์	session_start	เซสชันเริ่มแล้ว ระบบจะติดตามเหตุการณ์นี้โดยอัตโนมัติ
การซื้อในร้านค้า	Firebase.Event.ECOMMERCE_PURCHASE	การซื้อที่ร้านค้า คุณต้องติดตามเหตุการณ์นี้อย่างชัดเจน ในโค้ด
การซื้อแบบดิจิทัล	in_app_purchase	การซื้อในแอปแบบดิจิทัล ระบบจะติดตามเหตุการณ์นี้โดยอัตโนมัติ
เวลาในแอป	user_engagement	ระยะเวลาที่แอปทำงานอยู่เบื้องหน้า ระบบจะติดตามเหตุการณ์นี้โดยอัตโนมัติ
บริบทของ Instant App	app_type	เหตุการณ์ที่เกิดขึ้นจากแอปที่ทำงานในบริบทของแอปด่วนหรือแอปที่ติดตั้ง คุณต้องติดตามเหตุการณ์นี้อย่างชัดเจน ในโค้ด ดูความแตกต่างระหว่าง ข้อมูลแอปที่ติดตั้งและ Instant App ด้านบน
ผู้เข้าชมที่กลับมา	session_start.count และ app_type	กลุ่มเป้าหมายของผู้ใช้ที่เข้าชม 2 ครั้งขึ้นไป คุณต้องติดตามเหตุการณ์ app_type อย่างชัดเจน ระบบจะติดตาม session_start ให้คุณ ดูการแยกความแตกต่าง ระหว่างข้อมูลแอปที่ติดตั้งกับ Instant App ด้านบน

ดูข้อมูลเพิ่มเติมเกี่ยวกับค่าคงที่สําหรับเหตุการณ์ที่คุณรวบรวมได้ใน Analytics ได้ที่ FirebaseAnalytics.Event