ÿÿ Xác định ngÆ°á»i dùng trong Adapty | Tài liệu Adapty
English 中文TürkçeРуÑÑкийEspañol日本語Tiếng Việt

Xác định ngÆ°á»i dùng trong Flutter SDK

Adapty tạo má»™t ID hồ sÆ¡ ná»™i bá»™ cho má»—i ngÆ°á»i dùng. Tuy nhiên, nếu bạn có hệ thống xác thá»±c riêng, bạn nên đặt Customer User ID của mình. Bạn có thể tìm ngÆ°á»i dùng theo Customer User ID của há» trong phần Profiles và sá»­ dụng nó trong server-side API, thứ sẽ được gá»­i đến tất cả các tích hợp.

Äặt Customer User ID khi cấu hình

Nếu bạn đã có user ID khi cấu hình, hãy truyá»n nó qua tham số customerUserId vào phÆ°Æ¡ng thức .activate():

   try {
       await Adapty().activate(
           configuration: AdaptyConfiguration(apiKey: 'YOUR_API_KEY')
             ..withCustomerUserId(YOUR_CUSTOMER_USER_ID)
       );
   } catch (e) {
       // handle the error
   }

Muốn xem ví dụ thá»±c tế vá» cách tích hợp Adapty SDK vào ứng dụng di Ä‘á»™ng? Hãy xem ứng dụng mẫu của chúng tôi, nÆ¡i minh há»a toàn bá»™ quá trình thiết lập, bao gồm hiển thị paywall, thá»±c hiện mua hàng và các chức năng cÆ¡ bản khác.

Äặt Customer User ID sau khi cấu hình

Nếu bạn chÆ°a có user ID khi cấu hình SDK, bạn có thể đặt nó bất cứ lúc nào sau đó bằng phÆ°Æ¡ng thức .identify(). TrÆ°á»ng hợp phổ biến nhất để sá»­ dụng phÆ°Æ¡ng thức này là sau khi đăng ký hoặc đăng nhập, khi ngÆ°á»i dùng chuyển từ ngÆ°á»i dùng ẩn danh sang ngÆ°á»i dùng đã xác thá»±c.

try {
  await Adapty().identify(customerUserId);
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}

Tham số yêu cầu:

  • Customer User ID (bắt buá»™c): chuá»—i định danh ngÆ°á»i dùng.

Gá»­i lại dữ liệu ngÆ°á»i dùng quan trá»ng

Trong má»™t số trÆ°á»ng hợp, chẳng hạn khi ngÆ°á»i dùng đăng nhập lại vào tài khoản của há», máy chủ Adapty đã có thông tin vá» ngÆ°á»i dùng đó. Trong những tình huống này, Adapty SDK sẽ tá»± Ä‘á»™ng chuyển sang làm việc vá»›i ngÆ°á»i dùng má»›i. Nếu bạn đã truyá»n dữ liệu nào đó cho ngÆ°á»i dùng ẩn danh, chẳng hạn nhÆ° thuá»™c tính tùy chỉnh hoặc attribution từ các mạng bên thứ ba, bạn cần gá»­i lại dữ liệu đó cho ngÆ°á»i dùng đã được xác định.

Ngoài ra, bạn cần gá»i lại tất cả các paywall và sản phẩm sau khi xác định ngÆ°á»i dùng, vì dữ liệu của ngÆ°á»i dùng má»›i có thể khác.

Äăng xuất và đăng nhập

Bạn có thể đăng xuất ngÆ°á»i dùng bất cứ lúc nào bằng cách gá»i phÆ°Æ¡ng thức .logout():

try {
  await Adapty().logout();
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle unknown error
}

Sau đó bạn có thể đăng nhập ngÆ°á»i dùng bằng phÆ°Æ¡ng thức .identify().

Gán appAccountToken (iOS)

appAccountToken là má»™t UUID cho phép bạn liên kết các giao dịch App Store vá»›i danh tính ngÆ°á»i dùng ná»™i bá»™ của mình.
StoreKit liên kết token này vá»›i má»i giao dịch, giúp backend của bạn khá»›p dữ liệu App Store vá»›i ngÆ°á»i dùng của bạn.

Hãy sá»­ dụng má»™t UUID ổn định được tạo cho từng ngÆ°á»i dùng và tái sá»­ dụng nó cho cùng má»™t tài khoản trên nhiá»u thiết bị. Äiá»u này đảm bảo rằng các giao dịch mua và thông báo từ App Store được liên kết đúng cách.

Bạn có thể đặt token theo hai cách – trong quá trình kích hoạt SDK hoặc khi xác định ngÆ°á»i dùng.

Bạn phải luôn truyá»n appAccountToken cùng vá»›i customerUserId. Nếu bạn chỉ truyá»n token, nó sẽ không được Ä‘Æ°a vào giao dịch.

// During configuration:
try {
   await Adapty().activate(
       configuration: AdaptyConfiguration(apiKey: 'YOUR_API_KEY')
         ..withCustomerUserId(YOUR_CUSTOMER_USER_ID, iosAppAccountToken: "YOUR_APP_ACCOUNT_TOKEN")
   );
} catch (e) {
   // handle the error
}
// Or when identifying users
try {
    await Adapty().identify(customerUserId, iosAppAccountToken: "YOUR_APP_ACCOUNT_TOKEN");
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
}

Äặt obfuscated account ID (Android)

Google Play yêu cầu obfuscated account ID cho má»™t số trÆ°á»ng hợp sá»­ dụng nhằm tăng cÆ°á»ng quyá»n riêng tÆ° và bảo mật ngÆ°á»i dùng. Các ID này giúp Google Play xác định các giao dịch mua trong khi vẫn giữ thông tin ngÆ°á»i dùng ẩn danh, Ä‘iá»u này đặc biệt quan trá»ng để phòng chống gian lận và phân tích.

