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 các lệnh gọi API trong ứng dụng của bạn. 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 yêu cầu bạ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 phần Bắt đầu sử dụng Google Analytics.
Đối với ứng dụng trên nền tảng Apple:
- Đả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 ứ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.
Nếu đang phát triển một ứ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. Phần còn lại của hướng dẫn này tập trung vào các ứng dụng trên nền tảng Apple.
Nếu bạn là nhà phát triển của Apple, hãy đảm bảo rằng 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
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ỉ có trên Swift, nên không hỗ trợ việc triển khai Objective-C.
Kotlin
Để ghi nhật ký các sự kiện mua hàng trong ứng dụng, hãy liên kết đến Google Play.
Java
Để ghi nhật ký các sự kiện mua hàng trong ứng dụng, hãy liên kết đến Google Play.