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

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

เราทำการเปลี่ยนแปลงนี้ตามความคิดเห็นของนักพัฒนาแอปและการลงทุนอย่างต่อเนื่อง เพื่อปรับปรุงระบบนิเวศตั้งแต่มีการเปิดตัว 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 ของแต่ละโมดูล

   ดึงดูด

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

   Kotlin

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

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

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

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

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

หมายเหตุ: ทั้ง Instant App และแอปที่ติดตั้งแล้วต้องใช้พร็อพเพอร์ตี้ผู้ใช้ 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 ได้ การคาดการณ์ข้อมูลที่ได้จะแสดงจำนวนเหตุการณ์ที่ระบุใน Instant App หรือแอปที่ติดตั้งแล้ว

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีบันทึกและดูเหตุการณ์ใน 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 หรือแอปที่ติดตั้งแล้ว คุณต้องติดตามเหตุการณ์นี้อย่างชัดเจนในโค้ด ดูหัวข้อ การแยกความแตกต่างระหว่าง ข้อมูลแอปที่ติดตั้งแล้วกับข้อมูล Instant App ด้านบน
ผู้เข้าชมที่กลับมา	session_start.count และ app_type	กลุ่มเป้าหมายของผู้ใช้ที่เข้าชม 2 ครั้งขึ้นไป คุณต้องติดตามเหตุการณ์ app_type อย่างชัดเจน ส่วนระบบจะติดตาม session_start ให้คุณ ดูหัวข้อ การแยกความแตกต่าง ระหว่างข้อมูลแอปที่ติดตั้งแล้วกับข้อมูล Instant App ด้านบน

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