Why this matters
A cart funnel shows where measured progression stops; it does not explain why. Payment failures, shipping cost, inventory, slow pages, identity changes, and simple intent can all produce similar drop-off.
The funnel_3_step blueprint answers the narrow ordered question reliably. Use
separate evidence to investigate causes after the largest measured loss is
known.
What you get
- Three approved, observed ecommerce events
- Ordered shopper counts for the selected lookback
- Step and overall conversion calculated from canonical counts
- Identity and instrumentation caveats plus a ranked follow-up plan
Walk through it
Where do shoppers drop between cart and completed order?
I will verify the storefront’s exact event names and identity continuity before running the three-step funnel.
GET /v1/projects/:project_id/signal-map
GET /v1/projects/:project_id/onboarding
# Require status: "verified"; use live event/property reads for the selected signals.
GET /v1/projects/:project_id/event-names
GET /v1/query-blueprints/funnel_3_step
{
"server_emitted": [],
"analytics_events": [
{ "event": "cart_item_added", "count": 21400, "last_seen": 1783651200 },
{ "event": "checkout_started", "count": 8800, "last_seen": 1783651210 },
{ "event": "order_completed", "count": 4200, "last_seen": 1783651250 }
],
"wildcards": []
}
POST /v1/projects/:project_id/query-blueprints/funnel_3_step/run
Params:
step1: cart_item_added
step2: checkout_started
step3: order_completed
days: 30
{
"rows": [
{ "step1_count": 21400, "step2_count": 8800, "step3_count": 4200 }
]
}
The measured conversions are 41.1% from cart to checkout, 47.7% from checkout to order, and 19.6% overall. Those calculations do not include time-on-step, cart value, payment failure, or a benchmark.
The output
Cart-to-purchase funnel — last 30 days
cart_item_added 21,400 100.0%
checkout_started 8,800 41.1% drop: 58.9%
order_completed 4,200 19.6% step conversion: 47.7%
Evidence gaps
- <identity, sampling, delayed server confirmation, missing device property>
Follow-up hypotheses
- payment failures → inspect verified payment-failure signal
- slow checkout → inspect measured completion duration
- payment-method differences → run the dedicated comparison
Setting it up
Send browser actions with the public browser credential and server-confirmed orders with the trusted server credential. Use a stable first-party shopper ID and a verified transition when the shopper signs in. Never treat a client-side “purchase clicked” event as a completed order.
Include only necessary properties such as SKU or storefront. Keep payment data, addresses, tokens, and cart contents outside analytics.
Variations
- “Segment the same funnel by an observed device property.”
- “Compare two exact adjacent periods with the same frozen event mapping.”
- “Measure product-view to add-to-cart separately using a suitable approved query.”
- “Tell me which missing event prevents a trustworthy funnel.”