Organization Hierarchies Basic Overview (Studio)

About Organization Hierarchies in XM Discover

You can use organization hierarchies to incorporate your organization structure into XM Discover reporting. From contact centers to product lines and retail stores, an organization hierarchy can be useful to expand your analytics while improving personalization and data access control. For information on managing organization hierarchies, see Managing Organization Hierarchies.

For examples and troubleshooting tips for organization hierarchies in XM Discover, please see Best Practices for Organization Hierarchies (Studio).

Applying Organization Hierarchies

Organization hierarchy is a powerful feature that can greatly enhance your reporting and Customer Experience (CX) operationalization to address CX challenges. You can use organization hierarchies for a range of purposes:

• Dashboard personalization and access control: Provide tailored insights to each user and prevent them from seeing sensitive data.
• Product model relationship: Use organization hierarchies to capture relationships.
• Peer and parent reporting: Enable dashboard viewers to compare their CX performance KPIs to their peers and parents in the organization.
• Target and variance reporting: Quantify how each level of an organization stacks up to its targets and how these targets vary compared to actual KPIs.
• User and group management: Manage users and groups at scale.
• Notification, alert and case routing: Personalize notifications to foster accountability.

Dashboard Personalization and Access Control

You can use access control to prevent users from seeing sensitive data and distribute insights tailored to each person via dashboard personalization. Given their place in the hierarchy, users see content personally filtered for them. For example, contact centers can use organization hierarchies to show dashboard viewers data related to their recent customer service calls. When a supervisor opens the shared dashboard, data on all widgets is automatically filtered for them. An operations manager higher in the hierarchy can access data associated with all of their subordinates (both the aggregates and individual supervisors).

Product Model Relationship

You can use organization hierarchies to capture relationships. For example, a cruise line company can use an organization hierarchy to capture the relationship between voyages and ships. All users are assigned to the top level of the hierarchy and see the same report data. Selecting a specific ship name in the hierarchy filters the widgets to show data for all the voyages associated with that ship.

Peer and Parent Reporting

You can use organization hierarchies so that dashboard viewers can compare their CX performance KPIs to their peers and parents to highlight individual contributions and foster friendly competition. Report builders can share insights so users see their metrics relative to their peers or parents in the organization.

Target and Variance Reporting

Target and variance reporting enables you to quantify how each level of an organization stacks up to its targets and how these targets vary compared to the actual KPIs.

You can use organization hierarchies to define goals for data segments and measure the difference between goals and actual results. For example, a hotel group can define target sentiment values for individual hotels and create a simple custom math metric to show the difference between the target and actual sentiment.

User and Group Management

Hierarchy management means user and group management at scale, from distributing content to managing data access rights.

Notification, Alert, and Case Routing

Organization hierarchies enable organizations to personalize notifications to foster accountability.

Attribute Filter Hierarchies

Attribute filter-based hierarchies can better support larger brands that have structured fields that define the rules for each node or leaf. For more information, see Attribute Filter-Based Hierarchies.

Defining Organization Hierarchies

To define an organization hierarchy, you need to do the following:

1. Add an Organization Hierarchy: Create a new organization hierarchy. You can create a custom filter-based hierarchy or an attribute filter-based hierarchy.
2. Define the Organization Structure: Define your organization levels and their hierarchy.
3. Map Data Filters to Organization Levels: Specify a data filter for each level in your organization.
4. Map User Emails to Organization Levels: Assign users to their appropriate organization levels.
5. Map Custom Enrichment Data to Organization Levels: Add up to 6 enrichment parameters for each organization level if you intend to leverage target and variance reporting. This step is optional.
6. Publish an Organization Hierarchy: Make your organization hierarchy available for hierarchy-based data groupings.
7. Activate an Organization Hierarchy: Make your organization hierarchy available for dashboard personalization, peer and parent reporting, and target and variance reporting.

Attribute Filter-Based Hierarchies

Attribute filter-based hierarchies do not require classification or publishing; they process requests directly with the defined filter applied. Therefore, these hierarchies can better support larger brands that have structured fields that define the rules for each node or leaf.

Attribute Filter-Based Compared To Custom Filter-Based Hierarchies

Attribute filter-based hierarchies differ from custom filter-based hierarchies because attribute hierarchies:

