Xác định ngÆ°á»i dùng trong Capacitor SDK
Cách bạn quản lý giao dịch mua của ngÆ°á»i dùng phụ thuá»™c và o mô hình xác thá»±c của ứng dụng:
- Nếu ứng dụng không sá» dụng xác thá»±c backend và không lÆ°u trữ dữ liệu ngÆ°á»i dùng, xem phần vá» ngÆ°á»i dùng ẩn danh.
- Nếu ứng dụng có (hoặc sẽ có) xác thá»±c backend, xem phần vá» ngÆ°á»i dùng đã xác định.
Các khái niệm chÃnh:
- Hồ sÆ¡ ngÆ°á»i dùng là các thá»±c thể cần thiết để SDK hoạt Ä‘á»™ng. Adapty tá»± Ä‘á»™ng tạo chúng. Chúng có thể là ẩn danh (không có customer user ID) hoặc đã xác định (có customer user ID).
- Customer user ID là định danh tùy chá»n bạn tạo để Adapty liên kết ngÆ°á»i dùng của bạn vá»›i hồ sÆ¡ ngÆ°á»i dùng Adapty của há».
DÆ°á»›i đây là sá»± khác biệt giữa ngÆ°á»i dùng ẩn danh và ngÆ°á»i dùng đã xác định:
| NgÆ°á»i dùng ẩn danh | NgÆ°á»i dùng đã xác định | |
|---|---|---|
| Quản lý giao dịch mua | Khôi phục giao dịch mua ở cấp cá»a hà ng | Duy trì lịch sá» giao dịch mua trên nhiá»u thiết bị thông qua customer user ID |
| Quản lý hồ sÆ¡ ngÆ°á»i dùng | Hồ sÆ¡ má»›i má»—i lần cà i đặt lại | Cùng má»™t hồ sÆ¡ ngÆ°á»i dùng trên các phiên và thiết bị |
| TÃnh bá»n vững của dữ liệu | Dữ liệu ngÆ°á»i dùng ẩn danh gắn vá»›i thiết bị/lần cà i đặt | Dữ liệu ngÆ°á»i dùng đã xác định tồn tại trên các thiết bị và phiên |
NgÆ°á»i dùng ẩn danh
Nếu bạn không có xác thực backend, bạn không cần xỠlý xác thực trong mã ứng dụng:
- Khi SDK được kÃch hoạt lần đầu tiên khởi chạy ứng dụng, Adapty tạo má»™t hồ sÆ¡ ngÆ°á»i dùng má»›i cho ngÆ°á»i dùng.
- Khi ngÆ°á»i dùng mua bất cứ thứ gì trong ứng dụng, giao dịch mua nà y được liên kết vá»›i hồ sÆ¡ ngÆ°á»i dùng Adapty và tà i khoản cá»a hà ng của há».
- Khi ngÆ°á»i dùng cà i đặt lại ứng dụng hoặc cà i đặt từ thiết bị má»›i, Adapty tạo má»™t hồ sÆ¡ ngÆ°á»i dùng má»›i trống khi kÃch hoạt.
- Nếu ngÆ°á»i dùng đã từng mua hà ng trong ứng dụng của bạn trÆ°á»›c đó, theo mặc định, giao dịch mua của há» sẽ được tá»± Ä‘á»™ng đồng bá»™ từ App Store khi SDK được kÃch hoạt.
Khôi phục từ bản sao lÆ°u hoạt Ä‘á»™ng khác vá»›i cà i đặt lại. Theo mặc định, khi ngÆ°á»i dùng khôi phục từ bản sao lÆ°u, SDK giữ nguyên dữ liệu đã lÆ°u trong bá»™ nhá»› đệm và không tạo hồ sÆ¡ ngÆ°á»i dùng má»›i. Bạn có thể cấu hình hà nh vi nà y bằng cà i đặt clearDataOnBackup. Tìm hiểu thêm.
NgÆ°á»i dùng đã xác định
- Nếu má»™t hồ sÆ¡ ngÆ°á»i dùng chÆ°a có customer user ID (nghÄ©a là ngÆ°á»i dùng chÆ°a đăng nháºp), khi bạn gá»i customer user ID, nó sẽ được liên kết vá»›i hồ sÆ¡ ngÆ°á»i dùng đó.
- Nếu đây là cà i đặt lại, đăng nháºp lại, hoặc cà i đặt từ thiết bị má»›i, và bạn đã gá»i customer user ID của há» trÆ°á»›c đó, thì không tạo hồ sÆ¡ ngÆ°á»i dùng má»›i. Thay và o đó, chúng tôi chuyển sang hồ sÆ¡ ngÆ°á»i dùng hiện có được liên kết vá»›i customer user ID.
Bạn có hai lá»±a chá»n để xác định ngÆ°á»i dùng trong ứng dụng:
-
Trong quá trình đăng nháºp/đăng ký: Nếu ngÆ°á»i dùng đăng nháºp sau khi ứng dụng khởi Ä‘á»™ng, hãy gá»i
identify()với customer user ID khi hỠxác thực. -
Trong quá trình kÃch hoạt SDK: Nếu bạn đã có customer user ID được lÆ°u trữ khi ứng dụng khởi chạy, hãy gá»i nó khi gá»i
activate().
Theo mặc định, khi Adapty nháºn được giao dịch mua từ má»™t Customer User ID hiện Ä‘ang được liên kết vá»›i Customer User ID khác, mức Ä‘á»™ truy cáºp sẽ được chia sẻ, vì váºy cả hai hồ sÆ¡ ngÆ°á»i dùng Ä‘á»u có quyá»n truy cáºp có trả phÃ. Bạn có thể cấu hình cà i đặt nà y để chuyển quyá»n truy cáºp có trả phà từ hồ sÆ¡ ngÆ°á»i dùng nà y sang hồ sÆ¡ ngÆ°á»i dùng khác hoặc tắt hoà n toà n tÃnh năng chia sẻ. Xem bà i viết để biết thêm chi tiết.
Trong quá trình đăng nháºp/đăng ký
Nếu bạn xác định ngÆ°á»i dùng sau khi ứng dụng khởi chạy (và dụ: sau khi hỠđăng nháºp và o ứng dụng hoặc đăng ký), hãy sá» dụng phÆ°Æ¡ng thức identify để đặt customer user ID cho há».
- Nếu bạn chÆ°a sá» dụng customer user ID nà y trÆ°á»›c đây, Adapty sẽ tá»± Ä‘á»™ng liên kết nó vá»›i hồ sÆ¡ ngÆ°á»i dùng hiện tại.
- Nếu bạn đã sá» dụng customer user ID nà y để xác định ngÆ°á»i dùng trÆ°á»›c đây, Adapty sẽ chuyển sang là m việc vá»›i hồ sÆ¡ ngÆ°á»i dùng được liên kết vá»›i customer user ID nà y.
Khi tạo customer user ID, hãy lÆ°u nó cùng vá»›i dữ liệu ngÆ°á»i dùng để bạn có thể gá»i cùng má»™t ID khi hỠđăng nháºp từ thiết bị má»›i hoặc cà i đặt lại ứng dụng của bạn.
Luôn await identify trÆ°á»›c khi gá»i các phÆ°Æ¡ng thức SDK khác. Các lá»i gá»i đồng thá»i sẽ tạo ra lá»—i #3006 profileWasChanged hoặc kết thúc trên hồ sÆ¡ ngÆ°á»i dùng ẩn danh. Xem Thứ tá»± gá»i trong Capacitor SDK.
try {
await adapty.identify({ customerUserId: "YOUR_USER_ID" });
// successfully identified
} catch (error) {
// handle the error
}Trong quá trình kÃch hoạt SDK
Nếu bạn đã biết customer user ID khi kÃch hoạt SDK, bạn có thể gá»i nó trong phÆ°Æ¡ng thức activate thay vì gá»i identify riêng.
Nếu bạn biết customer user ID nhÆ°ng chỉ đặt nó sau khi kÃch hoạt, Ä‘iá»u đó có nghÄ©a là khi kÃch hoạt, Adapty sẽ tạo má»™t hồ sÆ¡ ngÆ°á»i dùng má»›i trống và chỉ chuyển sang hồ sÆ¡ ngÆ°á»i dùng hiện có sau khi bạn gá»i identify.
Bạn có thể truyá»n customer user ID hiện có (cái bạn đã sá» dụng trÆ°á»›c đây) hoặc customer user ID má»›i. Nếu bạn truyá»n cái má»›i, hồ sÆ¡ ngÆ°á»i dùng má»›i được tạo khi kÃch hoạt sẽ tá»± Ä‘á»™ng được liên kết vá»›i customer user ID đó.
Äể loại trừ các hồ sÆ¡ ngÆ°á»i dùng trống đã tạo khá»i analytics của dashboard, hãy và o App settings và thiết láºp Installs definition for analytics.
await adapty.activate({
apiKey: "YOUR_PUBLIC_SDK_KEY",
params: {
customerUserId: "YOUR_USER_ID"
}
});Äăng xuất ngÆ°á»i dùng
Nếu bạn có nút để đăng xuất ngÆ°á»i dùng, hãy sá» dụng phÆ°Æ¡ng thức logout. Thao tác nà y tạo má»™t ID hồ sÆ¡ ngÆ°á»i dùng ẩn danh má»›i cho ngÆ°á»i dùng.
try {
await adapty.logout();
// successful logout
} catch (error) {
// handle the error
}Äể đăng nháºp lại ngÆ°á»i dùng và o ứng dụng, hãy sá» dụng phÆ°Æ¡ng thức identify.
Cho phép mua hà ng mà không cần đăng nháºp
Nếu ngÆ°á»i dùng của bạn có thể mua hà ng cả trÆ°á»›c và sau khi đăng nháºp và o ứng dụng, bạn không cần thiết láºp thêm:
Cách hoạt động:
- Khi ngÆ°á»i dùng chÆ°a đăng nháºp thá»±c hiện mua hà ng, Adapty liên kết giao dịch đó vá»›i ID hồ sÆ¡ ngÆ°á»i dùng ẩn danh của há».
- Khi ngÆ°á»i dùng đăng nháºp và o tà i khoản của há», Adapty chuyển sang là m việc vá»›i hồ sÆ¡ ngÆ°á»i dùng đã xác định của há».
- Nếu đây là customer user ID hiện có (customer user ID đã được liên kết vá»›i má»™t hồ sÆ¡ ngÆ°á»i dùng), Adapty sẽ tá»± Ä‘á»™ng đồng bá»™ các giao dịch của nó.
- Nếu đây là customer user ID má»›i (và dụ: giao dịch mua đã được thá»±c hiện trÆ°á»›c khi đăng ký), Adapt ÿÿ y sẽ gán customer user ID cho hồ sÆ¡ ngÆ°á»i dùng hiện tại, vì váºy toà n bá»™ lịch sá» giao dịch mua được duy trì.