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 chín phần:

1. Chọn loại tài khoản của bạn
2. Kết nối dữ liệu của bạn
3. Thiết lập thương hiệu của bạn
4. Thiết lập tên miền gửi thư của bạn
5. Thêm địa chỉ công ty của bạn
6. Tạo một web paywall
7. Tạo campaign bằng AI
8. Khởi chạy một flow
9. Bắt đầu gửi thư

Adapty Mail theo dõi tiến trình của bạn trong danh sách kiểm tra onboarding và ẩn nó đi khi tất cả các bước đã hoàn thành.

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. Chọn loại tài khoản

Loại tài khoản quyết định dự án Adapty Mail của bạn có thể làm được những gì:

	Adapty-linked (được khuyến nghị)	Standalone
Đăng ký	Đăng nhập bằng tài khoản Adapty của bạn và mở Mail. Adapty tạo một project được liên kết với ứng dụng của bạn. Việc trao đổi dữ liệu giữa Adapty Mail và SDK bị tắt cho đến bước cuối cùng của quá trình thiết lập. Bạn không cần phải chuyển dữ liệu mua hàng sang Adapty: chế độ observer dễ thiết lập, chỉ báo cáo các giao dịch của bạn, là đã đủ.	Đăng ký chỉ cho Adapty Mail bằng địa chỉ email và mật khẩu. Không cần tài khoản Adapty và không cần cài đặt gì trong ứng dụng — bạn tự mang dữ liệu đến, thông qua FunnelFox hoặc API.
Trang thanh toán (Bước 6)	Generate with AI — một trang thanh toán được lưu trữ được xây dựng xung quanh thương hiệu của bạn, với thanh toán Stripe được tích hợp sẵn — hoặc paywall được lưu trữ của riêng bạn	Paywall được lưu trữ của riêng bạn
Phân khúc	Import từ Adapty hoặc xây dựng trong Mail	Xây dựng trong Mail
Thương hiệu — những gì email của bạn được tạo ra từ đó: tên, logo, màu sắc và giọng điệu (Bước 3)	Được xây dựng từ danh sách cửa hàng của ứng dụng trước khi bạn đến, nếu có	Được xây dựng từ URL cửa hàng bạn dán vào
Dữ liệu mua hàng (Bước 2)	Một cú nhấp chuột trong Settings > Project; FunnelFox và API cũng hoạt động	Khóa bí mật được dán vào Adapty dashboard hoặc FunnelFox, hoặc API
Nhóm	Các thành viên tham gia khi họ mở Mail từ công ty Adapty của bạn; cũng có thể mời qua email	Mời qua email

2. Kết nối dữ liệu

Trước khi Adapty Mail có thể gửi email cho người dùng, hệ thống cần:

• Địa chỉ email của họ: Nơi nhận email của bạn.
• Customer user ID của họ: Mã định danh duy nhất cho người dùng. Adapty lưu trữ thông tin này trong hồ sơ người dùng để nhận ra cùng một người trên nhiều thiết bị. Nếu không có mã này, Adapty sẽ tạo một hồ sơ người dùng mới mỗi khi họ cài đặt lại ứng dụng hoặc đăng xuất.
• Luồng sự kiện gói đăng ký của họ: Dùng thử, gia hạn, hủy và hoàn tiền — khi chúng xảy ra. Những sự kiện này cho phép bạn nhắm mục tiêu người dùng dựa trên hành vi của họ và liên kết doanh thu với email đã thúc đẩy giao dịch mua. Nếu không có luồng sự kiện, chuỗi email duy nhất mà người dùng có thể nhận được là chuỗi dành cho những người chưa bao giờ mua hàng.

Hãy làm theo hướng dẫn để tạo điểm đầu vào cho dữ liệu này:

