How do User Tags work?

“Tags” represent a special attribute for users, because it can contain multiple unique values.

Tags values are converted into lowercase, and any character non alpha-numeric is removed.

MY Tag &#= IS Nice” will be saved as “mytagisnice”.

 

Adding tags to users

You can only send Tags along with “login” and “update” events to add all those values to user tags. Passing tags along with other events are ignored.

If a tag is sent multiple times, it will only appear once in users’ tags. To send more than one tag, pass a list of tags, otherwise send it as a simple string/text.

[“tag1”, “tag2”, “tag3”, “tag4”] is equivalent with sending “tag1;tag2;tag3;tag4”

Here is an example of update event:

_vteq.push({"update":{"name": "alex", "tags": ["tag_one", "tag_two"]}})

will update the user tags with: tag_one and tag_two.

To use tags in segmentation:

  • use condition User tags contains tag_one for at least a single tag matching that text
  • use condition User tags equals tag_one for at least a single tag that exactly matches the text
  • use condition User tags contains tag_one|tag_two|tag_three to check if a user has one (any) of the tags
  • use condition User tags equals tag_one;tag_two to return users with both tags
  • use condition User tags not equals tag_one;tag_two to return users that do not include any of the tags;

Removing tags from users

If you want to remove tags from users, just add – (minus) in front of the tag value.

_vteq.push({"update":{"tags": ["-tag_one"]}})

Related Articles