How to track add to cart to purchase for Pinterest Ads

Architecture

The exact event sequence

Five stages. Stages one to three are browser-side and mostly fine. Stage four is where the money is and where the failures cluster. The identifier has to survive all of them.

1. Step 1

   Ad click

   Identifier captured on landing and persisted for the session and beyond.

2. Step 2

   Add to cart

   Browser-side, with item detail. The first genuine intent signal and the basis of most retargeting.

3. Step 3

   Checkout started

   Browser-side. Where drop-off analysis lives.

4. Step 4

   Order created

   From the order webhook, not the thank-you page — wallet payments can be abandoned after payment completes.

5. Step 5

   Purchase sent with the order ID

   Deduplicated on that ID at every destination, so one sale counts once.

Diagnostic sequence

What's specific to Pinterest Ads

The funnel logic above is the same wherever you advertise. These are the parts that change because it's Pinterest Ads.

1. 1

   Click identifier: the epik click identifier

   Pinterest appends epik to your landing page URL and the tag stores it in the _epik cookie. It is a single parameter rather than Google's three, which makes capture simpler — but Pinterest traffic skews heavily to iOS and to saved Pins opened weeks after they were first seen, so the identifier frequently arrives on a visit that is nowhere near the conversion. Persist it server-side the moment you see it.

2. 2

   Import mechanism: the Conversions API

   Server events posted to Pinterest's Conversions API, carrying the click identifier where you have it plus hashed customer information. Pinterest's API has been through more than one revision — check the current endpoint and required field names against Pinterest's own documentation before building, rather than trusting an older integration guide.

3. 3

   Deduplication

   Same shape as Meta: the browser tag and the Conversions API event must carry the same event_id for the same conversion, and the event name must match too. Send both without pairing them and every conversion counts twice. This is worth testing deliberately, because Pinterest volumes are often low enough that a doubling looks like a good week rather than a bug.

4. 4

   Window and timing

   Pinterest's attribution windows are configurable per campaign and separate the click path from the engagement and view paths, which is unusual. Confirm which window your reporting is set to before comparing anything, and verify the accepted event-freshness limit for server events against Pinterest's current documentation.

5. 5

   The Pinterest gotcha

   Pinterest is a save-now-buy-later platform in a way the other networks are not. A Pin saved in October and acted on in December is normal behavior, and it sits far outside any sensible click window — so a share of genuine Pinterest-driven revenue is structurally unattributable no matter how good the build is. Say that out loud before anyone sets a target.

Source-of-truth validation

How to prove the chain works

One real journey, followed all the way, then a reconciliation. Neither on its own is enough.

• A live Pinterest ad clicked, and the identifier confirmed present on the landing URL.
• The same identifier confirmed on the order record in your store after a full real journey through every step.
• Purchase sent with the order ID confirmed arriving at Pinterest Ads, verified by the event delivery and match reporting inside Pinterest Ads Manager, not the API response code.
• Your store's order records, web orders only reconciled against Pinterest Ads per record over a fully closed window.
• The same reconciliation repeated 30 days later.

Straight talk

When this doesn't apply to you

Worth checking before you build anything, because two of these are common and both mean the work isn't worth doing.

• If you don't have a cart — a single-product checkout, a booking flow — the add-to-cart stage doesn't exist and you want the checkout-to-purchase sequence instead.
• If Pinterest is a small test line on your media plan, the Conversions API is more work than the signal is worth this quarter. It earns its keep when Pinterest is a channel you are actually scaling.
• If your cycle from click to purchase sent with the order id regularly exceeds the import window, the final event can't drive bidding whatever you build. Optimize toward checkout started instead and use the later data for budget decisions rather than for bidding.
• If almost none of your orders carry a click identifier today, that's the whole project. Fix capture first — the import is the easy half and no tooling rescues a record with nothing to reference.