การซื้อในแอป (IAP) คือเนื้อหาดิจิทัลหรือฟีเจอร์ที่คุณสามารถขายในแอปบนอุปกรณ์เคลื่อนที่ผ่าน Google Play หรือ Apple App Store เพื่อให้แอปของคุณไม่จำเป็นต้องประมวลผลธุรกรรมทางการเงิน ตัวอย่างของการซื้อในแอป ได้แก่ เนื้อหาตามการสมัครสมาชิกหรือชิ้นส่วนเกมพิเศษ
Analytics จะแสดงเหตุการณ์ IAP ใน รายงานการซื้อในแอป
สำหรับแอป Android นั้น Analytics SDK จะทำงานร่วมกับ Google Play สำหรับแอปแพลตฟอร์มของ Apple SDK จะทำงานร่วมกับ Apple App Store โดยใช้ StoreKit 1 และ StoreKit 2 API จาก Apple
ในกรณีส่วนใหญ่ Analytics SDK จะรวบรวมเหตุการณ์ IAP โดยอัตโนมัติโดยไม่ต้องมีการเรียก API ในแอปของคุณ คู่มือนี้จะอธิบายวิธีตั้งค่าโปรเจ็กต์ของคุณสำหรับการติดตามอัตโนมัติ และอธิบายกรณีพิเศษบางกรณีที่ต้องใช้โค้ดสองสามบรรทัดในการติดตั้ง
ก่อนที่คุณจะเริ่ม
ตั้งค่าโปรเจ็กต์ Firebase และโค้ดเบสของแอปตามที่อธิบายไว้ใน เริ่มต้นใช้งาน Google Analytics
สำหรับแอปแพลตฟอร์ม Apple:
- ตรวจสอบให้แน่ใจว่าแอปของคุณใช้ Analytics SDK v6.20.0+
สำหรับแอป Android:
- ตรวจสอบให้แน่ใจว่าแอปของคุณใช้ Analytics SDK v17.3.0+ (หรือ Firebase Android BoM v25.2.0+)
- เชื่อมโยงแอป Firebase ของคุณกับ Google Play
หากคุณกำลังพัฒนาแอป Android คุณสามารถวัดเหตุการณ์ IAP ได้ทันทีที่ลิงก์กับ Google Play ส่วนที่เหลือของคู่มือนี้จะเน้นไปที่แอพแพลตฟอร์มของ Apple
หากคุณเป็นนักพัฒนาของ Apple ตรวจสอบให้แน่ใจว่าคุณคุ้นเคยกับ API การซื้อในแอปของ Apple StoreKit 1 และ StoreKit 2 โดยอ่าน เอกสารประกอบของ Apple
การนำไปปฏิบัติ
สวิฟท์
หากคุณใช้ 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() ... }
วัตถุประสงค์-C
หากคุณใช้ StoreKit 1 Analytics SDK จะบันทึกเหตุการณ์ IAP โดยอัตโนมัติ
StoreKit 2 ใช้งานได้กับ Swift เท่านั้น ดังนั้นจึงไม่รองรับการใช้งาน Objective-C
Kotlin+KTX
หากต้องการบันทึกเหตุการณ์ IAP ให้เชื่อมโยงกับ Google Play
Java
หากต้องการบันทึกเหตุการณ์ IAP ให้เชื่อมโยงกับ Google Play