Kiểm soát thông báo Google Play trong Android SDK

Google Play đôi khi cần hiển thị thông báo cho người dùng về gói đăng ký của họ — ví dụ như thông báo thanh toán gói đăng ký bị từ chối và cần cập nhật phương thức thanh toán. Google Play hiển thị những thông báo này trên đầu ứng dụng của bạn, và chỉ khi ứng dụng yêu cầu chúng.

Theo mặc định, Adapty SDK yêu cầu tin nhắn Google Play mỗi khi một Activity trong ứng dụng của bạn khởi động. Tin nhắn sau đó sẽ hiển thị đè lên bất cứ thứ gì mà Activity đó đang hiển thị, bao gồm flow, onboarding hoặc màn hình thanh toán. Để tự chọn thời điểm hiển thị, hãy chuyển SDK sang chế độ xử lý tin nhắn thủ công và gọi showStoreMessages khi tin nhắn không làm gián đoạn người dùng.

Google Play quyết định xem thông báo có áp dụng cho người dùng hay không, nên một yêu cầu không phải lúc nào cũng hiển thị thông báo. Nếu người dùng sửa phương thức thanh toán từ thông báo, SDK sẽ đồng bộ giao dịch mua của người dùng với Adapty, và trình lắng nghe hồ sơ của bạn sẽ nhận được mức độ truy cập đã được cập nhật.

Warning

Ở chế độ thủ công, SDK không bao giờ tự yêu cầu thông báo Google Play. Nếu ứng dụng của bạn không bao giờ gọi showStoreMessages, người dùng có thanh toán bị từ chối sẽ không thấy thông báo trong ứng dụng của bạn.

Trước khi bắt đầu

Bạn cần Adapty Android SDK 4.3.0 trở lên. Các phiên bản cũ hơn không hỗ trợ yêu cầu tin nhắn Google Play.

Bật xử lý thủ công

Để yêu cầu tin nhắn Google Play chỉ khi ứng dụng của bạn gọi showStoreMessages, hãy đặt withStoreMessagesHandling thành MANUAL khi bạn kích hoạt SDK:


AdaptyConfig.Builder("PUBLIC_SDK_KEY")
    .withStoreMessagesHandling(AdaptyConfig.StoreMessagesHandling.MANUAL) // AUTO is the default
    .build()


new AdaptyConfig.Builder("PUBLIC_SDK_KEY")
    .withStoreMessagesHandling(AdaptyConfig.StoreMessagesHandling.MANUAL) // AUTO is the default
    .build();

Hiển thị thông báo

Khi ứng dụng của bạn đến một thời điểm mà thông báo từ Google Play sẽ không làm gián đoạn người dùng — ví dụ: sau khi người dùng đóng một flow hoặc hoàn thành onboarding — hãy gọi showStoreMessages với Activity đang hiển thị thông báo đó:

Adapty.showStoreMessages(activity)

Adapty.showStoreMessages(activity);

Phương thức này không trả về kết quả. SDK sẽ không hiển thị thông báo trong các trường hợp sau:

SDK chưa được kích hoạt: Hãy gọi showStoreMessages sau khi đã gọi Adapty.activate.
Activity không thể hiển thị thông báo: Activity đang kết thúc hoặc đã bị hủy, hoặc cửa sổ của nó chưa được gắn vào. Hãy gọi phương thức này từ một Activity mà người dùng đang nhìn thấy.

Ở chế độ mặc định AUTO, bạn cũng có thể gọi showStoreMessages — ví dụ, để yêu cầu hiển thị lại thông báo trên một Activity đang chạy.