Identifying your users is critical as part of your Chameleon installation. Without that, Chameleon Experiences will not display to users. To identify users you must send a unique ID for each logged-in user. You can learn more about this here.
You can check whether users are being identified by a few methods:
Check in your Chameleon Dashboard that a green banner is displayed indicating that data is being correctly received. This does not prove that users are being identified correctly but does indicate that the user identification method is being called.
You can also double-check this per domain from the 'Verify installation' tab of the Installation page:
You can click and open the Chameleon Chrome Extension and review whether an error shows, like the one below. This indicates that users are not correctly being identified on that page and that the installation needs to be fixed.
If there is no error showing, you can review the “Viewing as” section to indicate which user is being identified to Chameleon on the underlying page. If this is not the user you are logged into your application as, then this can indicate a problem.
Opening the browser console and running
chmln.data.profile will bring up data about the user that is currently logged in and being identified. If this returns an error message, then users aren’t being identified on the page.
Here are some of the most common reasons when user identification breaks or is not successful:
User data is sent to Chameleon when it is available on a web page/application. For some apps, this data is loaded after the page loads and is sent to Chameleon after a small delay. To get around this, you can get the engineers on your team to call the chmln.identify method, and send that data to Chameleon as soon as the page is loaded.
Data on a web page should be sent immediately after the page is loaded. This is most likely caused by an issue with how Chameleon has been installed. We recommend involving your engineers to make sure that Chameleon is being loaded as soon as the page loads, including when it is reloaded.
When installing Chameleon, we ask developers to identify users by their unique ID. For users who don’t have a logged-in identity (e.g. visitors), we recommend generating a unique ID and storing it in a cookie, which will then be read afterward.
Please note that identifying anonymous users to Chameleon will have an impact on your MAU count, as each anonymous user is counted as an additional user.
You should have a single unified user ID that can be used across different integrations and is common across all apps.
👉 Have any questions or issues? Review the best way to get help.