Tích hợp Adapty vào ứng dụng Unity của bạn với sự hỗ trợ của AI

Hướng dẫn này sẽ đưa bạn qua từng bước tích hợp Adapty vào ứng dụng Unity với một công cụ AI — bạn chỉ cần cung cấp đúng tài liệu Adapty theo đúng thứ tự.

Trước khi bắt đầu: thiết lập dashboard

Adapty yêu cầu một số cấu hình trên dashboard trước khi bạn viết bất kỳ đoạn code SDK nào. Bạn có thể thực hiện điều này với một LLM skill tương tác, hoặc thủ công thông qua Dashboard.

Cách dùng Skill (khuyến nghị)

Adapty CLI skill cho phép LLM của bạn thiết lập ứng dụng, sản phẩm, mức độ truy cập, paywall và placement trực tiếp — mà không cần mở Dashboard cho từng bước. Bạn chỉ cần kết nối cửa hàng của mình trong Dashboard.

npx skills add adaptyteam/adapty-cli --skill adapty-cli

Sau khi thêm skill, chạy /adapty-cli trong agent của bạn. Nó sẽ hướng dẫn bạn qua từng bước — bao gồm cả khi nào cần mở Dashboard để kết nối cửa hàng.

Cách thủ công qua Dashboard

Nếu bạn muốn tự cấu hình mọi thứ, đây là những gì bạn cần trước khi viết code. LLM của bạn không thể tra cứu các giá trị dashboard — bạn cần cung cấp chúng.

1. Kết nối cửa hàng ứng dụng: Trong Adapty Dashboard, vào App settings → General. Kết nối cả App Store và Google Play nếu ứng dụng Unity của bạn nhắm đến cả hai nền tảng. Đây là yêu cầu bắt buộc để mua hàng hoạt động. Kết nối cửa hàng ứng dụng

2. Sao chép Public SDK key: Trong Adapty Dashboard, vào App settings → General, sau đó tìm phần API keys. Trong code, đây là chuỗi bạn truyền vào Adapty configuration builder.

3. Tạo ít nhất một sản phẩm: Trong Adapty Dashboard, vào trang Products. Bạn không tham chiếu sản phẩm trực tiếp trong code — Adapty cung cấp chúng thông qua paywall. Thêm sản phẩm

4. Tạo paywall và placement: Trong Adapty Dashboard, tạo paywall trên trang Paywalls, sau đó gán nó cho một placement trên trang Placements. Trong code, placement ID là chuỗi bạn truyền vào Adapty.GetPaywall("YOUR_PLACEMENT_ID"). Tạo paywall

5. Thiết lập mức độ truy cập: Trong Adapty Dashboard, cấu hình cho từng sản phẩm trên trang Products. Trong code, chuỗi được kiểm tra trong profile.AccessLevels["premium"]?.IsActive. Mức độ truy cập premium mặc định phù hợp với hầu hết các ứng dụng. Nếu người dùng trả phí được truy cập các tính năng khác nhau tùy theo sản phẩm (ví dụ: gói basic so với gói pro), hãy tạo thêm mức độ truy cập trước khi bắt đầu viết code.

Thiết lập khi sẵn sàng

Những mục này không bắt buộc để bắt đầu viết code, nhưng bạn sẽ cần chúng khi tích hợp trưởng thành hơn:

• A/B test: Cấu hình trên trang Placements. Không cần thay đổi code. A/B test
• Thêm paywall và placement: Thêm nhiều lệnh gọi GetPaywall với các placement ID khác nhau.
• Tích hợp analytics: Cấu hình trên trang Integrations. Cách thiết lập khác nhau tùy theo tích hợp. Xem tích hợp analytics và tích hợp attribution.

Cung cấp tài liệu Adapty cho LLM của bạn

Dùng Context7 (khuyến nghị)

Context7 là một MCP server cung cấp cho LLM của bạn quyền truy cập trực tiếp vào tài liệu Adapty cập nhật nhất. LLM của bạn tự động lấy đúng tài liệu dựa trên những gì bạn hỏi — không cần dán URL thủ công.

Context7 hoạt động với Cursor, Claude Code, Windsurf, và các công cụ tương thích MCP khác. Để thiết lập, chạy:

npx ctx7 setup

Lệnh này sẽ phát hiện trình soạn thảo của bạn và cấu hình Context7 server. Để thiết lập thủ công, xem Context7 GitHub repository.

Sau khi cấu hình, tham chiếu thư viện Adapty trong các prompt của bạn:

Use the adaptyteam/adapty-docs library to look up how to install the Unity SDK

Dùng tài liệu dạng plain text

Bạn có thể truy cập bất kỳ tài liệu Adapty nào dưới dạng Markdown thuần. Thêm .md vào cuối URL, hoặc nhấn Copy for LLM dưới tiêu đề bài viết. Ví dụ: adapty-cursor-unity.md.

Mỗi giai đoạn trong hướng dẫn triển khai bên dưới đều có block “Gửi cho LLM của bạn” với các link .md để dán vào.

Để có nhiều tài liệu hơn cùng một lúc, xem file index và các tập con theo nền tảng bên dưới.

Hướng dẫn triển khai

Phần còn lại của hướng dẫn này đi qua việc tích hợp Adapty theo thứ tự triển khai. Mỗi giai đoạn bao gồm tài liệu cần gửi cho LLM, những gì bạn sẽ thấy khi hoàn thành, và các vấn đề thường gặp.

