Skip to content
Get started

Quickstart

Set up Product Metrics with your AI assistant or in the app, from your workspace to the first order in Google Ads.

Every paid order goes from your store to your ad channels, with its profit and whether the customer is new or returning. Two ways to the same setup:

Set it up with AI

Connect the Product Metrics MCP server to Claude, ChatGPT, Claude Code or Cursor (open Connect your assistant below, or see every client), then paste the prompt. You sign in through your browser; there is no API key. When a step needs you, such as the Google consent or the Shopify install, the assistant gives you the link and waits.

Connect your assistant

First time? Add the Product Metrics MCP server to your assistant, then paste the prompt below.

In Claude, choose Add custom connector; in ChatGPT, Settings → Apps & Connectors. Paste this URL:

https://www.productmetrics.io/mcp

Claude Code: run this in your terminal.

claude mcp add --transport http product-metrics https://www.productmetrics.io/mcp

CodexAll clients and details →

Paste the prompt into your assistant.

Set up Product Metrics for my store, from connecting the store to sending the first order to Google Ads. Check my setup status first, walk me through each open step, and give me the link when I need to click something.
Set up Product Metrics for my store, from connecting the store to sending the first order to Google Ads. Check my setup status first, walk me through each open step, and give me the link when I need to click something.
Set up Product Metrics for my store, from connecting the store to sending the first order to Google Ads, and give me the link when I need to click something. 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).
Set up Product Metrics for my store, from connecting the store to sending the first order to Google Ads, and give me the link when I need to click something. 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).

In the app

By the end of these steps you will:

  1. Create a workspace and connect your store (where orders and product costs come from)
  2. Connect Google Ads and Merchant Center (where conversions go)
  3. Set your consent banner (so each channel only gets what the visitor allowed)
  4. Create the conversion actions in Google Ads
  5. Add your costs (so profit is complete)
  6. See your first order arrive with its profit

1. Create a workspace and connect your store

Sign in at app.productmetrics.io and follow onboarding to name your workspace. It holds your stores, team and billing.

Then go to Ecommerce platforms → Connect Shopify → Open Shopify App Store. Other platforms: choose yours (WooCommerce, Magento, Lightspeed, Shopware, or Cloudflare for a website without a store).

Open Ecommerce platforms

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

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.

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.

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.

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.
Example data.

Follow the setup guide

Select Setup guide on the Shopify page for every step, with screenshots.

The Shopify setup guide panel in Product Metrics, with every setup step and its screenshots.

In Shopify, Install the app, select Connect Product Metrics account, choose your workspace and select Link Shopify store. Then turn on Product Metrics under App embeds in the theme editor and Save, and select Create subscription: Shopify bills the app.

You should see You’re set up with three ticks.

2. Connect Google Ads and Merchant Center

Connect Google Ads in onboarding, on the Connect Google Ads and Merchant Center step, or later on Integrations: select Continue as your Google account and tick Google Ads. Pick the client account that runs your campaigns, not a manager account. Merchant Center is part of the Google Ads setup: link it to that Google Ads account in Google first.

Connect Google

On Connect Google Ads and Merchant Center, select Continue as your Google account and sign in with the account that can see your Google Ads. Tick Google Ads on Google’s screen: Merchant Center connects with the same sign-in.

The Connect step of onboarding, Connect Google Ads and Merchant Center: Google Ads and Merchant Center both Not connected, a Use our manager account link for when you can't sign in with that Google account, and the Continue as sam@northwind-outfitters.example button.
Example data.

Pick the client account

Choose the Google Ads client account that runs your campaigns, not a manager account. The workspace is named after the account you pick.

The account step of onboarding: the Google Ads accounts the signed-in Google account can see, to pick the one Product Metrics should analyse.
Example data.

Already have a workspace? Open Integrations and select Connect Google Ads on the Google Ads row (Add account once one is connected). The same sign-in and account steps follow.

Integrations in Product Metrics: the required connections first, Google Ads and Merchant Center with your product feed, each row with its status and one action.
Example data.

In onboarding, five short questions follow. Then Product Metrics analyses your campaigns and products and opens your results.

Choose your main goal

Pick what you want from Google Ads, such as profit, revenue or clearing stock. Your results open on it first, and you can change it later.

The Choose your main goal step of onboarding, with goals such as profit, revenue and clearing stock.

Tell us about branded campaigns

Say whether brand traffic has its own campaigns. Product Metrics leaves branded campaigns out, so your segments show non-branded performance.

The branded campaigns question of onboarding: whether brand traffic runs in its own campaigns.

Say what your campaigns optimise for

Choose whether your conversion value is profit or order value. Not sure? Product Metrics detects it for you.

The conversion value question of onboarding: profit, order value, or let Product Metrics detect it.

Choose your ecommerce platform

Pick the platform your store runs on. It decides how tracking installs and how your trial is billed.

The ecommerce platform question of onboarding, with the supported store platforms to pick from.

Name your segmentation tools

Select any other tools you use to segment products, or None. Then select See my segments.

The segmentation tools question of onboarding: other tools you use to segment products, a None option and the See my segments button.

You should see your Google Ads account on Integrations, under Required. Details: Google Ads, Merchant Center.

Consent decides what each channel may receive. Go to Tracking → Complete your tracking setup → Configure consent and choose the banner your store shows; on Shopify that is usually Shopify Customer Privacy.

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.

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.

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.

You should see Configure consent ticked off with the banner you chose. Details: Consent.

4. Create the conversion actions

Go to Tracking → Complete your tracking setup → Create Google Ads conversions and select Create 8 conversion actions. They start as secondary, so your campaigns don’t change yet.

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.

You should see Conversion actions read Tracking ready; Setting up is normal for about 15 minutes. Details: Conversion actions.

5. Add your costs

Profit needs your shipping, handling, returns and payment fees. Go to Tracking → Complete your tracking setup → Add your additional costs, check the defaults Product Metrics prefilled for your country, and select Activate additional costs.

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.

You should see Profit tracking say your additional costs are active. Details: Costs.

6. Check the first order

Place and pay for a test order, then open Tracking.

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.
Example data.

Review the Google Ads destination

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

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 the badge read Tracking active and Conversion actions read Tracking ready, and the order with its revenue, profit and new or returning customer. What the two badges mean: App badges.

Optional: also send to Meta or ChatGPT Ads

Not one of the six steps. Server-side tracking (Full Signal Tracking) also sends each order to your Meta pixel and to ChatGPT Ads (OpenAI). You need the pixel ID and an access token or API key from that channel.

Go to Tracking → Meta Conversions API → Connect Meta, or Tracking → OpenAI Conversions API → Connect OpenAI. You should see the test event accepted. Steps and custom conversions: Meta, ChatGPT Ads.

Where next

Developers: do the same with the CLI or the API.