Skip to main content

Configuration

Please follow these steps to configure the module:

  1. On the Admin sidebar, go to Stores → Settings → Configuration.
  2. In the left panel, expand Takyon Commerce and choose Umami.
  3. Expand the General section.
  4. Set Enabled to Yes.
  5. If you use the cloud version of Umami, set Connection Type to Cloud. If you self-host Umami, set Connection Type to Self-hosted.
  6. Set Website ID to the ID of the website you want to set up analytics for. You can find it in the settings of your website in Umami admin panel.
  7. If you use a self-hosted version of Umami, set Base URL to the base URL of the domain/subdomain you use to self-host Umami. For example, if your Umami instance is located at https://umami.yourdomain.com, use that URL for Base URL field.
  8. When complete, click Save Config.
  9. Clean the cache.

Troubleshooting​

Tracking doesn't work​

Make sure that Enabled is set to Yes and values for Website ID and Base URL (if you self-host Umami) are correct. Please clean the cache afterward.

If it didn't help, please open the console on your Magento storefront homepage and check it for errors.

I get Bad Request error in the console​

If you get an error in the console similar to "POST https://api-gateway.umami.dev/api/send 400 (Bad Request)", that means you have specified the wrong website ID, or you have a typo in Website ID field.

I get a CSP error in the console​

If you get an error in the console similar to "Loading the script 'https://umami.yourdomain.com/script.js' violates the following Content Security Policy directive: script-src ...", please follow this guide to update script-src and connect-src CSP policies for your domain/subdomain.