Is the drawer earning?
"Yes" is not a useful answer. The useful one names which feature earned it.
Ask: "How did the cart drawer do last month, and which feature drove it?"
Step 1 — Set the range explicitly
Call get_analytics with start and end as YYYY-MM-DD. Omit both for the last 30 days. The
range can be at most 400 days.
Dates are read in the store's own timezone, and the range that was actually used comes back in
dateRange — check it against what you asked for.
Step 2 — Read the per-feature breakdown, not the total
attributedRevenue is the headline. revenueByFeature is the answer:
| Field | The feature |
|---|---|
rewardsBar | Reward and free-shipping progress bar |
upsellProducts | In-drawer product recommendations |
giftWrap | Gift wrap add-on |
shippingProtection | Shipping protection add-on |
attributedRevenue is the sum of the features that are reported, so the total, the breakdown and
the Analytics page in the app agree.
rewardsBar appears only when the whole range is covered by reward-bar tracking. If your range
starts before tracking began, the row is left out, and note says the date to start from. Ask again
with a range that starts on or after that date to see the reward bar's share.
A feature contributing zero is worth acting on in one of two ways: it is switched off, or it is on
and nobody takes it. get_drawer_settings tells you which — and those two situations call for
opposite decisions.
Step 3 — Look at what actually sold
topUpsellProducts lists up to five products that sold through the drawer, with order count and
revenue. If upsellProducts revenue is low, this is where you see whether it is because one product
carries everything, or because nothing lands.
Step 4 — Put the numbers in context
aov— average order value on drawer orderstotalOrders— orders in the range that went through the drawerabandonedCartRate— the share that did not convert. It isnullwhen there were too few checkout sessions to say;abandonedCartRateNotethen explainscurrency— the store's own; do not assume a symbol
What you finish holding
Revenue for a range you can name, split by feature, with the products behind the upsell figure and the currency it is all denominated in.