Đo lường lượt mua hàng trong ứng dụng

Chọn nền tảng: iOS+ Android


Giao dịch mua hàng trong ứng dụng (IAP) là giao dịch mà trong đó, bạn có thể bán nội dung hoặc tính năng kỹ thuật số trong một ứng dụng dành cho thiết bị di động thông qua Apple App Store. Do đó, ứng dụng của bạn không phải xử lý các giao dịch tài chính. Ví dụ về giao dịch mua hàng trong ứng dụng bao gồm nội dung dựa trên gói thuê bao hoặc các yếu tố đặc biệt trong trò chơi.

Analytics hiển thị các sự kiện IAP trong báo cáo Giao dịch mua hàng trong ứng dụng.

Đối với các ứng dụng trên nền tảng Apple, SDK tích hợp với Apple App Store bằng cách sử dụng API StoreKit 1 và StoreKit 2 của Apple.

Trong hầu hết các trường hợp, SDK Analytics sẽ tự động thu thập các sự kiện IAP mà không cần lệnh gọi API trong ứng dụng của bạn. Trên iOS, bạn cũng có thể ghi lại các sự kiện IAP theo cách thủ công trong WebView ngoài các sự kiện IAP được thu thập tự động. Hướng dẫn này giải thích cách thiết lập dự án để theo dõi tự động và mô tả một số trường hợp đặc biệt cần triển khai một vài dòng mã.

Trước khi bắt đầu

  • Thiết lập dự án Firebase và cơ sở mã của ứng dụng như mô tả trong Bắt đầu sử dụng Google Analytics.

  • Liên kết dự án Firebase với một tài sản Google Analytics 4.

  • Đảm bảo rằng bạn đang sử dụng SDK mới nhất:

    • Đối với tính năng theo dõi giao dịch mua hàng trong ứng dụng tự động: Đảm bảo rằng ứng dụng của bạn đang sử dụng SDK Analytics phiên bản 6.20.0 trở lên.

    • Đối với tính năng theo dõi giao dịch mua hàng trong ứng dụng thủ công: Đảm bảo rằng ứng dụng của bạn đang sử dụng Analytics SDK phiên bản 12.5.0 trở lên.

  • Đảm bảo rằng bạn đã làm quen với API giao dịch mua hàng trong ứng dụng Apple StoreKit 1 và StoreKit 2 bằng cách xem tài liệu của Apple.

Triển khai

Trong hầu hết các trường hợp, SDK Analytics sẽ tự động ghi lại các sự kiện IAP mà không cần thêm mã.

Đối với các ứng dụng iOS, nếu bạn đang sử dụng StoreKit 1, thì SDK Analytics sẽ tự động ghi lại các sự kiện IAP. Nếu đang sử dụng StoreKit 2, bạn có thể ghi lại các sự kiện giao dịch mua hàng trong ứng dụng đã xác minh bằng đoạn mã bên dưới.

Ngoài ra, nếu cần theo dõi các giao dịch mua hàng trong ứng dụng được thực hiện bên ngoài App Store, bạn có thể ghi lại các sự kiện IAP theo cách thủ công trong WebView. Xin lưu ý rằng SDK sẽ tiếp tục tự động ghi lại các giao dịch mua hàng trong ứng dụng nếu có thể và sẽ không loại bỏ các sự kiện giao dịch mua hàng trong ứng dụng được ghi lại theo cách thủ công. Đảm bảo rằng bạn đang sử dụng SDK Analytics phiên bản 12.5.0 trở lên khi theo dõi giao dịch mua hàng trong ứng dụng theo cách thủ công.

Swift

Nếu bạn đang sử dụng StoreKit 1, thì Analytics SDK sẽ tự động ghi lại các sự kiện IAP.

Nếu bạn đang sử dụng StoreKit 2, hãy dùng mã sau để ghi lại các sự kiện IAP.

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

Nếu bạn đang sử dụng StoreKit 1, thì Analytics SDK sẽ tự động ghi lại các sự kiện IAP.

StoreKit 2 chỉ dành cho Swift, vì vậy, bạn không thể triển khai bằng Objective-C.