• Do not require publishing and classification.
• Support up to 75,000 nodes.
• Support up to 1,000 peer nodes.
• Restrict to one attribute for the leaf level node and one value for each leaf node.
• Do not offer automatic group creation.
  Qtip: You can add up to 500 users to a group using the bulk user upload.

Adding an Organization Hierarchy

1. Sign into Studio.
2. Expand the user avatar menu in the top navigation area.
   
3. Select Organization Hierarchy.
4. Select the Organization tab.
   
5. Click New Organization Hierarchy.
6. Enter a unique name for your hierarchy.
   
7. Select the hierarchy type.
   • Attribute Filter: Create the organization hierarchy based on an attribute filter. For more information, see Attribute Filter-Based Hierarchies.
   • Custom Filter: Create the organization hierarchy based on traditional XM Discover hierarchies.
8. Click Save.

Defining the Organization Structure

After you add an organization hierarchy, you can define your organization structure.

1. Sign into Studio.
2. Expand the user avatar menu in the top navigation area.
   
3. Select Organization Hierarchy.
4. Locate your organization hierarchy in the list. Click the Upload link in the Hierarchy files column.
   
   Qtip: The Upload link means no structure has been defined. Once the structure is defined, the Upload link changes to Edit.
5. Click Download Template. The MS Excel template file for the organization structure will be saved to the default location for downloads on your computer.
   
6. After you download the template, you can use it as a starting point to define your build your organization hierarchy structure by defining your organization levels and their hierarchy..
7. After you define your organization structure, you can upload the structure file. Click Upload File and select the structure file saved on your computer.

Mapping Data Filters to Organization Levels

After you define your organization structure, you can specify a data filter for each level in your organization.

1. Sign into Studio.
2. Expand the user avatar menu in the top navigation area.
   
3. Select Organization Hierarchy.
4. Locate your organization hierarchy in the list. Click the Upload link in the Hierarchy files column.
   
5. Select the Step 2: Data Filters tab from the left-side menu..
   
6. Click Download Template.
   Qtip: Data filters templates (MS Excel format only) are created based on the number of projects in your content provider and on the organization structure you uploaded earlier.
7. If you have access to several content providers or accounts, you will be asked to select a content provider and an account.
8. Select the project for your organization hierarchy.
   
9. Open the MS Excel template and define project-specific data filters for every level of your organization structure.
   Qtip: The data filters are essentially a structured attribute or a keyword.
10. After you define the data filters for your organization structure, you can upload the mapping file. Click Upload File and select the structure file saved on your computer.

Mapping Users to Organization Levels

After defining your organization structure and mapping data filters to organization levels, you can map user accounts to the same levels.

1. Sign into Studio.
2. Expand the user avatar menu in the top navigation area.
   
3. Select Organization Hierarchy.
4. Locate your organization hierarchy in the list. Click the Upload link in the Hierarchy files column.
   
5. Select the Step 3: Users tab from the left-side menu.
   
6. Click Download Template. The MS Excel template file for the user mapping will be saved to the default location for downloads on your computer.
   Qtip: User mapping templates (available in MS Excel format only) are based on the organization structure you uploaded earlier.
7. Open the MS Excel template and enter Studio users’ email addresses in Column B, starting from B6.
8. Select the Skip Users Not in System checkbox to skip email addresses that don’t match existing Studio users. This step is optional.
9. If you’re creating a custom filter-based hierarchy, select Automatically Create Groups From This Hierarchy to create a new group for each segment:
   • Selected: Studio will create a new group for every business segment defined in a hierarchy. All users mapped to these segments will be automatically added to their groups. This will allow you to easily share your dashboards with these users.
     Qtip: You can choose to create 1 additional group per hierarchy node.You can remove these derived groups at any time, as well as keep them after removing the related hierarchy.
   • Not selected: No segment-level groups will be created.
     Attention: A master group for all organization hierarchy users is created regardless of what you choose during this step.
10. After you map user emails to your organization structure, you can upload the mapping file. Click Upload File and select your user mapping file.
11. Click Done.
    Qtip: If you see an error message when you upload your file, please see Examples and Troubleshooting Tips for Organization Hierarchies in XM Discover.

Mapping Enrichment Parameters

