Kotlin Multiplatform SDK'da onboarding verilerini işle

Kullanıcılarınız bir sınav sorusuna yanıt verdiğinde veya bir giriş alanına veri girdiğinde onboardingViewOnStateUpdatedAction metodu çağrılır. Alan türünü kodunuzda kaydedebilir veya işleyebilirsiniz.

Örneğin:

import com.adapty.exampleapp.AppLogger
import com.adapty.kmp.AdaptyUI
import com.adapty.kmp.AdaptyUIOnboardingsEventsObserver
import com.adapty.kmp.models.AdaptyOnboardingsDatePickerParams
import com.adapty.kmp.models.AdaptyOnboardingsInputParams
import com.adapty.kmp.models.AdaptyOnboardingsMultiSelectParams
import com.adapty.kmp.models.AdaptyOnboardingsSelectParams
import com.adapty.kmp.models.AdaptyOnboardingsStateUpdatedParams
import com.adapty.kmp.models.AdaptyOnboardingsTextInput
import com.adapty.kmp.models.AdaptyUIOnboardingView
import com.adapty.kmp.models.AdaptyUIOnboardingMeta

class MyAdaptyUIOnboardingsEventsObserver : AdaptyUIOnboardingsEventsObserver {
    override fun onboardingViewOnStateUpdatedAction(
        view: AdaptyUIOnboardingView,
        meta: AdaptyUIOnboardingMeta,
        elementId: String,
        params: AdaptyOnboardingsStateUpdatedParams
    ) {
        // Store user preferences or responses
        when (params) {
            is AdaptyOnboardingsSelectParams -> {
                // Handle single selection
                val id = params.id
                val value = params.value
                val label = params.label
                AppLogger.d("Selected option: $label (id: $id, value: $value)")
            }
            is AdaptyOnboardingsMultiSelectParams -> {
                // Handle multiple selections
            }
            is AdaptyOnboardingsInputParams -> {
                // Handle text input
            }
            is AdaptyOnboardingsDatePickerParams -> {
                // Handle date selection
            }
        }
    }
}

// Set up the observer
AdaptyUI.setOnboardingsEventsObserver(MyAdaptyUIOnboardingsEventsObserver())
Kaydedilen veri örnekleri (format uygulamanıza göre farklılık gösterebilir)
// Example of a saved select action
{
    "id": "onboarding_on_state_updated_action",
    "view": { /* AdaptyUI.OnboardingView object */ },
    "meta": {
    "onboarding_id": "onboarding_123",
    "screen_cid": "preferences_screen",
    "screen_index": 1,
    "total_screens": 3
},
    "action": {
    "element_id": "preference_selector",
    "element_type": "select",
    "value": {
    "id": "option_1",
    "value": "premium",
    "label": "Premium Plan"
}
}
}

// Example of a saved multi-select action
{
    "id": "onboarding_on_state_updated_action",
    "view": { /* AdaptyUI.OnboardingView object */ },
    "meta": {
    "onboarding_id": "onboarding_123",
    "screen_cid": "interests_screen",
    "screen_index": 2,
    "total_screens": 3
},
    "action": {
    "element_id": "interests_selector",
    "element_type": "multi_select",
    "value": [
{
    "id": "interest_1",
    "value": "sports",
    "label": "Sports"
},
{
    "id": "interest_2",
    "value": "music",
    "label": "Music"
}
    ]
}
}

// Example of a saved input action
{
    "id": "onboarding_on_state_updated_action",
    "view": { /* AdaptyUI.OnboardingView object */ },
    "meta": {
    "onboarding_id": "onboarding_123",
    "screen_cid": "profile_screen",
    "screen_index": 0,
    "total_screens": 3
},
    "action": {
    "element_id": "name_input",
    "element_type": "input",
    "value": {
    "type": "text",
    "value": "John Doe"
}
}
}

// Example of a saved date picker action
{
    "id": "onboarding_on_state_updated_action",
    "view": { /* AdaptyUI.OnboardingView object */ },
    "meta": {
    "onboarding_id": "onboarding_123",
    "screen_cid": "profile_screen",
    "screen_index": 0,
    "total_screens": 3
},
    "action": {
    "element_id": "birthday_picker",
    "element_type": "date_picker",
    "value": {
    "day": 15,
    "month": 6,
    "year": 1990
}
}
}

Kullanım senaryoları

Kullanıcı profillerini veriyle zenginleştir

Girilen verileri kullanıcı profiliyle anında ilişkilendirmek ve aynı bilgiyi iki kez sormaktan kaçınmak için, eylemi işlerken girdi verisiyle kullanıcı profilini güncellemeniz gerekir.

Örneğin, kullanıcılardan name ID’li metin alanına adlarını girmelerini istiyorsunuz ve bu alanın değerini kullanıcının adı olarak ayarlamak istiyorsunuz. Ayrıca email alanına e-postalarını girmelerini istiyorsunuz. Uygulama kodunuzda bu şöyle görünebilir:

