Bắt đầu với Adapty Mail

Trong hướng dẫn này, bạn sẽ thiết lập Adapty Mail và khởi chạy flow email đầu tiên của mình.

Quá trình thiết lập gồm sáu phần:

1. Kết nối dữ liệu của bạn
2. Thiết lập tên miền gửi email
3. Tạo web paywall
4. Tạo chiến dịch với AI
5. Khởi chạy một flow
6. Bắt đầu gửi

Trước khi bắt đầu

Hãy đảm bảo những điều sau đã sẵn sàng trước khi bắt đầu:

• Quyền truy cập DNS: Bạn có thể thêm bản ghi vào tên miền gốc của mình.
• Thanh toán: Bạn có tài khoản Stripe với các sản phẩm gói đăng ký đã được cấu hình. Nếu muốn dùng nhà cung cấp khác, hãy tự host checkout — xem Thiết lập checkout.

1. Kết nối dữ liệu của bạn

Adapty Mail cần lịch sử mua hàng (để có thể quy gán doanh thu về đúng email đã thúc đẩy mỗi lần chuyển đổi), một mã định danh người dùng ổn định, và địa chỉ email của từng người dùng. Chuẩn bị điểm vào phù hợp với nơi dữ liệu đó đang tồn tại — bạn sẽ mở tap ở Bước 6, sau khi phần còn lại của quá trình thiết lập có thể xử lý những gì đến:

• Adapty: Nếu ứng dụng của bạn chạy Adapty SDK, hãy thiết lập xác định người dùng và thu thập email. Tạm thời để tắt tích hợp này — Adapty Mail sẽ chặn cho đến khi bạn có một flow. Xem Kết nối Adapty với Adapty Mail.
• Adapty Mail API: Nếu backend của bạn là nguồn dữ liệu chính, hãy lấy secret key từ Settings và xây dựng các request của bạn, nhưng chưa cần gửi. Các hồ sơ người dùng đến trước khi hoàn tất thiết lập sẽ không nhận được gì. Xem Gửi email và giao dịch qua Adapty Mail API.

Bạn có thể sử dụng nhiều điểm đầu vào cùng một lúc. Adapty Mail khớp dữ liệu đến dựa trên customer_user_id và địa chỉ email, vì vậy một người được nhận diện từ nhiều nguồn khác nhau vẫn chỉ có một hồ sơ người dùng và một chuỗi email.

2. Thiết lập tên miền gửi thư

Mở Adapty Mail: Nhấn vào logo Adapty ở phần header và chọn Mail.

Adapty Mail gửi thư từ tên miền của bạn. Bạn chỉ cần thêm bản ghi DNS một lần — tất cả các chiến dịch đều dùng chung tên miền đã xác minh đó.

1. Trong Adapty Mail, vào Settings → DNS và trong phần Email domains, nhấp vào Add domain.
2. Trong trường Domain, nhập tên miền gốc của bạn (ví dụ: yourapp.com). Chỉ chấp nhận apex domain — các subdomain như app.yourapp.com sẽ bị từ chối khi nhập.
3. Trong trường Sending subdomain, nhập tiền tố mà email của bạn sẽ được gửi từ đó, hoặc để trống để dùng mail. Email sẽ được gửi từ hello@mail.yourapp.com.
4. Nhấp vào Add domain.

5. Trong domain registrar của bạn, thêm mọi bản ghi DNS mà thẻ domain mới liệt kê. Chúng được chia thành ba nhóm: bản ghi DKIM và MAIL FROM của subdomain gửi mail, bản ghi cho mailbox dùng để khởi động domain, và bản ghi cho go.yourapp.com — phục vụ hình ảnh và các liên kết được theo dõi. Để biết mỗi nhóm xác thực điều gì, xem Những bản ghi bạn cần thêm. Để xuất tất cả cùng một lúc, nhấn Export.
6. Tùy chọn, thêm bản ghi TXT DMARC được đề xuất vào root domain của bạn (khuyến nghị).
7. Nhấn Check để xác minh ngay lập tức, hoặc thoát khỏi thẻ và để Adapty Mail tự động kiểm tra DNS.

Tổng quan về thời điểm xác minh:

• Tự động kiểm tra: Lần kiểm tra đầu tiên diễn ra 1 phút sau khi bạn thêm domain, sau đó khoảng thời gian giữa các lần kiểm tra tăng gấp đôi cho đến tối đa mỗi giờ một lần cho đến khi tìm thấy các bản ghi.
• Kiểm tra thủ công: Nhấp vào Check bất kỳ lúc nào để kích hoạt kiểm tra ngay lập tức.
• Lan truyền DNS: Thường chỉ vài phút, nhưng trong một số trường hợp hiếm gặp có thể mất đến 48 giờ.
• Cửa sổ xác minh: 7 ngày. Nếu hết hạn, các bản ghi DNS của bạn vẫn được giữ nguyên — hãy thêm lại domain trong Settings → DNS để bắt đầu cửa sổ mới.

Một tên miền đã xác minh là đủ để bắt đầu gửi. Một dự án có thể chứa tối đa năm tên miền, và bạn có thể thêm phần còn lại sau.

Để biết chi tiết về từng loại bản ghi và quy trình khởi động tên miền, xem Thiết lập tên miền gửi.

3. Tạo web paywall

Mỗi email đều liên kết đến một web paywall — trang thanh toán mà người dùng truy cập khi nhấp vào CTA. Bạn có hai lựa chọn:

• Tạo bằng AI: Để trình tạo web paywall tích hợp sẵn tạo một trang cho ứng dụng của bạn.
• Dùng paywall tự host: Kết nối một paywall bạn đã tự host.

Để bắt đầu, trong Adapty Mail vào Web Paywalls → Create.

Tùy chọn A: Tạo bằng AI

Trang hiển thị danh sách kiểm tra Prerequisites với các nút inline — hãy thực hiện theo thứ tự, sau đó quay lại và tạo. Danh sách kiểm tra bao gồm: đăng nhập vào paywall builder, kết nối Stripe, thêm sản phẩm, và xem lại kết quả. Xem Thiết lập checkout để biết hướng dẫn đầy đủ.

Khi tất cả điều kiện tiên quyết đã được đánh dấu xanh, nhấn Generate để mở hộp thoại tạo:

• Environment: Chọn Production hoặc Sandbox. Sandbox sử dụng sản phẩm ở chế độ test của Stripe và là lựa chọn mặc định an toàn cho môi trường dev và local.
• Plans: Chọn tối đa 3 Stripe plans (mỗi plan là một sản phẩm + giá). Đây là các ưu đãi mà paywall được tạo ra sẽ hiển thị cho người dùng khi thanh toán.

Nhấp Generate để bắt đầu quá trình tạo. Khi hoàn tất, mở editor để xem lại và xuất bản.

Lựa chọn B: Sử dụng paywall do bạn tự lưu trữ

1. Chọn Enter URL manually.

2. Dán URL của paywall do bạn tự lưu trữ kèm các placeholder dưới dạng query parameter. Adapty Mail sẽ thay thế chúng cho từng người nhận để trang checkout có thể nhận diện khách truy cập. Ví dụ:

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

   Trang Create liệt kê các placeholder bạn có thể sử dụng. Xem Thiết lập checkout để biết mỗi placeholder sẽ được thay thế bằng giá trị gì.

3. Lưu và xuất bản.

Để biết về cấu trúc luồng thanh toán và cách cá nhân hóa hoạt động, xem Thiết lập checkout.

4. Tạo chiến dịch với AI

AI sẽ tạo toàn bộ chuỗi email cho bạn — nội dung, thiết kế, ảnh hero và các link thanh toán được cá nhân hóa, tất cả đều phù hợp với thương hiệu của bạn.

1. Trong Adapty Mail, vào Campaigns và nhấp Create.
2. Đặt tên cho chiến dịch.
3. Trong dropdown Web paywall, chọn web paywall bạn đã thêm ở bước trước.

4. Nhấp vào Generate emails.
5. Điền vào hộp thoại tạo nội dung — giọng điệu, ngôn ngữ, câu lệnh tùy chỉnh (tùy chọn, tối đa 2.000 ký tự) và số lượng email (1–15, mặc định là 4). Xem Tạo chiến dịch để biết ý nghĩa của từng trường.

6. Nhấp Generate. Quá trình tạo thường mất vài phút. Hệ thống sẽ hết thời gian chờ sau 5 phút nếu không hoàn thành được — hãy thử lại nếu điều đó xảy ra.
7. Xem trước từng email. Thanh tiêu đề xem trước có Theme toggle (Auto, Light, Dark) để kiểm soát cách hiển thị bản xem trước — nội dung được tạo ra giống nhau ở tất cả các chế độ. Bạn có thể tạo lại từng email, chỉnh sửa nội dung, hoặc mở trình chỉnh sửa HTML để kiểm soát chi tiết hơn.

