For the complete documentation index, see llms.txt. This page is also available as Markdown.

Littledata Pixel

Add the Littledata Pixel as a Shopify custom pixel to improve tracking on headless storefronts and send redundant events to Meta, TikTok and Pinterest.

The Littledata Pixel is a custom web pixel you add from your Shopify admin. It works alongside Littledata's server-side tracking to fill gaps and make tracking more reliable, on your Shopify store and on headless storefronts. This page shows you how to add it, which events it sends, and how to check it's working.

The Littledata Pixel is not your Meta pixel. You only need one per store, whichever Meta pixels or ad accounts you use. To send data to a different Meta pixel, change the Pixel ID in your Meta destination.

Key benefits

  • Shopify Hydrogen and headless support: consistent tracking across a headless storefront.

  • Redundant tracking: both client-side and server-side events for key destinations.

  • Custom landing page support: track customers across non-Shopify pages.

  • Accelerated checkout support: track conversions across Shop Pay and other accelerated checkouts.

How to add the Littledata Pixel

1

Start the setup in the Littledata app

In the Littledata app, find the Littledata Pixel under Sources. Click Continue to start the setup.

Littledata Pixel with Pending setup status and a Continue button in the Littledata app
2

Open Customer events in Shopify

In your Shopify admin, go to Settings > Customer events.

3

Add a custom pixel

Click Add custom pixel. Name it exactly Littledata - Advanced Tracking, then click Add pixel.

The name must match so Littledata can detect the pixel on your store.

Add custom pixel dialog in Shopify with the pixel name Littledata - Advanced Tracking
4

Set the customer privacy settings

Under Permission, select Not required. Under Data sale, select Data collected does not qualify as sale. This lets the Littledata Pixel load. Littledata handles consent through Shopify's Customer Privacy API.

Customer privacy settings with Not required and Data collected does not qualify as sale selected

On a headless setup, if your cookie banner isn't automatically connected to the Customer Privacy API, check your cookie banner's documentation to connect it manually. If you use a custom storefront instead of Hydrogen, you also need to include the Customer Privacy API asset.

5

Paste the pixel code

Go back to the Littledata app and copy the custom pixel code. Paste it into the Code box of your new pixel in Shopify.

6

Save and connect

Click Save, then click Connect.

Shopify custom pixel page with Save and Connect buttons

When setup is complete, you go back to the Littledata app. The Littledata Pixel shows Connected once the pixel is detected on your store.

Redundant tracking

Added on top of Littledata's server-side tracking, the Littledata Pixel gives you fully redundant tracking in destinations that accept both client-side and server-side events:

This follows Meta's best practice for a redundant setup.

The Littledata Pixel does not send events to Google Analytics 4 or Google Ads. Those destinations get browsing events from Littledata's app embed and purchases from Littledata's servers.

Events the pixel collects

The pixel improves tracking of cart, checkout and purchase events for Meta Conversions API, TikTok and Pinterest.

Destinations
Web pixel event
Meta event
Description

Meta, TikTok, Pinterest

product_added_to_cart

AddToCart

An item is added to the cart

Meta, TikTok

checkout_started

InitiateCheckout*

A checkout starts

Meta, TikTok

payment_info_submitted

AddPaymentInfo*

The customer submits payment info

Meta, TikTok, Pinterest

checkout_completed

Purchase*

The checkout is completed (thank you page)

*An extra PageView is sent with this event.

Troubleshooting

Littledata Pixel status

Littledata checks regularly that both the tracking script (through the app embed) and the custom pixel are detected on your store. In the Littledata app, the Littledata Pixel shows one of these statuses:

Status
What it means
What to do

Connected

The pixel is detected on your store.

Nothing.

Not detected

Littledata's check could not find the pixel.

Click Fix now and follow the setup again.

Check that the pixel loads

1

Open the pixel test

In your Shopify admin, go to Settings > Customer events and open the Littledata - Advanced Tracking pixel. Click Test to open your store with the pixel helper.

Littledata - Advanced tracking pixel page in Shopify with the Test button highlighted
2

Check the events

Visit each page you want to test. In the Pixel helper dialog, check that the pixel shows as loaded and that the events you expect appear under Events received.

Shopify Pixel helper showing Littledata - Advanced tracking loaded with product_added_to_cart events

Reconnect the pixel

If the pixel isn't firing, someone on your team may have disconnected it.

1

Find the pixel

In your Shopify admin, go to Settings > Customer events and find Littledata - Advanced Tracking.

2

Connect it

Click the three dots (...) on the right, then click Connect.

Shopify Customer events list with the Connect option for a disconnected Littledata - Advanced tracking pixel

Last updated

Was this helpful?