get_cart_analysis
Cart composition and abandonment economics — completion by cart value band and cart size, the merchandise value sitting in abandoned carts, and the products most often removed after being added.
When to use it
Before reconstructing abandonment by hand from journeys and exits. It answers cart questions in one call.
Ask for it like this
You do not name the tool. These are questions that make an assistant reach for it:
Which abandoned carts cost me the most money?
Is my free shipping threshold hurting me?
How to read the result
- A value band whose completion drops sharply just above a shipping-fee threshold is the classic free-shipping friction signature. Check the store's threshold against the band edges.
- Products with removalRatePct above roughly 40% usually mean price shock or a wrong-variant add. Cross-check the PDP variant picker with get_element_click_analysis.
- Single-product carts completing far below multi-product carts points at a weak order-building path — no upsell, no cross-sell.
What will make you wrong
Caveats
- Session-attributed events only.
- Add-time prices exceed final revenue whenever a checkout discount applies.
Parameters
This tool takes no parameters of its own.
Shared parameters it accepts
Documented in full on the tool reference index.
Date window — defaults to the last 30 days.
dateFrom
Start of the window, YYYY-MM-DD. Inclusive.
dateTo
End of the window, YYYY-MM-DD. Inclusive.
Every tool also accepts merchantId, which resolves from your connection. You never pass it.
What comes back
JSON. These are the top-level keys; date-scoped tools additionally carry a _meta block with the server date and the data coverage envelope.
overview
Cart sessions, completed sessions, completion rate and the total abandoned cart value.
completionByCartValue
Completion rate per cart value band, with confidence intervals.
completionByCartSize
Completion rate per number of items in the cart.
mostRemovedProducts
Products removed after being added, with removal rate — the regret signal.
caveats
What the numbers do and do not cover.