> ## Documentation Index
> Fetch the complete documentation index at: https://docs.datalyr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify (App Store)

> Install DATALYR from the Shopify App Store in 5 minutes

Install DATALYR from the Shopify App Store for the easiest setup with automatic order tracking.

## Use Cases

**E-commerce Attribution**
Track every purchase back to the Meta, Google, or TikTok ad that drove it. See true ROAS with server-side conversion tracking.

**Product Performance**
See which products sell best from which ad campaigns. Optimize ad spend based on product-level attribution.

**Customer Journeys**
Track the full path from first ad click to purchase, even across multiple devices and sessions.

**Abandoned Cart Recovery**
Track cart additions and identify where customers drop off. Connect to ad platforms for retargeting.

## Before You Start

* [ ] You have a DATALYR account
* [ ] You've created a workspace
* [ ] You have a Shopify store (any plan)
* [ ] You have admin access to your Shopify store

## Installation Steps

### Step 1: Install from Shopify App Store

1. Go to the [DATALYR app in the Shopify App Store](https://apps.shopify.com/datalyr)
2. Click **Add app**
3. Review the permissions and click **Install app**
4. You'll be redirected to DATALYR to connect your store

### Step 2: Connect Your DATALYR Workspace

1. Log in to your DATALYR account (or create one)
2. Select the workspace you want to connect
3. Click **Connect Shopify Store**
4. Authorize the connection

### Step 3: Verify Installation

1. Visit your Shopify storefront in a new browser tab
2. Browse a few products
3. Go to your DATALYR dashboard
4. Click **Events** in the sidebar
5. You should see `page_view` and `view_item` events within seconds

If you see events, you're done! DATALYR is tracking.

## What Gets Tracked Automatically

The Shopify app automatically tracks:

**Pageviews**

* Homepage visits
* Product page views
* Collection page views
* All other pages

**E-commerce Events**

* Product views with product details
* Add to cart with product and price
* Begin checkout (checkout initiated)
* Purchase with full order details (order ID, revenue, items, customer info)

**Attribution Data**

* UTM parameters from ad campaigns
* Ad click IDs (fbclid, gclid, ttclid)
* Referrer and traffic source
* First touch, last touch, and current touch
* Cross-device visitor linking

**Customer Data**

* Customer ID (when logged in)
* Email (on purchase)
* Order history
* Customer lifetime value

## How Shopify Tracking Works

DATALYR uses Shopify's Web Pixels API for accurate, privacy-compliant tracking:

**Web Pixel**
Tracks customer behavior on your storefront (pageviews, product views, cart events).

**Order Sync**
Automatically syncs order data from Shopify via webhooks. No code required.

**Server-Side Events**
Sends conversion events to Meta CAPI, Google Enhanced Conversions, and TikTok Events API with enriched data.

## App Permissions

DATALYR requires these Shopify permissions:

* **Read orders**: To track purchases and revenue
* **Read products**: To include product details in events
* **Read customers**: To link orders to customer profiles
* **Web pixels**: To track customer behavior on your storefront

All data is processed securely and used only for attribution tracking.

## Configure Server-Side Conversions

To send conversion events to ad platforms:

1. In DATALYR, go to **Integrations**
2. Connect **Meta Ads**, **Google Ads**, or **TikTok Ads**
3. DATALYR will automatically send purchase events with enriched data
4. Your ad platforms receive server-side conversions for better optimization

No additional setup required - it works automatically once connected.

## Shopify Plus Features

If you have Shopify Plus, DATALYR supports:

* **Checkout Extensibility**: Track checkout steps in new checkout
* **Multistore**: Install on multiple stores under one workspace
* **Wholesale**: Track B2B orders separately

## Troubleshooting

**Not seeing events?**

Check that:

* The app is installed and connected in your Shopify admin
* You're viewing your live storefront (not preview/development)
* Your workspace is connected in DATALYR
* Ad blockers are disabled

**Orders not syncing?**

Orders sync automatically via webhooks. If orders aren't appearing:

1. Check that the app has "Read orders" permission
2. Wait up to 5 minutes for the first sync
3. Place a test order to verify

**Duplicate tracking?**

If you previously installed DATALYR manually, remove the old tracking script from your theme to avoid duplicate events.

## Uninstall Manual Installation (If Applicable)

If you previously installed DATALYR manually in your theme:

1. Go to **Online Store → Themes**
2. Click **Actions → Edit code**
3. Find and remove the DATALYR script from `theme.liquid`
4. Save changes

The app handles all tracking automatically.

## App vs Manual Installation

**Use the App if:**

* You want automatic order tracking
* You don't want to edit theme code
* You want one-click installation
* You want automatic updates

**Use Manual Installation if:**

* You need full control over event tracking
* You want to customize which events are tracked
* You have a highly customized theme

[See manual installation guide →](/getting-started/installation/platforms/shopify-manual)

## Next Steps

<CardGroup cols={2}>
  <Card title="Connect Ad Accounts" icon="megaphone" href="/integrations/overview">
    Link Meta, Google, or TikTok Ads
  </Card>

  <Card title="View Your Dashboard" icon="chart-line" href="/features/dashboard">
    See your Shopify tracking data
  </Card>

  <Card title="Server-Side Conversions" icon="server" href="/integrations/meta-capi">
    Set up Meta CAPI
  </Card>

  <Card title="Verify Tracking" icon="check" href="/getting-started/installation/verify-tracking">
    Confirm events are tracking
  </Card>
</CardGroup>

## Need Help?

Can't find the app in the Shopify App Store? Check our [troubleshooting guide](/troubleshooting/tracking-not-working) or contact support.
