Pembelian dalam aplikasi (IAP) adalah konten atau fitur digital yang dapat Anda jual di aplikasi seluler melalui Google Play atau Apple App Store sehingga aplikasi Anda tidak perlu memproses transaksi keuangan. Contoh pembelian dalam aplikasi mencakup konten berbasis langganan atau bagian game khusus.
Analytics menampilkan peristiwa IAP dalam laporan Pembelian dalam aplikasi.
Untuk aplikasi Android, Analytics SDK terintegrasi dengan Google Play. Untuk aplikasi platform Apple, SDK terintegrasi dengan Apple App Store menggunakan StoreKit 1 dan StoreKit 2 API dari Apple.
Pada umumnya, Analytics SDK mengumpulkan peristiwa IAP secara otomatis tanpa memerlukan panggilan API di aplikasi Anda. Panduan ini menjelaskan cara menyiapkan project Anda untuk pelacakan otomatis, dan menjelaskan beberapa kasus khusus yang memerlukan beberapa penerapan baris kode.
Sebelum memulai
Siapkan project Firebase dan codebase aplikasi Anda seperti yang dijelaskan dalam artikel Memulai Google Analytics.
Tautkan project Firebase Anda ke properti Google Analytics 4.
Untuk aplikasi platform Apple:
- Pastikan aplikasi Anda menggunakan Analytics SDK v6.20.0+.
Untuk aplikasi Android:
- Pastikan aplikasi Anda menggunakan Analytics SDK v17.3.0+ (atau Firebase Android BoM v25.2.0+).
- Tautkan aplikasi Firebase Anda ke Google Play.
Jika mengembangkan aplikasi Android, Anda dapat mengukur peristiwa IAP segera setelah menautkan ke Google Play. Bagian selanjutnya dalam panduan ini difokuskan pada aplikasi platform Apple.
Jika Anda adalah developer Apple, pastikan Anda sudah memahami API pembelian dalam aplikasi Apple StoreKit 1 dan StoreKit 2 dengan meninjau dokumentasi Apple.
Penerapan
Swift
Jika Anda menggunakan StoreKit 1, Analytics SDK secara otomatis akan mencatat peristiwa IAP ke dalam log.
Jika Anda menggunakan StoreKit 2, gunakan kode berikut untuk mencatat peristiwa IAP ke dalam log.
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
Jika Anda menggunakan StoreKit 1, Analytics SDK secara otomatis akan mencatat peristiwa IAP ke dalam log.
StoreKit 2 hanya tersedia untuk Swift, sehingga implementasi Objective-C tidak didukung.
Kotlin+KTX
Untuk mencatat peristiwa IAP ke dalam log, tautkan ke Google Play.
Java
Untuk mencatat peristiwa IAP ke dalam log, tautkan ke Google Play.