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

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


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

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

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

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

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

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

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

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

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

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

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

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

การใช้งาน

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

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

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

หากต้องการติดตามการซื้อในแอปด้วยตนเอง ให้ตรวจสอบว่าคุณใช้ SDK Analytics v23.2.0 ขึ้นไป (หรือ Firebase Android BoM v34.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);
  }
}