Register app user

Register your app users with Shake by calling the Shake.registerUser method.

The passed user identifier argument should ideally reflect the identifier that uniquely represents the app user in your database. Often it is the app user's email address, but it may be their app User ID, or their device's UUID. Shake's public method is intentionally called register and not logIn because app user identification context is different in different apps.

Most apps communicate with their backend through the network layer which performs the URL request and asynchronously receives a callback with the request result. That callback's body is a common place where developers call the Shake.registerUser method, but maybe your context is different. Make sure to call this method at the place where it fits your app's flow perfectly.

A common case is to register app users from your app's Login screen

main.dart

void logInUser(String email, String password) {
    networkService.performLogin(email, password,
        (User user) {
            Shake.registerUser(user.getId());
            
            handleLogin(user);
        },
        (String message) {
            // Handle failed login
        });
}

note

Keep in mind that if your app is already published, some users will be already logged in into the app. To handle this case, we recommend calling Shake.registerUser method also on the first screen app shows. Registered user is stored locally and this method won't send registration request if it not needed.