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

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


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

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

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

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

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

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

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

  • ตรวจสอบว่าคุณใช้ SDK เวอร์ชันล่าสุด โดยทำดังนี้

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

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

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

การใช้งาน

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

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

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

Swift

หากคุณใช้ StoreKit 1, SDK ของ Analytics จะบันทึกเหตุการณ์ 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, SDK ของ Analytics จะบันทึกเหตุการณ์ IAP โดยอัตโนมัติ

StoreKit 2 เป็น Swift เท่านั้น จึงไม่รองรับการใช้งาน Objective-C