Bạn có thể cần đặt các ID này nếu ứng dụng của bạn xá»­ lý dữ liệu ngÆ°á»i dùng nhạy cảm hoặc nếu bạn cần tuân thủ các quy định vá» quyá»n riêng tÆ° cụ thể. Các obfuscated ID cho phép Google Play theo dõi các giao dịch mua mà không để lá»™ định danh ngÆ°á»i dùng thá»±c tế.

// During configuration:
try {
   await Adapty().activate(
       configuration: AdaptyConfiguration(apiKey: 'YOUR_API_KEY')
         ..withCustomerUserId(YOUR_CUSTOMER_USER_ID, androidObfuscatedAccountId: "OBFUSCATED_ACCOUNT_ID")
   );
} catch (e) {
   // handle the error
}
// Or when identifying users
try {
    await Adapty().identify(customerUserId, androidObfuscatedAccountId: "OBFUSCATED_ACCOUNT_ID");
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
}

Phát hiện ngÆ°á»i dùng trên nhiá»u thiết bị

Khi SDK được kích hoạt, nó tá»± Ä‘á»™ng Ä‘á»c các quyá»n hiện có của ngÆ°á»i dùng từ StoreKit (iOS) hoặc Google Play Billing (Android) và đồng bá»™ chúng vá»›i backend của Adapty. Má»™t gói đăng ký Ä‘ang hoạt Ä‘á»™ng sẽ xuất hiện trên hồ sÆ¡ ngÆ°á»i dùng Adapty mà không cần ứng dụng gá»i restorePurchases.

Äiá»u không xảy ra tá»± Ä‘á»™ng là nhận diện rằng má»™t hồ sÆ¡ ngÆ°á»i dùng trên thiết bị má»›i thuá»™c vá» cùng má»™t ngÆ°á»i dùng nhÆ° hồ sÆ¡ trên thiết bị ban đầu. Adapty khá»›p các hồ sÆ¡ ngÆ°á»i dùng theo Customer User ID, vì vậy tính liên tục danh tính phụ thuá»™c vào những gì bạn sá»­ dụng làm CUID.

Những ÿÿgì Adapty có thể phát hiện trên nhiá»u thiết bị

Cài đặt của bạnAdapty phát hiện được gìBạn phải làm gì
Customer User ID = device_id (không đăng nhập ứng dụng)Thiết bị má»›i nhận được CUID khác và do đó có hồ sÆ¡ ngÆ°á»i dùng khác. Gói đăng ký đồng bá»™ vá»›i hồ sÆ¡ ngÆ°á»i dùng má»›i thông qua sá»± kiện Access level updated, nhÆ°ng subscription_started không kích hoạt — hồ sÆ¡ ngÆ°á»i dùng má»›i được coi là ngÆ°á»i kế thừa của giao dịch mua ban đầu. Các phân tích dá»±a trên subscription_started sẽ đếm thiếu những ngÆ°á»i dùng quay lại.Sá»­ dụng ID tài khoản ổn định làm Customer User ID để ngÆ°á»i dùng quay lại khá»›p vá»›i hồ sÆ¡ ngÆ°á»i dùng hiện có trên các thiết bị.
Customer User ID = ID tài khoản ổn định (đăng nhập trên má»i thiết bị)SDK tá»± Ä‘á»™ng đồng bá»™ gói đăng ký khi activate(), và identify() khá»›p hồ sÆ¡ ngÆ°á»i dùng hiện có theo CUID.Không cần cài đặt thêm — cả danh tính lẫn gói đăng ký Ä‘á»u được xá»­ lý tá»± Ä‘á»™ng.
NgÆ°á»i kế thừa Apple Family SharingThành viên gia đình nhận gói đăng ký thông qua sá»± kiện Access level updated — subscription_started không kích hoạt.Lắng nghe sá»± kiện Access level updated. Xem Apple Family Sharing để biết ma trận sá»± kiện đầy đủ.
Cùng tài khoản Apple/Google, ngÆ°á»i dùng khác nhau trong ứng dụngHồ sÆ¡ ngÆ°á»i dùng đầu tiên ghi lại giao dịch mua trở thành hồ sÆ¡ cha. Các hồ sÆ¡ ngÆ°á»i dùng tiếp theo thấy gói đăng ký thông qua chuá»—i kế thừa, vá»›i má»™t sá»± kiện Access level updated.Yêu cầu đăng nhập, sau đó chá»n chế Ä‘á»™ chia sẻ phù hợp vá»›i mô hình của bạn.

Khôi phục giao dịch mua trên thiết bị mới

Hiển thị nút “Khôi phục giao dịch mua†do ngÆ°á»i dùng khởi tạo trên paywall của bạn. Apple App Review (hÆ°á»›ng dẫn 3.1.1) yêu cầu có nút này, và nó đóng vai trò dá»± phòng khi quá trình đồng bá»™ tá»± Ä‘á»™ng bá» sót má»™t trÆ°á»ng hợp đặc biệt. Nút này nên gá»i restorePurchases trên SDK của bạn.

Không cần gá»i restorePurchases theo chÆ°Æ¡ng trình khi khởi chạy lần đầu trong Ä‘iá»u kiện sá»­ dụng bình thÆ°á»ng — SDK đã thá»±c hiện tÆ°Æ¡ng Ä‘Æ°Æ¡ng khi activate(). Chỉ dùng các lệnh gá»i theo chÆ°Æ¡ng trình để buá»™c kiểm tra biên lai má»›i, ví dụ khi debug trÆ°á»ng hợp mất quyá»n truy cập sau khi activate() đã hoàn thành.

ÿÿÿÿ