Trong hướng dẫn này, bạn sẽ thiết lập Adapty Mail và khởi chạy chiến dịch marketing đầu tiên. Các chiến dịch giao dịch (tin nhắn dịch vụ, chẳng hạn như xác nhận đăng ký) nằm ngoài phạm vi của bài viết này.

Quá trình thiết lập gồm mười phần:

• Trước khi bắt đầu
• 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 email
• 5. Thêm địa chỉ công ty của bạn
• 6. Chọn loại điểm đến email
• 7. Thiết lập web paywall
  • Tùy chọn A: Tạo bằng AI
  • Tùy chọn B: Sử dụng paywall do bạn tự host
• 8. Tạo chiến dịch bằng AI
• 9. Khởi chạy một flow
• 10. Bắt đầu gửi
• Xử lý sự cố
• Tìm hiểu thêm

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 mọi 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 (khuyến nghị)	Standalone
Đăng ký	Đăng nhập bằng tài khoản Adapty 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 chuyển giao các giao dịch mua của mình sang Adapty: chế độ observer dễ thiết lập, chỉ ghi lại các giao dịch của bạn, là đủ rồi.	Đăng ký chỉ dùng 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 vào, thông qua FunnelFox hoặc API.
Trang thanh toán (Bước 7)	Tạo bằng AI — trang thanh toán được lưu trữ xây dựng xoay quanh thương hiệu của bạn, tích hợp thanh toán Stripe — hoặc paywall tự lưu trữ của bạn	Paywall tự lưu trữ của 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 — thứ 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 ứng dụng của bạn trước khi bạn đến, nếu có	Được xây dựng từ URL cửa hàng mà bạn dán vào
Dữ liệu mua hàng (Bước 2)	Một cú nhấp trong Settings > Project; FunnelFox và API cũng hoạt động được	Secret key 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 của bạn

Adapty Mail chọn người nhận, đưa từng người vào một flow, và gán doanh thu cho email đã thúc đẩy lần mua đó. Toàn bộ quá trình này được vận hành bởi ba loại dữ liệu:

• Địa chỉ email của họ (bắt buộc): Địa chỉ nhận email của bạn, phải qua xác minh địa chỉ.
• Customer user ID của họ (tùy chọn, nhưng nên có): Mã định danh duy nhất của người dùng. Adapty lưu trữ nó 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ó, Adapty sẽ tạo một hồ sơ 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ọ (tùy chọn, nhưng nên có): Các sự kiện dùng thử, gia hạn, hủy và hoàn tiền theo thời gian thực. Điều 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, người dùng chỉ có thể nhận được chuỗi email 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 app của bạn đã chạy Adapty SDK. Adapty 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 app, hãy thêm phần xác định danh tính 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 lưu trữ dữ liệu này, nếu app không có 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 tại Settings > Project dùng để xác thực các yêu cầu. 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 qua web funnel của FunnelFox. FunnelFox đã lưu sẵn email, giao dịch mua và các sự kiện gói đăng ký của họ, rồi tự động chuyển tiếp sang Adapty Mail — không cần làm gì với SDK, cũng không cần viết request. 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 điểm đầu vào cùng lúc. Adapty Mail ghép người dùng theo địa chỉ email. Hai nguồn báo cùng một địa chỉ sẽ gộp vào một hồ sơ người dùng; hai địa chỉ khác nhau sẽ tạo ra hai hồ sơ riêng biệt, dù customer_user_id giống nhau.

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. Tên miền phải có hậu tố cấp cao nhất (yourapp.com). Adapty Mail không chấp nhận tên miền con (app.yourapp.com) hoặc tên miền có hậu tố cấp hai (yourapp.co.uk, yourapp.com.br).

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

3. Nhấp vào Add domain.

   

4. Trong domain registrar của bạn, hãy thêm tất cả các 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 thư, bản ghi cho hộp thư dùng để làm ấm domain, và bản ghi cho go.yourapp.com — nơi 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 cần thêm. Để xuất tất cả cùng lúc, nhấn Export.

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

6. Nhấn Check để xác minh ngay, hoặc thoát khỏi thẻ và để Adapty Mail tự động 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. Chọn loại đích đến cho email

Chọn nơi email sẽ dẫn người dùng đến. Email destination là địa chỉ trang bạn lưu lại và có thể tái sử dụng — bất kỳ số lượng chiến dịch nào cũng có thể trỏ đến cùng một đích. Tùy theo loại chiến dịch, Adapty Mail cung cấp các loại đích đến khác nhau, được trình bày chi tiết trong Email destinations. Một chiến dịch chưa có đích đến sẽ không thể lưu được. Hướng dẫn này xây dựng một chiến dịch marketing, vì vậy cần một web paywall.

