Update: New metrics in the Replenishment API v2022-11-07
In early 2024 Amazon upgraded the Replenishment API (v2022‑11‑07) to return four new seller‑oriented metrics—REVENUE_BY_DELIVERIES, SUBSCRIBER_RETENTION, SUBSCRIBER_CHURN, and SUBSCRIBER_LIFETIME_VALUE—via the getSellingPartnerMetrics call for the prior twelve‑month period. The metrics provide revenue breakdowns by delivery count and 30‑/90‑day retention and churn rates, enabling automated subscription performance tracking.
Overview
Amazon has upgraded the Replenishment API (v2022‑11‑07) with four new seller‑oriented metrics, a change that went live in early 2024. The addition lets subscription‑based merchants retrieve twelve months of revenue, retention, churn, and lifetime‑value data through the getSellingPartnerMetrics call. Access to these figures is essential for sellers who depend on recurring orders, as it fuels more precise inventory planning and subscription program tuning.
Key Points
- Four metrics introduced — The API now returns REVENUE_BY_DELIVERIES, SUBSCRIBER_RETENTION, SUBSCRIBER_CHURN, and SUBSCRIBER_LIFETIME_VALUE for the prior twelve‑month period.
- Revenue split by delivery count — REVENUE_BY_DELIVERIES breaks down subscription earnings by the number of deliveries a buyer has received, highlighting the contribution of high‑frequency purchasers.
- Retention tracked at 30‑ and 90‑day intervals — SUBSCRIBER_RETENTION reports the share of active subscriptions that survive the first month and the first three months, giving a clear picture of early‑stage stickiness.
- Churn quantified for the same windows — SUBSCRIBER_CHURN supplies the percentage of subscriptions that cancel within 30 days and 90 days, allowing sellers to measure the impact of onboarding and engagement efforts.
- Lifetime value estimation — SUBSCRIBER_LIFETIME_VALUE provides an average revenue figure per subscriber over the entire relationship, supporting long‑term budgeting and acquisition‑cost decisions.
How the Updated Replenishment API Works
- Authenticate and call the metrics endpoint — Using AWS Signature V4, a seller issues a GET request to
/replenishment/2022-11-07/metrics, attachingMarketplaceIdand optionalStartDate/EndDate. For example, a US‑based seller could requesthttps://sellingpartnerapi-na.amazon.com/replenishment/2022-11-07/metrics?MarketplaceId=ATVPDKIKX0DER&StartDate=2023-05-01&EndDate=2024-04-30. - Include the new metric identifiers — In the request payload, the seller lists the codes , , , and . The service responds with a JSON object that contains time‑series arrays for each metric.
Analysis & Recommendations
Why This Matters
Sellers can now programmatically pull twelve‑month subscription revenue, retention (e.g., 30‑day 78%, 90‑day 62%) and churn data, allowing real‑time dashboards, automated alerts when churn exceeds 15%, and precise CPA calculations (e.g., $30 max for a $120 LTV). This shifts subscription management from manual CSV downloads to proactive, data‑driven actions.
Key Takeaways
- Four new metrics—REVENUE_BY_DELIVERIES, SUBSCRIBER_RETENTION, SUBSCRIBER_CHURN, SUBSCRIBER_LIFETIME_VALUE—were added to the Replenishment API.
- The API endpoint /replenishment/2022-11-07/metrics now returns 12‑month time‑series arrays when the new metric codes are included.
- Sample figures can show 30‑day retention of 78% and 90‑day retention of 62%, and churn thresholds (e.g., >15% at 30 days) can trigger automated act...
Recommended Actions
- →Update your integration in Seller Central > Developer Central > SP‑API to call GET /replenishment/2022-11-07/metrics and include the four new metri...
- →Create a dashboard or alert in your analytics platform (e.g., QuickSight, Looker) that monitors SUBSCRIBER_CHURN >15% at the 30‑day mark and trigge...
Comments
Join the discussion
Log in or create an account to share your thoughts on this update.
No comments yet. Be the first to share your thoughts!