Mỗi email mà Adapty Mail gửi đều chứa một link checkout duy nhất dành riêng cho người nhận đó. Khi họ nhấp vào, họ sẽ đến một web checkout funnel nhận dạng họ theo hồ sơ người dùng, hiển thị ưu đãi của bạn và xử lý thanh toán. Các checkout funnel nằm trong Web Paywalls bên trong Adapty Mail và được chỉnh sửa trong web paywall builder tích hợp sẵn.

Yêu cầu

• Một nhà cung cấp thanh toán web đã được cấu hình với các sản phẩm gói đăng ký của bạn. Generate with AI chỉ hỗ trợ Stripe và kết nối trong builder. Use your own hosted paywall chấp nhận bất kỳ nhà cung cấp nào — Stripe, Paddle, PayPal hoặc khác — vì việc thanh toán được xử lý ở phía bạn.

Bạn không cần tài khoản riêng để dùng web paywall builder. Nó được tích hợp sẵn với Adapty Mail: một workspace sẽ được tự động tạo lần đầu tiên bạn đăng nhập, và bạn được đăng nhập vào editor bằng thông tin đăng nhập Adapty của mình. Điều này độc lập với bất kỳ web paywall nào bạn có thể đã cấu hình trên trang paywall của Adapty Dashboard chính — các web paywall của Adapty Mail là các thực thể riêng biệt, được quản lý hoàn toàn từ Adapty Mail.

Thiết lập checkout funnel của bạn

Trong Adapty Mail, đi tới Web Paywalls → Create. Bạn có hai lựa chọn:

• Generate with AI: Web paywall builder tích hợp của Adapty Mail sẽ tự động tạo funnel cho bạn. Chỉ hỗ trợ Stripe — đối với Paddle hoặc PayPal, hãy dùng lựa chọn thứ hai.
• Use your own hosted paywall: Kết nối một paywall bạn đã tự host, trên bất kỳ nhà cung cấp thanh toán nào.

Generate with AI

Trang Create hiển thị bảng Prerequisites ở đầu trang với các nút thao tác nội tuyến hướng dẫn bạn qua từng điều kiện tiên quyết — sẵn sàng thương hiệu, đăng nhập builder, kết nối Stripe, sản phẩm và bước xem lại và đăng cuối cùng. Thực hiện từng bước; bảng sẽ tự động làm mới khi mỗi bước hoàn tất.

Khi các điều kiện tiên quyết đã xanh, nhấp Generate để mở hộp thoại tạo. Có hai lựa chọn cần thực hiện:

• Environment: Chọn Production hoặc Sandbox. Sandbox sử dụng các sản phẩm chế độ test Stripe của bạn và là lựa chọn mặc định an toàn cho môi trường dev và local — tài khoản của nó được tách biệt hoàn toàn khỏi môi trường production, nên các giao dịch test không bao giờ ảnh hưởng đến dữ liệu thực.
• Plans: Chọn tối đa 3 Stripe plans. Mỗi plan là một tổ hợp sản phẩm + giá. Paywall sẽ trình bày các plan này dưới dạng các ưu đãi tại checkout. Nếu bạn chọn ít hơn 3, paywall chỉ hiển thị các plan bạn đã chọn.

Nhấp Generate để chạy quá trình tạo. Khi hoàn tất, mở editor trong builder để xem lại kết quả và đăng. Sau đó, nhấp Save.

Để biết chi tiết về nhà cung cấp thanh toán trong builder (tài khoản Stripe, chế độ test vs live, thiết lập sản phẩm), xem Cấu hình web paywall.

Sử dụng paywall tự host

Theo hướng này, Adapty Mail sẽ chuyển người nhận đến một trang do bạn tự host và thay thế các giá trị của từng người nhận vào URL. Mọi thứ sau khi nhấp — ưu đãi, thanh toán, cá nhân hóa — đều diễn ra ở phía bạn, với bất kỳ nhà cung cấp thanh toán nào.

1. Trong Web Paywalls → Create, chọn Enter URL manually.
2. Dán URL paywall tự host của bạn kèm các placeholder dưới dạng query parameter. Adapty Mail sẽ thay thế chúng theo từng người nhận để trang có thể xác định được khách truy cập. Ví dụ:

   https://example.com/paywall?email={email}&adapty_profile_id={adapty.external_profile_id}

3. Đặt Name cho paywall và lưu lại. Sau đó bạn có thể gắn nó vào các chiến dịch.

Trang Create liệt kê các placeholder bạn có thể dùng và đánh dấu từng placeholder tìm thấy trong URL bạn dán vào:

Placeholder	Value
{email}	Địa chỉ email của người nhận.
{adapty.external_profile_id}	ID hồ sơ người dùng của người nhận trong Adapty.
{funnelfox.external_profile_id}	ID hồ sơ người dùng của người nhận trong FunnelFox.
{custom.external_profile_id}	ID người dùng bạn đã gửi qua Adapty Mail API.
{scheduled_email_id}	ID của email chứa liên kết.