import com.adapty.kmp.Adapty
import com.adapty.kmp.AdaptyUI
import com.adapty.exampleapp.AppLogger
import com.adapty.kmp.AdaptyUIOnboardingsEventsObserver
import com.adapty.kmp.models.AdaptyOnboardingsEmailInput
import com.adapty.kmp.models.AdaptyOnboardingsInputParams
import com.adapty.kmp.models.AdaptyOnboardingsStateUpdatedParams
import com.adapty.kmp.models.AdaptyOnboardingsTextInput
import com.adapty.kmp.models.AdaptyProfileParameters
import com.adapty.kmp.models.AdaptyUIOnboardingView
import com.adapty.kmp.models.AdaptyUIOnboardingMeta

class MyAdaptyUIOnboardingsEventsObserver : AdaptyUIOnboardingsEventsObserver {
    override fun onboardingViewOnStateUpdatedAction(
        view: AdaptyUIOnboardingView,
        meta: AdaptyUIOnboardingMeta,
        elementId: String,
        params: AdaptyOnboardingsStateUpdatedParams
    ) {
        // Store user preferences or responses
        when (params) {
            is AdaptyOnboardingsInputParams -> {
                // Handle text input
                val builder = AdaptyProfileParameters.Builder()

                // Map elementId to appropriate profile field
                when (elementId) {
                    "name" -> {
                        when (val input = params.input) {
                            is AdaptyOnboardingsTextInput -> {
                                builder.withFirstName(input.value)
                            }
                        }
                    }
                    "email" -> {
                        when (val input = params.input) {
                            is AdaptyOnboardingsEmailInput -> {
                                builder.withEmail(input.value)
                            }
                        }
                    }
                }

                // Update profile asynchronously
                mainUiScope.launch {
                    val profileParams = builder.build()
                    val result = Adapty.updateProfile(profileParams)
                    result.onSuccess { profile ->
                        // Profile updated successfully
                        AppLogger.d("Profile updated: ${profile.email}")
                    }.onError { error ->
                        // Handle the error
                        AppLogger.e("Failed to update profile: ${error.message}")
                    }
                }
            }
        }
    }
}

// Set up the observer
AdaptyUI.setOnboardingsEventsObserver(MyAdaptyUIOnboardingsEventsObserver())

Yanıtlara göre paywallları özelleştir

Onboardinglardaki sınavları kullanarak, kullanıcıların onboardingı tamamladıktan sonra göreceği paywallları da özelleştirebilirsiniz.

Örneğin, kullanıcılara spor deneyimleri hakkında soru sorabilir ve farklı kullanıcı gruplarına farklı CTA’lar ve ürünler gösterebilirsiniz.

  1. Onboarding oluşturucusuna bir sınav ekleyin ve seçeneklere anlamlı ID’ler atayın.
experience.webp
  1. Sınav yanıtlarını ID’lerine göre işleyin ve kullanıcılar için özel özellikler belirleyin.
import com.adapty.kmp.Adapty
import com.adapty.kmp.AdaptyUI
import com.adapty.exampleapp.AppLogger
import com.adapty.kmp.AdaptyUIOnboardingsEventsObserver
import com.adapty.kmp.models.AdaptyOnboardingsSelectParams
import com.adapty.kmp.models.AdaptyOnboardingsStateUpdatedParams
import com.adapty.kmp.models.AdaptyProfileParameters
import com.adapty.kmp.models.AdaptyUIOnboardingView
import com.adapty.kmp.models.AdaptyUIOnboardingMeta

class MyAdaptyUIOnboardingsEventsObserver : AdaptyUIOnboardingsEventsObserver {
    override fun onboardingViewOnStateUpdatedAction(
        view: AdaptyUIOnboardingView,
        meta: AdaptyUIOnboardingMeta,
        elementId: String,
        params: AdaptyOnboardingsStateUpdatedParams
    ) {
        // Handle quiz responses and set custom attributes
        when (params) {
            is AdaptyOnboardingsSelectParams -> {
                // Handle quiz selection
                val builder = AdaptyProfileParameters.Builder()

                // Map quiz responses to custom attributes
                when (elementId) {
                    "experience" -> {
                        // Set custom attribute 'experience' with the selected value (beginner, amateur, pro)
                        builder.withCustomAttribute("experience", params.value)
                    }
                }

                // Update profile asynchronously
                mainUiScope.launch {
                    val profileParams = builder.build()
                    val result = Adapty.updateProfile(profileParams)
                    result.onSuccess { profile ->
                        // Profile updated successfully
                        AppLogger.d("Custom attribute 'experience' set to: ${params.value}")
                    }.onError { error ->
                        // Handle the error
                        AppLogger.e("Failed to update profile: ${error.message}")
                    }
                }
            }
        }
    }
}

// Set up the observer
AdaptyUI.setOnboardingsEventsObserver(MyAdaptyUIOnboardingsEventsObserver())
  1. Her özel özellik değeri için segmentler oluşturun.
  2. Bir placement oluşturun ve oluşturduğunuz her segment için kitleleri ekleyin.
  3. Uygulama kodunuzda placement için bir paywall gösterin. Onboardinginizde paywall açan bir düğme varsa, paywall kodunu bu düğmenin eylemine yanıt olarak uygulayın.