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

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

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

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

หากคุณเป็นนักพัฒนาแอป Apple โปรดทำความคุ้นเคยกับ API การซื้อในแอปของ Apple StoreKit 1 และ StoreKit 2 โดยอ่านเอกสารประกอบของ 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+KTX

หากต้องการบันทึกเหตุการณ์ IAP ให้ลิงก์กับ Google Play

Java

หากต้องการบันทึกเหตุการณ์ IAP ให้ลิงก์กับ Google Play