Thứ tá»± gá»i trong Android SDK
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. |
Bá» qua các bÆ°á»›c nà y sẽ dẫn đến mất quyá»n truy cáºp premium cho ngÆ°á»i dùng quay lại, thiếu appsflyer_id trên hồ sÆ¡ ngÆ°á»i dùng, và paywall được trả vá» cho sai đối tượng.
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: