Thứ tá»± gá»i trong Kotlin Multiplatform SDK
Adapty.activate() phải hoà n thà nh trÆ°á»›c khi bạn gá»i bất kỳ phÆ°Æ¡ng thức Adapty SDK nà o khác. Cho đến khi nó 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 sẽ thất bại vá»›i lá»—i kÃch hoạt. Xem Xá» lý lá»—i trong Kotlin Multiplatform SDK.
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() ngay tại thá»i Ä‘iểm đó. Äừng gá»i các phÆ°Æ¡ng thức liên quan đến hà nh Ä‘á»™ng ngÆ°á»i dùng cho đến khi identify hoà n tất. Các lệnh gá»i chạy đồng thá»i vá»›i nó có thể trả vá» lá»—i, 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 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 thá»±c. Nếu ứng dụng của bạn không xác thá»±c ngÆ°á»i dùng, hãy 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á»±. Hãy 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Æ¡ ẩn danh tạm thá»i và không phải lúc nà o cÅ©ng được chuyển sang hồ sÆ¡ đã xác định. Äể biết chi tiết vá» AppsFlyer, xem AppsFlyer.
Thứ tự thực hiện đúng
Lá»™ trình của bạn phụ thuá»™c và o hai yếu tố: thá»i Ä‘iểm bạn biết customer user ID, và liệu bạn có sá» dụng MMP hoặc analytics SDK 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 MMP hoặc analytics SDK (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 ngay khi khởi Ä‘á»™ng ứng dụng, hãy truyá»n nó và o AdaptyConfig.Builder trÆ°á»›c khi gá»i activate() (bÆ°á»›c 2a). Cách nà y sẽ không bao giá» tạo hồ sÆ¡ ngÆ°á»i dùng ẩn danh, do đó bÆ°á»›c 4 là không cần thiết.
| BÆ°á»›c | Lệnh gá»i | Khi nà o | Ghi chú |
|---|---|---|---|
| 1 | Khởi tạo MMP hoặc analytics SDK (AppsFlyer, Adjust, PostHog, Branch) | Khi khởi động ứng dụng, thực hiện đầu tiên | ChỠcallback UID từ MMP, và dụ getAppsFlyerUID. |
| 2a | Adapty.activate(configuration = AdaptyConfig.Builder("KEY").withCustomerUserId(...).build()) | Khi khởi Ä‘á»™ng ứng dụng, sau bÆ°á»›c 1, nếu bạn đã có customer user ID | Khuyến nghị. Sẽ không tạo hồ sÆ¡ ngÆ°á»i dùng ẩn danh. |
| 2b | Adapty.activate(configuration = AdaptyConfig.Builder("KEY").build()) không có withCustomerUserId | Khi khởi Ä‘á»™ng ứng dụng, sau bÆ°á»›c 1, nếu bạn chÆ°a có customer user ID (hoặc không thu tháºp) | Adapty sẽ tạo 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 nà o liên quan đến ngÆ°á»i dùng | Bắt buá»™c để MMP ID được gắn và o đúng hồ sÆ¡ ngÆ°á»i dùng. |
| 4 | Adapty.identify("YOUR_USER_ID").onSuccess { ... }.onError { ... } | Sau bÆ°á»›c 3 (hoặc bÆ°á»›c 2 nếu không có MMP), trÆ°á»›c bÆ°á»›c 5 — chỉ áp dụng cho luồng 2b có xác thá»±c | Chá» onSuccess trÆ°á»›c bất kỳ lệnh gá»i nà o liên quan đến ngÆ°á»i dùng. Các lệnh gá»i đồng thá»i trong lúc identify có thể gắn và o hồ sÆ¡ ngÆ°á»i dùng ẩn danh. |
| 5 | getPaywall (getFlow trong SDK v4), getPaywallProducts, restorePurchases, makePurchase, updateAttribution, updateProfile | Sau bÆ°á»›c 4 nếu bạn gá»i identify; ngược lại 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. |
Bá» qua các bÆ°á»›c nà y sẽ khiến ngÆ°á»i dùng cÅ© mất quyá»n truy cáºp premium, thiếu appsflyer_id trên hồ sÆ¡ ngÆ°á»i dùng, và paywall trả vá» sai đối tượng.
Cà i đặt từ web2app và web funnel
Nếu ngÆ°á»i dùng mua hà ng qua web checkout (Stripe, Paddle) và sau đó cà i đặt ứng dụng native, lần đầu tiên activate() 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 trá»±c tiếp và o AdaptyConfig.Builder. Nếu không, lần mua hà ng 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 đó gá»i restorePurchases.
Äể biết metadata cần gá»i vá»›i má»—i web checkout, xem: