Tích hợp ban đầu với Google Play

Kết nối tài khoản Google Play của bạn với Adapty để máy chủ của chúng tôi có thể đọc các sản phẩm trên Play Store, xác thực giao dịch mua và nhận các sự kiện gói đăng ký trên Android.

Quá trình thiết lập mất khoảng một tiếng. Onboarding tích hợp trong Adapty Dashboard cũng hướng dẫn các bước tương tự nếu bạn muốn thực hiện trong một cửa sổ duy nhất.

Trước khi bắt đầu

Không giống như Apple, Google chia hệ sinh thái nhà phát triển của mình thành hai sản phẩm riêng biệt — Google Play Console và Google Cloud Console — và thiết lập này liên quan đến cả hai.

Những gì liên quan

• Service account: Tài khoản Google dành cho máy móc, không phải con người. Bạn cần tạo một service account mới để cấp cho Adapty quyền truy cập vào Google Cloud và Google Play Console.
• Google Cloud Console: Nền tảng hạ tầng đa năng của Google. Play Store không có thông tin xác thực API riêng, vì vậy bạn phải tạo chúng tại đây. Dùng Cloud Console để bật Developer API, tạo service account và cấp cho nó một số quyền cần thiết. Adapty cần những quyền này để nhận thông tin về các lần gia hạn, hủy đăng ký và hoàn tiền. File khóa của service account — dùng để Adapty xác thực với Google — cũng được tải xuống từ đây.
• Google Play Console: Nơi bạn phát hành ứng dụng và bán gói đăng ký. Dùng Play Console để cấp cho service account phần còn lại của các quyền cần thiết. Adapty cần những quyền này để đọc danh sách sản phẩm và xác thực giao dịch mua. Ngoài ra, đây cũng là nơi bạn bật thông báo nhà phát triển theo thời gian thực (RTDN) để thiết lập kênh liên lạc giữa Play Store và Adapty.

Đặc quyền truy cập cần thiết

Google cấp quyền Project Creator cho mọi người trong tổ chức mới theo mặc định, vì vậy bạn có thể đã có quyền này rồi. Tuy nhiên, một tổ chức doanh nghiệp có chính sách bảo mật chặt chẽ có thể đã thu hồi quyền đó.

Tài nguyên cần thiết

Một dự án Google Cloud. Tạo mới nếu bạn chưa có, hoặc dùng lại một dự án đang chạy. Bạn sử dụng dự án này để bật các Developer API và tạo service account cho Adapty.

Dự án này độc lập với ứng dụng trên Play Console. Một dự án có thể quản lý giao tiếp của nhiều ứng dụng. Mỗi ứng dụng sẽ có topic riêng — một hàng đợi giao tiếp — bên trong dự án.

Khi kết nối các dịch vụ của Google với Adapty, bạn cần sử dụng cùng một project từ đầu đến cuối. Nên ưu tiên dùng project của team thay vì project cá nhân — vì key và topic sẽ tồn tại ở đó trong suốt vòng đời của ứng dụng.

Danh sách kiểm tra cho tích hợp ban đầu

1. Bật Developer APIs trong Google Cloud Console.
2. Tạo service account trong Google Cloud Console.
3. Cấp quyền cần thiết cho service account trong Google Play Console.
4. Tạo file key cho service account trong Google Cloud Console.
5. Tải file key và package name lên Adapty trong Adapty Dashboard. Service account mới cần ít nhất 24 giờ để kích hoạt, và Adapty không thể đọc sản phẩm của bạn cho đến khi đó — để bỏ qua thời gian chờ này, hãy chỉnh sửa và lưu bất kỳ mô tả sản phẩm nào trong Google Play Console.
6. Bật Real-time developer notifications (RTDN) trong Google Play Console, sử dụng tên topic mà Adapty tạo ra.
7. Cài đặt Adapty SDK cho từng framework mà app của bạn sử dụng:
   • Android
   • React Native
   • Flutter
   • Kotlin Multiplatform
   • Unity
   • Capacitor
8. Kiểm tra in-app purchase trên thiết bị thật trước khi phát hành.

Các bước tiếp theo

Sau khi tích hợp xong, bạn có thể bắt đầu sử dụng các tính năng của Adapty.

Để hiển thị paywall, bạn cần thêm code vào ứng dụng: tối thiểu là hiển thị paywall, và xử lý quá trình mua hàng nếu bạn tự render paywall.