• Adapty: Dùng tùy chọn này nếu ứng dụng của bạn đã chạy Adapty SDK. Adapty sẽ tự động chuyển tiếp hồ sơ người dùng, email và các sự kiện gói đăng ký, nên bạn không cần server riêng. Trong ứng dụng, hãy thêm phần định danh người dùng và thu thập email. Xem Kết nối Adapty với Adapty Mail.
• Adapty Mail API: Dùng tùy chọn này nếu bạn đã có backend riêng chứa dữ liệu đó, nếu ứng dụng không tích hợp Adapty SDK, hoặc nếu bạn import người dùng đăng ký từ nơi khác. Bạn tự gửi hồ sơ người dùng và các sự kiện giao dịch. Secret key ở Settings > Project dùng để xác thực các request. Xem Gửi email và giao dịch qua Adapty Mail API.
• FunnelFox: Dùng tùy chọn này nếu bạn thu hút và tính phí người dùng thông qua các web funnel của FunnelFox. FunnelFox đã lưu trữ email, lịch sử mua hàng và các sự kiện gói đăng ký của họ, đồng thời tự động chuyển tiếp tất cả sang Adapty Mail — không cần tích hợp SDK, cũng không cần viết request nào. Xem hướng dẫn tích hợp FunnelFox.
• Kết hợp nhiều nguồn: Bạn có thể dùng nhiều hơn một nguồn cùng lúc. Adapty Mail khớp dữ liệu người dùng đến dựa trên customer_user_id và địa chỉ email.

Adapty Mail bắt đầu gửi email khi phần còn lại của quá trình thiết lập đã hoàn tất.

3. Thiết lập thương hiệu của bạn

Adapty Mail không thể tạo email hoặc web paywall nếu không có thương hiệu. Thương hiệu lưu trữ thông tin mà Adapty Mail cần để phù hợp với giao diện và giọng điệu của ứng dụng — tên, logo, màu sắc, phông chữ, phong cách diễn đạt, tính năng và đánh giá. Bạn cung cấp thông tin từ store listing, và Adapty Mail sẽ xây dựng thương hiệu từ đó.

1. Trong Adapty Mail, mở Brand.
2. Nếu trang hiển thị thông tin thương hiệu đã điền sẵn, hãy xem lại và tiếp tục. Nếu hiển thị màn hình Set up your brand, làm theo các bước bên dưới.
3. Trong mục Store, chọn App Store hoặc Google Play, rồi dán URL trang sản phẩm của bạn.
   Note

   Màn hình thiết lập chỉ nhận URL từ App Store hoặc Google Play. Nếu ứng dụng của bạn chưa có trang sản phẩm trên cửa hàng — ví dụ như funnel web-to-app — hãy liên hệ bộ phận hỗ trợ Adapty trước khi tiếp tục.

4. Nhấn Build my brand. Adapty Mail sẽ tải trang, phân tích đánh giá và xác định phong cách thương hiệu của bạn. Quá trình này thường hoàn tất trong chưa đầy một phút.
5. Để xem lại các mục, chỉnh sửa thủ công, hoặc thêm nguồn từ landing page và mạng xã hội, xem Brand.

4. Thiết lập domain gửi email

Adapty Mail gửi email từ domain riêng của bạn. Bạn chỉ cần thêm bản ghi DNS một lần, và mọi chiến dịch đều sử dụng cùng một domain đã được xác minh.

Để đăng ký domain đầu tiên, trong Adapty Mail hãy vào Settings > DNS > phần Email domains.

1. 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.

2. Trong trường Sending subdomain, nhập tiền tố mà email của bạn gửi đi, hoặc để trống để sử dụng mail. Email sẽ được gửi từ hello@mail.yourapp.com.

3. Nhấp vào Add domain.

   

4. Trong nhà đăng ký tên miền của bạn, thêm tất cả các bản ghi DNS mà thẻ tên miền 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 email, bản ghi cho hộp thư dùng để làm ấm tên miền, và bản ghi cho go.yourapp.com dùng để 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.

5. Tùy chọn, thêm bản ghi DMARC TXT được đề xuất vào tên miền gốc của bạn (khuyến nghị).

6. Nhấn Check để xác minh ngay lập tức, hoặc thoát khỏi thẻ và để Adapty Mail tự kiểm tra DNS.

Tóm tắt thời gian xác minh:

• Tự động kiểm tra định kỳ: Lần kiểm tra đầu tiên chạy sau 1 phút kể từ khi bạn thêm tên miền, sau đó khoảng thời gian giữa các lần kiểm tra tăng gấp đôi, tối đa mỗi giờ một lần cho đến khi tìm thấy bản ghi.
• Kiểm tra thủ công: Nhấn 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 mất vài phút, trong trường hợp hiếm gặp có thể lên đế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 tên miền trong Settings > DNS để bắt đầu cửa sổ mới.

Một tên miền đã xác minh là đủ để bắt đầu sử dụng Adapty Mail. 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à quá trình khởi động tên miền, xem Thiết lập tên miền gửi của bạn.

