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

เลือกแพลตฟอร์ม: iOS+ Android

การซื้อในแอป (IAP) คือเนื้อหาดิจิทัลหรือฟีเจอร์ที่คุณสามารถขายในแอปบนอุปกรณ์เคลื่อนที่ผ่าน Apple App Store เพื่อให้แอปไม่ต้องประมวลผลธุรกรรมทางการเงิน ตัวอย่างการซื้อในแอป ได้แก่ เนื้อหาตามการสมัครใช้บริการหรือไอเท็มพิเศษในเกม

Analytics จะแสดงเหตุการณ์ IAP ใน รายงานการซื้อในแอป

สำหรับแอปแพลตฟอร์ม Apple นั้น SDK จะผสานรวมกับ Apple App Store โดยใช้ StoreKit 1 และ StoreKit 2 API จาก Apple

ในกรณีส่วนใหญ่ Analytics SDK จะรวบรวมเหตุการณ์ IAP โดยอัตโนมัติโดยไม่ต้อง มีการเรียก API ในแอป นอกจากนี้ใน iOS คุณยังบันทึกเหตุการณ์ IAP ด้วยตนเอง ใน WebView นอกเหนือจากเหตุการณ์ IAP ที่รวบรวมโดยอัตโนมัติได้ด้วย คู่มือนี้จะอธิบายวิธีตั้งค่าโปรเจ็กต์สำหรับการติดตามอัตโนมัติ และอธิบายกรณีพิเศษบางกรณีที่ต้องใช้โค้ดเพียงไม่กี่บรรทัดในการติดตั้งใช้งาน

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

การใช้งาน

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

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

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

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