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

# New and returning customers (/docs/concepts/new-and-returning-customers)

<!-- agent-signals: reading_time_min: 4 · est_tokens: 1696 · updated: 2026-11-16 -->
Related: [How Product Metrics works](/docs/concepts/how-it-works.md), [Conversion values](/docs/concepts/conversion-values.md), [Profit](/docs/concepts/profit.md), [Conversion actions and events](/docs/concepts/conversion-actions-and-events.md), [Consent](/docs/concepts/consent.md), [Server-side tracking](/docs/concepts/server-side-tracking.md)

> How Product Metrics decides whether an order comes from a new or a returning customer, and what it sends for each.

Each paid order is **new**, **returning** or **unknown**, matched against the customer's earlier paid orders in the same store. The classification decides which customer conversions are sent: **New Customer** for a first order, **Returning Customer** for a later one. The values are on [Conversion values](/docs/concepts/conversion-values).



![Each paid order is matched to the customer by customer ID, then email, then phone. With no earlier paid order in the same store it is a new customer, sent once per customer. With an earlier paid order it is returning. If no match is possible it is unknown and sent as revenue and profit only.](/docs/_assets/ce68998fe6333aaaa1fecbd89ff6e0ceaaf47431597d3b4fd272e370bebd6ea7)

*Figure: How an order is classified as new, returning or unknown.*

## New vs returning

|               | **New**                                                    | **Returning**                                                          |
| ------------- | ---------------------------------------------------------- | ---------------------------------------------------------------------- |
| **What**      | No earlier paid order from this customer in this store     | At least one earlier paid order                                        |
| **Example**   | First order, #1042                                         | Second order, #1077                                                    |
| **Sent as**   | Product Metrics - New Customer (+ Profit), `PMNewCustomer` | Product Metrics - Returning Customer (+ Profit), `PMReturningCustomer` |
| **How often** | Once per customer                                          | Every later paid order                                                 |

An **unknown** order, one Product Metrics can't match to a customer, is still sent as revenue and profit, but not as new or returning.

## Rules

1. **Matched by the shop's own records.** The customer is recognised by their customer ID in your store, else their email address, else their phone number. Email and phone are hashed first.
2. **Per store.** History is kept per store connection. A customer of two stores is new in each.
3. **Only paid orders count as history.** A pending order is no history; a cancelled order adds no value.
4. **Once per customer.** A customer's new customer conversion is sent for their first paid order only. A later order never sends it again, to Google Ads or to Meta.
5. **Any earlier paid order makes them returning.** If the store reports the customer as returning, or Product Metrics has seen a paid order from them before, the order is returning.
6. **From the moment tracking is live.** Orders from before you connected the store aren't imported, so the store's own history and the orders Product Metrics has seen decide.

## Examples

```text
Order #1042   customer id 5531, no earlier paid order
  → NEW: New Customer 108.00, New Customer Profit 48.46
Order #1077   customer id 5531
  → RETURNING: Returning Customer 64.00, Returning Customer Profit 22.40
Order #1081   guest, no email or phone on the order
  → UNKNOWN: Revenue and Profit only
```

```text
Order #2001   guest, anna@example.com
Order #2050   anna@example.com, now with an account (customer id 7702)
  → the customer id now leads, so lifetime value starts again under it
```

## Per platform

| Platform                                          | Where customer history comes from                                                                                                                         |
| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Shopify](/docs/platforms/shopify)                     | The customer's earlier orders in Shopify.                                                                                                                 |
| [WooCommerce](/docs/platforms/woocommerce)             | Earlier paid orders by customer account, or billing email for guest orders. Only the statuses you marked as paid count.                                   |
| [Magento](/docs/platforms/magento)                     | Earlier paid orders in the same store view, by customer account or guest email.                                                                           |
| [Lightspeed](/docs/platforms/lightspeed)               | Lightspeed's new-customer flag and the customer's order history.                                                                                          |
| [Shopware](/docs/platforms/shopware)                   | Earlier paid orders in the same sales channel, by customer account or guest email.                                                                        |
| [Any website (Cloudflare)](/docs/platforms/cloudflare) | Only the purchase on the page: website orders aren't sent as new customers. An identified buyer Product Metrics has seen pay before is sent as returning. |

## Types

| Classification | Evidence                           | Conversions sent                                                    |
| -------------- | ---------------------------------- | ------------------------------------------------------------------- |
| `NEW`          | No earlier qualifying order found  | Revenue, Profit, New Customer, New Customer Profit, LTV             |
| `RETURNING`    | An earlier qualifying order exists | Revenue, Profit, Returning Customer, Returning Customer Profit, LTV |
| `UNKNOWN`      | Not enough identity to match       | Revenue, Profit                                                     |

Profit versions need complete costs. LTV needs a recognised customer.

## Try it

**Ask your assistant:** "How many of my last 20 orders were new customers?"

You should see each order as new, returning or unknown. Product Metrics also records how much of the customer's order history it read before classifying: complete, partial or unknown.

## Where next

| If you need…                          | Go to                                                              |
| ------------------------------------- | ------------------------------------------------------------------ |
| Bid on new customers                  | [New customer bidding](/docs/features/new-customer-bidding)             |
| Bid on repeat orders                  | [Returning customer bidding](/docs/features/returning-customer-bidding) |
| Value customers over time             | [LTV bidding](/docs/features/ltv-bidding)                               |
| Lists of your customers in Google Ads | [Customer lists](/docs/features/customer-list)                          |
