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. customer_user_id là cách Adapty Mail liên kết các chiến dịch, lượt nhấp và giao dịch mua về đúng hồ sơ người dùng.

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 tính năng gửi

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

• Được liên kết với ứng dụng Adapty. Adapty đã tạo dự án này cho bạn vào lần đầu tiên bạn mở Mail từ Adapty Dashboard.

Trong Adapty Mail, vào Settings > Project và, trong phần Adapty Integration, nhấn Enable Adapty integration (hoặc Enable nếu tích hợp đã tồn tại từ lần thiết lập trước). Nút này sẽ bị vô hiệu hóa cho đến khi bạn có ít nhất một flow, với tooltip “Set up at least one flow before enabling Adapty integration”.

• Not linked. Bạn tự tạo dự án này trong Adapty Mail — dù trên tài khoản độc lập hay tài khoản Adapty.

  Phần Adapty Integration sẽ không xuất hiện, nhưng Adapty vẫn có thể cấp dữ liệu cho dự án — nó chỉ cần 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, dán key vào 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 sẽ gửi mọi sự kiện gói đăng ký — gói đăng ký mới, gia hạn, dùng thử, chuyển đổi, hoàn tiền, vấn đề thanh toán — vào Adapty Mail. Các sự kiện này điều khiển thành viên phân khúc, định tuyến chiến dịch và điều kiện dừng để tạm dừng chuỗi khi người dùng chuyển đổi.

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.