Overview

Tags are used in Totango to automatically highlight important insights about accounts and users.  Totango allows you to add and remove tags via the UI for a single or multiple accounts/users.
In addition, you can use Integration Hub Data Files to add/remove tags.

The method is to use Integration Hub Data Files to upload a CSV file containing the desired tags.

Pre-requirements

The following must be fulfilled in order to manage tags using CSV:

• The tag must be already defined in Totango, a new tag will not be created.
  • To define an account tag, the tag must be added to at least one account 
  • To define a user tag, the tag must be added to at least one user
• Tag name should be unique among tags and attributes (you cannot have attribute and tag with the same name)
• Tag upload should not create new accounts or users. Make sure these accounts and users are already existing in Totango.

Prepare your CSV file

Your CSV file should include each tag name as a separate column.
The tag value can be "yes", "true", "no", "false".

What does the tag value mean?

• Use "yes" or "true" (lowercase) as a tag value to add this tag
• Use "no" or "false" (lowercase) as a tag value to remove this tag
• Use empty as a tag value to not change the existing tag.

In the following example, tag 2 will be added to account_1, tag 3 will be removed (if exists) and tag 1 will not be changed:

How to upload the file?

1. Open the integration hub -> Data files page in Totango.
2. Click on "+ Upload Data" button
3. Select the "Accounts Data" or "Users Data" based on your use case.
4. Select the file and add a description.
   Make sure that the option to "Allow new attribute creation" is turned off.
   
   
   
   
5. Complete the import, without changing the mapping. Totango will map the CSV fields to the tags.
6. Please note that if the tags do not exist, the import will fail.

Known Limitation

• The tag must be already defined in Totango, a new tag will not be created.
• The account and user must be already defined in Totango, a new account and user will not be created.

For more information, contact your CSM