ÿÿ HÆ°á»›ng dẫn Nhanh vá» Adapty | Tài liệu Adapty
English 中文TürkçeРуÑÑкийEspañol日本語Tiếng Việt

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

HÆ°á»›ng dẫn này dành cho bạn nếu bạn có hệ thống xác thá»±c riêng. Tại đây, bạn sẽ há»c cách làm việc vá»›i hồ sÆ¡ ngÆ°á»i dùng trong Adapty để đảm bảo nó phù hợp vá»›i hệ thống xác thá»±c hiện có của bạn.

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:

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).
  • Bạn cung cấp customer user ID để đối chiếu hồ sÆ¡ ngÆ°á»i dùng trong Adapty vá»›i hệ thống xác thá»±c ná»™i bá»™ của bạn.

Äây là những Ä‘iểm 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 danhNgÆ°á»i dùng đã xác định
Quản lý giao dịch muaKhôi phục giao dịch mua ở cấp cá»­a hàngDuy trì lịch sá»­ giao dịch mua trên nhiá»u thiết bị thông qua customer user ID của há»
Quản lý hồ sÆ¡ ngÆ°á»i dùngHồ sÆ¡ ngÆ°á»i dùng má»›i má»—i lần cài đặt lạiCùng má»™t hồ sÆ¡ ngÆ°á»i dùng xuyên suốt các phiên và thiết bị
LÆ°u trữ dữ liệuDữ liệu ngÆ°á»i dùng ẩn danh gắn vá»›i lần cài đặt ứng dụngDữ liệu ngÆ°á»i dùng đã xác định được lÆ°u trữ qua các lần cài đặt ứng dụng

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 code ứng dụng:

  1. Khi SDK được kích hoạt lần đầu tiên khi ứng dụng khởi chạy, Adapty tạo má»™t hồ sÆ¡ ngÆ°á»i dùng má»›i cho ngÆ°á»i dùng.
  2. 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 của há» và tài khoản cá»­a hàng của há».
  3. Khi ngÆ°á»i dùng cài đặt lại ứng dụng hoặc cài đặt trên thiết bị má»›i, Adapty tạo má»™t hồ sÆ¡ ngÆ°á»i dùng ẩn danh má»›i khi kích hoạt.
  4. Nếu ngÆ°á»i dùng đã thá»±c hiện giao dịch mua trÆ°á»›c đó trong ứng dụng của bạn, theo mặc định, các giao dịch mua của há» sẽ được tá»± Ä‘á»™ng đồng bá»™ từ App Store khi SDK được kích hoạt.

Vậy, vá»›i ngÆ°á»i dùng ẩn danh, hồ sÆ¡ ngÆ°á»i dùng má»›i sẽ được tạo má»—i lần cài đặt, nhÆ°ng Ä‘iá»u đó không phải là vấn Ä‘á» vì trong phân tích Adapty, bạn có thể cấu hình những gì sẽ được coi là lần cài đặt má»›i.

Äối vá»›i ngÆ°á»i dùng ẩn danh, bạn cần đếm lượt cài đặt theo ID thiết bị. Trong trÆ°á»ng hợp này, má»—i lần cài đặt ứng dụng trên má»™t thiết bị được tính là má»™t lượt cài đặt, bao gồm cả cài đặt lại.

NgÆ°á»i dùng đã xác định

Bạn có hai lá»±a chá»n để xác định ngÆ°á»i dùng trong ứng dụng:

Theo mặc định, khi Adapty nhận được giao dịch mua từ má»™t Customer User ID hiện Ä‘ang liên kết vá»›i Customer User ID khác, mức Ä‘á»™ truy cập được chia sẻ, vì vậy cả hai hồ sÆ¡ ngÆ°á»i dùng Ä‘á»u có quyá»n truy cập trả phí. Bạn có thể cấu hình cài đặt này để chuyển quyá»n truy cập 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 việc chia sẻ. Xem bài viết để biết thêm chi tiết.

identify-diagram.webp

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 của há».

  • Nếu bạn chÆ°a từng 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.

Customer user ID phải là duy nhất cho má»—i ngÆ°á»i dùng. Nếu bạn hardcode giá trị tham số, tất cả ngÆ°á»i dùng sẽ được coi là má»™t.

Hãy chá» callback hoàn thành của Identify trÆ°á»›c khi gá»i các phÆ°Æ¡ng thức SDK khác. Các lệnh gá»i đồng thá»i sẽ tạo ra lá»—i #3006 profileWasChanged hoặc rÆ¡i vào hồ sÆ¡ ngÆ°á»i dùng ẩn danh. Xem Thứ tá»± gá»i trong Unity SDK.

