Dynamic Text Customization Within Your Native SDK

A personalized message increases the likelihood that your visitor will provide feedback. Your Native SDK now supports Dynamic Text Customization, allowing you to personalize your visitor's feedback experience! Leverage the power of Custom Properties to insert personalized user information into placeholders within your questions' titles and descriptions. This article details how to implement this feature as well as provides a few use cases to help spark your creativity.

What are the requirements?

This functionality requires at least:

Android SDK version - 1.7.1

iOS SDK version - 1.7.1

How can you implement?

Begin by including a special placeholder in survey's Create/Edit tab within your Qualaroo dashboard. Placeholders are supported only for your questions' titles and descriptions.

An example placeholder is: ${custom_property_name}

custom_property_name stands for, and is replaced by, some custom property that our customer has set inside their application via our SDK.

For example, my first question will have a title (or description): "Hello ${first_name}!"

When the Custom Property is set via setCustomProperty("first_name", "Jacob") method call, the user will see a question with a title: "Hello Jacob!" when they are prompted for feedback.

Please note that if there are missing Custom Properties (i.e. they are not set within the SDK), the survey WILL NOT be shown as we try to avoid showing incomplete surveys to visitors. A Custom Property set with empty text counts as a valid property.

Custom Properties have to be set before showing a survey (properties being set while running a survey will not modify the currently live survey).

Use case 1:

Consider we are running confirmation survey, and a new user named Joe has just completed the sign-up process. I would like to greet him by name, and ask him how he found out about our product. Keeping track of all properties related to our users is very important to us, so right after he signs up we store a Custom Property within our Native SDK. This property is named “first_name” and I set it to "Joe". With those conditions met I can run a survey that could look like:

"Hi ${first_name}! So happy to have you here! How did you learn about this app?"

- "it was recommended to me by a friend"

- "I found it on Google Play"

- "I heard about it on the radio"

Use case 2:

During our feedback campaign, it is important that we separate our user base into 2 cohorts: Active and Passive users.

Active users are generally eager to participate in any activity we request of them, such as replying to a Qualaroo survey. Passive users tend to require more explanation before they agree to provide feedback.

For Active users, we set a Custom Property "additional_description" to "" (which stands for empty text).

For our Passive users, we set a "additional_description" to "Answer this question and get a chance to win a wonderful prize!"

Once the Custom Properties are set, the survey logic looks like:

"Should the app include the dark mode for using at night?" <- title

"${additional_description}" <- description

- "Yes!"

- "I don't need it"

And now, for Active users, this survey will look like:

"Should the app include the dark mode for using at night?"

- "Yes!"

- "I don't need it"

While passive users will see:

"Should the app include the dark mode for using at night?"

"Answer this question and get a chance to win a wonderful prize!"

- "Yes!"

- "I don't need it"

Use case 3:

Our team is running a hotel booking app and we want to run a template survey whenever a user finishes his/her stay. Whenever we detect that it’s time to show a rating survey, we set two custom properties:

• ${hotel_name} to hotel’s name
• ${hotel_city} to city that the hotel is located in

Once those properties are set, we can run the following survey:

“Hey! Your trip to ${hotel_city} seems to have finished! How would you rate your stay at ${hotel_name}?”

• 0 - 10 (NPS)

So, for example this could look like this:

“Hey! Your trip to Cracow seems to have finished! How would you rate your stay at Hotel Chopin?”

• 0 - 10 (NPS)

We hope you found this article helpful! Please feel free to reach out to us at support@qualaroo.com if you ever have any questions or need anything at all!