Play Billing Lab là một ứng dụng đồng hành giúp bạn kiểm thử khả năng tích hợp với hệ thống thanh toán của Google Play. Bạn có thể sử dụng tính năng thử nghiệm xem trước giao dịch mua ngoài ứng dụng (OOAP) của Play Billing Lab để xác thực rằng phần phụ trợ của bạn được định cấu hình đúng cách để xử lý các mặt hàng mua được bên ngoài ứng dụng, bao gồm cả Phần thưởng của Play Games.
Với tính năng đang ở giai đoạn xem trước OOAP, bạn có thể chọn một số sản phẩm hoặc ưu đãi cụ thể để hiển thị trên các nền tảng bên ngoài ứng dụng, chẳng hạn như trang thông tin chi tiết ứng dụng trên Google Play, đồng thời xác minh quy trình mua và thực hiện quyền từ đầu đến cuối.
Điều kiện tiên quyết
Trước khi sử dụng Play Billing Lab để kiểm thử quy trình giao dịch mua ngoài ứng dụng (OOAP) nhằm xác thực chế độ thiết lập cho Phần thưởng của Play Games, hãy đảm bảo bạn đáp ứng các yêu cầu sau:
- Đăng ký tham gia Chương trình tiếp cận sớm (EAP) của Phần thưởng của Play Games.
Trạng thái người thử nghiệm được cấp phép: Tài khoản thử nghiệm của bạn phải được đăng ký làm người thử nghiệm được cấp phép cho trò chơi. Để biết thông tin chi tiết, hãy xem tài liệu về người kiểm thử được cấp phép trên Google Play.
Lưu ý: Mặc dù người dùng nào cũng có thể xem ứng dụng Play Billing Lab, nhưng chỉ những người kiểm thử được cấp phép của nhà phát triển EAP trong danh sách cho phép mới có thể định cấu hình và kích hoạt các chế độ ghi đè OOAP.
Tính nhất quán của tài khoản trên các nền tảng: Bạn phải đăng nhập vào Play Billing Lab và Cửa hàng Google Play bằng cùng một tài khoản người kiểm thử được cấp phép. Nếu tài khoản không khớp, Cửa hàng Play có thể không hiển thị sản phẩm hoặc ưu đãi thử nghiệm bị ghi đè, hoặc không hoàn tất giao dịch mua thử nghiệm.
Tải xuống và cài đặt
Bạn có thể tải và cài đặt Play Billing Lab từ Google Play:
- Cửa hàng Google Play (Android): Ứng dụng Play Billing Lab
- Kênh thử nghiệm trên web: Chọn tham gia Play Billing Lab trên web
Hướng dẫn từng bước về cách tích hợp và thử nghiệm EAP
Các bước sau đây trình bày chi tiết cách tích hợp và thử nghiệm Phần thưởng của Play Games bằng Play Billing Lab.
Bước 1: Chạy Play Billing Lab và đăng nhập
Khi bạn mở Play Billing Lab lần đầu tiên sau khi cài đặt:
- Nhấn vào Đăng nhập bằng Google.
- Chọn Tài khoản Google đã đăng ký làm người thử nghiệm được cấp phép cho ứng dụng của bạn.
- Sau khi đăng nhập, bạn sẽ thấy Trang tổng quan chính.
Bước 2: Chuyển đến phần thử nghiệm giao dịch mua ngoài ứng dụng (OOAP)
- Trên Trang tổng quan, hãy tìm thẻ Giao dịch mua ngoài ứng dụng.
- Nhấn vào Test (Kiểm thử) để mở màn hình thiết lập cấu hình OOAP.
Bước 3: Chỉ định tên gói ứng dụng và mã sản phẩm
Trên màn hình thiết lập OOAP, hãy nhập giá trị nhận dạng ứng dụng bắt buộc:
- Tên gói: Tên chính xác của gói Android cho ứng dụng của bạn (ví dụ:
com.example.app). - Loại sản phẩm: Sử dụng trình đơn thả xuống để chọn Sản phẩm tính phí một lần (mặt hàng trong ứng dụng) hoặc Gói thuê bao.
- Mã sản phẩm (SKU): Mã sản phẩm của sản phẩm trong ứng dụng hoặc gói thuê bao mà bạn muốn thử nghiệm.
Bước 4: Chọn một ưu đãi đủ điều kiện
Sau khi bạn nhập tên gói, mã sản phẩm và loại sản phẩm, Play Billing Lab sẽ truy vấn phần phụ trợ và hiển thị danh sách các ưu đãi hiện có cho sản phẩm đó.
Đối với sản phẩm tính phí một lần: Chọn lựa chọn mua hoặc ưu đãi phù hợp.
Chọn một ưu đãi đủ điều kiện.
Bước 5: Bắt đầu thử nghiệm OOAP
Sau khi chọn ưu đãi, hãy nhấn vào Bắt đầu thử nghiệm. Cấu hình được lưu và đồng bộ hoá với máy chủ phụ trợ của Google Play.
Sau khi kích hoạt, Trang tổng quan sẽ hiển thị huy hiệu Đang hoạt động trên thẻ Giao dịch mua ngoài ứng dụng, cho biết tên gói, mã sản phẩm (SKU) và thời gian còn lại đã định cấu hình.
- Cửa sổ kiểm thử: Theo mặc định, các cấu hình kiểm thử OOAP đang hoạt động sẽ duy trì trạng thái hoạt động trong 2 giờ trước khi tự động hết hạn.
Ghi đè phần phụ trợ: Khi hoạt động, cấu hình này sẽ hiển thị ở mức ưu tiên cao nhất trên nhiều nền tảng OOAP (chẳng hạn như trang thông tin chi tiết ứng dụng trong Cửa hàng Play).
Bắt đầu kiểm thử OOAP.
Bước 6: Kiểm thử quy trình thu nạp toàn diện cho ưu đãi bên ngoài ứng dụng
Trong khi thử nghiệm OOAP đang hoạt động trong Play Billing Lab, hãy mở ứng dụng Cửa hàng Google Play đã đăng nhập bằng cùng một tài khoản người kiểm thử được cấp phép:
- Xoá bộ nhớ đệm của Cửa hàng Google Play:
- Mở ứng dụng Cài đặt trên thiết bị của bạn.
- Nhấn vào Ứng dụng > Cửa hàng Google Play.
- Nhấn vào Bộ nhớ và bộ nhớ đệm, sau đó nhấn vào Xoá bộ nhớ đệm và Xoá bộ nhớ.
- Mở ứng dụng Cửa hàng Google Play.
- Chuyển đến trang thông tin chi tiết ứng dụng.
Hoàn tất giao dịch mua thử nghiệm (lớp phủ Play Express): Nhấn vào thẻ cho mặt hàng. Lớp phủ bảng dưới cùng của quy trình thanh toán nhanh gốc trên Google Play trong Cửa hàng Play.
- Xem giá, phương thức thanh toán (phương thức kiểm thử cho người kiểm thử được cấp phép) và thông tin chi tiết về ưu đãi.
- Nhấn vào Mua bằng 1 lần nhấn để hoàn tất giao dịch.
Kiểm thử quy trình thu nạp từ đầu đến cuối. Xác minh việc tích hợp phần phụ trợ:
- Sau khi giao dịch mua thành công, hãy xác minh rằng Google Play gửi Thông báo theo thời gian thực dành cho nhà phát triển (RTDN) đến máy chủ phụ trợ của bạn.
- Lưu ý: Phần thưởng cũng gửi RTDN.
- Xác minh rằng máy chủ của bạn gọi Google Play Developer API để xác nhận giao dịch mua và cấp quyền cho người dùng.
- Kiểm tra nhật ký mua của người dùng trong ứng dụng Cửa hàng Play để xác nhận rằng đơn đặt hàng thử nghiệm đã được ghi lại.
- Sau khi giao dịch mua thành công, hãy xác minh rằng Google Play gửi Thông báo theo thời gian thực dành cho nhà phát triển (RTDN) đến máy chủ phụ trợ của bạn.
Bước 7: Dừng và xoá thử nghiệm OOAP
Sau khi bạn thử nghiệm xong:
- Chuyển đến trang Giao dịch mua ngoài ứng dụng.
- Nhấn vào Xoá thử nghiệm để dừng thử nghiệm OOAP và xoá các chế độ cài đặt thử nghiệm OOAP.
Sửa đổi cấu hình kiểm thử
Bạn không thể thay đổi tên gói, mã sản phẩm, lựa chọn ưu đãi hoặc thay đổi chế độ ghi đè Quốc gia trên Cửa hàng Play khi một thử nghiệm xem trước OOAP đang chạy.
Để làm vậy, bạn cần dừng và xoá thử nghiệm OOAP hiện tại
Cách chỉnh sửa sản phẩm hoặc ưu đãi
Nếu bạn đang chạy thử nghiệm OOAP và muốn thử nghiệm một sản phẩm hoặc ưu đãi khác, hãy làm như sau:
- Mở Play Billing Lab rồi nhấn vào Xem trên thẻ Giao dịch mua ngoài ứng dụng đang hoạt động.
- Nhấn vào Chỉnh sửa để sửa đổi tên gói, mã sản phẩm hoặc ưu đãi thử nghiệm.
- Xác nhận Dừng thử nghiệm khi được nhắc. Thử nghiệm sẽ bị dừng và tất cả dữ liệu đầu vào có liên quan sẽ bị xoá.
- Nhập sản phẩm mới hoặc chọn ưu đãi mới, rồi bắt đầu lại thử nghiệm.
Cách thử nghiệm giá được bản địa hoá bằng chế độ ghi đè theo quốc gia
Play Billing Lab cho phép bạn ghi đè quốc gia trên Cửa hàng Google Play để thử nghiệm định dạng đơn vị tiền tệ và giá theo khu vực. Tuy nhiên, bạn phải đồng bộ hoá rõ ràng các thay đổi về quốc gia với quy trình thử nghiệm OOAP:
Dừng thử nghiệm OOAP đang hoạt động: Nếu bạn cố gắng chỉnh sửa chế độ ghi đè quốc gia trong khi thử nghiệm OOAP đang hoạt động (từ Trang tổng quan hoặc trang Giao dịch mua ngoài ứng dụng), thì Play Billing Lab sẽ hiển thị cảnh báo nhắc bạn dừng thử nghiệm trước. Nếu bạn xác nhận bằng cách nhấn vào Dừng thử nghiệm, thì thử nghiệm OOAP hiện tại sẽ dừng và dữ liệu đầu vào của thử nghiệm sẽ bị xoá.
Đặt chế độ ghi đè quốc gia: Sau khi dừng thử nghiệm OOAP, bạn có thể chỉnh sửa chế độ cài đặt quốc gia trên trang Cài đặt cấu hình. Chọn quốc gia mục tiêu (ví dụ: Nhật Bản, Vương quốc Anh) rồi nhấn vào Áp dụng.
Bắt đầu lại thử nghiệm OOAP: Sau khi chế độ ghi đè quốc gia có hiệu lực, hãy quay lại thẻ Giao dịch mua ngoài ứng dụng, chọn sản phẩm và ưu đãi của bạn, rồi nhấn vào Bắt đầu thử nghiệm.
Trang tổng quan của bạn hiện sẽ hiển thị cả chế độ Ghi đè quốc gia đang hoạt động và Thử nghiệm OOAP đang hoạt động.
Xác minh giá theo bản địa hoá trong Cửa hàng Play: Mở Cửa hàng Play rồi truy cập vào trang thông tin chi tiết của ứng dụng. Thẻ giao diện người dùng xuất hiện và bảng dưới cùng của Play Express giờ đây sẽ hiển thị giá sản phẩm được định dạng theo nội tệ của quốc gia mà bạn đã ghi đè!
Quy trình khắc phục sự cố và câu hỏi thường gặp
Tại sao ưu đãi thử nghiệm mà tôi đã thiết lập không xuất hiện trên trang thông tin chi tiết ứng dụng trong Cửa hàng Play?
- Tính nhất quán của tài khoản: Xác minh rằng tài khoản đã đăng nhập vào ứng dụng Cửa hàng Play chính là tài khoản đã đăng nhập vào Play Billing Lab.
- Danh sách cho phép của EAP và trạng thái người kiểm thử được cấp phép: Xác minh rằng tài khoản nhà phát triển của bạn nằm trong danh sách cho phép của EAP Bản dùng thử OOAP của Play Billing Lab và tài khoản của bạn được liệt kê là người kiểm thử được cấp phép đang hoạt động trong Play Console.
- Hết hạn: Các thử nghiệm OOAP đang hoạt động sẽ hết hạn sau 2 giờ. Mở Play Billing Lab để kiểm tra xem thẻ thử nghiệm của bạn đã chuyển sang trạng thái Hết hạn hay chưa. Nếu có, hãy bắt đầu một thử nghiệm mới.
Tại sao tôi không thể chọn hoặc xem bất kỳ ưu đãi nào khi thiết lập sản phẩm trong Play Billing Lab?
- Điều kiện nhận ưu đãi: Play Billing Lab chỉ hiển thị những ưu đãi mà tài khoản người kiểm thử cụ thể của bạn hiện đủ điều kiện mua.
Tại sao giao dịch mua thử nghiệm của tôi không thành công trong lớp phủ Play Express?
- Đảm bảo rằng thiết bị kiểm thử của bạn đang chạy Android 12 (cấp độ API 31) trở lên và đã cài đặt phiên bản mới nhất của Cửa hàng Google Play.
- Kiểm tra webhook RTDN và chế độ tích hợp API của phần phụ trợ ứng dụng. Khi thử nghiệm thông qua Cửa hàng Play, giao dịch mua sẽ diễn ra bên ngoài giao diện người dùng chuẩn của ứng dụng. Máy chủ phụ trợ của bạn phải nhận được thông báo RTDN từ Google Play một cách đáng tin cậy và xác nhận giao dịch mua không đồng bộ.
Làm cách nào để dừng hoặc xoá một thử nghiệm đang hoạt động trước khi hết thời gian 2 giờ?
- Mở Play Billing Lab, tìm thẻ đang hoạt động (Giao dịch mua ngoài ứng dụng hoặc Cài đặt cấu hình) rồi nhấn vào Dừng hoặc Xoá. Khi được nhắc, hãy xác nhận lựa chọn của bạn. Giá trị ghi đè sẽ bị xoá ngay lập tức khỏi máy chủ Google Play.