> ## Documentation Index
> Fetch the complete documentation index at: https://06bf7a0-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://06bf7a0-productmetrics.manicule.dev/docs/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://06bf7a0-productmetrics.manicule.dev/docs/api/mcp.
> Every agent surface: https://06bf7a0-productmetrics.manicule.dev/docs/.well-known/llms-manifest.json

# Quickstart (/docs/quickstart)

<!-- agent-signals: reading_time_min: 11 · est_tokens: 4057 · updated: 2026-11-17 -->
Related: [Introduction](/docs/index.md)

> 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:



* [With your AI assistant](#set-it-up-with-ai): connect the MCP server and paste one prompt. Your assistant checks your setup and takes you through each step.
* [In the app](#in-the-app): six steps, from your workspace to the first order in Google Ads.

## 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](/docs/mcp/overview)), 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.



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:** "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."

**Claude Code or Codex:** "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](https://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](/docs/platforms/overview) (WooCommerce, Magento, Lightspeed, Shopware, or Cloudflare for a website without a store).



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/f066a9a06aab40f6dc017eb5d001756331b8ffca668293eb2d01ec3db2ecb3e6)

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 accounts this Shopify store belongs to, an option to create a new workspace, and the Link Shopify store button.](/docs/_assets/db6b2280b91f76f69cd6ad8f80b28ed0afbcf59084635f5d2a90d6973334e313)

   *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)

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.



1. **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.](/docs/_assets/0d2be369dbe5104c735cd1c7373a8e7ff08264ebea02c129bd51097490f525e3)

   *Example data.*

2. **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.

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.

**Connect through our manager account instead**

Use this when you can't sign in with a Google account that can see your Google Ads. Product Metrics' manager account invites your Google Ads account, with access to that one account only.

1. **Choose the manager account.** On the **Connect** step, select **Use our manager account**.

   ![The Connect step of onboarding with the Use our manager account link, for when you can't sign in with the Google account that sees your Google Ads.](/docs/_assets/4795c769c1dc46b2348ec5796a84155e4bb0f4d0de7212fffd32ca30801c7727)

2. **Name the workspace.** Enter a name for the workspace the invite belongs to, then select **Continue**.

   ![The workspace name field of the manager account route, with the Continue button.](/docs/_assets/4fa654128e9a60d95e2ae0545925409921419a320e8b5f14f87d092342f2b85e)

3. **Enter your customer ID.** Enter your Google Ads customer ID and select **Send invite**.

   ![The Use our manager account form on the Connect step: enter the account's customer ID and send the invite, the account owner accepts it in Google Ads under Admin → Access and security → Managers, and Product Metrics checks access every 2 minutes. A Google Ads customer ID field, a Check access link, Connect with Google instead, and the Send invite button.](/docs/_assets/eaee093b9a33fc6b0e91382fb830909287363dcdfbdccd09a822b1be7a2fb4c1)

4. **Accept the invite in Google Ads.** In Google Ads, open **Admin → Access and security → Managers** and accept the invite. Product Metrics checks access every few minutes and starts the analysis once it has access.

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



1. **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.](/docs/_assets/59d669b32061f54cb7ec72f6f4776e2ecb41b38e029cd51ba9304d8d489d27ee)

2. **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.](/docs/_assets/739825977f0ed6ec90bd4202f51fb525ade67fbb923d65ad9ccd4c148a497a9d)

3. **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.](/docs/_assets/02f0b85eb17c45e59f2cd0d58988067b0f44bfb768c113b88ba48159840674c3)

4. **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.](/docs/_assets/9c69ba710abf2d1bed58b2db75e79d5b9764364067378b114dfd09c231815424)

5. **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.](/docs/_assets/48df86dc846a691a344fddac34913b6b8c67671a2bd973ebe5a72c2695128ffa)

You should see your Google Ads account on **Integrations**, under **Required**. Details: [Google Ads](/docs/channels/google-ads), [Merchant Center](/docs/using/merchant-center).

### 3. Set your consent banner

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**.



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 Consent management panel in Tracking: the storefront script collects nothing until your cookie banner says the visitor agreed, a Not configured status, and the Consent platform dropdown.](/docs/_assets/f0a8d61eaa086657ce840c85899df48d5f3a7a52fb6c552710f93b1482b90e72)

You should see **Configure consent** ticked off with the banner you chose. Details: [Consent](/docs/using/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.



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 heading.](/docs/_assets/816fdc81f1068f5d013a17d0d26166a0834cc61c69943d0c05d5171b557e0652)

You should see **Conversion actions** read **Tracking ready**; **Setting up** is normal for about 15 minutes. Details: [Conversion actions](/docs/using/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**.



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.

You should see **Profit tracking** say your additional costs are active. Details: [Costs](/docs/using/costs).

### 6. Check the first order

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



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 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](/docs/using/check-tracking#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](/docs/channels/meta), [ChatGPT Ads](/docs/channels/openai).

## Where next



* [POAS bidding](/docs/features/poas-bidding): bid on profit with a target ROAS as a %.
* [How it works](/docs/concepts/how-it-works): from paid order to conversion action.
* [Connect your assistant](/docs/mcp/overview): ask for a POAS report per campaign.
* [Quickstart for developers](/docs/cli/quickstart): the same setup from the CLI, MCP or API.

Developers: do the same with the [CLI](/docs/cli/quickstart) or the [API](/docs/api/account/setup-get-status).
