Placements

Placement là một điểm trong ứng dụng của bạn nơi bạn chèn nội dung từ Adapty. Bạn có thể gọi một placement khi khởi động ứng dụng, trước một tính năng cao cấp, trên màn hình cài đặt, hoặc bất kỳ nơi nào khác.

Một placement có một trong ba loại. Hai trong số đó dành cho công việc mới:

• Flow placement phục vụ một flow: một màn hình hoặc chuỗi màn hình, được xây dựng trong Flow & Paywall Builder. Một flow có thể là onboarding, một paywall, hoặc một onboarding kết thúc bằng paywall. Nếu bạn muốn tự xây dựng màn hình, hãy sử dụng paywall placement thay thế.
• Paywall placement truyền một paywall — cấu hình sản phẩm bạn tạo trong dashboard — đến màn hình bạn tự xây dựng.

Loại thứ ba, onboarding placements, phục vụ các onboarding từ Onboarding Builder cũ. Adapty sẽ ngừng hỗ trợ builder đó vào ngày 1 tháng 10 năm 2026, vì vậy hãy xây dựng các onboarding mới dưới dạng flow.

Quy tắc và lưu ý

• Loại của một placement được xác định ngay khi bạn tạo nó, vì mỗi loại có bộ chỉ số riêng.
• ID của placement là duy nhất trong toàn bộ ứng dụng, nên cùng một ID không thể vừa phục vụ một flow vừa phục vụ một paywall ở nơi khác.
• Một paywall triển khai thủ công và một flow không thể dùng chung một A/B test, vì mỗi loại cần placement type riêng. Để so sánh chúng, hãy triển khai dần flow đó trên placement riêng của nó rồi đo lường cả hai.
• Để chuyển một paywall placement sang flow, hãy tạo một flow placement mới với ID mới, sau đó phát hành bản cập nhật ứng dụng gọi đến placement đó. Xem Migrate to flows.
• Thứ duy nhất bạn hardcode trong ứng dụng là placement ID. Mọi thứ còn lại bạn quản lý từ dashboard mà không cần phát hành ứng dụng: flow hoặc paywall nào được phục vụ, phân khúc đối tượng, và A/B test.
• Placement ID phải khớp chính xác với ID trên dashboard. Sao chép nó mà không có khoảng trắng thừa. Nếu ID không khớp, request từ SDK sẽ thất bại và SDK sẽ dùng file dự phòng cục bộ nếu bạn đã thiết lập.
• Chỉ áp dụng với Old Paywall Builder — tắt Show on device không xóa paywall khỏi placement của nó. Placement vẫn phân giải đến paywall đó mà không có cấu hình builder, khiến ứng dụng không có gì để hiển thị. Để ngừng hiển thị một paywall, hãy xóa nó khỏi đối tượng của placement.

Danh sách placement

Để xem tất cả các placement của bạn, hãy vào Placements từ menu chính của Adapty. Bạn sẽ thấy chúng được phân loại theo loại: Paywalls, Onboardings và Flows.

Mỗi tab hiển thị toàn bộ các vị trí trong hành trình người dùng nơi các flow, paywall, onboarding hoặc A/B test có thể xuất hiện. Mỗi mục trong danh sách tương ứng với một placement cụ thể, giúp bạn dễ dàng quản lý và chỉnh sửa.

Bạn có thể chỉnh sửa thông tin chi tiết của placement, liên kết chúng với flow, paywall, onboarding hoặc A/B test mong muốn cho một đối tượng cụ thể, hoặc xóa các placement không cần thiết. Các số liệu trong bảng phản ánh analytics của các placement kể từ khi chúng được kích hoạt.

Từ đây bạn có thể:

• Tạo placement mới
• Chỉnh sửa placement hiện có
• Xóa placement hiện có
• Tải xuống fallback cục bộ cho flow, paywall hoặc onboarding. Các tệp này được dùng khi người dùng mở ứng dụng mà không có kết nối đến backend Adapty (không có internet, hoặc trường hợp hiếm gặp khi backend bị lỗi) và không có cache trên thiết bị. Cùng một lần tải Fallbacks sẽ bao gồm cả flow lẫn paywall — phiên bản SDK bạn chọn trong hộp thoại tải xuống sẽ quyết định bundle có bao gồm flow (SDK 4.0+) hay chỉ có paywall.