Enable Program Reactivation

This section describes how to build a program reactivation flow, to reactivate the ZenSaver program. This section includes the following topics:

1.0. Update Application UI If the User Is Already Activated

Use the following UX design and code to check if the user is already activated. If the user is already reactivated, then update the UI to reactivate the IQL program.

class ExplainerFragment : Fragment(R.layout.fragment_explainer) {
    private lateinit var binding: FragmentExplainerBinding
    private val viewModel: OnboardingViewModel by activityViewModels()

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        binding = FragmentExplainerBinding.bind(view)
        addObserver()
        ...
        ...
    }

    private fun addObserver() {
        lifecycleScope.launch {
            viewModel.driverStatus
                .flowWithLifecycle(lifecycle, Lifecycle.State.CREATED)
                .distinctUntilChanged()
                .collectLatest {
                    setUpView(it)
                }
        }
    }

    private fun setUpView(driverStatus: IQLDriverStatus?) {
        if (driverStatus?.metrics != null && driverStatus.metrics!!.dateFirstDrive != null) {
            // If the user is a returning user
            setProgressIndicatorCard(driverStatus)
        } else {
            setHowItWorksCard()
        }
    }
    ...
    ...
    @SuppressLint("NewApi")
    private fun setProgressIndicatorCard(driverStatus: IQLDriverStatus) {
        with(binding) {
            progressIndicatorCard.root.makeVisible()
            textView2.text = getString(R.string.welcome)
            textView3.text = getString(R.string.reactive_zensaver_subtitle)
            val result = HtmlCompat.fromHtml(getString(R.string.by_clicking_reactivate), HtmlCompat.FROM_HTML_MODE_LEGACY)
            textTerms.text = result

            activateZenSaver.text = getString(R.string.reactivate_zensaver)
            ...
            ...

            var progressPercentageValue = driverStatus.metrics?.progressPercentage?.toInt() ?: 0

            if (driverStatus.metrics?.isOfferAvailable == true) {
                progressPercentageValue = MAX_PROGRESS
                setupVerticalProgress()
            }

            if (progressPercentageValue < 0) {
                progressPercentageValue = DEFAULT_PROGRESS_PERCENTAGE
            }

            progressIndicatorCard.progressPercentage.text =
                ProgressUtils.getProgressFormatString(progressPercentageValue)

            // Other UI elements setup
            ...
            ...
        }
    }
}

2.0. IQL Reference Application UX Design

Here is the overall design implementation for the IQL Reference Application:

3.0. Publisher Integration Testing Checklist

Use the following testing checklist to that a returning user's data is displayed:

When a returning user reactivates the program, ensure that their previous program data is displayed accurately and that they can edit any necessary fields.

PreviousCapture User Permissions NextTest Drive Experience