Tổng quan về Kotlin Multiplatform SDK

Chào mừng! Chúng tôi ở đây để giúp việc tích hợp in-app purchase trở nên dễ dàng hơn bao giờ hết 🚀

Chúng tôi đã xây dựng Adapty Kotlin Multiplatform SDK để giúp bạn thoát khỏi những rắc rối với in-app purchase, để bạn có thể tập trung vào điều bạn làm tốt nhất – xây dựng những ứng dụng tuyệt vời. Đây là những gì chúng tôi lo cho bạn:

• Xử lý giao dịch mua, xác thực hóa đơn và quản lý gói đăng ký ngay từ đầu
• Tạo và kiểm thử paywall mà không cần cập nhật ứng dụng
• Nhận phân tích mua hàng chi tiết mà không cần cài đặt - bao gồm cohort, LTV, tỷ lệ rời bỏ và phân tích phễu
• Luôn cập nhật trạng thái gói đăng ký của người dùng trên các phiên và thiết bị
• Tích hợp ứng dụng với các dịch vụ attribution marketing và phân tích chỉ bằng một dòng code

Bắt đầu

Đây là những gì chúng ta sẽ đề cập trong hướng dẫn tích hợp:

1. Cài đặt & cấu hình SDK: Thêm SDK làm dependency vào dự án và kích hoạt nó trong code.
2. Kích hoạt mua hàng qua flow: Thiết lập flow mua hàng để người dùng có thể mua sản phẩm. Để tự xây dựng UI, xem Triển khai paywall thủ công.
3. Kiểm tra trạng thái gói đăng ký: Tự động kiểm tra trạng thái gói đăng ký của người dùng và kiểm soát quyền truy cập vào nội dung trả phí.
4. Xác định người dùng (tùy chọn): Liên kết người dùng với hồ sơ người dùng Adapty của họ để đảm bảo dữ liệu được lưu trữ nhất quán trên các thiết bị.

Xem thực tế

Muốn thấy mọi thứ kết hợp với nhau như thế nào? Chúng tôi đã chuẩn bị sẵn cho bạn:

• Ứng dụng mẫu: Xem ví dụ đầy đủ minh họa toàn bộ quá trình thiết lập
• Video hướng dẫn: Theo dõi video triển khai từng bước bên dưới

Các khái niệm chính

Trước khi bắt đầu viết code, hãy cùng làm quen với những khái niệm cốt lõi giúp Adapty hoạt động.

Điểm hay trong cách tiếp cận của Adapty là chỉ có placement được hardcode trong ứng dụng. Tất cả những thứ còn lại – sản phẩm, thiết kế paywall, giá cả và ưu đãi – đều có thể quản lý linh hoạt từ Adapty Dashboard mà không cần cập nhật ứng dụng:

1. Sản phẩm - Bất kỳ thứ gì có thể mua trong ứng dụng của bạn – gói đăng ký, consumable product, hoặc quyền truy cập trọn đời.

2. Flow hoặc paywall - Sản phẩm được đóng gói kèm cấu hình, gắn với một placement. Có hai loại:

   • Flow - Giao diện trực quan, không cần code, được xây dựng trong Flow & Paywall Builder. Adapty tự render UI và xử lý việc mua hàng cho bạn.
   • Paywall - Không có cấu hình giao diện; bạn tự xây dựng UI trong code của mình và tự gọi makePurchase. Xem Triển khai paywall thủ công.

   Trong code SDK, cả hai đều được lấy qua cùng một phương thức getFlow.

3. Placement - Một điểm chiến lược trong hành trình người dùng của bạn, nơi bạn muốn hiển thị một flow hoặc paywall. Hãy xem placement như “nơi” và “thời điểm” trong chiến lược kiếm tiền của bạn. Các placement phổ biến bao gồm:

   • main - Vị trí paywall chính của bạn
   • onboarding - Hiển thị trong quá trình onboarding của người dùng
   • settings - Có thể truy cập từ phần cài đặt ứng dụng của bạn

   Bắt đầu với những cái cơ bản như main hoặc onboarding cho lần tích hợp đầu tiên, rồi nghĩ xem còn vị trí nào khác trong ứng dụng mà người dùng có thể sẵn sàng mua hàng.

4. Hồ sơ người dùng - Khi người dùng mua sản phẩm, hồ sơ của họ sẽ được gán một mức độ truy cập mà bạn dùng để xác định quyền truy cập vào các tính năng trả phí.