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 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 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 ứng dụng Android, SDK Analytics tích hợp với Google Play. Đối với các ứng dụng 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 giao dịch mua hàng trong ứng dụng mà không yêu cầu lệnh gọi API. Hướng dẫn này giải thích cách thiết lập dự án để tự động theo dõi, đồng thời mô tả một số trường hợp đặc biệt cần có một vài dòng mã để triển khai.
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 với 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 SDK Analytics 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 của bạn với Google Play.
Nếu đang phát triển ứng dụng Android, bạn có thể đo lường các sự kiện IAP 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 Apple, hãy đảm bảo bạn đã nắm rõ các API 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
Swift
Nếu bạn đang sử dụng StoreKit 1, SDK Analytics sẽ tự động ghi lại các sự kiện IAP.
Nếu bạn đang sử dụng StoreKit 2, hãy sử dụng mã sau để ghi nhật ký các sự kiện giao dịch mua 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, SDK Analytics sẽ tự động ghi lại các sự kiện IAP.
StoreKit 2 chỉ dành cho Swift, vì vậy, việc triển khai Objective-C không được hỗ trợ.
Kotlin+KTX
Để ghi nhật ký sự kiện IAP, hãy liên kết với Google Play.
Java
Để ghi nhật ký sự kiện IAP, hãy liên kết với Google Play.