After defining your organization structure and mapping data filters and user emails to its organization levels, you can define up to 6 enrichment parameters for each organization level. This step is optional.

1. Sign into Studio.
2. Expand the user avatar menu in the top navigation area.
   
3. Select Organization Hierarchy.
4. Locate your organization hierarchy in the list. Click the Upload link in the Hierarchy files column.
   
5. Select the Step 4: Enrichment tab from the left-side menu.
   
6. Click Download Template. The MS Excel template file for the enrichment mapping will be saved to the default location for downloads on your computer.
7. Open the MS Excel template and provide enrichment parameters for each organization level.
8. After you map enrichment parameters to your organization structure, you can upload the mapping file. Click Upload File select your enrichment mapping file
   Qtip: If you see an error message when you upload your file, see Defining Organization Hierarchies Troubleshooting.
9. Click Edit Reportable Parameters.
10. Select the parameters you want to enable for reporting in the left column and move them to the right column using the arrow buttons in the middle.
    
11. Click Add All in the left column to enable all enrichment parameters.
12. Click Hide All in the right column to disable all enrichment parameters.
13. Click Done to apply your selections.
    Qtip: You can edit reportable parameters at any time after uploading the enrichment mapping file. To do so, click Edit in the Enrichment column of your organization hierarchy and then click the Edit Reportable Parameters button in the new window.

Publishing and Unpublishing an Organization Hierarchy

After defining your organization structure and mapping filters, users, and enrichment parameters to its organization levels, you can publish and unpublish it.

1. Sign into Studio.
2. Expand the user avatar menu in the top navigation area.
   
3. Select Organization Hierarchy.
4. Locate your organization hierarchy in the list.
5. Expand the actions menu to the left of the hierarchy.
   
6. Select Publish.
   
   Qtip: After the initial publishing, the menu options change to Republish / Unpublish. Click Republish to apply any changes you have made to the hierarchy’s structure and data filters since the last publishing.
7. In the Publish Organization Hierarchy window, select the Include Records Without Text? checkbox to include records with empty verbatim into your organization hierarchy. Alternatively, deselect the Include Records Without Text? checkbox to exclude records with empty verbatims from your organization hierarchy.
   
8. Select the Include In Incremental Dataflows? checkbox to include the organization hierarchy model in incremental runs. Alternatively, deselect the Include In Incremental Dataflows? checkbox to exclude the organization hierarchy model from incremental runs.
   Qtip: If you expect that publishing an organization hierarchy will conflict with other Realtime Downstream dataflows, you should deselect the Include In Incremental Dataflows? checkbox. The model that gets created and subsequently classified will not block other dataflows if this option is not selected.
9. Click Ok. The category model for this organization hierarchy will be built.
10. Click Unpublish to unpublish an active hierarchy and temporarily disable hierarchy-based data groupings.
    
    Qtip: This may be useful when you need to update the organization hierarchy, but not make it entirely unavailable to your team. When you unpublish an active organization hierarchy, dashboard personalization is not disabled.
    Qtip: Change the name of a current organization hierarchy, if it is unpublished, rather than create a new hierarchy for a name change. For more information, please see Renaming an Organization Hierarchy.

Activating and Deactivating an Organization Hierarchy

Before you activate an organization hierarchy, you need to upload its structure, data filters, user mappings, and enrichment parameters (this step is optional), and publish it. You can activate an unpublished hierarchy. Unpublished hierarchies can be used to personalize dashboards but are not available as groupings.

1. Sign into Studio.
2. Expand the user avatar menu in the top navigation area.
   
3. Select Organization Hierarchy.
4. Locate your organization hierarchy in the list.
5. Turn on the toggle in the Enabled column.
   
6. Alternatively, expand the actions menu to the left of the hierarchy.
7. Select Enable.
   
8. Click Yes to confirm that you wish to activate the hierarchy.
   
9. To deactivate an organization hierarchy, turn off the toggle in the Enabled column.
   
10. Alternatively, expand the actions menu.
11. Select Disable.
    
    Qtip: You cannot use deactivated hierarchies in dashboards.
    Qtip: You can unpublish an active hierarchy to disable hierarchy-based groupings while keeping dashboard personalization. You can also delete an organization hierarchy.