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

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

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

หากกำลังพัฒนาแอป 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