วัดการซื้อในแอป

การซื้อในแอป (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 ในแอปของคุณ ใน iOS คุณยังบันทึกเหตุการณ์ IAP ด้วยตนเอง ใน WebView ได้ด้วย นอกเหนือจากเหตุการณ์ IAP ที่รวบรวมโดยอัตโนมัติ คู่มือนี้อธิบายวิธี ตั้งค่าโปรเจ็กต์สำหรับการติดตามอัตโนมัติ และอธิบายกรณีพิเศษบางกรณี ที่ต้องใช้โค้ด 2-3 บรรทัดในการติดตั้งใช้งาน

ก่อนเริ่มต้น

• ตั้งค่าโปรเจ็กต์ Firebase และโค้ดเบสของแอปตามที่อธิบายไว้ในเริ่มต้นใช้งาน Google Analytics

• ลิงก์โปรเจ็กต์ Firebase กับพร็อพเพอร์ตี้ Google Analytics 4

แอป Android

• ตรวจสอบว่าแอปของคุณใช้ Analytics SDK เวอร์ชัน 17.3.0 ขึ้นไป (หรือ Firebase Android BoM เวอร์ชัน 25.2.0 ขึ้นไป)

• ลิงก์แอป Firebase กับ Google Play

แอปแพลตฟอร์มของ Apple

• ตรวจสอบว่าคุณใช้ SDK เวอร์ชันล่าสุด

  • สําหรับการติดตามการซื้อในแอปอัตโนมัติ โปรดตรวจสอบว่าแอปของคุณ ใช้ Analytics SDK เวอร์ชัน 6.20.0 ขึ้นไป

  • สําหรับการติดตามการซื้อในแอปด้วยตนเอง โปรดตรวจสอบว่าแอปของคุณใช้ Analytics SDK เวอร์ชัน 12.5.0 ขึ้นไป

• โปรดทำความคุ้นเคยกับ API การซื้อในแอป StoreKit 1 และ StoreKit 2 ของ Apple โดยอ่านเอกสารประกอบของ Apple

การใช้งาน

ในกรณีส่วนใหญ่ SDK ของ Analytics จะบันทึกเหตุการณ์ IAP โดยอัตโนมัติโดยไม่ต้องใช้โค้ดเพิ่มเติม

การติดตั้งใช้งานในแอป Android

สำหรับแอป Android คุณจะวัดเหตุการณ์ IAP ได้ทันทีที่ ลิงก์กับ Google Play

การใช้งานในแอปแพลตฟอร์ม Apple

สําหรับแอป iOS หากคุณใช้ StoreKit 1 อยู่ SDK ของ Analytics จะบันทึก เหตุการณ์ IAP โดยอัตโนมัติ หากใช้ StoreKit 2 คุณจะบันทึกเหตุการณ์การซื้อในแอปที่ยืนยันแล้วได้โดยใช้ข้อมูลโค้ดด้านล่าง

หรือหากต้องการติดตามการซื้อในแอปที่ทำนอก App Store คุณสามารถบันทึกเหตุการณ์ IAP ด้วยตนเองใน WebView ได้ โปรดทราบว่า SDK จะยังคงบันทึกการซื้อในแอปโดยอัตโนมัติต่อไปเมื่อเป็นไปได้ และจะไม่ขจัดเหตุการณ์ in_app_purchase ที่บันทึกด้วยตนเองที่ซ้ำกัน ตรวจสอบว่าคุณใช้ Analytics SDK v12.5.0 ขึ้นไปเมื่อติดตามการซื้อในแอปด้วยตนเอง

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()
  ...
}