Lên kế hoạch tích hợp

Trước khi bắt đầu viết code, hãy yêu cầu LLM phân tích dự án của bạn và tạo kế hoạch triển khai. Nếu công cụ AI của bạn hỗ trợ chế độ lập kế hoạch (như chế độ plan của Cursor hoặc Claude Code), hãy sử dụng nó để LLM có thể đọc cả cấu trúc dự án lẫn tài liệu Adapty trước khi viết code.

Hãy cho LLM biết bạn dùng cách tiếp cận nào để xử lý mua hàng — điều này ảnh hưởng đến hướng dẫn mà nó nên theo:

• Adapty Paywall Builder: Bạn tạo paywall trong trình tạo no-code của Adapty, và SDK hiển thị chúng tự động.
• Paywall tự tạo: Bạn tự xây dựng giao diện paywall trong code nhưng vẫn dùng Adapty để lấy sản phẩm và xử lý mua hàng.
• Observer mode: Bạn giữ nguyên hạ tầng mua hàng hiện có và chỉ dùng Adapty cho analytics và tích hợp.

Chưa biết chọn cái nào? Đọc bảng so sánh trong quickstart.

Cài đặt và cấu hình SDK

Thêm package Adapty SDK qua Unity Package Manager và kích hoạt nó với Public SDK key của bạn. Đây là nền tảng — mọi thứ khác đều không hoạt động nếu thiếu bước này.

Hướng dẫn: Cài đặt & cấu hình Adapty SDK

Gửi cho LLM của bạn:

Read these Adapty docs before writing code:
- https://adapty.io/docs/vi/sdk-installation-unity.md

Hiển thị paywall và xử lý mua hàng

Lấy paywall theo placement ID, hiển thị nó và xử lý các sự kiện mua hàng. Hướng dẫn bạn cần phụ thuộc vào cách bạn xử lý mua hàng.

Kiểm tra từng lần mua trong sandbox khi bạn thực hiện — đừng chờ đến cuối. Xem Kiểm tra mua hàng trong sandbox để biết hướng dẫn thiết lập.

Read these Adapty docs before writing code:
- https://adapty.io/docs/vi/unity-quickstart-paywalls.md
- https://adapty.io/docs/vi/unity-get-pb-paywalls.md
- https://adapty.io/docs/vi/unity-present-paywalls.md
- https://adapty.io/docs/vi/unity-handling-events.md
- https://adapty.io/docs/vi/unity-handle-paywall-actions.md

Read these Adapty docs before writing code:
- https://adapty.io/docs/vi/unity-quickstart-manual.md
- https://adapty.io/docs/vi/fetch-paywalls-and-products-unity.md
- https://adapty.io/docs/vi/present-remote-config-paywalls-unity.md
- https://adapty.io/docs/vi/unity-making-purchases.md
- https://adapty.io/docs/vi/unity-restore-purchase.md

Read these Adapty docs before writing code:
- https://adapty.io/docs/vi/observer-vs-full-mode.md
- https://adapty.io/docs/vi/implement-observer-mode-unity.md
- https://adapty.io/docs/vi/report-transactions-observer-mode-unity.md

Kiểm tra trạng thái gói đăng ký

Sau khi mua hàng, kiểm tra hồ sơ người dùng để xem mức độ truy cập có đang hoạt động không nhằm giới hạn nội dung premium.

Hướng dẫn: Kiểm tra trạng thái gói đăng ký

Gửi cho LLM của bạn:

Read these Adapty docs before writing code:
- https://adapty.io/docs/vi/unity-check-subscription-status.md

Xác định người dùng

Liên kết tài khoản người dùng trong ứng dụng của bạn với hồ sơ Adapty để mua hàng được duy trì trên nhiều thiết bị.

Hướng dẫn: Xác định người dùng

Gửi cho LLM của bạn:

Read these Adapty docs before writing code:
- https://adapty.io/docs/vi/unity-quickstart-identify.md

Chuẩn bị phát hành

Khi tích hợp của bạn hoạt động trong sandbox, hãy đi qua checklist phát hành để đảm bảo mọi thứ sẵn sàng cho môi trường production.

Hướng dẫn: Checklist phát hành

Gửi cho LLM của bạn:

Read these Adapty docs before releasing:
- https://adapty.io/docs/vi/release-checklist.md

File index tài liệu dạng plain text

Nếu bạn cần cung cấp cho LLM ngữ cảnh rộng hơn ngoài các trang riêng lẻ, chúng tôi lưu trữ các file index liệt kê hoặc kết hợp toàn bộ tài liệu Adapty:

• llms.txt: Liệt kê tất cả các trang với các link .md. Đây là tiêu chuẩn đang nổi lên để làm cho website có thể truy cập bởi LLM. Lưu ý rằng với một số AI agent (ví dụ: ChatGPT), bạn sẽ cần tải xuống llms.txt và tải lên chat dưới dạng file.
• llms-full.txt: Toàn bộ tài liệu Adapty được kết hợp thành một file duy nhất. Rất lớn — chỉ dùng khi bạn cần toàn bộ nội dung.
• unity-llms.txt và unity-llms-full.txt dành riêng cho Unity: Các tập con theo nền tảng giúp tiết kiệm token so với toàn bộ site.