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

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

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

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

สำหรับแอปแพลตฟอร์ม 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

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

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

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

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

การใช้งาน

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

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

หรือหากต้องการติดตามการซื้อในแอปที่ทำนอก App Store คุณสามารถบันทึกเหตุการณ์ IAP ใน WebView ด้วยตนเอง โปรดทราบว่า SDK จะยังคงบันทึกการซื้อในแอปโดยอัตโนมัติต่อไปเมื่อเป็นไปได้ และจะไม่ขจัดเหตุการณ์ in_app_purchase ที่บันทึกด้วยตนเองที่ซ้ำกัน ตรวจสอบว่าคุณใช้ 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