Loại điểm đến	Nội dung điểm đến	Nơi sử dụng
Web Paywall	Trang thanh toán trên trình duyệt, nơi các giao dịch mua là thanh toán web thay vì giao dịch qua App Store hoặc Google Play.	Các chiến dịch marketing
Deep Link	Một màn hình trong ứng dụng của bạn. Nếu thiết bị chưa cài ứng dụng, liên kết sẽ dẫn đến trang cửa hàng.	Email kích hoạt ứng dụng, sau khi mua hàng trên web
Cancellation Page	Trang quản lý tài khoản và gói đăng ký — do bạn hoặc nhà cung cấp dịch vụ thanh toán của bạn lưu trữ.	Email gửi một lần thông báo cho người đăng ký mới nơi quản lý gói đăng ký của họ

Trong Adapty Mail, vào Email Destinations, giữ Web Paywall được chọn và nhấn Create. Đặt Name cho destination.

7. Thiết lập web paywall

Điền vào trường URL trên destination bạn vừa tạo. Adapty Mail có thể tạo paywall cho bạn, hoặc bạn có thể tự host:

Tùy chọn	Cách trang được tạo	Yêu cầu
Generate with AI	Adapty Mail xây dựng trong builder tích hợp sẵn, được hỗ trợ bởi FunnelFox.	Stripe và một dự án được liên kết với ứng dụng Adapty
Use your own hosted paywall	Bạn tự xây dựng và lưu trữ. Adapty Mail chuyển hướng đến đó kèm theo thông tin người nhận trong URL.	Bất kỳ nhà cung cấp thanh toán nào, cộng với code của bạn để truyền external_profile_id từ URL đến một transaction event.

Lựa chọn A: Tạo bằng AI

Under the URL field, find the generate one with AI link. Click it.

Expand the Generation setup panel and complete its six steps in order. Each button opens the page where that step happens, so click Refresh when you come back.

Checklist item	What to do
1. Brand is ready	Already ticked if you’ve set up your brand. If not, click Set up brand.
2. Log in to the paywall builder dashboard	Click Log in to authenticate the builder.
3. Stripe account connected	Click Connect Stripe and connect your account.
4. At least one Stripe product with a price	Click Open Stripe dashboard and add a product with a price.
5. Generate the paywall	5.1. Click Generate. 5.2. Pick up to three plans. Click Add plan for each one after the first. 5.3. Give each plan a production price, a sandbox price, or both, all in one currency. Fill the same column for every plan — a partly filled column blocks generation. Without sandbox prices, test emails hit the production paywall, where test purchases don’t work. 5.4. Click Generate paywall. It takes a few minutes, and the URL field fills itself when it’s done.
6. Review and publish the paywall in the builder	Click Open editor, then review and publish. Disabled until you’ve generated the paywall.

Once the paywall is published, click Save.

Phương án B: Dùng paywall do bạn tự lưu trữ

1. Dán URL của paywall bạn đang lưu trữ vào URL, với các placeholder làm query parameter. URL phải dùng HTTPS. Adapty Mail sẽ thay thế các placeholder cho từng người nhận để trang thanh toán 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ể dùng, và sẽ chặn việc lưu nếu phát hiện placeholder không hợp lệ. Xem Cài đặt checkout để biết mỗi placeholder tương ứng với giá trị gì. 2. Nhấn Save.

Cài đặt checkout hướng dẫn toàn bộ quy trình tạo, nội dung trang được tạo ra gồm những gì, và một trang self-hosted cần làm gì.

8. 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ấn Create.

2. Trong hộp thoại New marketing campaign, chọn lý do khách hàng nhận những email này: một sản phẩm họ chưa mua, một gói đăng ký họ đã hủy, hoặc một lần thanh toán thất bại. Bạn không thể thay đổi điều này sau, và chiến dịch chỉ xuất hiện trong flow cho tình huống bạn chọn. Nhấn Continue.

3. Đặt tên cho chiến dịch.

4. Trong dropdown Email Destination (Web Paywall), chọn web paywall bạn đã thêm ở bước trước.

   

5. Nhấp vào Generate emails.

6. Điền vào hộp thoại tạo — giọng điệu, 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 mỗi trường có tác dụng gì.

   

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

8. 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 riêng lẻ, 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.

   

9. Nhấp Create để lưu chiến dịch.

Adapty Mail lưu chiến dịch ở trạng thái draft. Nó sẽ không gửi gì cho đến khi bạn gắn nó vào một flow ở bước tiếp theo.

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

