Thứ tá»± gá»i trong iOS 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 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() sẽ thất bại vá»›i lá»—i #2002 notActivated.
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() 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 thá»±c hiện song song vá»›i nó sẽ thất bại vá»›i lá»—i #3006 profileWasChanged, hoặc đổ và o hồ sÆ¡ ngÆ°á»i dùng ẩn danh được tạo lúc activation. 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, 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 cùng má»™t quy tắc. 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ẽ gắn và o má»™t hồ sÆ¡ ngÆ°á»i dùng ẩn danh tồn tại 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. Vá» chi tiết cụ thể vá»›i AppsFlyer, xem AppsFlyer.
Thứ tự đúng
Lộ trình của bạn phụ thuộc và o hai yếu tố: khi nà o bạn biết customer user ID và bạn có sỠdụng SDK MMP hoặc analytics hay không.
- BÆ°á»›c 2 và 5: Bắt buá»™c cho má»i ứng dụng. Activate SDK, sau đó gá»i các phÆ°Æ¡ng thức SDK.
- BÆ°á»›c 1 và 3: Chỉ bắt buá»™c nếu bạn tÃch hợp SDK MMP hoặc analytics (AppsFlyer, Adjust, Branch, PostHog).
- BÆ°á»›c 4: Chỉ bắt buá»™c 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 ứng dụng khởi chạy, hãy truyá»n trá»±c tiếp và o activate() (bÆ°á»›c 2a). Lá»™ trình nà y 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 | Thá»i Ä‘iểm | LÆ°u ý |
|---|---|---|---|
| 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(with: config) vá»›i customerUserId được đặt trên config | Khởi chạy ứng dụng, sau bÆ°á»›c 1, nếu bạn có customer user ID | Äược khuyến nghị. Không bao giá» tạo hồ sÆ¡ ngÆ°á»i dùng ẩn danh. |
| 2b | Adapty.activate(with: config) không có customerUserId | Khởi chạy ứng dụng, sau bÆ°á»›c 1, nếu bạn không có customer user ID (hoặc không thu tháºp) | Adapty tạo má»™t hồ sÆ¡ ngÆ°á»i dùng ẩn danh. |
| 3 | Adapty.setIntegrationIdentifier(...) 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 | Bắt buá»™c để MMP ID gắn và o đúng hồ sÆ¡ ngÆ°á»i dùng. |
| 4 | try await Adapty.identify("YOUR_USER_ID") | Sau bÆ°á»›c 3 (hoặc bÆ°á»›c 2 nếu không có MMP), trÆ°á»›c bÆ°á»›c 5 — chỉ trên lá»™ trình 2b có xác thá»±c | Luôn await. Các lệnh gá»i đồng thá»i trong quá trình identify sẽ tạo ra lá»—i #3006 profileWasChanged. |
| 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ẽ gây ra 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á» sai đối tượng.
Cà i đặt web2app và web-funnel
Nếu ngÆ°á»i dùng mua hà ng qua web checkout (Stripe, Paddle, FunnelFox) 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Æ¡ nà y không được liên kết vá»›i hồ sÆ¡ 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 activate(). Nếu không, giao dịch 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 đó restorePurchases.
Vá» metadata cần gá»i kèm theo má»—i web checkout, xem: