Thu thập email người dùng cho Adapty Mail

Adapty Mail cần một customer_user_id ổn định và email cho mỗi người dùng mà nó gửi tới. Hãy kết nối cả hai trong code ứng dụng của bạn trước khi chạy chiến dịch.

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

Mỗi người dùng cần cung cấp cho Adapty hai giá trị: một customer_user_id ổn định để định danh người dùng, và email. Việc định danh phải được thực hiện trước — nếu không có nó, Adapty không có hồ sơ người dùng để gắn email vào.

Định danh người dùng. 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, ID phải được thiết lập trước khi hiển thị bất kỳ paywall nào.

Hướng dẫn theo nền tảng: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.
Truyền email. Ngay khi người dùng cung cấp email của họ, hãy gửi nó đến Adapty thông qua updateProfile bằng tham số email.

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

Luôn truyền một customer_user_id ổn định, không bao giờ dùng mã định danh ẩn danh. Nếu người dùng gỡ cài đặt và cài lại ứng dụng, Adapty dùng ID này để liên kết lần cài đặt lại với hồ sơ người dùng hiện có và gán các giao dịch mua về đúng người dùng.
Hãy xin sự đồng ý rõ ràng từ người dùng trước khi thu thập và gửi email đến Adapty. Bạn có trách nhiệm tuân thủ GDPR, CAN-SPAM và các quy định tương tự ở thị trường mục tiêu của mình.

Kiểm tra mức độ bao phủ email của bạn

Sau khi triển khai thu thập, hãy kiểm tra mức độ bao phủ trong Adapty:

Vào Customers → Profiles.
Lọc theo các hồ sơ người dùng đã có email.

Hãy đạt ít nhất 30–50% bao phủ email trong số người dùng đang hoạt động trước khi chạy chiến dịch đầu tiên. Bạn không cần đợi đến 100% — hãy ra mắt ngay khi đạt 30%. Những người dùng cung cấp email sau đó sẽ tự động được đưa vào các chiến dịch đang chạy khi họ đủ điều kiện.

Các 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.

Chiến lược	Phù hợp nhất với	Cách hoạt động
Xác thực hiện có	Ứng dụng có bất kỳ hình thức đăng nhập nào	Bạn đã có email — truyền nó cho Adapty sau khi người dùng xác thực. Xem tài liệu tham khảo về phương thức xác thực bên dưới để biết cách đọc nó.
Cổng email trước paywall	Ứng dụng không có xác thực — sức khỏe, wellness, chiêm tinh, chỉnh sửa ảnh	Thêm một màn hình nhập email giữa onboarding và paywall. Tỷ lệ chuyển đổi thường đạt 70–90% vì người dùng đã đầu tư thời gian.
Web paywall builder checkout	Ít tích hợp SDK; email được thu thập trên web	Màn hình đầu tiên của web paywall builder thu thập email và truyền vào Adapty — hữu ích cho người dùng click vào chiến dịch trước khi cổng trong ứng dụng được triển khai.
Bước trong onboarding	Onboarding dạng quiz (thể dục, dinh dưỡng, giáo dục)	Đặt ô nhập email ở bước 2–3 trong onboarding. Đóng khung như cung cấp giá trị (“Chúng tôi sẽ gửi email kế hoạch cá nhân hóa của bạn”) và tránh để bước này có thể bỏ qua.
Adapty Mail API	Gửi email từ server của bạn, không cần Adapty SDK	Gửi hồ sơ người dùng đến endpoint Save profile của Adapty Mail API. Xem Gửi email và giao dịch qua Adapty Mail API.

Giới hạn

Người dùng ẩn danh: Người dùng không có customer_user_id ổn định không thể nhận được chiến dịch. Hãy định danh họ khi họ tạo tài khoản hoặc đăng nhập — từ đó, mọi email họ cung cấp sẽ được khớp với hồ sơ người dùng Adapty của họ.
Người dùng không có email: Hồ sơ người dùng không có email sẽ bị loại khỏi việc gửi chiến dịch và không xuất hiện trong phân tích chiến dịch. Ngay khi họ cung cấp email, họ sẽ đủ điều kiện cho các chiến dịch trong tương lai.