Skip to main content

Google Tag Manager

SonoTrix add-on for CS-Cart that injects your Google Tag Manager web container and can optionally push GA4-compatible ecommerce dataLayer events from the storefront.

This is not a Google Analytics 4 or Google Ads add-on. Configure GA4, Ads, and other tags inside GTM.

Avoid double-firing pixels

If GTM already loads Meta, Snapchat, TikTok, X, or Pinterest tags, do not also enable the matching SonoTrix pixel add-ons for the same IDs — events may fire twice.

What you need from Google​

  1. A Google account
  2. A Tag Manager account
  3. A Web container and its ID in the form GTM-XXXXXXX

Install the add-on​

  1. Download the Google Tag Manager package.
  2. Go to Add-ons → Manage add-ons.
  3. Upload, install, and enable the add-on.

See also: How to Install CS-Cart Add-ons.

Part A — Google Tag Manager setup​

Step 1: Create a Tag Manager account and web container​

  1. Open https://tagmanager.google.com.
  2. Sign in with your Google Account.
  3. Click Create Account.
  4. Enter an Account name and country.
  5. Under Container Setup:
    • Enter a container name (usually your site domain, e.g. www.example.com).
    • Choose container type Web.
  6. Click Create and accept the Terms of Service.

Official guide: Create an account and container.

Step 2: Copy the GTM Container ID​

  1. After creation (or from the Accounts list), open your web container.
  2. Copy the container ID shown in the format GTM-XXXXXXX (top of the workspace).
  3. You will paste this into the add-on. Do not paste the full GTM install snippet — only the container ID.
  1. In GTM, add the tags you need (GA4 Configuration, Google Ads, remarketing, etc.).
  2. Publish a workspace version.
  3. Use GTM Preview / Tag Assistant to validate before relying on production traffic.

The SonoTrix add-on only loads the container. Tag logic stays in your GTM account.

Part B — Configure the CS-Cart add-on​

Go to Add-ons → Manage add-ons → Google Tag Manager → Settings.

Container​

  1. Paste GTM Container ID (GTM-XXXXXXX).
  2. Read the Security notice in settings: do not paste custom JavaScript into the add-on.
  3. Save.

dataLayer Ecommerce (optional)​

All ecommerce dataLayer pushes are off by default.

  1. Enable Enable ecommerce dataLayer pushes if you want CS-Cart to push events for GTM/GA4 tags.
  2. Enable individual events as needed:
    • view_item
    • add_to_cart
    • begin_checkout
    • purchase
    • search
    • sign_up

Storefronts Containers​

Per storefront:

  • Disabled
  • Default (main container ID)
  • Custom (different GTM-XXXXXXX per storefront)

Verify​

  1. Open the storefront with Tag Assistant or GTM Preview.
  2. Confirm the container loads and your published tags fire.
  3. If using dataLayer ecommerce, trigger product view / add to cart / purchase and confirm the events in Preview.

Official Google help​