Mengukur pembelian dalam aplikasii

Pembelian dalam aplikasi (IAP) adalah konten atau fitur digital yang dapat Anda jual di aplikasi seluler melalui 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 platform Apple, SDK terintegrasi dengan Apple App Store menggunakan API StoreKit 1 dan StoreKit 2 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.

• 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.

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.

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()
  ...
}