Phần thưởng thử nghiệm

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 giao dịch mua ngoài ứng dụng (OOAP) của Play Billing Lab để xác thực rằng ứng dụng và 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 thử nghiệm OOAP, bạn có thể chọn một ưu đãi Phần thưởng của Play Games, mô phỏng việc Google Play cấp phần thưởng cho người dùng ngay trong Play Billing Lab, đồng thời xác minh quy trình nhận 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:

  1. 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 mới có thể định cấu hình và kích hoạt các chế độ ghi đè OOAP.

  2. 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 ứng dụng Play Billing Lab qua Google Play.

Hướng dẫn từng bước về cách tích hợp và thử nghiệm

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. Để biết thông tin chung về cách thử nghiệm giao dịch mua ngoài ứng dụng, hãy xem bài viết Thử nghiệm giao dịch mua ngoài ứng dụng.

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.
Trang tổng quan của Play Billing Lab
Trang tổng quan của Play Billing Lab.
  • 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:

  1. 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).
  2. 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).
  3. Mã sản phẩm (SKU): Mã sản phẩm của sản phẩm tính phí một lần có ưu đãi Phần thưởng của Play Games mà bạn muốn thử nghiệm.
Chỉ định tên gói ứng dụng và mã sản phẩm
Chỉ định tên gói ứng dụng và mã sản phẩm.

Bước 4: Chọn ưu đãi Phần thưởng của Play Games

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 đó.

  • Chọn ưu đãi Phần thưởng của Play Games mà bạn muốn thử nghiệm.

    Chọn một ưu đãi đủ điều kiện
    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 Phần thưởng của Play Games, 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. Sau thời gian này, bạn phải định cấu hình lại thử nghiệm.

    Bắt đầu thử nghiệm OOAP
    Bắt đầu kiểm thử OOAP.

Bước 6: Trao phần thưởng và xác minh việc phân phối

Khi thử nghiệm OOAP đang hoạt động cho ưu đãi Phần thưởng của Play Games, bạn có thể cấp phần thưởng ngay trong Play Billing Lab mà không cần mua phần thưởng đó trên Cửa hàng Google Play:

  1. Cấp phần thưởng: Trên màn hình Giao dịch mua ngoài ứng dụng trong Play Billing Lab, hãy nhấp vào Cấp phần thưởng để mô phỏng việc Google Play cấp phần thưởng cho người dùng. Bạn phải xử lý các phần thưởng hiện có trước khi có thể nhận thêm phần thưởng.

    Ba màn hình cho thấy quy trình thử nghiệm Phần thưởng của Play Games. Trên màn hình đầu tiên, người dùng chọn cấp phần thưởng. Màn hình thứ hai cho thấy phần thưởng đã được Play cấp thành công, sau đó người dùng nhấp để được cấp lại phần thưởng. Màn hình thứ ba cho thấy trạng thái lỗi vì phần thưởng đầu tiên chưa được xử lý đúng cách.
    Quy trình thử nghiệm Phần thưởng của Play Games.
  2. Xử lý và cấp quyền: Ứng dụng của bạn phải phát hiện giao dịch mua ngoài ứng dụng (ví dụ: bằng cách gọi queryPurchasesAsync khi trò chơi bắt đầu hoặc chạy ở nền trước), sau đó phân phối vật phẩm cho người dùng tương ứng. Để biết toàn bộ quy trình, hãy xem phần xử lý giao dịch mua.

Bước 7: Dừng và xoá thử nghiệm OOAP

Sau khi bạn thử nghiệm xong:

  1. Chuyển đến trang Giao dịch mua ngoài ứng dụng.
  2. 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.
Dừng và xoá thử nghiệm OOAP
Xoá 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 thử nghiệm OOAP đang chạy.

Để làm việc nà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:

  1. 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.
  2. 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.
  3. 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á.
  4. 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.
Chỉnh sửa sản phẩm hoặc ưu đãi
Chỉnh sửa sản phẩm hoặc ưu đãi.

Cách kiểm thử cấu hình theo khu vực 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 để kiểm tra điều kiện nhận ưu đãi ở nhiều khu vực. Nếu bạn không chọn quốc gia, Play Billing Lab sẽ sử dụng Quốc gia trên Play cho tài khoản thử nghiệm được cấp phép của bạn. Bạn phải đồng bộ hoá các thay đổi về quốc gia với quy trình kiểm thử OOAP:

  1. 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á.

  2. Đặ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 trong trang Cài đặt cấu hình (hoặc nhấn vào Đặt chế độ ghi đè quốc gia trên màn hình Giao dịch mua ngoài ứng dụng). 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.

  3. 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.

Kiểm thử cấu hình theo khu vực bằng chế độ ghi đè theo quốc gia
Kiểm thử cấu hình theo khu vực bằng cách ghi đè quốc gia.

Quy trình khắc phục sự cố và câu hỏi thường gặp

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 thử nghiệm cụ thể của bạn hiện đủ điều kiện nhận. Đối với các mặt hàng không tiêu dùng, bạn không được sở hữu sản phẩm đó. Đối với các mặt hàng tiêu dùng, bạn phải tiêu thụ mọi giao dịch mua hiện có trước khi kiểm thử.
  • Trạng thái người kiểm thử được cấp phép: Xác minh rằng tài khoản của bạn có tên trong danh sách người kiểm thử được cấp phép đang hoạt động trong Play Console.

Tại sao tôi không thể cấp một phần thưởng khác trong Play Billing Lab?

  • Phần thưởng chưa được xử lý: Bạn phải xử lý (xác nhận hoặc sử dụng) phần thưởng hiện có trước khi có thể nhận thêm phần thưởng. Mở trò chơi và xác minh rằng phần thưởng trước đó đã được xử lý.
  • 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 nhận được phần thưởng trong trò chơi?

  • 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 Play Billing Lab, ứng dụng Cửa hàng Google Play và trò chơi của bạn chính là tài khoản người kiểm thử được cấp phép.
  • Xử lý giao dịch mua ngoài ứng dụng: Kiểm tra logic xử lý giao dịch mua và triển khai queryPurchasesAsync của trò chơi. Vì phần thưởng được cấp bên ngoài giao diện người dùng chuẩn của ứng dụng, nên trò chơi hoặc máy chủ phụ trợ của bạn phải phát hiện các giao dịch mua chưa được xác nhận và xử lý các giao dịch đó.

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á (hoặc nhấn vào Xoá thử nghiệm trên màn hình Giao dịch mua ngoài ứng dụng). 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.