Ba placeholder ID hồ sơ tương ứng với ba nguồn mà một hồ sơ có thể đến, và trang này liệt kê tất cả chúng dù dự án của bạn có sử dụng hay không. Hãy chọn cái phù hợp với cách bạn gửi dữ liệu: {adapty.external_profile_id} cho tích hợp Adapty, {custom.external_profile_id} cho API. Một placeholder mà người nhận không có giá trị sẽ được phân giải thành chuỗi rỗng, vì vậy nó không bao giờ xuất hiện dưới dạng văn bản thô trên trang của bạn — còn một placeholder mà Adapty Mail không nhận ra sẽ được truyền qua đúng như bạn đã nhập.

Trang của bạn cần làm gì

Phần của Adapty Mail kết thúc tại redirect. Hai nhiệm vụ còn lại là của bạn:

• Xác định người dùng trước khi thanh toán bắt đầu: Đọc profile ID hoặc email từ query string và gắn vào giao dịch mua, để khoản thanh toán được ghi nhận đúng khách hàng mà email đã gửi tới.
• Báo cáo lại giao dịch mua: Adapty Mail không thấy các khoản thanh toán được thực hiện trên provider của bạn, và một giao dịch mua mà nó không biết sẽ không được tính là chuyển đổi cũng như doanh thu được ghi nhận attribution trong Analytics — tệ hơn nữa, phần còn lại của chuỗi email vẫn tiếp tục gửi tới người dùng đã mua rồi. Hãy gửi thông tin qua bất kỳ đường nào hiện đã mang dữ liệu của bạn: Adapty integration, hoặc một transaction event trên Adapty Mail API.

Kiểm tra trước khi ra mắt

Send test email giúp xác minh email hiển thị đúng và trang của bạn nhận được thanh toán, nhưng Sandbox không thể chọn được đối với paywall được thêm bằng URL — modal sẽ thông báo “This paywall has no sandbox products, so only production is available.” Vì vậy, lần test sẽ đi đến trang thực tế với sản phẩm thật: dùng thẻ thật rồi hoàn tiền, hoặc trỏ URL đến môi trường test của bạn trong khi kiểm tra kết nối. Xem Kiểm tra thiết lập của bạn.

Giao diện checkout trông như thế nào

Khi người dùng nhấp vào link checkout, họ sẽ đến Main conversion page. Sau khi họ thực hiện thanh toán, họ sẽ thấy Payment success hoặc Payment failed — chỉ hiển thị một trang cho mỗi lần thử.

Main conversion page Một trang trình bày bán hàng toàn trang. AI tạo nội dung và hình ảnh cho từng phần:

Phần	Nội dung AI tạo
Headline	Tiêu đề đậm, hướng đến lợi ích
Subheadline	Đề xuất giá trị bổ sung
Offer badge	Badge tạo cảm giác cấp bách (không bịa đặt giá — sử dụng ngôn ngữ khuyến mãi chung)
CTA button	Văn bản hướng đến hành động, 2–5 từ
Benefits	3–6 thẻ lợi ích dạng emoji + văn bản
Features	3–8 mô tả tính năng với tiêu đề và phụ đề
Plans	Tiêu đề lựa chọn plan và văn bản đồng hồ đếm ngược ưu đãi
Social proof	Văn bản chứng minh cộng đồng và 3–5 đánh giá người dùng thực tế
FAQ	3–6 câu hỏi và câu trả lời phổ biến
Guarantee	Văn bản đảm bảo hoàn tiền hoặc đảm bảo sự hài lòng

Payment success Thông báo chúc mừng kèm các bước tiếp theo và hình ảnh do AI tạo.

Payment failed Thông báo thân thiện nhắc người dùng thử lại. Trạng thái checkout được giữ nguyên.

Cách cá nhân hóa hoạt động

Mỗi liên kết CTA trong email đều trỏ đến một URL thanh toán được tạo riêng cho người nhận đó. Trước khi gửi, Adapty Mail thay thế từng placeholder trong URL paywall của bạn bằng giá trị tương ứng của người nhận:

https://example.com/paywall?email=jane@example.com&adapty_profile_id=6f2a...c91

Một paywall được tạo tự động sẽ nhận các tham số này mà không cần cấu hình gì trong trình tạo paywall trên web. Với paywall bạn thêm bằng URL, bạn chọn những placeholder muốn đưa vào. Khi người dùng nhấp vào, trang thanh toán đọc các tham số để nhận diện họ. Khi mua hàng hoàn tất, Adapty khớp doanh thu với địa chỉ email cụ thể đã tạo ra chuyển đổi đó. Dữ liệu này xuất hiện trong Phân tích chiến dịch.

Xử lý sự cố

Vấn đề	Giải pháp
Link thanh toán không mở được	Kiểm tra xem paywall đã được xuất bản trong trình tạo paywall web chưa
Người dùng không được xác định khi thanh toán	Đảm bảo Adapty.identify() đã được gọi với đúng user ID trước khi email được gửi
Lượt mua không được gán cho email	Attribution được tính theo lượt click vào CTA trong email, vì vậy người nhận phải truy cập vào trang thanh toán qua đúng link đó, và lượt mua phải được Adapty Mail nhận trên cùng một hồ sơ người dùng. Lượt mua đã được gán cho email trước đó sẽ giữ nguyên attribution đó