For holistic user education, you should consider both "push" and "pull" help. Chameleon enables you to do both, and in this article, we'll go over the various ways you cal deliver "pull" guidance with Walkthrough Tours.

When you build a Walkthrough Tour, you can share it directly with your users so they can start at their convenience via:

💡 You can also configure Experience buttons in the Builder, to trigger a Chameleon Tour or Microsurvey. Read this article to learn how to deliver Tours from other Experience buttons.


Tour Sharing in Chameleon

Once you choose to build a Walkthrough Tour, you will find the Tour sharing options in the last configuration panel from your Dashboard.

Tour Shairng options from the Chameleon Dashboard

Here you can add the domain URL where your Tour is created to share it with your users, use our API to trigger the Tour, or add it to a Chameleon Launcher.


Tour Links

Chameleon provides a unique link for each Walkthrough Tour you create, which can be used to start it remotely.

These links can be put to good use by including them in help articles, live chats, blog posts, and email announcements. They are a great way to provide interactive guidance for users and bring them to your app from external sources.

🎯 To successfully share your Tour via an URL, make sure that:

  • Your Tours are live -- the most recent published version of the Tour will load with the link.

  • Chameleon is properly installed on all pages where the Tour shows. Learn more here.

This link will redirect the user to the URL defined above, regardless of Tour's first Step URL. The Tour will show for any user that accesses the link, irrespective of whether the user is part of the target audience or has seen the Tour before.

URL Rules, Element Rules, and Target Audiences

Most commonly, Tour links are used when you expect a Tour to display when clicked. For example, Tour links are used as an item in a Launcher or as a CTA of hyperlinked text in an email.

That is why any rules set for the first step of the Tour are ignored, and the Tour will display regardless.


Note: If no protocol setting is included Chameleon will prefix http:// onto the indicated Tour start URL. If your web app requires https, make sure to include it, or make sure your app redirects http URLs to https.


Dynamic URLs

If the first step of your Tour is matched to a dynamic URL, then you must first specify the exact URL to load with this Tour link.

Chameleon doesn't support wildcards in Manual Tour redirect URLs because we can not use them to point the user to a specific URL. Still, to be sure the right audience sees your Experiences, you can send to Chameleon the domain in the user data. Then you can insert this into your URL. 😉

💡 If this still doesn't work for you, you can could use either of these options:

  1. Use a click-triggered automatic Tour either through an icon click (a Chameleon icon, so it doesn't require engineering time) or by hard-coding a button and using element-click.

  2. Create a Launcher that contains several helpful links, one of which launches this Tour. You can configure the Launcher to appear either by clicking a widget (added by Chameleon) or clicking an element that is hard-coded.

You can also use variables/merge tags to personalize your Tour start URL, in case you're looking to send this Tour Link to many users, each with their unique URL.

👉 Learn more about handling URLs in Chameleon.


Warning ⚠️

If you're using variables within the URL to be loaded, then Chameleon needs to be able to read the relevant user data, which cannot happen when cookies are disabled.

Some browsers (e.g. Safari) disable cookies by default (the setting for "Website Tracking: Prevent cross-site tracking" is checked) so in these instances, the Tour link will not be able to load the appropriate URL and start the Tour. 


API Sharing

You can also use our API to trigger a Tour for your users by adding the unique Tour ID in API calls. This way, you can include your Experience anywhere in your application and use triggers from there.

Check out how you can show a Tour via JS API here.

💡 If you're using this method, any step Triggers that you have set (click/hover/delay) will be ignored by default, for your Tour to show. But you can also change this option anytime.


Launchers

Another way to deliver "Pull" help is by using Launchers. They provide an off-the-shelf customizable widget to display a menu of Tours (and more) that users can self-start at their convenience.

With each Walkthrough Tour you create, you can also include it in an existing Launcher or create a new one and add it as a Launcher item. Read this article to learn how to add items to your Launcher.


Note: The number of Launchers available to customers will vary by plan. Find the differences between the different plans by visiting our Plans page.


Know more

Did this answer your question?