Semantic Mapper

 

Map New Event

This option provides a comprehensive mapping process, enabling you to define and configure semantic events step by step. It offers flexibility and precision in mapping events based on your unique needs.

Explore the Events

The Semantic Mapper page allows you to view all events you provided to Conviva and explore events to decide which events that require mapping.

Note: If you have a clear understanding of the events that need to be mapped and the corresponding tag key and tag value, skip the exploring process.

1. To access the Semantic Mapper page, from the ECO application, select Activation.

   

   Under the Semantic Mapper tab, drop down lists display on the page and allow you to view all events, event tag keys, event tag values, and mapped events. Click Add Dimension to add dimension drop down list to help you explore events.

   

2. To view the unmapped events in the specific time range, in the time range bar, select your desired time range, such as May 24 to May 26.

3. Check the unmapped events and confirm which unmapped event requires mapping based on these points:

   • Consolidate event names to simplify event recognition.

   • Group related events to optimize event presentation and correlate app activities.

For example, the event screen_view does not indicate which kind of screen viewers viewed. Map the event with the tag key screen_name and the tag value login_welcome to Login Screen View. This mapping assists in clearly identifying and analyzing a viewer behavior when the viewer views the login screen.

4. This mapping assists in clearly identifying and analyzing a viewer behavior when the viewer views the login screen.

5. Confirm the event tag key and event tag value for the event you want to map.

   1. To filter all data related with the event, from the dimensional list, click the event. For example, double click screen_view.

   2. From the drop-down list, select Event Tag Key, and then click the specific item of tag key. For example, you want to map screen_view to a clear event that shows which kind of screen viewers viewed. You need to click screen_name.

   3. From the drop-down list, select Event Tag Value to view all the tag values of the event tag key, and confirm the event tag values.

      For example, for the event screen_view with the screen_name tag key, the event tag values are login_welcome, login_username, login_link, and so on. You want a single mapped event that indicates viewers viewed login screen, so the event tag values is login_welcome.

Set Mapping Rules and Deploy Mapped Events

After confirming the event that needs to be mapped, and the related event tag key and event tag value, you need to set mapping rules for mapping events.

1. To access the page, click +Map New Event from the main page.

2. Fill up the fields in Set Mapping Rules by using one of the options:

   Note: If the event rule matches an existing one, a reminder message appears. Click Yes to apply the duplicate rule to the new event mapping. Click No to cancel the mapping.

   • If you have previously explored events using the mentioned steps, click Map This to set the rules automatically.

     When setting the tag value, you have several conditions and rule options available, including "contains", "not contains", "equals", "not equals", "is empty", and "is not empty", as well as "or" and "and" rules.

     Note: Is not empty: Indicates the string contains at least one character. Is empty: Includes cases where the string is either empty (contains zero characters) or null (has no value).

     

     Example:

     For the event _user.login with the event_action tag key, the event tag values are Success and success if you want to a mapped event that indicates the success login. Use one of the options.

     • Option A: Set the tag Value to contain uccess.

     • Option B: Set a tag value to equal Success, click “Add OR Rule” and then set the tag value to equal success.

   • If you have a clear understanding of the events that need to be mapped and the corresponding tag key and tag value, follow the step:

     • From the drop-down list of Event Name, Tag Key and Tag Value, select the event name, tag key and tag value. For example, select screen_view, screen_name, and login_welcome.

       Note: You have multiple conditions and rule options at your disposal when configuring the tag value. Refer to the previous note for further details.

3. Select a suitable category and type the event name in the Set Mapped Event field. For example, use Login Screen View as the mapped name and select Login/Logout.

4. Click Save.

5. On the Semantic Mapper page, click Deploy, select the specific items on the Deployment Confirmation page, and click Deploy.

   

6. After deploying, you can check the total number of the mapped events on the Semantic Mapper page and also use the mapped events as dimension values on the Trends page.

Quick Map

1. To open the map page, click Quick Map from the main page.

2. On the Quick Map page, from the drop-down list on the left, select all the events that you want to map.

3. In the Quick Map field, select suitable category and set mapped names.

4. To complete the mapping, click Map Selected Events.

Block Event

