Mengukur pembelian dalam aplikasii

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 akan otomatis mengumpulkan peristiwa IAP tanpa memerlukan panggilan API di aplikasi Anda. Di iOS, Anda juga dapat mencatat peristiwa IAP ke dalam log secara manual di WebView sebagai tambahan peristiwa IAP yang dikumpulkan secara otomatis. 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 Mulai Menggunakan Google Analytics.
Tautkan project Firebase Anda ke properti Google Analytics 4.

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.

Catatan: Untuk aplikasi Android, Anda dapat mengukur peristiwa IAP segera setelah aplikasi ditautkan ke Google Play. Bagian selanjutnya dalam panduan ini difokuskan pada aplikasi platform Apple.

Aplikasi platform Apple

Pastikan Anda menggunakan SDK terbaru:
- Untuk pelacakan pembelian dalam aplikasi otomatis: Pastikan aplikasi Anda menggunakan Analytics SDK v6.20.0 atau yang lebih tinggi.
- Untuk pelacakan pembelian dalam aplikasi manual: Pastikan aplikasi Anda menggunakan Analytics SDK v12.5.0 atau yang lebih tinggi.
Pastikan Anda sudah memahami API pembelian dalam aplikasi Apple StoreKit 1 dan StoreKit 2 dengan meninjau dokumentasi Apple.

Penerapan

Pada umumnya, Analytics SDK akan otomatis mencatat peristiwa IAP ke dalam log tanpa memerlukan kode tambahan.

Penerapan di aplikasi Android

Untuk aplikasi Android, Anda dapat mengukur peristiwa IAP segera setelah aplikasi ditautkan ke Google Play.

Penerapan di aplikasi platform Apple

Untuk aplikasi iOS, jika Anda menggunakan StoreKit 1, Analytics SDK akan otomatis mencatat peristiwa IAP ke dalam log. Jika menggunakan StoreKit 2, Anda dapat mencatat peristiwa pembelian dalam aplikasi terverifikasi ke dalam log menggunakan cuplikan kode di bawah.

Jika Anda perlu melacak pembelian dalam aplikasi yang dilakukan di luar App Store, Anda juga dapat mencatat peristiwa IAP ke dalam log secara manual di WebView. Perhatikan bahwa SDK akan terus mencatat pembelian dalam aplikasi ke dalam log secara otomatis jika memungkinkan. Selain itu, SDK ini tidak akan menghapus duplikat peristiwa pembelian dalam aplikasi yang dicatat ke dalam log secara manual. Pastikan Anda menggunakan Analytics SDK v12.5.0 atau yang lebih tinggi saat melacak pembelian dalam aplikasi secara manual.

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