5. Thêm địa chỉ công ty của bạn

Luật chống thư rác yêu cầu mỗi email marketing phải có địa chỉ bưu chính thực tế. Adapty Mail sẽ đặt địa chỉ của bạn vào footer của mỗi email chiến dịch, và sẽ chặn việc tạo chiến dịch cho đến khi bạn điền thông tin này.

1. Trong Adapty Mail, vào Settings > Company.
2. Trong phần Company address, điền Legal company name, Address line 1, City, Postal code, và Country. Address line 2 và State / Region là tùy chọn.
3. Nhấn Save.

6. Tạo web paywall

Khi người nhận nhấp vào CTA trong email, họ sẽ được dẫn đến một web paywall — trang thanh toán trên trình duyệt. Mỗi chiến dịch đều liên kết đến một web paywall, và Adapty Mail sẽ từ chối chiến dịch nào không có nó. Đây không phải là paywall trong ứng dụng của bạn: giao dịch mua được thực hiện ở đây là thanh toán web, không phải giao dịch qua App Store hay Google Play.

Bạn có hai lựa chọn:

• Tạo bằng AI: Tạo paywall với trình tạo tích hợp, được hỗ trợ bởi FunnelFox. Paywall được tạo ra sử dụng Stripe để xử lý thanh toán.
• Dùng paywall tự host: Trỏ Adapty Mail đến một trang bạn đã host sẵn, với bất kỳ nhà cung cấp nào bạn dùng. Adapty Mail chuyển hướng người dùng đến paywall của bạn, với thông tin người dùng được điền sẵn vào URL. Paywall tự host có thể dùng bất kỳ nhà cung cấp thanh toán nào.

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

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

Trang này hiển thị danh sách kiểm tra điều kiện tiên quyết với các nút nội tuyến — hãy hoàn thành 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 xét kết quả. Xem Thiết lập checkout để biết hướng dẫn đầy đủ. Nếu bạn hoàn thành một điều kiện tiên quyết ở tab khác, hãy nhấn Refresh trên danh sách kiểm tra để đồng bộ trạng thái.

Khi tất cả điều kiện tiên quyết đều có dấu xanh, hãy nhấn Proceed to generation. Trong hộp thoại Choose plans:

1. Chọn 1–3 gói, tất cả cùng một đơn vị tiền tệ. Mỗi gói là một ưu đãi mà paywall được tạo ra sẽ hiển thị khi thanh toán. Nhấp vào Add plan để thêm gói thứ hai và thứ ba.
2. Với mỗi gói, chọn giá production, giá sandbox tương ứng, hoặc cả hai. Giá production và giá sandbox trên cùng một hàng được tính là một gói.
3. Nhấp vào Generate paywall.

Điền đầy đủ thông tin cho mỗi gói hoặc để trống toàn bộ cột đó — một cột điền dở sẽ chặn quá trình tạo paywall. Nếu không có giá sandbox, các email kiểm tra sẽ dẫn đến paywall production và tính năng mua thử sẽ không hoạt động.

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.

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

Campaign là một chuỗi tối đa 15 email mà một người nhận sẽ nhận được theo thời gian. AI sẽ viết toàn bộ chuỗi dựa trên thương hiệu bạn đã thiết lập ở Bước 3: nội dung, thiết kế, hình ảnh hero và các liên kết thanh toán được cá nhân hóa.

1. Trong Adapty Mail, vào Campaigns và nhấp Create.

2. Đặt tên cho campaign.

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ữ, prompt 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ấn Generate. Quá trình tạo thường mất vài phút. Hệ thống sẽ hết thời gian 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ó nút Theme toggle (Auto, Light, Dark) để điều chỉnh 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ấn Create để lưu chiến dịch.

Chiến dịch được lưu dưới dạng bản nháp và chưa 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 “xuất bản” riêng trong trình chỉnh sửa chiến dịch.

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

Adapty Mail có các flow riêng. Một flow kết nối trigger (sự kiện gói đăng ký) với campaign (chuỗi email). Mỗi trigger trong số năm trigger — gói đăng ký sắp hết hạn, thanh toán thất bại, v.v. — có flow riêng của nó. Một flow có thể gửi một campaign cho tất cả mọi người khi trigger được kích hoạt, hoặc dùng phân khúc để gửi các campaign khác nhau đến các nhóm người dùng khác nhau.

