You can change the settings within the Littledata app by selecting an already finished connection and navigating through the tabs that each connection has available. There you will find connection-specific settings, the global settings will be located in the top right part of the page, under the Settings cog and Data Pipeline.
Found in the General tab under each finished connection. Here you will find the keys that Littledata needs to send event data to the specific destination.
Measurement ID
Your data stream's Measurement ID used to send event data.
API Secret
Measurement Protocol API secret is used for your data stream to establish a secure connection between the Shopify and Littledata servers.
Google Ads conversion IDs
Add the Google Ads (AdWords) conversion IDs that you configured with Ads. This accepts an array of strings. Our script will automatically add this to gtag('config')
command.
Example: googleAdsConversionIds
: ["AW-11111111", "AW-22222222"]
(array)
Segment write key
Segment write key of the source receiving data.
Pixel ID
Facebook Pixel ID of the source receiving data.
Access Token
The access token required to send data to the Facebook pixel.
Ad Account ID
Pinterest Ad Account ID of the source receiving data.
Tag ID
Pinterest Tag ID of the source receiving data.
Conversion Access Token
Pinterest Conversion Access Token of the source receiving data.
Pixel Code
TikTok Pixel Code of the source receiving data.
Access Token
TikTok Access Token of the source receiving data.
Found in the Data Customisation tab under each finished connection.
Order identifier
There are 3 ways to track your orders:
Default: Order Name
Product identifier
There are 3 ways to track your products:
Default: Product ID
Client-side purchase (Google Analytics only)
We are using a combination of client-side and server-side tracking for the Google Analytics 4 conversions. By using this combination you have access to geolocation and device data in your reports. Check the dedicated help article to learn more.
Default: OFF
Disable recurring orders
By default we track recurring orders as a separate event. If you want to disable this, set this field to ON.
Default: OFF
Track pageviews only when page reloads
For some themes, where the URL changes (e.g. a new variant) without a new page load our script will track a new page view. Change doNotTrackReplaceState
to ON to disable a new page view on history.replaceState()
via browser History API
Default: OFF
Use page type for list name
Littledata's tracking script uses the document.location.pathname
as the list name for list events. Setting usePageTypeForListName
to ON overrides this to use Shopify's page_type as the list name, which has fewer values and may be more helpful in reporting.
Default: OFF
Exclude orders by order channel
You can choose to exclude orders based on the order channel. Choose one from the already known channels, or add a custom one. See how to exclude orders by order channel.
Found under the Settings cog and Data Pipeline.
Debug
Debug mode adds extra console logs to track how the script is performing.
Default: OFF
Respect user tracking consent
Our tracking script can automatically integrate with Shopify's Customer Privacy API. When respectUserTrackingConsent
is true
, the script will wait for customer's to opt in to performance cookies before initialising the third-party tracking scripts or sending any pageviews and events.
Default: ON
Product clicks
By default our tracking code briefly interrupts a click on a product in a product list, in order to send the tracking event before the page reloads. If this is interfering with other apps or scripts you can switch productClicks
to OFF to disable tracking.
Default: ON
Product page clicks
By default we track clicks on product images and social share buttons on the product details page. If this doesn't work with your theme you can opt out by setting productPageClicks
to OFF.
Default: ON
Hide branding
Our app generates a branded message in the site console log. You can disable this by switching hideBranding
to ON.
Default: OFF
Product lists on any page
By default we only track product lists on collection and search pages. You can product list views and clicks on any page (e.g. 'recently viewed' list on the product details page) by setting productListsOnAnyPage
to ON.
Default: OFF
Product list links have images
We assume that a product list will consist of a list of links to product images OR a list of links with images in a sibling HTML element (i.e. both the <a>
and <img>
tag share the same parent element). If you need to track only links where the <img>
tag is a child of the <a>
tag set productListLinksHaveImages
to ON.
Default: OFF
Product list links have prices
You can restrict the tracking of product list views and clicks to just those where the product price is also included in a link (although not necessarily the same anchor tag as the product image) by setting productListLinksHavePrices
to ON.
Default: OFF
Found in the Tracking Customisation tab under the Google Analytics 4 connection.
Extra linker domains (Universal Analytics)
To enable cross-domain tracking on pages that your Shopify store links to (destination domains) you can add an extra array of domains to the data layer. You do not need to add domains here which only send traffic to your Shopify store (source domains) - by default this script will look for the linker URL parameters.
You will also need to enable the Google Analytics linker on those source or destination domains.
Example: extraLinkerDomains: ["mylandingpage.com"]
(array)
Google Signals (Universal Analytics)
This field opts your site into using Google Signals, to enable more powerful demographic reports and cross-device tracking using the Google Ads cookie. You need to check this is compatible with your website terms of use, or opt out by setting googleSignals
to OFF.
Default: ON
Cookie update (Universal Analytics)
This cookieUpdate
field passes on the cookie_update field to gtag. A common use is when the _ga cookie was overwritten as server-side cookie to preserve it.
Default: ON
Found in the Tracking Customisation tab under the Segment connection.
Anonymize IP
This field instructs the Segment library to mask the last 3 numbers of the user's IP address, to support greater user privacy at the expense of some geo-location accuracy.
Default: OFF
Cookies to track
Grab the values from an array of named cookies and pass them as traits on Segment identify calls.
Example: cookiesToTrack: ["iterableEmailCampaignId", "iterableTemplateId"]
(array)
CDN for Analytics JS
If you have a proxy CDN setup, redirecting to https://cdn.segment.com
, to load Segment's AnalyticsJS library from your own domain you can specify it here. It must include the full domain, with no trailing slash.
Default: CDNForAnalyticsJS: "https://cdn.segment.com"
(string)
Segment user ID
You can choose an identifier to use for logged-in users. WARNING: this must match what is configured for server-side events in Littledata's app settings.
Possible values: none
, shopifyCustomerId
, email
, md5EmailHash
, customerMetafield
Default: shopifyCustomerId