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

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


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

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

สำหรับแอป Android นั้น Analytics SDK จะผสานรวมกับ Google Play

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

  • คุณสามารถบันทึกเหตุการณ์การซื้อในแอปจากแอปได้โดยตรงโดยไม่ต้องโต้ตอบกับ Play Store

  • นอกจากนี้ คุณยังบันทึกเหตุการณ์ IAP ด้วยตนเองใน WebView ได้ด้วย

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

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

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

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

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

    • สำหรับการติดตามการซื้อในแอป อัตโนมัติ ให้ตรวจสอบว่าแอป ใช้ Analytics เวอร์ชัน 17.3.0 ขึ้นไป (หรือ Firebase Android BoM เวอร์ชัน 25.2.0 ขึ้นไป)
    • สำหรับการติดตามการซื้อในแอป ด้วยตนเอง ให้ตรวจสอบว่าแอปใช้ Analytics SDK เวอร์ชัน 23.2.0 ขึ้นไป (หรือ Firebase Android BoM เวอร์ชัน 34.10.0 ขึ้นไป)
  • ลิงก์แอป Firebase กับ Google Play

การใช้งาน

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

สำหรับแอป Android คุณสามารถวัดเหตุการณ์ IAP ได้ทันทีที่ ลิงก์กับ Google Play

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

หากต้องการติดตามการซื้อในแอปด้วยตนเอง ให้ตรวจสอบว่าคุณใช้ Analytics SDK เวอร์ชัน 23.2.0 ขึ้นไป (หรือ Firebase Android BoM เวอร์ชัน 34.10.0 ขึ้นไป)

Kotlin

import android.os.Bundle
import com.google.firebase.analytics.FirebaseAnalytics

class MyClass(val analytics: FirebaseAnalytics) {

  ...

  fun logInAppPurchaseEvent(itemName: String, value: Double, currency: String) {
    val params = Bundle()
    params.putString(FirebaseAnalytics.Param.ITEM_NAME, itemName)
    params.putDouble(FirebaseAnalytics.Param.VALUE, value)
    params.putString(FirebaseAnalytics.Param.CURRENCY, currency)
    analytics.logEvent(FirebaseAnalytics.Event.IN_APP_PURCHASE, params)
  }
}

Java

import android.os.Bundle;
import com.google.firebase.analytics.FirebaseAnalytics;

public class MyClass {
  private FirebaseAnalytics analytics;

  ...

  public void logInAppPurchaseEvent(String itemName, Double value, String currency) {
    Bundle params = new Bundle();
    params.putString(FirebaseAnalytics.Param.ITEM_NAME, itemName);
    params.putDouble(FirebaseAnalytics.Param.VALUE, value);
    params.putString(FirebaseAnalytics.Param.CURRENCY, currency);
    analytics.logEvent(FirebaseAnalytics.Event.IN_APP_PURCHASE, params);
  }
}