Skip to content

Enable tracking

Two things need to be in place before Máximo captures storefront and checkout events: the conversion pixel (usually automatic) and the theme app embed (a one-time step you do in the theme customizer). You can check the status of both from Settings → Storefront events.

What registers automatically

Section titled “What registers automatically”

Máximo registers a single Shopify web pixel, the conversion pixel: under Customer Events. This happens on its own after you authorize the app, and again whenever you save your Google Ads, Meta, TikTok, or Pinterest settings, so the pixel always reflects your latest destination configuration.

On Settings → Storefront events, the Conversion pixel card shows Registered once this has happened. If it still shows Setting up, or you want to force a refresh, use the Register pixel (or Re-register pixel) button on that page.

What you need to add manually

Section titled “What you need to add manually”

The pixel captures the event data, but the Máximo Pixels theme app embed is what loads the vendor SDKs (Google, Meta, TikTok, Pinterest) and keeps first-party cookies and click IDs available during checkout. Add it once:

  1. Go to Online Store → Themes → Customize in Shopify admin (or click Activate in theme on Settings → Storefront events, which opens the customizer directly).
  2. Under Theme settings → App embeds, turn on Máximo Pixels.
  3. Save the theme.

The Storefront tracking embed card on Settings → Storefront events shows Active once Máximo detects the embed on your published theme, or Not detected if it isn’t turned on yet.

Confirming each destination is armed

Section titled “Confirming each destination is armed”

Once both cards show Active / Registered, storefront events are flowing. To confirm a specific destination (Meta, TikTok, Pinterest, Google) is actually receiving them:

  • Check Pixel presence to see whether that destination’s tracking is being detected on your storefront.
  • Check the Delivery monitor for delivery failures once events start flowing server-side.
  • Confirm the destination itself is configured (pixel ID, catalog connection) on its own settings page, the pixel only fires beacons for destinations you’ve set up.

Recovering from “Disconnected” in Customer Events

Section titled “Recovering from “Disconnected” in Customer Events”

If Shopify’s Settings → Customer events page shows Máximo’s pixel as Disconnected, it usually means the pixel’s settings are stale or the registration didn’t complete. To recover:

  1. Re-save your destination settings (Google Ads, Meta, TikTok, or Pinterest), saving triggers Máximo to re-register the pixel with fresh settings.
  2. Or use Re-register pixel on Settings → Storefront events directly.
  3. If you granted the app additional permissions (for example, re-approving scopes) after your first install, reinstall the app. A permission granted after the initial install doesn’t retroactively apply until the app is reinstalled or reauthorized.
Section titled “Related”