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

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 di động thông qua Google Play hoặc 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 cho thấy 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 Android, SDK Analytics sẽ tích hợp với Google Play. Đối với các ứng dụng nền tảng Apple, SDK này 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 giao dịch mua trong ứng dụng mà không yêu cầu lệnh gọi API trong ứng dụng của bạn. Trên iOS, bạn cũng có thể ghi nhật ký các sự kiện giao dịch mua trong ứng dụng theo cách thủ công trong WebView ngoài các sự kiện giao dịch mua trong ứng dụng đượ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 một vài dòng mã để triển khai.

Trước khi bắt đầu

Ứng dụng Android

  • Đảm bảo rằng ứng dụng của bạn đang sử dụng Analytics SDK phiên bản 17.3.0 trở lên (hoặc Firebase Android BoM phiên bản 25.2.0 trở lên).

  • Liên kết các ứng dụng Firebase với Google Play.

Ứng dụng nền tảng của Apple

  • Đả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 Analytics SDK 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.

  • Hãy đảm bảo bạn đã nắm rõ API giao dịch mua trong ứng dụng StoreKit 1 và StoreKit 2 của Apple 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, Analytics SDK sẽ tự động ghi lại các sự kiện mua hàng trong ứng dụng mà không cần thêm mã.

Triển khai trong ứng dụng Android

Đối với ứng dụng Android, bạn có thể đo lường các sự kiện mua hàng trong ứng dụng ngay khi liên kết với Google Play.

Triển khai trong các ứng dụng nền tảng Apple

Đối với các ứng dụng iOS, 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 đang dùng StoreKit 2, bạn có thể ghi nhật ký các sự kiện 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 nhật ký 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 trùng lặp được ghi nhật ký theo cách thủ công. Đảm bảo rằng bạn đang sử dụng Analytics SDK 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ì SDK Analytics sẽ tự động ghi nhật ký các sự kiện IAP.

Nếu bạn đang sử dụng StoreKit 2, hãy dùng mã sau để ghi nhật ký các sự kiện mua hàng trong ứng dụng.

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ì SDK Analytics sẽ tự động ghi nhật ký các sự kiện IAP.

StoreKit 2 chỉ dành cho Swift, vì vậy, chúng tôi không hỗ trợ việc triển khai Objective-C.