8. Nhấp Create để lưu chiến dịch. Chiến dịch sẽ được lưu ở trạng thái draft và chưa được gửi đi — chiến dịch chỉ hoạt động khi được gắn vào một flow (bước tiếp theo). Không có thao tác “publish” riêng trong trình chỉnh sửa chiến dịch.

5. Khởi chạy một flow

Một flow kết hợp một trigger (sự kiện như gói đăng ký hết hạn) với một phân khúc, và gửi cho phân khúc đó campaign mà bạn chọn. Adapty Mail đi kèm với năm trigger cố định, mỗi trigger có giao diện flow riêng.

1. Trong Adapty Mail, vào Flows, sau đó mở trigger bạn muốn cấu hình:

   • Never purchased — người dùng đã đăng ký nhưng chưa thực hiện mua hàng.
   • Renewal cancelled — người dùng đã tắt tự động gia hạn nhưng vẫn còn gói đăng ký đang hoạt động.
   • Billing issue — thanh toán thất bại, thẻ bị từ chối hoặc hết hạn, hoặc đang trong thời gian ân hạn.
   • Expired — gói đăng ký đã hết hạn và quyền truy cập bị mất.
   • Refunded — người dùng đã yêu cầu hoàn tiền sau khi mua.

   Xem Flows để biết mục tiêu và hướng dẫn về giọng văn phù hợp cho từng trigger.

2. Nhấn Create để mở hộp thoại.

3. Trong hộp thoại:
   • Chọn Segment (ví dụ: All Users để nhắm đến tất cả người dùng khi họ đạt trigger này, hoặc tạo phân khúc mới dựa trên các thuộc tính hồ sơ người dùng).
   • Giữ nguyên loại nội dung là Campaign (tùy chọn A/B Test được đề cập trong A/B testing).
   • Chọn Campaign bạn đã lưu ở Bước 4.
4. Nhấn Save.

Flow sẽ hoạt động ngay lập tức — không cần bước khởi chạy riêng. Từ thời điểm này, người dùng khớp với phân khúc sẽ bắt đầu nhận campaign ngay khi họ đạt đến trigger event.

6. Bắt đầu gửi

Chiến dịch của bạn đã được kết nối nhưng chưa hoạt động — chưa có dữ liệu người dùng nào được gửi đến Adapty Mail. Bắt đầu luồng dữ liệu là bước cuối cùng, và mỗi điểm đầu vào từ Bước 1 có cách khởi động khác nhau:

• Adapty: Trong Adapty Mail, vào Settings → Project và nhấp Enable Adapty integration. Nút này bị vô hiệu hóa cho đến khi bạn hoàn thành Bước 5, với tooltip “Set up at least one flow before enabling Adapty integration”. Xem Kết nối Adapty với Adapty Mail.
• Adapty Mail API: Bắt đầu gửi các sự kiện hồ sơ người dùng và giao dịch. Các hồ sơ người dùng bạn gửi trước khi hoàn tất thiết lập này sẽ không nhận được bất cứ điều gì, đó là lý do tại sao bước này được thực hiện cuối cùng. Xem Gửi email và giao dịch qua Adapty Mail API.

Từ đây, những người dùng khớp với phân khúc của bạn sẽ nhận được chiến dịch ngay khi họ kích hoạt trigger. Trước khi để người dùng thực sự tham gia, hãy kiểm tra toàn bộ chuỗi với một người dùng thử nghiệm.

Khắc phục sự cố

Tìm hiểu thêm

• Kiểm tra flow của bạn: Chạy thử một người dùng qua toàn bộ chuỗi trước khi ra mắt.
• Kết nối Adapty với Adapty Mail: Thiết lập SDK và các chiến lược để thu thập email nếu ứng dụng của bạn chưa thu thập chúng.
• Thiết lập tên miền gửi thư: Chi tiết bản ghi DNS, các cấp độ khởi động và khắc phục sự cố.
• Thiết lập checkout: Cấu trúc kênh checkout và cá nhân hóa.
• Phân tích chiến dịch: Theo dõi mức độ gửi thư, tương tác và doanh thu.
• A/B testing: Kiểm tra nhiều phiên bản chuỗi.