Kết nối Adapty với Adapty Mail

Adapty là một trong những điểm tích hợp của Adapty Mail — sử dụng khi ứng dụng của bạn đã chạy Adapty SDK. Adapty truyền hồ sơ người dùng, địa chỉ email và các sự kiện gói đăng ký sang Adapty Mail, Adapty Mail sử dụng chúng để chọn người nhận, đưa mỗi người vào một flow và ghi nhận doanh thu cho email đã thúc đẩy giao dịch mua đó.

Nếu ứng dụng của bạn không chạy Adapty SDK, hãy gửi dữ liệu tương tự từ server của bạn — xem Gửi email và giao dịch qua Adapty Mail API.

Adapty Mail cần ba thứ từ ứng dụng của bạn: dữ liệu mua hàng (để có thể gán doanh thu về đúng email đã dẫn đến mỗi lượt chuyển đổi), một mã định danh người dùng ổn định, và email của người dùng. Hãy thiết lập cả ba, sau đó cấu hình domain, checkout, chiến dịch và flow trong Adapty Mail, rồi mới bật tính năng gửi email sau cùng.

1. Để Adapty theo dõi doanh thu của bạn

Bước đầu tiên phụ thuộc vào việc bạn đã triển khai in-app purchase hay chưa:

• Nếu bạn đã triển khai in-app purchase với Adapty, bạn không cần làm gì thêm ở bước này.
• Nếu bạn đã triển khai in-app purchase mà không dùng Adapty và không có kế hoạch migrate sang Adapty, hãy cài đặt SDK cho nền tảng của bạn ở chế độ observer. Ở bước này, bạn chỉ cần thêm SDK vào dự án, kích hoạt nó với chế độ observer được bật, và báo cáo các giao dịch. Hướng dẫn theo nền tảng: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.
• Nếu bạn chưa triển khai in-app purchase và muốn dùng Adapty, hãy hoàn thành các bước trong hướng dẫn quickstart để ủy quyền xử lý mua hàng cho Adapty.

Sau đó, bật thông báo máy chủ App Store trong Adapty để nhận các cập nhật liên quan đến doanh thu trực tiếp từ App Store.

2. Xác định người dùng của bạn

Truyền một ID ổn định — ID người dùng từ backend, Firebase UID, hoặc tương tự — bằng cách truyền nó dưới dạng customerUserId vào .activate() khi khởi động SDK, hoặc gọi Adapty.identify() sau đó (ví dụ: khi đăng nhập). Dù theo cách nào, hãy đặt ID này trước khi hiển thị bất kỳ paywall nào. Adapty sử dụng ID này để duy trì một hồ sơ người dùng cho mỗi người qua các lần cài đặt lại và đăng nhập, và Adapty Mail lưu trữ ID đó trong số các external ID của hồ sơ. Adapty Mail khớp người dùng theo địa chỉ email, không phải theo ID này.

Hướng dẫn theo nền tảng: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.

3. Thu thập email người dùng

Khi người dùng cung cấp email trong ứng dụng của bạn (ví dụ: lúc đăng ký hoặc thanh toán), hãy truyền giá trị đó cho Adapty bằng cách gọi updateProfile với thuộc tính email. Mỗi người nhận trong một chiến dịch đều cần có giá trị này.

Hướng dẫn theo nền tảng: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.

Chiến lược thu thập email

Hầu hết các ứng dụng không thu thập email theo mặc định. Hãy chọn cách tiếp cận phù hợp với trạng thái hiện tại của ứng dụng bạn.

4. Thiết lập domain, trang thanh toán, chiến dịch và flow

Để gửi email, Adapty Mail yêu cầu:

• Một sending domain đã được xác minh
• Một trang thanh toán để các email của bạn liên kết đến
• Một chiến dịch để gửi
• Một flow quyết định ai sẽ nhận email đó

Hãy thiết lập cả bốn thứ trong Adapty Mail — làm theo các bước 3 đến 8 của hướng dẫn Bắt đầu với Adapty Mail.

5. Bật chức năng gửi

Bật integration là bước cuối cùng: sự kiện bắt đầu chạy, phân khúc bắt đầu khớp, và email bắt đầu được gửi. Việc Mail project của bạn có được liên kết với ứng dụng Adapty hay không chỉ thay đổi cách bạn bật nó, không ảnh hưởng đến nội dung nhận được:

• Liên kết với ứng dụng Adapty. Adapty đã tạo project này cho bạn lần đầu tiên bạn mở Mail từ Adapty dashboard.

  Trong Adapty Mail, vào Settings > Project và, trong phần Data integration, nhấp Enable Adapty integration (hoặc Enable nếu integration đã tồn tại từ lần cài đặt trước).

• Chưa được liên kết. Bạn tự tạo dự án này trong Adapty Mail — dù là trên tài khoản độc lập hay tài khoản Adapty.

  Phần Data integration không có nút Enable Adapty integration, nhưng Adapty vẫn có thể cung cấp dữ liệu cho dự án — chỉ cần có key.

  1. Trong Adapty Mail, vào Settings > Project và sao chép Secret key.
  2. Trong Adapty Dashboard, vào Integrations > Adapty Mail, bật tích hợp lên, dán key vào trường Secret Key, rồi lưu lại.

Cả hai cách đều tạo ra cùng một tích hợp trong Adapty — nút trong Adapty Mail sẽ tự động điền secret key cho bạn.

Khi được bật, Adapty gửi mọi sự kiện gói đăng ký — đăng ký mới, gia hạn, dùng thử, chuyển đổi, hoàn tiền, sự cố thanh toán — vào Adapty Mail. Các sự kiện này điều khiển tư cách thành viên phân khúc, định tuyến chiến dịch, và điều kiện dừng giúp tạm dừng một chuỗi khi người dùng chuyển đổi.

Hạn chế

• Người dùng ẩn danh: Nếu không có customer_user_id ổn định, Adapty sẽ tạo một profile ID mới mỗi khi ai đó cài lại ứng dụng hoặc đăng xuất. Các giao dịch mua trước khi họ cung cấp email sẽ không được ghi nhận vào hồ sơ người dùng Adapty Mail — chúng vẫn gắn với ID cũ. Doanh thu, trạng thái mua hàng và phân khúc của họ sẽ sai từ đó trở đi.
• Người dùng chưa có email: Adapty Mail sẽ không tạo hồ sơ người dùng nào cho người chưa cung cấp địa chỉ email. Không có gì để loại trừ khỏi danh sách gửi hay phân tích — đơn giản là họ không tồn tại trong hệ thống. Ngay khi có địa chỉ email, hồ sơ người dùng sẽ được tạo và họ trở thành đối tượng nhận email.