> For the complete documentation index, see [llms.txt](https://help.littledata.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.littledata.io/advanced/developer/data-pipeline-settings.md).

# Changing the data pipeline settings

Every setting that controls how Littledata sends your Shopify data, where to find it, and what it defaults to.

Littledata's settings live in two places, and which one you need depends on whether the change applies to a single destination or to your whole store.

| Where                    | Scope                                                         | How to get there                                              |
| ------------------------ | ------------------------------------------------------------- | ------------------------------------------------------------- |
| **Destination settings** | One destination at a time — GA4, Meta, Segment, Klaviyo, etc. | Littledata dashboard → the destination's widget               |
| **Global settings**      | Your whole store, across every destination                    | Shopify Admin → Littledata → the left-side navigation sidebar |

Destination settings are split across tabs. Every destination has a **General** and a **Data customization** tab; Google Analytics 4 and Segment each add one more.

| Tab                        | What it controls                            | Available on       |
| -------------------------- | ------------------------------------------- | ------------------ |
| **General**                | Connection credentials and consent mode     | All destinations   |
| **Data customization**     | How orders, products and pageviews are sent | All destinations   |
| **Session enrichment**     | Attribution rules for orders                | Google Analytics 4 |
| **Tracking customization** | Segment-specific library behaviour          | Segment            |

## Destination settings

### General settings

This tab holds the credentials Littledata needs to reach the destination, plus the consent mode toggle.

| Destination            | Field                   | What it is                                                                                                   |
| ---------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Google Analytics 4** | Measurement ID          | Your data stream's Measurement ID, used to send event data                                                   |
|                        | API secret              | The Measurement Protocol API secret, which secures the connection between the Shopify and Littledata servers |
| **Google Ads**         | Google Ads account      | The Google Ads account connected to your Shopify store                                                       |
| **Segment**            | Segment write key       | The write key of the Segment source receiving data                                                           |
| **Meta**               | Pixel ID                | The Meta Pixel ID receiving data                                                                             |
|                        | Access token            | The token required to send data to the Meta Pixel                                                            |
| **Pinterest**          | Ad account ID           | The Pinterest ad account receiving data                                                                      |
|                        | Tag ID                  | The Pinterest tag receiving data                                                                             |
|                        | Conversion access token | The token required to send conversions to Pinterest                                                          |
| **TikTok**             | Pixel code              | The TikTok pixel code receiving data                                                                         |
|                        | Access token            | The token required to send data to TikTok                                                                    |
| **Klaviyo**            | Klaviyo account         | The Klaviyo account connected to your Shopify store                                                          |
| **Attentive**          | Attentive account       | The Attentive account connected to your Shopify store                                                        |

<figure><img src="https://3956158252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QhTbrMraNWciQeDvu1b%2Fuploads%2Fgit-blob-ed39bf10644a91dff6d45fa81d67e33fc037f2e8%2Fconnect%20GA4%20with%20LD.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Consent mode

Turning **Consent mode** on makes that destination responsive to user consent, so you can manage data flow based on each user's consent choices.

It is available on every destination except Klaviyo and Attentive, and is set per destination — enabling it for GA4 does not enable it for Meta.

{% hint style="warning" %}
Consent mode is **off by default** on new connections. While it is off, the destination tracks every user as if consent had been granted, regardless of what your cookie banner says.
{% endhint %}

If [Shopify Markets](/sources/shopify-markets/markets-settings.md) is enabled, this setting is held per market, so you need to set it for every market.

### Data customization settings

This tab controls how orders and products are identified, which orders are excluded, and how pageviews and product lists are tracked.

| Setting                                    | What it does                                                                                                                                                                               | Applies to                                                     | Default       |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------- | ------------- |
| **Order identifier**                       | Which Shopify field identifies an order — see [below](#order-identifier)                                                                                                                   | Google Analytics, Google Ads, Segment                          | `Order Name`  |
| **Product identifier**                     | Which Shopify field identifies a product — see [below](#product-identifier)                                                                                                                | Google Analytics, Google Ads, Segment, Meta, Pinterest, TikTok | `Product ID`  |
| **Send user data to Google Analytics**     | Sends the hashed first-party `user_data` object to GA4                                                                                                                                     | Google Analytics                                               | `OFF`         |
| **Order channels exclusion list**          | Excludes orders from named channels — pick a known channel or add a custom one. See [how to exclude orders by order channel](/advanced/troubleshooting/how-to-exclude-orders-by-source.md) | All except Klaviyo, Attentive, Google Ads                      | None excluded |
| **Order tags exclusion list**              | Excludes orders carrying any of these tags, e.g. `sample order`. Tags are case-insensitive                                                                                                 | All destinations                                               | None excluded |
| **Exclude zero value orders**              | Stops zero-value orders being tracked                                                                                                                                                      | All destinations                                               | `OFF`         |
| **Disable recurring orders**               | Stops recurring orders being tracked as a separate event                                                                                                                                   | All except Klaviyo, Attentive, Google Ads                      | `OFF`         |
| **Track pageviews only when page reloads** | Stops a new pageview firing on `history.replaceState()` — see [below](#track-pageviews-only-when-page-reloads)                                                                             | All except Klaviyo, Attentive, Google Ads                      | `OFF`         |
| **Use page type for list name**            | Uses [Shopify's `page_type`](https://shopify.dev/docs/themes/liquid/reference/objects/request#request-page_type) as the list name instead of `document.location.pathname`                  | All except Klaviyo, Attentive, Google Ads                      | `OFF`         |

#### Order identifier

There are three ways to identify an order.

| Option                   | Example         | What it is                                                                      |
| ------------------------ | --------------- | ------------------------------------------------------------------------------- |
| Order ID                 | `5028988223651` | Shopify's internal order identifier                                             |
| Order Number             | `1024`          | The order's position in your shop's order count — your internal counter         |
| **Order Name** (default) | `#US1023`       | The order number plus any prefix or suffix set in your store's general settings |

#### Product identifier

There are three ways to identify a product.

| Option                   | Example          | What it is                                              |
| ------------------------ | ---------------- | ------------------------------------------------------- |
| **Product ID** (default) | `8663410540836`  | Shopify's internal product identifier                   |
| Variant ID               | `46799140684068` | Shopify's internal variant identifier                   |
| SKU                      | `tshirt-xl-red`  | The identifier you set yourself on a product or variant |

#### Send user data to Google Analytics

GA4 accepts hashed first-party data to better attribute ads and users. Before turning this on, [opt in to detected user-provided data](https://support.google.com/analytics/answer/14077171?hl=en) in your Google Analytics property.

{% hint style="warning" %}
Opting into user-provided data in GA4 without also turning this setting on could result in Google not tracking purchases.
{% endhint %}

Read more about how [user data works in GA4](/integrations/shopify-to-google-analytics/tracking-first-party-data-ga4.md).

#### Track pageviews only when page reloads

On some themes the URL changes without a new page load — selecting a new variant, for example — and Littledata's script tracks that as a new pageview. Turning this **ON** stops a new pageview firing on `history.replaceState()` via the [browser History API](https://developer.mozilla.org/en-US/docs/Web/API/History_API).

### Google Analytics session enrichment

Found in the **Session enrichment** tab of the **Google Analytics 4** destination.

{% hint style="info" %}
[Session enrichment](/integrations/shopify-to-google-analytics/source-medium-customization-payment-gateway.md) is a newer version of our Google Analytics tracker. It extends Google's Measurement Protocol to give you more accurate attribution and deeper control over your tracking.
{% endhint %}

| Setting                                     | What it does                                                                                                                                                                   | Default  |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- |
| **Attribution boost**                       | Improves order attribution by matching return purchases to known attribution information, such as UTM parameters                                                               | `ON`     |
| **Attribution boost — recurring purchases** | Keeps every recurring purchase on the original UTM parameters from the first order in the series, so campaign attribution stays consistent                                     | `OFF`    |
| **Source / medium customization**           | [Your own rules](/integrations/shopify-to-google-analytics/source-medium-customization-payment-gateway.md) to overwrite how orders get attributed, based on conditions you set | No rules |

### Segment tracking customization

Found in the **Tracking customization** tab of the **Segment** destination.

| Setting                                | What it does                                                                                                                                                                                                                                                            | Default                   |
| -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
| **Anonymize IP**                       | Masks the last 3 numbers of the user's IP address — greater privacy, at the cost of some geo-location accuracy                                                                                                                                                          | `OFF`                     |
| **Include revenue on purchase events** | Adds revenue to purchase events                                                                                                                                                                                                                                         | `OFF`                     |
| **User ID**                            | Which identifier to use for logged-in users — see [below](#user-id)                                                                                                                                                                                                     | `Shopify customer ID`     |
| **CDN for Analytics JS**               | Loads Segment's AnalyticsJS from your own domain if you have a [proxy CDN setup](https://segment.com/docs/connections/sources/catalog/libraries/website/javascript/custom-proxy) redirecting to `https://cdn.segment.com`. Give the full domain, with no trailing slash | `https://cdn.segment.com` |
| **Cookies to track**                   | Reads the values of named cookies and passes them as traits on Segment identify calls, e.g. `"iterableEmailCampaignId", "iterableTemplateId"`                                                                                                                           | No cookies                |

#### User ID

You can [choose which identifier to use](https://segment.com/docs/connections/sources/catalog/libraries/website/shopify-littledata/#user-identity) for logged-in users:

* Shopify customer ID (default)
* Email
* MD5 hashed email
* Customer metafield
* None

{% hint style="info" %}
This must match what is configured for server-side events in Littledata's app settings.
{% endhint %}

## Global settings

Found in the left-side navigation sidebar inside Shopify Admin. These settings apply across every destination.

| Setting                               | What it does                                                                                                                                                                 | Default |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| **Use note attributes**               | Lets Littledata attach notes to cart and order events, which improves accuracy for reporting and server-side analytics                                                       | `ON`    |
| **Product list links include images** | Tracks [clicks on product images](/integrations/shopify-to-google-analytics/tracking-product-list-views-and-clicks.md) as product views — see the note below                 | `OFF`   |
| **Product list links include prices** | Only tracks product list views and clicks where the price is visible, giving cleaner product list reporting. Turn this on if the price is part of the clickable product link | `OFF`   |
| **Hide branding**                     | Removes Littledata's console branding message from your browser logs                                                                                                         | `OFF`   |
| **Debug logs**                        | Adds extra console logs showing how the script is performing                                                                                                                 | `OFF`   |

<figure><img src="https://3956158252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QhTbrMraNWciQeDvu1b%2Fuploads%2Fgit-blob-e16d3e3065938fed17c8a4a7705189e6851acead%2Fnote%20attributes%20in%20LD%20app.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**On product list links and images:** we assume a product list is either a list of links to product images, or a list of links with images in a sibling HTML element — that is, the `<a>` and `<img>` tags share the same parent. Turn **Product list links include images** on if you need to track only links where the `<img>` tag is a child of the `<a>` tag.
{% endhint %}
