การซื้อในแอป (IAP) คือเนื้อหาดิจิทัลหรือฟีเจอร์ที่คุณสามารถขายในแอปบนอุปกรณ์เคลื่อนที่ผ่าน Google Play หรือ Apple App Store เพื่อให้แอปไม่ต้อง ประมวลผลธุรกรรมทางการเงิน ตัวอย่างของการซื้อในแอป ได้แก่ เนื้อหาตามการสมัครใช้บริการหรือไอเท็มพิเศษในเกม
Analytics แสดงเหตุการณ์ IAP ในรายงานการซื้อในแอป
สำหรับแอป Android Analytics SDK จะผสานรวมกับ Google Play สำหรับแอปแพลตฟอร์ม Apple นั้น SDK จะผสานรวมกับ Apple App Store โดยใช้ API ของ StoreKit 1 และ StoreKit 2 จาก Apple
ในกรณีส่วนใหญ่ Analytics SDK จะรวบรวมเหตุการณ์ IAP โดยอัตโนมัติโดยไม่จำเป็นต้องเรียกใช้ API ในแอปของคุณ คู่มือนี้จะอธิบายวิธีตั้งค่าโปรเจ็กต์สำหรับการติดตามอัตโนมัติ และอธิบายกรณีพิเศษบางกรณีที่ต้องใช้โค้ดเพียงไม่กี่บรรทัดในการติดตั้งใช้งาน
ก่อนเริ่มต้น
ตั้งค่าโปรเจ็กต์ Firebase และโค้ดเบสของแอปตามที่อธิบายไว้ในเริ่มต้นใช้งาน Google Analytics
สำหรับแอปแพลตฟอร์ม Apple ให้ทำดังนี้
- ตรวจสอบว่าแอปของคุณใช้ Analytics SDK เวอร์ชัน 6.20.0 ขึ้นไป
สำหรับแอป Android
- ตรวจสอบว่าแอปของคุณใช้ Analytics SDK เวอร์ชัน 17.3.0 ขึ้นไป (หรือ Firebase Android BoM เวอร์ชัน 25.2.0 ขึ้นไป)
- ลิงก์แอป Firebase กับ Google Play
หากกำลังพัฒนาแอป Android คุณจะวัดเหตุการณ์ IAP ได้ทันทีที่ลิงก์กับ Google Play ส่วนที่เหลือของคู่มือนี้จะมุ่งเน้นที่แอปในแพลตฟอร์มของ Apple
หากคุณเป็นนักพัฒนาแอปของ Apple โปรดทำความคุ้นเคยกับ API การซื้อในแอป StoreKit 1 และ StoreKit 2 ของ Apple โดยอ่านเอกสารประกอบของ Apple
การใช้งาน
Swift
หากคุณใช้ StoreKit 1 Analytics SDK จะบันทึกเหตุการณ์ IAP โดยอัตโนมัติ
หากใช้ StoreKit 2 ให้ใช้โค้ดต่อไปนี้เพื่อบันทึกเหตุการณ์ IAP
import StoreKit import FirebaseAnalytics // A user tapped a button to purchase an item. func userTappedPurchaseUpgradeButton() { let product = ... purchaseSomeProduct(product) } func purchaseSomeProduct(_ product: Product) { // Purchase a Product. This is mostly standard boilerplate StoreKit 2 // code, except for the Analytics.logTransaction() call. let result = try await product.purchase() switch result { case .success(let verification): let transaction = try checkVerified(verification) // Call this Firebase API to log the in-app purchase event. Analytics.logTransaction(transaction) await transaction.finish() ... }
Objective-C
หากคุณใช้ StoreKit 1 Analytics SDK จะบันทึกเหตุการณ์ IAP โดยอัตโนมัติ
StoreKit 2 ใช้ได้เฉพาะ Swift เท่านั้น จึงไม่รองรับการใช้งาน Objective-C
Kotlin
หากต้องการบันทึกเหตุการณ์ IAP ให้ลิงก์ไปยัง Google Play
Java
หากต้องการบันทึกเหตุการณ์ IAP ให้ลิงก์ไปยัง Google Play