Adapty Mail bao gồm các flow riêng. Một flow kết nối các trigger (sự kiện gói đăng ký) với các campaign (chuỗi email). Mỗi 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 đến tất cả mọi người khi họ kích hoạt trigger, hoặc dùng các phân khúc để gửi campaign khác nhau cho từng nhóm người dùng khác nhau.

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 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ị 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 nội dung cho từng trigger.

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

3. Trong hộp thoại:
   • Chọn một Segment. All Users nhắm mục tiêu đến tất cả mọi người kích hoạt trigger này, và như vậy là đủ để bắt đầu. Để thu hẹp đối tượng sau này, hãy tạo một phân khúc khác — một tập con đã được lọc từ người dùng của bạn, dựa trên 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 8.
4. Nhấp Save. Flow đã hoạt động — không có nút khởi chạy riêng.
   • Người dùng kích hoạt trigger và khớp với phân khúc sẽ tham gia campaign ngay lập tức. Email đầu tiên sẽ được gửi sau khoảng Delay của nó.
   • Mỗi email có Delay riêng — khoảng thời gian chờ sau email trước đó. Bạn có thể chỉnh sửa chúng trong trình chỉnh sửa campaign.
   • Adapty Mail chỉ gửi trong khoảng từ 08:00 đến 21:00 theo múi giờ của người nhận. Nếu thời điểm gửi nằm ngoài khung giờ đó, email sẽ được dời sang thời điểm gần nhất trong khung giờ cho phép.
   • Email đầu tiên được miễn trừ nếu thời điểm gửi nằm trong vòng hai giờ kể từ khi trigger kích hoạt. Email đó sẽ được gửi đúng giờ, kể cả vào ban đêm.

10. Bắt đầu gửi

Chiến dịch của bạn đã được cấu hình 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 điểm vào bạn đã chọn. Việc project 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 luồng dữ liệu từ Adapty, không ảnh hưởng đến nội dung dữ liệu nhận được:

Dữ liệu của bạn đến từ	Dự án Mail của bạn được liên kết với một ứng dụng Adapty	Phải làm gì
Adapty SDK	Có	Trong Adapty Mail, vào Settings > Project và, trong phần Data integration, nhấn Enable Adapty integration.
Adapty SDK	Không	Adapty có thể cung cấp dữ liệu cho một dự án 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, qua Adapty Mail API	Cả hai	Bắt đầu gửi hồ sơ người dùng và sự kiện 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 kỳ email 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 đến trong khoảng một phút.

Từ đây, những người dùng kích hoạt trigger và khớp với phân khúc của bạn sẽ vào campaign. Trước khi để người dùng thực vào, hãy kiểm tra toàn bộ chuỗi với một người dùng thử.

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 bị thiếu. Tooltip của nút sẽ chỉ rõ cái nào. Xem Bước 3 và Bước 5
Tạo paywall bị chặn	Bảng điều khiển sẽ nêu 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 thể lưu campaign	Mỗi campaign cần có một điểm đến. Tạo một cái trong Bước 6
Không thể chỉnh sửa điểm đến	Điểm đến sẽ trở thành chỉ đọc khi bạn gắn nó vào một campaign. Hãy tạo điểm đến mới và chọn điểm đến đó.
Bản ghi DNS không xác minh được	Kiểm tra xem chúng có khớp chính xác không — không có dấu chấm ở cuối, đúng CNAME target, một giá trị mỗi bản ghi. DNS có thể mất đến 48 giờ để lan truyền
Cửa sổ xác minh đã hết hạn	Thêm lại tên miền trong Settings > DNS để bắt đầu cửa sổ mới. Các bản ghi tại nhà đăng ký của bạn vẫn còn hiệu lực — không cần thêm lại ở đó
Tạo email bị timeout	Quá trình tạo sẽ dừng sau 5 phút. Thử lại, và liên hệ hỗ trợ Adapty nếu vẫn tiếp tục thất bại
Người nhận thử nghiệm không nhận được email	Địa chỉ trong hồ sơ người dùng có thể đã không qua được bước kiểm tra mà Adapty Mail thực hiện cho mỗi hồ sơ mới. Hãy thử với địa chỉ khác

Đố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 thử flow của bạn: Chạy thử một người dùng test qua toàn bộ chuỗi trước khi khởi chạy.
• 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 domain gửi mail: Chi tiết bản ghi DNS, các cấp độ warm-up và khắc phục sự cố.
• Thiết lập checkout: Nội dung trang checkout và cách hoạt động của tính năng cá nhân hóa.
• Phân tích chiến dịch: Theo dõi khả năng gửi, mức độ tương tác và doanh thu.
• A/B test: Kiểm thử nhiều phiên bản chuỗi khác nhau.