Display Welcome Screen

Launching the welcome screen with due personalization at the right moment

---

The Welcome Screen is a novel feature loaded in the AppVirality SDK, something which you’d not find anywhere else. This is a proactive measure to enable an intensely personalized experience to the new users coming onto your app, via a Referral Invite.

You can greet such users (ones who discovered your app via a Referral Invite) with a personalized welcome screen, displaying:

By default AppVirality generates a compelling welcome message, based on your campaign configuration settings on Dashboard. You can change this default welcome message at any time in your AppVirality dashboard

Navigation:

Dashboard >> App Details >> Select Campaign >> Click More >> Landing Pages >> Scroll down to Configure In-App Welcome Message

This can be customized to display what you would like better in place of what the systems generate.

 

Now let’s explore the method of implementing the onset of the Welcome Screen in your app, in a contextual manner.

Implement the following code blocks in your Main Activity (recommended) to launch the Welcome Screen. We have broken the method into easily recountable steps for you.

 

---

The foremost check to run is whether the registering user is an existing user or not.

The Welcome Screen is tagged to the Installation event and facilitates the user’s onboarding by initiating the Sign-up activity, while proclaiming the incentive. This has been a crucial factor is increasing user sign-up conversions by over 45%. Hence this bridge between the Installation and Sign-up would need a validation, wherein you can successfully screen/filter off the existing users.

The below code block should enable your check on the user’s pre-existence:

  
import com.appvirality.AppVirality;

public class MainActivity extends AppCompatActivity {
  AppVirality appVirality;
  private static final int REG_SCREEN_REQ_CODE = 100;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    appVirality = AppVirality.getInstance();
    if(!appVirality.isExistingUser()) {
      showWelcomeScreen();
    }
  }
}

 

 

---

Inside the Welcome Screen launcher (i.e. method) you must run through a set of operations to ensure the right user & event are being mapped. This is critical as this would directly impact the rewards being distributed to the concerned stakeholders.

As it goes: 

  
private void showWelcomeScreen() {
    appVirality.checkAttribution(null, new AppVirality.CheckAttributionListener() {
        @Override
        public void onResponse(JSONObject responseData, String errorMsg) {
            if (responseData != null) {
                String attributionSetting = responseData.optString("attributionSetting");
                if (!responseData.optBoolean("isExistingUser") && !(attributionSetting.equalsIgnoreCase("0") && !responseData.optBoolean("hasReferrer"))) {
                    Intent intent = new Intent(MainActivity.this, WelcomeScreenActivity.class);
                    intent.putExtra("referrer_details", responseData.toString());
                    startActivityForResult(intent, REG_SCREEN_REQ_CODE);
                    // Set the user as existing user after displaying the welcome screen, to
                    // avoid welcome screen getting displayed on subsequent launches
                    appVirality.setExistingUser();
                }
                
            }
        }
    });
}

---

Implement the above logic by including the following code blocks inside your Welcome Screen:

Display Welcome Message or Ask for Referral Code

 String attributionSetting = referrerDetails.optString("attributionSetting");

 // shouldEnterRefCode will be True if Referrer Details are not available, if
 // so take referral code from user to get possible Referrer Details
 final boolean shouldEnterRefCode = !attributionSetting.equals("0") && (!referrerDetails.getBoolean("hasReferrer") || appVirality.isSessionInitialized());

 if (attributionSetting.equals("0") || referrerDetails.getBoolean("isReferrerConfirmed")) {
    // Displaying Welcome Message if attribution setting is Only
    // Referral Link or Referrer has been confirmed
 } else {
    // If Attribution Setting is Only Referral Code or (Referral Link + Referral Code)
    // and Referrer is not confirmed
    if (referrerDetails.getBoolean("hasReferrer")) {
        // If user should enter Referral Code to get the Referrer Details
        if (shouldEnterRefCode) {
            // Ask the user to enter referral code, check using checkAttribution,
            // if correct display welcome message using its response
        } else {
            // Display welcome message with Sign Up button
        }
    } else {
        // Doesn't have Referrer Details, Ask the user to enter referral code, check
        // using checkAttribution, if correct display welcome message using its response
    }
 }

---

Meanwhile you must implement the following code snippets to ensure the concurrent activities are tied up together:

Sign-Up Action

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == REG_SCREEN_REQ_CODE && resultCode == RESULT_OK) {
        Intent loginIntent = new Intent(MainActivity.this, LoginActivity.class);
        loginIntent.putExtra("referral_code", data.getStringExtra("referral_code"));
        startActivity(loginIntent);
    }
}

After successful Sign Up

UserDetails userDetails = new UserDetails();
// Set the user details using the UserDetails class's setter methods
            
appVirality.init(userDetails, new AppVirality.AppViralitySessionInitListener() {
    @Override
    public void onInitFinished(boolean isInitialized, JSONObject responseData, String errorMsg) {
        if (isInitialized) {
            if (responseData.optBoolean("isNewSession")) {
                appVirality.saveConversionEvent("install", null, null, null, Constants.GrowthHackType.Word_of_Mouth, null);
                // Uncomment the below line if you have reward on sign up
                // appVirality.saveConversionEvent("signup", null, null, null, Constants.GrowthHackType.Word_of_Mouth, null);
            }
        }
    }
});