> ## Documentation Index
> Fetch the complete documentation index at: https://1213424-productmetrics.manicule.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> For every page in one file, fetch https://1213424-productmetrics.manicule.dev/docs/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://1213424-productmetrics.manicule.dev/docs/api/mcp.
> Every agent surface: https://1213424-productmetrics.manicule.dev/docs/.well-known/llms-manifest.json

# Shopify server-side tracking and profit bidding (POAS) (/docs/platforms/shopify)

<!-- agent-signals: reading_time_min: 11 · est_tokens: 4817 · updated: 2026-11-17 -->
Related: [Connect your store: Shopify, WooCommerce, Magento, Lightspeed, Shopware or any website](/docs/platforms/overview.md), [WooCommerce server-side tracking and profit bidding (POAS)](/docs/platforms/woocommerce.md), [Magento server-side tracking and profit bidding (POAS)](/docs/platforms/magento.md), [Lightspeed eCom server-side tracking and profit bidding (POAS)](/docs/platforms/lightspeed.md), [Shopware server-side tracking and profit bidding (POAS)](/docs/platforms/shopware.md), [Server-side tracking and profit bidding on any website (Cloudflare)](/docs/platforms/cloudflare.md)

> Connect your Shopify store, get server-side conversion tracking live in Google Ads, Meta and ChatGPT Ads, and bid on profit, new customers or lifetime value.

Shopify tells Product Metrics about every **paid order**, with its product costs and customer. Product Metrics adds **profit**, **new or returning customer** and **lifetime value**, and sends it server-side to each ad channel you connect. No code and no Google tag: the app's script runs through Shopify's app proxy on your own store domain.



* **Install:** the Shopify app and its app embed. No code.
* **Product cost:** from Shopify. You add shipping, handling, returns and payment fees.
* **Consent banner:** Shopify Customer Privacy, or a supported banner (OneTrust, Cookiebot, Usercentrics or Osano).

## Set it up with AI



Setting it up with AI takes one prompt and 60 seconds: paste it into your assistant.



