Xác định người dùng trong iOS SDK

Cách bạn quản lý các 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 của bạn 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ủa bạn 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).
• Bạn cung cấp customer user ID để liên kết chéo hồ sơ người dùng trong Adapty với hệ thống xác thực nội bộ của bạn.

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

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 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.
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ơ Adapty 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 từ thiết bị mới, Adapty tạo một hồ sơ ẩ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 kích hoạt.

Vì vậy, với người dùng ẩn danh, hồ sơ mới sẽ được tạo mỗi lần cài đặt, nhưng đó 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ần 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ần cài đặt, kể cả cài đặt lại.

Người dùng đã xác định

Bạn có hai tùy 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, 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 động, hãy gửi nó khi gọi activate().

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 động (ví dụ: sau khi họ đăng nhập vào ứng dụng hoặc đăng ký), hãy dùng phương thức identify để đặt customer user ID của 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ơ 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ơ được liên kết với customer user ID này.

Luôn await 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 sẽ hoạt động trên hồ sơ ẩn danh. Xem Thứ tự gọi trong iOS SDK.

do {
    try await Adapty.identify("YOUR_USER_ID") // Unique for each user
} catch {
    // handle the error
}

// User IDs must be unique for each user
Adapty.identify("YOUR_USER_ID") { error in
    if let 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ơ ẩn danh mới và chỉ chuyển sang hồ sơ hiện có sau khi bạn gọi identify.

Bạn có thể truyền customer user ID hiện có (đã dùng trước đó) hoặc một customer user ID mới. Nếu bạn truyền một customer user ID mới, hồ sơ ẩn danh được tạo khi kích hoạt sẽ tự động được liên kết với customer user ID đó.

// Place in the app main struct for SwiftUI or in AppDelegate for UIKit

let configurationBuilder =
    AdaptyConfiguration
        .builder(withAPIKey: "PUBLIC_SDK_KEY")
        .with(customerUserId: "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.

do {
  try await Adapty.activate(with: configurationBuilder.build())
} catch {
  // handle the error
}

// Place in the app main struct for SwiftUI or in AppDelegate for UIKit

let configurationBuilder =
    AdaptyConfiguration
        .builder(withAPIKey: "PUBLIC_SDK_KEY")
        .with(customerUserId: "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(with: configurationBuilder.build()) { error in
  // handle the error
}

Đă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.

do {
    try await Adapty.logout()
} catch {
    // handle the error
}

Adapty.logout { error in
    if error == nil {
        // successful logout
    }
}

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ọ vẫn 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 liên kết nó với ID hồ sơ ẩn danh của họ.
2. 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ơ đã 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 sẽ gán customer user ID cho hồ sơ hiện tại, do đó toàn bộ lịch sử mua hàng đượ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ơ), bạn cần lấy mức độ truy cập thực tế sau khi chuyển đổi hồ sơ. 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ơ để dữ liệu tự động đồng bộ.

Các bước tiếp theo

Chúc mừng! Bạn đã triển khai logic thanh toán trong ứng dụng! Chúc bạn thành công với việc kiếm tiền từ ứng dụng!

Để khai thác thêm từ Adapty, 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 tỷ lệ giữ chân
• 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ơ 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