Overview

Customer information is crucial to fully understand the customer state.

Collection feature lets you upload your transactional information to Totango and use it to understand  the customer entire picture, analyze it, and take action based on the transactional information.

This article contains the following sections

•  Overview
  • Value
  • Customers Real Life Stories
  • Use Cases
• How to configure and upload it?
  • Step 1 - Collection Definition
  • Step 2 - Collection Upload
  • Step 3 - Expose it in Account Profile
  • Step 3a - Managing Collection via UI
  • Step 4 - Collections in Segment
• Collection Deletion
• Limitations
• Other Resources

Value

• Increase CSMs productivity by consuming all the customer detailed information in one place without the need to log into several systems.
• Smart and knowledgeable engagements with customers based on real-time information will contribute to bring back customers onto the right path and proactively help resolve the problems.

Customers Real Life Stories

• I am part of the renewal and upsell CS team, I need to understand what is going on with my customers’ opportunities, quickly respond to any opportunity change without logging into various applications. In order to do it, I am able to view the opportunity details in the account profile.
• My company values customer feedback, therefore I defined a collection which enables me to review any survey outcome. I expect the CSM to review the details of the survey in the account profile and reach out to the survey issuer within 48 hours.
  I am able to create a segment of accounts that filled up a survey and review the survey details.

Use Cases

• As a user, I am able to use collection-related filters in any account segment and find out the accounts I want to focus on.
  
  
  
• As a user, I am able to use collection segments to analyze the collection information (I am able to filter by collection information and analyze it in the segment table).
  
  
  
  
  
  
  
  
• As a user, I am able to view collection information in account profile.
  
  
  
• As a global admin, I am able to define a new collection in the information settings page.
  
  
  
• As a global admin, I am able to upload a collection data file ( it can be a one-time or a recurring upload).
  
  
• As an admin, I am able to define the collection consumption in account profile per account profile and per team.
  
  
  

How to configure and upload it?

Step 1 - Collection Definition

• Define the collection information. Go to the attribute and metrics page, and add a new collection.
  In this page, you can also review the existing collections.
  
  
• Click the button to add a new collection and insert the collection name, collection key attribute name, add other collection information.
  Note, a collection name cannot include a slash character (“/”).
  
  
  
  
• You can define the attribute display name, order, and whether to present it in the account profile widget.
  Note, If the attribute id contains a slash character (“/”), it will be converted to a dash character ("-") instead of a slash character.
  
• You can also remove a collection attribute by click the "X" icon near the collection attribute.
  Note, if you remove a collection attribute and this attribute is uploaded from your upload file and the upload job is defined to create new attributes, it will re-create the collection attribute.
  
• Decide if this collection can be edited via UI
• Once you are done with adding the collection information, save it.
  

  
  Important note, a collection must have a key. This key should be a unique per collection.
  

Step 2 - Collection Upload

Important note, before uploading, you need to prepare the collection upload file and make sure your file contains these mandatory keys: collection id and account id. Read more about the collection file structure here.

After the file is ready, follow these steps to upload the collection information to Totango and monitor it.

Step 3 - Expose it in Account Profile

The Collection information is now configured, uploaded and ready to use!

A team admin or a global admin is able to go to the account profile edit layout dialog and expose the Collection for his team or all teams per account type.

Note, the Collection widget is turned off by default.

 In addition, an admin can set up privileged access to the collection widget. Read more about it here.

Step 3a - Managing Collection via UI

If you checked the "Can be edited in Totango" option you can add new rows to the collection via UI.

Adding records to a collection

Note: If the ID field of a collection is left blank the system will automatically generate an ID for each row

Editing records in a collection

To edit an existing record in the collection

Step 4 - Collections in Segment

Collections are natively exposed in segments. All your collections will appear in the "New Segment" dialog.

Collection Deletion

A collection can be deleted manually or by defining a collection retention policy.

• An entire collection can be deleted manually from the collection definition page.
  
  Once a collection is deleted, it will delete the collection definition and all the collection data.
  A collection cannot be deleted if there is an Integration Hub Data Files recurring upload job defined for this collection.
  
  
  
  
  
  
• Whenever a new collection is created, you can define a retention policy for this collection in the data retention page. Read more about it in the data retention knowledge base article.
  
  
  
  Note, the default settings for a new collection is inherited from its parent -the "Accounts" entity.

Limitations

• Collection information cannot be used in user segments, campaigns or health designer.
• Collection upload does not support a slash character (“/”) in the file column headers.
• A collection name does not support a slash character (“/”) within the collection name.
• Deleting collection records from the UI is not supported and will be supported in the future

Other Resources

• Read about collection privileged access here.
• For information that is extracted directly from a 3rd party application (and not stored in Totango) use Virtual Collections. Read more about it here.

  For more information, reach out to your CSM.