Home Projects Portfolio Dashboard Export PDF Log in

Gamifying Profile Completion: Implementing Smart Reminders in Laravel

In the landing project, we recently tackled a challenge common to many user-facing applications: how to encourage users to complete their profiles without becoming a source of annoyance. We implemented a new profile completion tracking system that balances user engagement with smart, rate-limited communication.

The Problem: Engagement vs. Fatigue

Previously, our dashboard only offered a generic hint for incomplete profiles. It was easy to ignore and lacked clear guidance on progress. We needed a system that provided a visual incentive for users and a background worker to send timely, relevant reminders.

Our Approach: The Scoring Service

We centralized our logic into a ProfileCompletionService. By treating the profile as a 10-point checklist, we created a single source of truth that calculates progress based on essential fields like biography, skills, and professional history.

class ProfileCompletionService
{
    public function calculateScore(User $user): int
    {
        $fields = ['name', 'bio', 'phone', 'email', 'technologies', 'experience'];
        return collect($fields)->filter(fn($f) => !empty($user->$f))->count();
    }
}

This service powers both the dashboard progress bar and the background command that triggers email and database notifications.

Intelligent Filtering and Rate-Limiting

To ensure our reminders are effective and non-intrusive, we added strict filters to our background command:

  1. Filtering: We now explicitly exclude recruiter accounts and orphaned users without tenants to ensure notifications only reach relevant portfolio owners.
  2. Rate-Limiting: Reminders are capped at once every 20 hours per user, with a global maximum of 10 reminders.
  3. Re-arming: By using an Observer pattern, the system resets the reminder cycle if a profile that was previously complete becomes incomplete again (e.g., after a field update), ensuring users remain engaged over time.

Measuring Success

By leveraging Laravel's built-in command scheduling and robust testing suite, we ensured the system remains reliable. We verified our logic with 9 unit and feature tests, ensuring that timezones and recurrence rules work as expected.

Takeaway

Don't let your engagement features turn into spam. Build a centralized service to calculate progress, gate your communications with strict business logic (like user roles and rate limits), and always provide clear, visual feedback in the UI to guide your users' next steps.


Generated with Gitvlg.com

Gamifying Profile Completion: Implementing Smart Reminders in Laravel
Germanwithpants

Germanwithpants

Author

Share: