Zingtree Tags: tagging

How To Use One Tree for End-Users and Employees/Agents

updates-blog

We’ve had requests to make it easy to use one tree for both end-user support and internal agent usage. Rather than maintaining two separate trees, being able to have one source of content and show (or hide) parts between agents and end-users can be extremely helpful. So, we’ve introduced two new template tags that allow this to happen.

Demo

The Dual Use Agent and End-User Example Tree from the Zingtree Gallery shows how this type of tree is built and operated. You can switch between End-User and Agent views by opening the Show More Display Options link.

Creating Agent-Only or End-User Only Buttons

The first node in the demo has a button labelled “Other Options for Agents only”.  This button only appears when agents are viewing the tree, but not for end-users.  Here’s how this magic is done:

  • If you prefix the button label with AGENT_ , only agents will see that button.
  • Prefix a button with USER_ to show it to just end-users.

Creating Nodes with Dual Content

In the content area for any node, you can insert special tags that make the text visible to just agents, or just end-users.

To show content for agents only:

Surround the content with [[AGENT-ONLY]] and [[/AGENT-ONLY]].

To show content for end-users only:

Surround the content with [[USER-ONLY]] and [[/USER-ONLY]].

You can access these template tags from the content editor in any node:


Example

If your node content area looks like this…

This is the content for a node.

[[AGENT-ONLY]]Agent stuff shows here[[/AGENT-ONLY]]

[[USER-ONLY]]User content shows here[[/USER-ONLY]]

An end user will see this…

This is the content for a node.

User content shows here

And your agents will see this…

This is the content for a node.

Agent stuff shows here

How to Preview

The updated Preview tool lets you see content views for agents or end-users:

Implementation

Your agent-only content will appear in trees accessed via the Zingtree Agent Portal. You can also make this content appear by adding the following parameters to the URL for Zingtree hosted or embedded trees:

&agent_mode=1&apikey=YOUR_API_KEY

Substitute your API key for YOUR_API_KEY in the URL. You can find the API Key from the API page, or if you have multiple organizations at the bottom of the Organizations and Billing page.


Do you like this new feature? Or have any other comments? Please share with us!

Managing a “Forest” of Decision Trees Using Tagging

As Zingtree is getting more and more larger companies as clients, we’ve received a lot of requests for being able to better manage a large library of trees. Some customers are planning on creating hundreds or even thousands of trees.  Our latest update makes it even easier to locate and organize large decision tree “forests.”

First Step: Tag Your Trees!

If you haven’t done so already, you should tag your trees. A tag is like a category – any tree can have multiple tags. This is the first step to being better organized.

To tag a tree:

  1. Start at My Trees, and select a tree.
  2. Go to the Settings tool.
  3. Enter a tag, or pick from a list of existing tags:
  4. Click Update Settings to save.

Locating Trees by Tag

Once you’ve tagged your trees, Zingtree has a few different ways to make it easy to stay organized:

  • For Authors: Filter your list of trees by tag in the My Trees tool.
  • For Authors: Use Tree Search to enter a list of tags to find trees that have any or all of the desired tags.
  • For Agents or End-Users: Authors can use new Macros to present a list of trees to an end-user that contain any or all tags in a list.

Authors: Filter by Tag in the My Trees Tool

When you use the My Trees tool, you’ll see an option at the top right for Has Tag. This contains a list of all the decision tree tags in use for your organization:

Select a tag, and you’ll see all the trees that have that tag.

Authors: Use Tree Search

For more powerful searching using tags, use the Search button in My TreesYou have four different search options. These two apply to tag matching:

  • Match Tree Tags (any): Enter a comma separated list of tags. The results return a list of trees that include any of the tags in the list.
  • Match Tree Tags (all):  Enter a comma separated list of tags. The results return a list of trees that include all of the tags in the list.

Using Macros to Present Lists of Trees by Tag

Inside the content area of any tree, you can insert a special macro to show all the trees in your organization that match any or all tags in a list. You can examine the Tree Tag Demo in the Zingtree Gallery to see how this is done.

The two macros you can insert into the content area are:

  • ##treetaglist-any: tags##
  • ##treetaglist-all: tags##

In the examples above, replace tags with a comma separated list of tags. treetaglist-any will return a list of trees that match any of the tags in the list.  treetaglist-all returns only those trees that contain all the tags in the list.

Examples:

#treetaglist-any: demo,gallery## – matches trees that are tagged with either demo or gallery.

#treetaglist-all: demo,gallery## – matches trees that are tagged with both demo and gallery.

Shortcut: When editing a node, you can insert these macros from the Templates editing tool in the Content editor:

Bonus: Dynamic Lists

When publishing a tree, if you add a tags= parameter to the tree URL, you can dynamically import the list of tags used by the tree macros.  Be sure to separate the tags with | characters. Example:

http://zingtree.com/host.php?style=panels&tree_id=287688184&tags=demo|gallery

Inside the tree, this macro will list trees that have tags that match ALL the tags in the passed-in tags= parameter:

##treetaglist-all:##

This macro will list  trees that have tags that match ANY tags in the passed-in tags= parameter:

##treetaglist-any:##

Node #6 from the Tree Tag Demo in the Zingtree Gallery shows how this is done. Try it!

Integrations: Dynamic Tree Lists by Passing Tags

Our customers Corey and John asked for a way to send a list of tags from their Help Desk system, and open a specific tree or show a list of matching trees. Here’s how to do it.

  1. Go to My Trees, and click Search.
  2. Use one of the tree tag searches.
  3. In the search results, click the Integration Link Template button at the bottom of the page.  This will show you a URL to use as the basis for linking from your Help Desk/CRM system to the Zingtree search.  You can add style parameters to this link from the Advanced Hosting Options page as well to ensure your trees appear with the desired look and feel.

Example:

This link is derived from a search in the Zingtree Gallery. The search, style and transition parameters are changed from the template example to customize the result.

http://zingtree.com/host-trees.php?jump=1&key=6a103737e44e4aa6e1e4b6b0bcb46f83&type=treetag-all&search=demo,gallery&style=panels&transition=fade

Credits

Thanks to Corey, John, Elise, Trey and a few others for sharing their tree management needs.  If you have a suggestion, comment, or question, please reach out and talk to us!

Agent Portal: How to Show or Hide Trees from Agents

blog-howto

When using the Zingtree Agent Portal, some customers asked if there was a way to make specific scripts visible to certain agents, or hide scripts from other agents. With this latest update, you can now assign agents to groups, and have trees visible to only those groups. This is done using tagging. Here’s how it works:

When editing your Agent Lists from Account > My Agents, assign tags to each individual agent. Each tag corresponds to a group that the agent belongs to.

Next, assign tags to your trees, using the Settings tool. These tags are also used to group trees.

And that’s it!

If an Agent has tags assigned to them, they will only be able to see trees with those same tags. For example, if Agent Bill is assigned a tag of “sales,” he will only be able to see trees also tagged as “sales.”

Notes:

  • Any agents with no tags will be able to see all trees.
  • You can assign multiple tags to agents or trees.

Update: Tagging Agents, Trees and Nodes

NL-header-updates3

For this latest update, we’ve focused on improving the ability to tag various Zingtree objects. You can tag Nodes, Trees, and Agents to really help categorize and organize your work.

When adding tags, you can now pick from a list of existing tags, or easily delete tags with a single click.  This makes it easy to ensure consistency in your tagging (thanks to Bryan M for the inspiration).

Here’s a screen snippet from the Tree Settings tool showing how this new tagging interface works.

 

Tagging in Tree Settings

Some other goodies in this release:

  • Update: Restricts tree view in Agent Portal for tagged agents matching tree tags (h/t Adam C).
  • Update: Scoring Nodes now can be set with placeholders for values but no destination node picked (h/t Arie).
  • Update: Scoring nodes can now be set as the root node for A/B tests (h/t Ben C).
  • Bug Fix: Tree tag filtering in Agent Portal now works properly.
  • Bug Fix: Edge of scoring ranges now works properly (h/t Martin S).
  • Update: Added number of agent feedback comments for each tree to My Trees page (h/t Martin S).

Once again, thanks to our intrepid, fanatical Zingtree users for most of these suggestions.

Do you have any great ideas to make Zingtree even better? Please share!

New This Week: Tagging Nodes and Trees

Updates2

 

As our customers are getting deeper and deeper into building Zingtrees, it’s become clear that we needed to include a way to help organize nodes in large trees, as well as organize large libraries of  trees. So we’ve introduced a new feature called “tagging“, which in essence lets you add a list of category tags to both nodes and trees.

At the node level, you can add one or more tags to each node, and then use the Overview tool to show only those nodes that include a certain tag.  This makes it easy to find specific types of nodes.

At the tree level, in Settings, you can add one or more tags to each tree. The My Trees page lets you filter your list of trees based upon those tags. If you’re a call center, agents can also use the tag filter to locate specific trees in the Zingtree Agent Portal.

Are you using tags in a novel way? Let us know via our Feedback form!