Instrument your Mobile Application with Product Mapper

Module

A Module in Product Mapper represents a section in your mobile application. Each section can have sub-sections or pages. For example, an e-commerce application can have modules like Home, Products, Sign in, Sign up, and so on. The Products module can further have sub-modules like Electronic equipment, home appliances, Kitchen needs, and so on. A module consists of pages in your mobile application. 

Feature

A Feature represents a page in your mobile application. A page or group of pages can be part of a module. For example, Sign in, Sign up, About us, can all be part of the Home module.

Rules

You can create rules to track page views. Gainsight PX supports three kinds of rules for mobile applications:

• Screen Rule: This rule is used to track the number of visits for a page (feature) in your mobile application. You can also track which user visited.  
• Custom Event Rule: This rule tracks events fired via API. 
• Tap Rule: This rule events are created when the user taps on the mapped element.

Create Modules

This subsection explains the process of creating Modules in Gainsight PX. Once you create modules, you can add features under the modules.

To create Modules:

1. Navigate to the Product Mapper from the left pane.
2. Select the Mobile channel.
3. Select the required mobile product.
4. Click Create module or select the Module option from the + New menu.

Note: You can also create a module by clicking on the Add new... Module icon on the right side of the screen. 

5. Enter a name for the module and hit the enter key. In the following image, a new module called Mobile is created.

Create Features

This subsection explains the process of creating Features in Gainsight PX. You can create a Feature under a module or keep it independent under your product tree.

To create Features:

1. To create a feature under a module, right-click the required module, and select Feature. 

The new feature is created under the selected module.

Note: To create a feature independently, select the Feature option from the + New menu.   

2. (Optional) Click Reorder and drag a feature or module, to change its position. 

Similarly, create modules and features as required. 

Create Screen Rule

This section explains how to create a Screen rule. Once you create features for your mobile page, you must create screen rules for tracking page views.

To create screen rule:

1. From the left pane, click Product Mapper.
2. Select the required feature.
3. Right-click the feature and select Screen rule. The Rule window displays.

You can also click the Screen rule icon on the top right corner.

6. Enter a name for your rule.
7. Select either Screen name or Screen class from the first drop-down menu.
8. Select a suitable operator.
9. Enter the name of the Screen name or Screen class (based on the option selected in step 7). A set of matching options are suggested. Select your Screen name or Screen class.
10. Select Platform.
11. Select either Android or iOS from the platform drop-down menu and select a suitable operator.

The above rule tracks the feature when a user views the page called screen mobile from the Android app.

To create multiple rules in a single feature, click + Add. For example, to create a feature that tracks both the sign-in page and sign up pages simultaneously, create two rules in the same feature. This feature jointly tracks all sign in and signup attempts. You must use the OR logic to ensure that the feature is tracked when either of the two rules is executed. The AND logic must be used when you want to track the feature only when both rules are satisfied.

You can view the analytics of the feature or modules from the Adoption report.

You can also view the features that a user has accessed, from the Recent Activity section of the Audience Explorer page.

Create Custom Event Rule

This section explains how to create custom event rules. Custom event rules track those aspects of your mobile application that are not readily displayed on mobile. A developer must first create custom events in your own application and associated properties if any before you can create custom event rules. 

To create Custom event rules:

1. Select the required feature. 
2. Click the Custom event icon or right-click the required feature and select Custom event. 

3. Enter a name for the rule.
4. Select the required event from the drop-down menu.

5. (Optional) Click + Add to add properties for the event.

7. Select a suitable operator for the property type and enter the name of the property.

8. (Optional) Click + Add to add multiple Properties. You can apply AND or OR logic between properties. 

Create Modules

This subsection explains the process of creating Modules in Gainsight PX. Once you create modules, you can add features under the modules.

To create a module:

1. Log into your Gainsight PX mobile subscription.
2. Select the required product and type of application as Mobile from the available drop-down options.
3. From the left pane click Product Mapper and then click Map Features. The screen displays a QR Code.

4. Scan the QR code with an app on your mobile device or copy an URL using Click to copy link and send the link to your mobile device.
5. From the displayed screen, click OPEN IN APP link. Your mobile application is launched. (that has Gainsight mobile SDK).
6. Tap the PX icon on the home screen.
7. From the displayed options, tap Product Feature Map. The product tree displays.
   
8. Tap the + icon and then click Add Module.
   
9. Enter the module name and tap Done. The new module now appears in the product tree.

Create Features

This subsection explains the process of creating Features in Gainsight PX. You can create a Feature under a module or keep it independent under your product tree.

To create Features:

1. Tap the PX icon on the home screen.
2. From the displayed options, tap Product Feature Map. The product tree displays.
3. Tap the module for which you want to create the feature.
4. Tap the + icon and then tap Add Feature. The new feature is created within the selected module.

Create Tap Rule

This section explains how to create a Tap Rule. Once you create features for your mobile page, you must create tap rules for tracking tap events for the elements on your application.

To create tap rule:

1. Tap the PX icon on the home screen.
2. From the displayed options, tap Product Feature Map. The product tree displays.
3. Select the feature for which you want to create the rule and tap the create Tap Rule icon.
   
4. Touch down and drag your thumb on the screen and then select the element that you want to map. A blue dotted line appears around the selected element. Touch up (release your thumb) once you reach the required element.

    

5. Enter the Title of the rule and click Save. The red button starts blinking when the feature is being mapped. You can also pause/stop the mapping using the respective buttons.

10. View the new feature details that appear in your Product Tree.