XỠlý dữ liệu từ onboarding trong Unity SDK
Khi ngÆ°á»i dùng trả lá»i câu há»i trong quiz hoặc nháºp dữ liệu và o trÆ°á»ng nháºp liệu, phÆ°Æ¡ng thức OnboardingViewOnStateUpdatedAction sẽ được gá»i. Bạn có thể lÆ°u hoặc xá» lý loại trÆ°á»ng đó trong code của mình.
Triển khai phương thức OnboardingViewOnStateUpdatedAction trong class của bạn:
public class OnboardingManager : MonoBehaviour, AdaptyOnboardingsEventsListener
{
public void OnboardingViewOnStateUpdatedAction(
AdaptyUIOnboardingView view,
AdaptyUIOnboardingMeta meta,
string elementId,
AdaptyOnboardingsStateUpdatedParams @params
)
{
switch (@params) {
case AdaptyOnboardingsSelectParams selectParams:
// handle single selection
break;
case AdaptyOnboardingsMultiSelectParams multiSelectParams:
// handle multiple selections
break;
case AdaptyOnboardingsInputParams inputParams:
// handle text input
break;
case AdaptyOnboardingsDatePickerParams datePickerParams:
// handle date selection
break;
}
}
// ... other interface methods
}Các tham số bao gồm:
| Tham số | Mô tả |
|---|---|
elementId | Mã định danh duy nhất cho phần tá» nháºp liệu. Bạn có thể dùng nó để liên kết câu há»i vá»›i câu trả lá»i khi lÆ°u dữ liệu. |
@params | Äối tượng dữ liệu đầu và o của ngÆ°á»i dùng. Có thể là má»™t trong các kiểu sau. |
AdaptyOnboardingsSelectParams | Chá»n má»™t tùy chá»n. Chứa Id, Value, Label |
AdaptyOnboardingsMultiSelectParams | Chá»n nhiá»u tùy chá»n. Chứa danh sách Params (má»—i phần tá» có Id, Value, Label)• input: Äối tượng vá»›i type, value• datePicker: Äối tượng vá»›i day, month, year |
AdaptyOnboardingsInputParams | TrÆ°á»ng nháºp văn bản. Chứa Input có thể là AdaptyOnboardingsTextInput, AdaptyOnboardingsEmailInput, hoặc AdaptyOnboardingsNumberInput |
AdaptyOnboardingsDatePickerParams | Chá»n ngà y tháng. Chứa Day, Month, Year (có thể null) |
Và dụ dữ liệu đã lưu (có thể khác trong triển khai của bạn)
// Example of a saved select action
{
"elementId": "preference_selector",
"meta": {
"onboardingId": "onboarding_123",
"screenClientId": "preferences_screen",
"screenIndex": 1,
"screensTotal": 3
},
"params": {
"type": "select",
"value": {
"id": "option_1",
"value": "premium",
"label": "Premium Plan"
}
}
}
// Example of a saved multi-select action
{
"elementId": "interests_selector",
"meta": {
"onboardingId": "onboarding_123",
"screenClientId": "interests_screen",
"screenIndex": 2,
"screensTotal": 3
},
"params": {
"type": "multiSelect",
"value": [
{
"id": "interest_1",
"value": "sports",
"label": "Sports"
},
{
"id": "interest_2",
"value": "music",
"label": "Music"
}
]
}
}
// Example of a saved input action
{
"elementId": "name_input",
"meta": {
"onboardingId": "onboarding_123",
"screenClientId": "profile_screen",
"screenIndex": 0,
"screensTotal": 3
},
"params": {
"type": "input",
"value": {
"type": "text",
"value": "John Doe"
}
}
}
// Example of a saved date picker action
{
"elementId": "birthday_picker",
"meta": {
"onboardingId": "onboarding_123",
"screenClientId": "profile_screen",
"screenIndex": 0,
"screensTotal": 3
},
"params": {
"type": "datePicker",
"value": {
"day": 15,
"month": 6,
"year": 1990
}
}
} Các trÆ°á»ng hợp sá» dụng
Bổ sung thông tin và o hồ sÆ¡ ngÆ°á»i dùng
Nếu bạn muốn liên kết ngay dữ liệu đầu và o vá»›i hồ sÆ¡ ngÆ°á»i dùng và tránh há»i lại cùng má»™t thông tin, bạn cần cáºp nháºt hồ sÆ¡ ngÆ°á»i dùng vá»›i dữ liệu đó khi xá» lý hà nh Ä‘á»™ng.
Và dụ: bạn yêu cầu ngÆ°á»i dùng nháºp tên và o trÆ°á»ng văn bản có ID là name và muốn đặt giá trị đó là m tên của há». Ngoà i ra, bạn yêu cầu há» nháºp email và o trÆ°á»ng email. Trong code ứng dụng, nó có thể trông nhÆ° thế nà y:
public class OnboardingManager : MonoBehaviour, AdaptyOnboardingsEventsListener
{
public void OnboardingViewOnStateUpdatedAction(
AdaptyUIOnboardingView view,
AdaptyUIOnboardingMeta meta,
string elementId,
AdaptyOnboardingsStateUpdatedParams @params
)
{
if (@params is AdaptyOnboardingsInputParams inputParams) {
var builder = new AdaptyProfileParameters.Builder();
switch (elementId) {
case "name":
if (inputParams.Input is AdaptyOnboardingsTextInput textInput) {
builder.SetFirstName(textInput.Value);
}
break;
case "email":
if (inputParams.Input is AdaptyOnboardingsEmailInput emailInput) {
builder.SetEmail(emailInput.Value);
}
break;
}
Adapty.UpdateProfile(builder.Build(), (error) => {
if (error != null) {
// handle the error
}
});
}
}
// ... other interface methods
}Tùy chỉnh paywall dá»±a trên câu trả lá»i
Bằng cách sá» dụng quiz trong onboarding, bạn cÅ©ng có thể tùy chỉnh paywall hiển thị cho ngÆ°á»i dùng sau khi há» hoà n thà nh onboarding.
Và dụ: bạn có thể há»i ngÆ°á»i dùng vá» kinh nghiệm thể thao của há» và hiển thị các CTA và sản phẩm khác nhau cho từng nhóm ngÆ°á»i dùng.
- Thêm quiz trong onboarding builder và gán các ID có ý nghÄ©a cho các tùy chá»n.
- Xá» lý các phản hồi từ quiz dá»±a trên ID của chúng và đặt thuá»™c tÃnh tùy chỉnh cho ngÆ°á»i dùng.
public class OnboardingManager : MonoBehaviour, AdaptyOnboardingsEventsListener
{
public void OnboardingViewOnStateUpdatedAction(
AdaptyUIOnboardingView view,
AdaptyUIOnboardingMeta meta,
string elementId,
AdaptyOnboardingsStateUpdatedParams @params
)
{
if (@params is AdaptyOnboardingsSelectParams selectParams) {
var builder = new AdaptyProfileParameters.Builder();
switch (elementId) {
case "experience":
// set custom attribute 'experience' with the selected value (beginner, amateur, pro)
builder.SetCustomStringAttribute("experience", selectParams.Value);
break;
}
Adapty.UpdateProfile(builder.Build(), (error) => {
if (error != null) {
// handle the error
}
});
}
}
// ... other interface methods
}- Tạo phân khúc cho từng giá trị thuá»™c tÃnh tùy chỉnh.
- Tạo một placement và thêm đối tượng cho từng phân khúc bạn đã tạo.
- Hiển thị paywall cho placement trong code ứng dụng của bạn. Nếu onboarding của bạn có nút mở paywall, hãy triển khai code paywall như một phản hồi cho hà nh động của nút đó.