First connect the Product Metrics MCP server ([https://www.productmetrics.io/mcp](https://www.productmetrics.io/mcp); see [Connect your assistant](/docs/mcp/connect)).

**Claude or ChatGPT:** "Connect my Shopify store to Product Metrics. Check my setup status first, walk me through each open step, and give me the link when I need to click something in Shopify."

**Claude Code or Codex:** "Connect my Shopify store to Product Metrics and walk me through each open setup step, giving me the link when I need to click something in Shopify. Use the Product Metrics MCP server, or the productmetrics CLI with --json and the Product Metrics skills if they are installed (run `productmetrics help agents` first)."

## Prerequisites

* A Shopify login that can install apps and edit the theme.
* A [workspace](/docs/using/create-a-workspace). You can also create one while linking the store.
* A Shopify subscription for the app: it checks your setup without one, but collects nothing until it starts. Shopify stores don't need Product Metrics Pro billing; you pay through Shopify.

## In the app

### 1. Install the Shopify app

In Product Metrics, go to **Ecommerce platforms → Connect Shopify → Open Shopify App Store**. In Shopify, select **Install** and approve the permissions Shopify lists (orders, products, customers, themes, and a checkout pixel).



1. **Open Ecommerce platforms.** Go to **Integrations → Ecommerce platforms** and select **Connect** on **Shopify**.

2. **Start the setup.** The Shopify page lists three steps: connect your store, verify the app and link a property. Select **Connect Shopify**.

   ![The Shopify page under Integrations → Ecommerce platforms: 0 of 3 steps done, step 1 Connect your store with the Connect Shopify button, then Verify the app and Link a property, and a Setup guide button.](/docs/_assets/9af617bb0e806b577a6dfdad7049aefdf2941ee94a1ada092429474c785e4119)

3. **Install the app from Shopify.** Select **Open Shopify App Store** and install Product Metrics. In Shopify, select **Install** and approve the permissions it lists (orders, products, customers, themes, and a checkout pixel).

   ![The Connect Shopify dialog: install Product Metrics from Shopify, then link the store to your existing Product Metrics account. Shopify owns installation and store authorisation; after installing the app, you sign in to Product Metrics to select the company and tracking-ready property. Cancel and Open Shopify App Store buttons.](/docs/_assets/7f5fa9b1f168b5384f4820bc14c59c9b1324045000c5619120b8ec59e47117c6)

4. **Sign in to link the store.** In the Product Metrics app in Shopify, select **Connect Product Metrics account** and sign in, or create an account if you are new.

   ![The Product Metrics sign-in page, opened from Shopify to link the store.](/docs/_assets/5971d5f5a51faa299ca7473c014610d32282696d8456b4ef2537a07e117deb6e)

5. **Choose workspace and accounts.** Pick the workspace and the Google Ads accounts this store belongs to, or create a new workspace, then select **Link Shopify store**. The app then asks you to save its **app embed**: select **Open theme editor**, turn on **Product Metrics** under **App embeds** and select **Save**.

   ![The link step: the workspace and the Google Ads accounts this Shopify store belongs to, an option to create a new workspace, and the Link Shopify store button.](/docs/_assets/9359696727d58018f7a62e5b990e7364536f44271d69fe16b9400a879fce8191)

   *Example data.*

6. **Follow the setup guide.** Select **Setup guide** on the Shopify page for every step, with screenshots.

   ![The Shopify setup guide panel in Product Metrics: a Download Word document button, then Before you begin: a Shopify login that is allowed to install apps and access to your Product Metrics workspace.](/docs/_assets/3fb7e48458516403699bf6d9c6224aa5207f2b0b3f207af53856b24fa1287465)

**You should see:** the Product Metrics app open in Shopify Admin.

### 2. Link the store

In the app, select **Connect Product Metrics account**, sign in, choose the workspace and accounts this store belongs to, and select **Link Shopify store**.

**You should see:** **One step left: save the app embed**.

### 3. Save the app embed

Select **Open theme editor**, turn on **Product Metrics** under **App embeds**, and select **Save**. The checkout pixel connects on its own.

### 4. Start the subscription

Select **Create subscription** and approve the charge in Shopify: one subscription with a spending cap you approve, and you pay only for what you use.

**You should see:** **You're set up** with three ticks: **Shopify permissions**, **App embed** and **Checkout pixel**.



![The Product Metrics app home in Shopify admin for Example Store: a You're set up banner, ticks for Shopify permissions, App embed and Checkout pixel, and the Open dashboard, Test your storefront and Run a tracking test buttons.](/docs/_assets/3388a5437e3988e089852270f08fde17ab57d4df45dfc3d4a39755f8c68593ad)

*Figure: The Product Metrics app in Shopify once setup is done.*

### 5. Finish tracking setup

The rest is the same on every platform: the [setup checklist](/docs/using/overview#find-the-next-step) in **Tracking → Complete your tracking setup** opens each step in turn:

* **Consent**: choose **Shopify Customer Privacy**, unless your store shows OneTrust, Cookiebot, Usercentrics or Osano. See [Consent](/docs/using/consent).
* **Channels**: connect [Google Ads](/docs/channels/google-ads), [Meta](/docs/channels/meta) and [ChatGPT Ads (OpenAI)](/docs/channels/openai).
* **Google Ads conversion actions**: [create them](/docs/using/conversion-actions).
* **Additional costs**: product costs come from Shopify; [add the rest](/docs/using/costs).

Step by step in **Tracking**:



1. **Open Tracking.** Go to **Integrations → Tracking**. The checklist shows six steps: start by connecting your store, or use Cloudflare Tracking if you have no store platform.

   ![Tracking in Product Metrics with the Complete your tracking setup checklist of six steps, starting with Connect your store.](/docs/_assets/09a584afb1797a0439b68310c4d6085412eafebba1524c019f42a90f3ed4ea37)

2. **Follow the next step.** Once your store is connected and linked, the checklist opens the next open step. Each step says what it does.

   ![The Complete your tracking setup checklist in Tracking: 3 of 6 essential steps completed, with Connect your store, Link the store to this property and Install storefront tracking ticked, and Configure consent open as step 4 with the consent platform still Not configured.](/docs/_assets/b385237058280a34dca53f7f1e42704faa9a8aee59024bd5baafc2211e201e7e)

3. **Configure consent.** Under **Configure consent**, pick the cookie consent platform your storefront uses. The storefront script collects nothing until the visitor agrees.

   ![The Configure consent step in the tracking checklist, with the list of consent platforms to choose from.](/docs/_assets/f0a8d61eaa086657ce840c85899df48d5f3a7a52fb6c552710f93b1482b90e72)



1. **Create Google Ads conversions.** Under **Create Google Ads conversions**, select **Create 8 conversion actions**. Product Metrics manages one Google Ads conversion action per purpose; they start as secondary goals, and you choose the primary goal in Google Ads.

   ![The Conversion actions page in Product Metrics, opened from Tracking: Not configured, 0 of 8 managed and the Create 8 conversion actions button. Below it, Customer types (New customer revenue and profit, Returning customer revenue and profit) and Order value (Order revenue, Order profit), each Missing with Google goal status Unknown, and the Lifetime value group.](/docs/_assets/816fdc81f1068f5d013a17d0d26166a0834cc61c69943d0c05d5171b557e0652)



1. **Add your additional costs.** Product costs come from your store where it reports them. Under **Add your additional costs**, add shipping, handling, returns and payment fees, set **Product cost fallback (%)** and select **Activate additional costs**, so the profit conversions carry real profit.

   ![The Add your additional costs step in Tracking, prefilled for your country: shipping, handling, returns and payment fee fields, a Product cost fallback (%) field and the Activate additional costs button.](/docs/_assets/9aa53f961b1d7a0f43c3ebdccb7dfda4cb044d52cf5c7d4cd3b10fc95a7083fb)

**You should see:** the badge next to **Tracking** read **Tracking active**.

### 6. Check it works

In Shopify, the app says **Tracking is live on your store** once it sees storefront activity. Then select **Tracking → Run tracking test** in the app. In Product Metrics, check **Tracking** too:



1. **Check storefront collection.** **Storefront & data collection** shows how tracking runs on your site and which consent and profit settings apply.

   ![The WooCommerce installation panel from Storefront & data collection in Tracking: Active, northwind-outfitters.example collecting visits, carts and checkouts on this domain, and storefront tracking managed by the WooCommerce plugin, with no Cloudflare setup or manual script tag required. An Advanced collection settings button.](/docs/_assets/360f30f6ea7a26ac41a96d240ec9e7d99f1f6bea85d7d728a315ab3452f3fd12)

   *Example data.*

2. **Review the Google Ads destination.** The **Google Ads** panel shows the connection, the conversion actions, profit tracking and the enhanced conversions terms.

3. **Check that tracking is live.** When every step is done, the badge next to **Tracking** reads **Tracking active**, and Tracking shows how many conversion actions receive orders.

**You should see:** **Passing**, **Needs attention** or **Listening** per check. More in [Check tracking](/docs/using/check-tracking).

## How it works on Shopify

|                               | On Shopify                                                                                       |
| ----------------------------- | ------------------------------------------------------------------------------------------------ |
| **Install**                   | Shopify App Store app plus the app embed in your theme; the checkout pixel connects on its own   |
| **Order sent**                | When Shopify marks it paid                                                                       |
| **Product cost**              | From Shopify; you add shipping, handling, returns and payment fees                               |
| **Consent**                   | Shopify Customer Privacy, or OneTrust, Cookiebot, Usercentrics or Osano                          |
| **Refunds and cancellations** | Shopify reports them; Product Metrics adjusts the conversion it sent                             |
| **Billing**                   | One Shopify subscription with a spending cap. Uninstalling the app cancels it and stops tracking |

## What you get on Shopify

Each feature, its channels and the Shopify guide for each:



| Feature                                                                | Channels                                                                                                                                                                             | On this platform                                                                     |
| ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
| [Server-side conversion tracking](/docs/features/ad-blocker-proof-tracking) | [Google Ads](/docs/tracking/server-side/shopify-google-ads) · [Meta](/docs/tracking/server-side/shopify-meta) · [ChatGPT Ads](/docs/tracking/server-side/shopify-openai)                            | Sent once Shopify marks the order paid; the script runs through Shopify's app proxy. |
| [Enhanced Conversions](/docs/features/enhanced-conversions)                 | [Google Ads](/docs/tracking/enhanced-conversions/shopify-google-ads) · [Meta](/docs/tracking/enhanced-conversions/shopify-meta) · [ChatGPT Ads](/docs/tracking/enhanced-conversions/shopify-openai) | Sent only with ad user data consent in Shopify Customer Privacy or your banner.      |
| [Customer lists](/docs/features/customer-list)                              | [Google Ads](/docs/tracking/customer-lists/shopify-google-ads)                                                                                                                            | Six Customer Match lists, filled from your Shopify orders.                           |
| [POAS and ROAS bidding](/docs/features/poas-bidding)                        | [Google Ads](/docs/bidding/poas/shopify-google-ads) · [Meta](/docs/bidding/poas/shopify-meta) · [ChatGPT Ads](/docs/bidding/poas/shopify-openai)                                                    | Product costs from Shopify, plus your [additional costs](/docs/using/costs).              |
| [New customer bidding](/docs/features/new-customer-bidding)                 | [Google Ads](/docs/bidding/new-customers/shopify-google-ads) · [Meta](/docs/bidding/new-customers/shopify-meta)                                                                                | Each paid order is new or returning, from whether the customer bought before.        |
| [Returning customer bidding](/docs/features/returning-customer-bidding)     | [Google Ads](/docs/bidding/returning-customers/shopify-google-ads) · [Meta](/docs/bidding/returning-customers/shopify-meta)                                                                    | Orders from customers who bought before, as their own conversion.                    |
| [LTV bidding](/docs/features/ltv-bidding)                                   | [Google Ads](/docs/bidding/ltv/shopify-google-ads) · [Meta](/docs/bidding/ltv/shopify-meta) · [ChatGPT Ads](/docs/bidding/ltv/shopify-openai)                                                       | Observed value from paid Shopify orders, not a prediction.                           |

## Troubleshooting

| Message                                                | Fix                                                                                                                                                                                                      |
| ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "One step left: save the app embed"                    | The app embed is off, or the theme wasn't saved. Select **Open theme editor**, turn on **Product Metrics** under **App embeds**, select **Save**, then **Check settings** in the app.                    |
| "A few permissions are missing" or "New version ready" | Select **Upgrade now** and approve the permissions Shopify lists.                                                                                                                                        |
| "Shopify denied access to the checkout pixel"          | Shown under **Checkout tracking needs attention**. Check the app's permissions, then select **Check setup again**.                                                                                       |
| "We couldn't reach Product Metrics tracking"           | Wait a moment, then select **Check setup again**.                                                                                                                                                        |
| "Product Metrics doesn't recognise this store's link"  | Link the store again, then select **Check setup again**.                                                                                                                                                 |
| "Contact Product Metrics support"                      | Select **Contact support**.                                                                                                                                                                              |
| "This store needs support to finish connecting"        | The store is linked to another Product Metrics workspace. Nothing is billed or overwritten. Choose that workspace when you link, disconnect it there first, or select **Contact support**.               |
| Fewer conversions than Shopify orders                  | Orders are sent when Shopify marks them paid. Check that [consent](/docs/using/consent) names the banner your store shows: customer data goes only with ad user data, and the click only with ad storage too. |

## FAQ

### Do I need a developer to set it up on Shopify?

No. You install the app from the Shopify App Store, turn on the app embed in your theme editor and start the subscription; the checkout pixel connects on its own. No code and no Google tag.

### How is Product Metrics billed on Shopify?

Through one Shopify subscription with a spending cap you approve, and you pay only for what you use. You don't need a separate Pro subscription. Uninstalling the app cancels it and stops tracking.

### Does it work with my cookie banner?

Yes, with Shopify Customer Privacy, OneTrust, Cookiebot, Usercentrics or Osano. Choose the one your store shows in **Configure consent**; customer data is sent only with ad user data consent.

### Where do product costs come from on Shopify?

From Shopify itself. You add shipping, handling, returns and payment fees once as additional costs in **Tracking**, and profit includes them.

## Where next



* [Google Ads](/docs/channels/google-ads): connect Google Ads and Merchant Center
* [Meta](/docs/channels/meta): send purchases through the Meta Conversions API
* [ChatGPT Ads (OpenAI)](/docs/channels/openai): send purchases through the OpenAI Conversions API
* [Check tracking works](/docs/using/check-tracking): the checks to run after your first order
* [Server-side conversion tracking](/docs/features/ad-blocker-proof-tracking): every platform and channel
* [Other platforms](/docs/platforms/overview): compare every store platform

On the website: [Product Metrics for Shopify](https://www.productmetrics.io/platforms/shopify), [Full Signal Tracking](https://www.productmetrics.io/server-side-tracking), [Product Segmentation](https://www.productmetrics.io/product-segmentation), [pricing](https://www.productmetrics.io/pricing)

Developers: do the same with the [CLI](/docs/cli/commands#stores-and-tracking) or the [API](/docs/api/stores-and-tracking/stores-connect).
