Before you start

Create a UserTrail site for your Adobe Commerce storefront and copy the tracking snippet.

You may need developer access, theme access, or tag manager access depending on how your Adobe Commerce store is managed.

Install with a tag manager

Many Adobe Commerce stores use a tag manager for analytics scripts.

General steps:

1. Create a Custom HTML tag in your tag manager.
2. Paste the UserTrail snippet.
3. Choose the storefront pages where it should fire.
4. Respect analytics consent rules.
5. Publish the tag manager container.
6. Test the live storefront.

Install in the theme

If your team manages theme templates directly, add the snippet to the shared page header before the closing </head> tag.

Deploy through your normal Adobe Commerce release process and clear caches after deployment.

Ecommerce privacy notes

Be careful with account, cart, checkout, and payment flows.

Recommended setup:

• mask personal information
• do not record payment fields
• test checkout recordings before going live
• use consent mode where required
• exclude pages that cannot be safely masked

Verify recording

Test a storefront journey:

1. Open a category page.
2. Open a product page.
3. Add a product to cart.
4. View cart.
5. Check UserTrail Sessions and Heatmaps.

If checkout is tracked, confirm private fields are masked before collecting real traffic.

Troubleshooting

If tracking does not work:

• clear Adobe Commerce cache
• clear CDN or full-page cache
• confirm the snippet is present in rendered HTML
• check Content Security Policy settings
• confirm consent rules allow the script
• check the site id in the snippet