1. To access the Block Event page, click Block Event from the main page.

2. On the “Set Block Rules” section, from the “Block Event Name” drop-down list, select the event that you want to block. For example, choose conviva_network_request.

3. To set block rules, choose one of the options based on your requirements.

   • To block all the events that you selected in step 2, select Block All.

   • To block the specific events that are based on the events you selected in step 2, select Block if…, and fill out the key values that the specific event owns. You can add multiple block rules for different specific events by clicking Add OR Rule.

     For example, if you want to block the conviva_network_request event that triggered when loading images, select Block if…, and fill out the key values as .png, .jepg, and .jpg.

     

4. To apply the block rules that you set, click Block Event from the top right corner.

Create Custom Dimension

For example, create a custom dimension based on the Player Name event tag key and select mapped events to determine the dimension values. This new dimension enable the analysis of application player performance across different player dimensions in the Trends dashboard.

1. Click New Custom Dimension.

   

2. Select a tag key either is a global type or event type from the drop-down list.

   Note: The global tag keys, such as duration and targetUrl, apply to all events. Event tag keys apply to only the specific mapped events.

   

   Note: When creating a custom dimension and entering a tag key name, the Tag Key list displays up to 500 matching tag keys. If the desired tag key is not listed, locate it in the Tag Key table, click the kebab icon next to the tag key name, and select New Custom Dimension to add the tag key to the Tag Key field in the Custom Dimension area. Alternatively, use the global filter in the Semantic Mapper to find the tag key in the Tag Key table.

3. For event specific tag keys, select the events from which the dimension values are extracted. By default, select all mapped events. If you want to use specific mapped events, perform these steps:

   Note: Global tag keys exist in all events, so mapped event selection is not required.

1. Select the mapped event containing the tag key selected in the previous step from the field.

   

2. (Optional) To add more mapped events for the custom dimension values, click Add and select a mapped event. For example, selecting both play start and play end events to extract dimension values for a play duration dimension.

   

   Note: If the event you want to add does not appear in the mapped event list, use the Map New Event tab to map the event so it appears in the list.

4. In the Set Custom Dimension field, set the dimension name.

   

5. In the Trends dashboard, click + Dimension from the Dimension table, and check whether the created dimension is in the Custom list. Select the check box to apply the new dimension to the dimension tables.

   

6. (Optional) To edit a custom dimension, choose either:

   • Go to the Management tab, edit the custom dimension from the Custom Dimension table. For more information, check Management.

   • Go to the Semantic Mapper tab, select the desired custom dimension from the dimension drop-down list, click edit, and make necessary updates.

Rename Page and Screen Titles

The Edited Page Title and Edited Screen Title are two preset dimensions offered by Conviva, helping you aggregate data using rules to improve the usability and quality of dimensional analysis results. These dimensions are especially helpful when the collected data contains variations, such as 'Home' and 'home' referring to the same concept but appearing as two different values, or when values are not easily readable, like '/ai_alert'. The two preset dimensions allow you to clean up or standardize values based on custom rules, ensuring consistent data for actionable insights.

1. Click Rename Page/Screen.

   

2. Select an option based on your condition:

   • Page Title Rename: for renaming web page titles.

   • Screen Title Rename: for renaming mobile screen titles.

     

3. Select an item from the Metadata Name drop-down list, specify the condition, enter the value, and add the necessary rules based on your conditions. Enter the new name in the Set New Name field and click Save.

   For example, if you want to aggregate page titles containing "Home" or "home," select Title, choose "equals Home," click Add OR Rule, and use "equals home."

   

   

   Note:  To add more logical algorithms, click Add New Metadata and fill in the required fields.

4. Go to the Metric Builder page and click Preview to validate the generated metrics in a preview version of Trends with up to 14 days of sample data. Go back to the Semantic Mapper page to update if necessary.

   

5. Click Deploy, find the dimension, review the changes and Click Deploy. The deployed changes take effect within minutes, depending on the data volume. After deployment, you can start using the updated dimension in the ECOTrends dashboard.

   

Map New Event Map New Event semantic mapper semantic mapper quick map quick map block map block map mapped events mapped events blocked events blocked events Create Custom Dimension