--- title: "Thu thập email người dùng cho Adapty Mail" description: "Truyền email và mã định danh ổn định của người dùng vào Adapty để các chiến dịch có thể tiếp cận người dùng của bạn." --- 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 \{#collect-user-emails\} 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. 1. **Đị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](identifying-users), [Android](android-identifying-users), [React Native](react-native-identifying-users), [Flutter](flutter-identifying-users), [Unity](unity-identifying-users), [Kotlin Multiplatform](kmp-identifying-users), [Capacitor](capacitor-identifying-users). 2. **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](setting-user-attributes), [Android](android-setting-user-attributes), [React Native](react-native-setting-user-attributes), [Flutter](flutter-setting-user-attributes), [Unity](unity-setting-user-attributes), [Kotlin Multiplatform](kmp-setting-user-attributes), [Capacitor](capacitor-setting-user-attributes). :::important - 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: 1. Vào **Customers → Profiles**. 2. 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 \{#email-collection-strategies\} 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](api-mail/operations/saveProfile) của Adapty Mail API. Xem [Gửi email và giao dịch qua Adapty Mail API](mail-send-data-via-api). | ## Giới hạn \{#limitations\} - **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.