Adapty.Identify("YOUR_USER_ID", (error) => { // Unique for each user
  if(error == null) {
    // successful identify
  }
});

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 biệt.

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 ẩn danh má»›i 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 vào customer user ID hiện có (đã từng sá»­ dụng trÆ°á»›c đây) hoặc má»™t ID má»›i. Nếu bạn truyá»n má»™t ID má»›i, hồ sÆ¡ ngÆ°á»i dùng má»›i được tạo khi kích hoạt sẽ được tá»± Ä‘á»™ng liên kết vá»›i customer user ID đó.

Theo mặc định, việc tạo hồ sÆ¡ ngÆ°á»i dùng ẩn danh không ảnh hưởng đến các dashboard phân tích, vì lượt cài đặt được tính dá»±a trên ID thiết bị.

ID thiết bị đại diện cho một lần cài đặt ứng dụng từ cửa hàng trên một thiết bị và chỉ được tạo lại sau khi ứng dụng được cài đặt lại.
Nó không phụ thuộc vào việc đây là lần cài đặt đầu tiên hay lần cài đặt lại, hoặc liệu có sử dụng customer user ID hiện có hay không.

Việc tạo hồ sÆ¡ ngÆ°á»i dùng (khi kích hoạt SDK hoặc đăng xuất), đăng nhập, hoặc nâng cấp ứng dụng mà không cài đặt lại không tạo thêm sá»± kiện cài đặt.

Nếu bạn muốn đếm lượt cài đặt dá»±a trên ngÆ°á»i dùng duy nhất thay vì thiết bị, hãy vào App settings và cấu hình Installs definition for analytics.

using UnityEngine;
using AdaptySDK;

var builder = new AdaptyConfiguration.Builder("YOUR_API_KEY")
    .SetCustomerUserId("YOUR_USER_ID"); // Customer user IDs must be unique for each user. If you hardcode the parameter value, all users will be considered as one.

Adapty.Activate(builder.Build(), (error) => {
    if (error != null) {
        // handle the error
        return;
    }
});

Äăng xuất ngÆ°á»i dùng

Nếu bạn có nút cho phép ngÆ°á»i dùng đăng xuất, hãy sá»­ dụng phÆ°Æ¡ng thức logout.

Việc đăng xuất ngÆ°á»i dùng sẽ tạo má»™t hồ sÆ¡ ngÆ°á»i dùng ẩn danh má»›i cho ngÆ°á»i dùng đó.

Adapty.Logout((error) => {
  if(error == null) {
    // successful logout<ÿÿ/span>
  }
});

Äể đă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ể thá»±c hiện giao dịch mua cả trÆ°á»›c và sau khi đăng nhập vào ứng dụng, bạn cần đảm bảo rằng há» sẽ giữ được quyá»n truy cập sau khi đăng nhập:

  1. Khi ngÆ°á»i dùng chÆ°a đăng nhập thá»±c hiện giao dịch mua, Adapty gắn nó vá»›i ID hồ sÆ¡ ngÆ°á»i dùng ẩn danh của há».
  2. Khi ngÆ°á»i dùng đăng nhập vào tài khoản, 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 má»›i (ví dụ: giao dịch mua được thá»±c hiện trÆ°á»›c khi đăng ký), Adapty gán customer user ID cho hồ sÆ¡ ngÆ°á»i dùng hiện tại, do đó toàn bá»™ lịch sá»­ giao dịch mua được duy trì.
    • 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), bạn cần lấy mức Ä‘á»™ truy cập thá»±c tế sau khi chuyển đổi hồ sÆ¡ ngÆ°á»i dùng. Bạn có thể gá»i getProfile ngay sau khi xác định, hoặc lắng nghe các cập nhật hồ sÆ¡ ngÆ°á»i dùng để dữ liệu tá»± Ä‘á»™ng đồng bá»™.

Các bước tiếp theo

Xin chúc mừng! Bạn đã triển khai logic thanh toán in-app trong ứng dụng của mình! Chúc bạn thành công vá»›i việc kiếm tiá»n từ ứng dụng!

Äể khai thác Adapty tối Ä‘a hÆ¡n, bạn có thể khám phá các chủ Ä‘á» sau:

  • Kiểm thá»­: Äảm bảo má»i thứ hoạt Ä‘á»™ng nhÆ° mong đợi
  • Onboardings: Thu hút ngÆ°á»i dùng vá»›i onboarding và thúc đẩy sá»± gắn kết
  • Tích hợp: Tích hợp vá»›i các dịch vụ attribution marketing và phân tích chỉ trong má»™t dòng code
  • Äặt thuá»™c tính hồ sÆ¡ ngÆ°á»i dùng tùy chỉnh: Thêm thuá»™c tính tùy chỉnh vào hồ sÆ¡ ngÆ°á»i dùng và tạo phân khúc, để bạn có thể chạy A/B test hoặc hiển thị các paywall khác nhau cho các ngÆ°á»i dùng khác nhau
ÿÿÿÿ