1. Trong Adapty Mail, vào Flows, rồi 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 giao dịch mua nào.
   • 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ị thu hồi.
   • 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à gợi ý về giọng văn cho từng trigger.

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

3. Trong hộp thoại:
   • Chọn một Segment. All Users nhắm đến tất cả mọi người kích hoạt trigger này, và đủ để bắt đầu. Để thu hẹp đối tượng sau, hãy tạo một phân khúc khác — một tập con người dùng được lọc theo quốc gia, độ tuổi hoặc trạng thái gói đăng ký.
   • Đặt loại nội dung thành Campaign (tùy chọn A/B Test được đề cập trong A/B testing).
   • Chọn Campaign bạn đã lưu ở Bước 7.
4. Nhấn Save.

Flow sẽ hoạt động ngay lập tức — không có bước khởi chạy riêng. Kể từ thời điểm này, những người dùng khớp với phân khúc sẽ bắt đầu nhận được chiến dịch ngay khi họ kích hoạt sự kiện trigger.

9. 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 đến Adapty Mail. Hãy bắt đầu truyền dữ liệu qua entry point bạn đã chọn. Việc dự án của bạn có được liên kết với Adapty (Bước 1) hay không chỉ ảnh hưởng đến cách bạn bật nguồn dữ liệu Adapty, không ảnh hưởng đến nội dung dữ liệu đến:

Dữ liệu của bạn đến từ	Mail project của bạn được liên kết với ứng dụng Adapty	Cần làm gì
SDK Adapty	Có	Trong Adapty Mail, vào Settings > Project và nhấn Enable Adapty integration. Nút này sẽ không hoạt động cho đến khi bạn có một flow (Bước 8).
SDK Adapty	Không	Adapty có thể cung cấp dữ liệu cho một project chưa được liên kết — chỉ cần có key. Sao chép secret key từ Settings > Project và dán vào Adapty dashboard tại Integrations > Adapty Mail.
Backend của bạn, thông qua Adapty Mail API	Cả hai	Bắt đầu gửi các profile và sự kiện giao dịch. Các profile bạn gửi trước khi hoàn tất bước thiết lập này sẽ không nhận được bất kỳ nội dung nào — đó là lý do bước này được thực hiện cuối cùng.
FunnelFox	Cả hai	Sao chép secret key từ Settings > Project và dán vào FunnelFox tại Integrations > Adapty Mail. Dữ liệu sẽ bắt đầu xuất hiện sau khoảng một phút.

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ộ quy trình với một người dùng thử nghiệm.

Khắc phục sự cố

Vấn đề	Giải pháp
Generate emails bị mờ (không nhấn được)	Địa chỉ thương hiệu hoặc công ty của bạn đang bị thiếu. Tooltip của nút sẽ chỉ rõ cái nào. Xem Bước 3 và Bước 5
Việc tạo paywall bị chặn	Bảng điều khiển sẽ nêu rõ nguyên nhân: chưa có thương hiệu, chưa kết nối tài khoản Stripe, hoặc chưa có sản phẩm Stripe nào có giá. Khắc phục xong, nhấn Refresh để cập nhật danh sách kiểm tra
Không lưu được campaign	Mỗi campaign đều cần một web paywall. Tạo một cái ở Bước 6
Enable Adapty integration bị mờ (không nhấn được)	Adapty Mail cần có ít nhất một flow trước. Xem Bước 8
Bản ghi DNS không xác minh được	Kiểm tra lại xem chúng có khớp chính xác không — không có dấu chấm ở cuối, CNAME target đúng, mỗi bản ghi chỉ một giá trị. DNS có thể mất đến 48 giờ để phát tán
Cửa sổ xác minh đã hết hạn	Thêm lại domain trong Settings > DNS để bắt đầu cửa sổ xác minh mới. Các bản ghi tại nhà đăng ký tên miền của bạn vẫn còn hiệu lực — không cần thêm lại gì cả
Quá trình tạo email bị timeout	Việc tạo email sẽ dừng sau 5 phút. Hãy thử lại, và liên hệ bộ phận hỗ trợ Adapty nếu vẫn tiếp tục xảy ra

Đối với các lỗi ngoài quá trình thiết lập ban đầu, hãy xem các phần xử lý sự cố trong Thiết lập domain gửi mail của bạn và Thiết lập checkout.

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.