Adapty.activate() phải hoàn thành trước khi bạn gọi bất kỳ phương thức nào khác của Adapty SDK. Cho đến khi hoàn tất, SDK chưa có trạng thái. Bất kỳ lệnh gọi nào được thực hiện trước hoặc song song với activate() đều thất bại với lỗi ADAPTY_NOT_INITIALIZED.

Nếu ứng dụng của bạn xác thực người dùng và bạn thu thập customer user ID sau khi khởi chạy, hãy gọi Adapty.identify() vào thời điểm đó. Không gọi các phương thức liên quan đến hành động người dùng cho đến khi callback hoàn thành của identify được kích hoạt. Các lệnh gọi chạy đua với nó sẽ trả về lỗi trong callback, hoặc sẽ tác động lên hồ sơ người dùng ẩn danh được tạo khi kích hoạt. Khi điều này xảy ra, attribution, MMP ID như appsflyer_id, và quyền sở hữu lượt cài đặt không phải lúc nào cũng được chuyển sang hồ sơ người dùng đã xác định. Nếu ứng dụng của bạn không xác thực người dùng, bỏ qua identify và tiếp tục làm việc với hồ sơ người dùng ẩn danh.

Các SDK MMP và analytics (AppsFlyer, Adjust, Branch, PostHog) tuân theo quy tắc tương tự. Khởi tạo chúng trước và chờ callback UID của chúng trước khi gọi Adapty.activate. Nếu không, MMP ID sẽ được gán vào một hồ sơ người dùng ẩn danh tồn tại trong thời gian ngắn và không phải lúc nào cũng được chuyển sang hồ sơ người dùng đã xác định. Để biết chi tiết về AppsFlyer, xem AppsFlyer.

Thứ tự đúng

Con đường thực hiện phụ thuộc vào hai yếu tố: khi nào bạn biết customer user ID, và liệu bạn có sử dụng SDK MMP hoặc analytics hay không.

• Bước 2 và 5: Bắt buộc với mọi ứng dụng. Kích hoạt SDK, sau đó gọi các phương thức SDK.
• Bước 1 và 3: Chỉ cần thiết nếu bạn tích hợp SDK MMP hoặc analytics (AppsFlyer, Adjust, Branch, PostHog).
• Bước 4: Chỉ cần thiết nếu ứng dụng của bạn xác thực người dùng và thu thập customer user ID sau khi khởi chạy.

Nếu bạn đã có customer user ID khi khởi chạy ứng dụng, hãy truyền nó vào AdaptyConfig.Builder trước khi gọi activate() (bước 2a). Con đường này không bao giờ tạo hồ sơ người dùng ẩn danh, vì vậy bước 4 là không cần thiết.

Bước	Lệnh gọi	Thời điểm	Ghi chú
1	Khởi tạo SDK MMP hoặc analytics của bạn (AppsFlyer, Adjust, PostHog, Branch)	Khởi chạy ứng dụng, đầu tiên	Chờ callback UID của MMP, ví dụ getAppsFlyerUID.
2a	Adapty.activate(context, AdaptyConfig.Builder("KEY").withCustomerUserId(...).build())	Khởi chạy ứng dụng, sau bước 1, nếu bạn đã có customer user ID	Khuyến nghị. Không bao giờ tạo hồ sơ người dùng ẩn danh.
2b	Adapty.activate(context, AdaptyConfig.Builder("KEY").build()) không có customerUserId	Khởi chạy ứng dụng, sau bước 1, nếu bạn chưa có customer user ID (hoặc không bao giờ thu thập)	Adapty tạo một hồ sơ người dùng ẩn danh.
3	Adapty.setIntegrationIdentifier("appsflyer_id", uid) cho từng MMP	Sau bước 2, trước bất kỳ lệnh gọi hành động người dùng nào	Cần thiết để MMP ID được gán vào đúng hồ sơ người dùng.
4	Adapty.identify("YOUR_USER_ID") { error -> ... }	Sau bước 3 (hoặc bước 2 nếu không có MMP), trước bước 5 — chỉ trên con đường 2b có xác thực	Sử dụng completion callback. Các lệnh gọi đồng thời trong quá trình identify có thể tác động lên hồ sơ người dùng ẩn danh.
5	getPaywall, getPaywallProducts, restorePurchases, makePurchase, updateAttribution, updateProfile	Sau bước 4 nếu bạn gọi identify; nếu không thì sau bước 3 (hoặc bước 2 nếu không có MMP)	Các lệnh gọi này cần một hồ sơ người dùng ổn định.

Cài đặt Web2app và web-funnel

Nếu người dùng mua trên web checkout (Stripe, Paddle) và sau đó cài đặt ứng dụng native, lần activate() đầu tiên trên thiết bị sẽ tạo một hồ sơ người dùng ẩn danh mới. Hồ sơ người dùng này không được liên kết với hồ sơ người dùng web. Nếu bạn có thể xác định customer user ID trước khi khởi chạy ứng dụng (từ luồng xác thực hoặc install referrer), hãy truyền nó vào AdaptyConfig.Builder trực tiếp. Nếu không, giao dịch mua trên web sẽ không hiển thị trên thiết bị cho đến khi bạn gọi identify("YOUR_USER_ID") và sau đó là restorePurchases.

Để biết metadata cần gửi kèm với mỗi web checkout, xem:

• Stripe
• Paddle