Product Experiences

With Product Experiences, you can change the behavior and appearance of your app remotely without an update. This helps you to deliver in-app personalization experience to your app users and test their response. You can use Product Config to modify app behavior and Feature Flags to add or remove features from your app without performing an app store deployment.

Introduction

You can remotely configure your app with Product Config. The configuration can be anything, including the look and feel of the app, and the workflow for users.

For example, you want to want to enable dark mode on your app. However, you want the following additional options:

  • You want to test it first on iPhone users who live in New York.
  • You must also be capable of disabling the feature if it needs more work.

You can create a Product Config for this improvement and test the response to your app. Before we begin using Product Config, we must complete the necessary setup.

Set up

To run a Product Config or a feature flag, you must create keys and segments for your app.

Create Keys

These are the keys that you have defined in your app code. You can map these keys from the CleverTap dashboard and control the configuration of your app.

To create keys:

  1. Go to Product Experiences > Setup > Keys
  2. Click +Key to create a new key.

Note

The name of the key defined here must match the name of the key defined in the app. This name cannot be changed later. You can add up to 500 keys.

  1. Add the Key definition.

Let us add some sample values:

You can now activate or deactivate the dark mode based on the Keys. The default value that the app is expecting for this key is 3. These values are set in your app. Let us assume that the key value 3 means activate the feature, 4 means deactivate the feature.

  1. Click Save. The dark_mode key is now listed on the Manage Keys page.

Edit/Archive Keys

  1. Go to Product Experiences > Setup > Keys. The Keys page appears.
  2. Click the ellipsis menu to edit or archive a key. Only the default value and description can be edited after saving a key.

You can view all the archived keys by selecting the Archived Keys box at the bottom of the key's list. If a key is used in a product config or feature flag then it cannot be archived.

Create Segments

The segments are the target users that will receive app changes.

To define the segments:

  1. Go to Product Experiences > Setup > Segments
  2. Click +Segment to create a new segment.
  3. Name the segment.
  4. Create a segment by users who performed and/or did not perform an event. You can also create segments for user properties such a demographics, geography, and so on. For our example, create a segment of iPhone users living in New York.
  5. Save the segment.

Edit/Clone a Segment

  1. Go to Product Experiences > Setup > Segments. The Segments page appears.
  2. Click the ellipsis menu to edit or clone a segment. For example, you may want to edit the city and create another user segment for Miami.

Product Config

Create Product Config

You can have multiple members of your team create Product Config with multiple keys and segments. You can then group these keys.

  1. To create a Product Config, click Product Experiences > Product Config. The Product Config page appears.
  2. Click the +Product Config button to create a new Product Config. The create a Product Config page appears.
  3. Enter the name and description for your Product Config. For our example, let us name the Product config as dark mode.
  4. Select the Segments and Keys for your Product Config group. The Keys are the keys that you have assigned in your app for each element or feature and the Segments are the group of users that will receive this feature. In our example, we select the "iPhone users in New York" and "iPhone users in Miami" as Segments and "Dark_Key" as the Product Config Key. For more information on creating keys, see Keys

Note

A key can only be used in one Product Config.

  1. Add the value and set the priority for your Product Config keys. Drag the icon up or down to change segment priority.
  2. Publish your Product Config or schedule it to be published at a later date.

Edit/Archive Product Config

  1. To edit a Product Config, click Product Experiences > Product Config. The Product Config page appears.
  2. Click the ellipsis menu to edit or archive a Product Config.

Note

Any changes to a Product Config are saved in a new version. You can always revert to an earlier version.

View Statistics

The stats will show you the distribution and value of the key stats for your Product Config. To view stats for a Product Config:

To view Product Config Stats:

  1. Click Product Experiences > Product Config. The Product Config page appears.
  2. Click the Product config from the list and scroll down to view the stats.

You can view the following information:

  1. You can see a trend of the total number of keys delivered for all segments or a particular segment from the first chart.
  2. In the second box, you can further break it down to get the count of each type of key value wise.

Product Config Version

A new version is created every time you edit a Product Config. If the current config is not working for some reason, you can always revert to an older version of Product Config:

  1. Click Product Experiences > Product Config. The Product Config page appears.
  2. Click the ellipsis menu to edit a Product Config. The versions appear on the right side.
  3. Click the required version number and Publish. The selected version becomes active and the current version becomes inactive.

Feature Flags

You can have canary releases using Feature Flags. You can remotely turn on or turn off features on your app.

For example, you want to want to enable an automatic playlist of recommended videos on your app. This is a really great feature but it freezes the app screen for some versions of iOS. You want the following options:

  • You must be able to target iPhone users.
  • You want to test it on 20% of New York users and 30 % of Miami users before you roll it out to all users.
  • You must also be capable of disabling the feature if it needs more work.

Feature Flags can enable or disable a feature with a simple toggle. You can also test the feature on your users before you make it available to everyone. Your users will now have seamless access to the feature and add to a better experience.

Create Feature Flags

  1. To create a Feature Flag, click Product Experiences > Feature Flags. The Feature Flags page appears.
  2. Click the +Feature Flag button to create a new Feature Flag. The create a Feature Flag page appears.
  3. Enter the name and description for your Feature Flag. For example, we create an Auto Playlist Feature Flag.
  4. Select the Segments and Keys for your Feature Flag. The Keys are the keys that you have assigned in your app for each feature and the Segments are the group of users that will receive this feature. For example, we select the "iPhone users in New York" and "iPhone users in Miami" segment. We select the Keys called Auto Playlist key. For more information on creating keys, see Keys

Note

A Feature Flag can have only boolean values, that is, true or false. A key can only be used in one Feature Flag.

  1. Under Key value and priority, add the set the Key value for each segment.
  2. Toggle the selected segment and define the percent of users that will receive this change.
  1. Publish your Feature Flag or schedule it to be published at a later date.

Edit/Archive Feature Flags

Note

Any changes to a Feature Flag are saved in a new version. You can always revert to an earlier version.

View Statistics

The stats will show you the distribution and value of the key stats for your Feature Flag. To view stats for a Feature Flag:

To view Feature Flag Stats:

  1. Click Product Experiences > Feature Flags. The Feature Flag page appears.
  2. Click the Feature Flag from the list and scroll down to view the stats.

You can view the following information:

  1. You can see a trend of the total number of keys delivered for all segments or a particular segment from the first chart.
  2. In the second box, you can further break it down to get a count of each type of key value-wise

Feature Flag Version

A new version is created every time you edit a Feature Flag. If the current feature is not working for some reason, you can always revert to an older version of Feature Flag:

  1. Click Product Experiences > Feature Flag. The Feature Flag page appears.
  2. Click the ellipsis menu to edit a Feature Flag. The versions appear on the right side.
  3. Click the required version number and Publish it. The selected version becomes active and the current version becomes inactive.

Updated 2 months ago


Product Experiences


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.