Overview Snapshot

cdp_overview

Summarizes your entire customer base in one call — the "how are my customers doing?" snapshot, instead of ten separate lookups.

Read-only and hard-scoped to your brand.

Parameters

Returns

• totals — { customers, identifiedProfiles, anonymousProfiles }. The identified vs anonymous split comes from the CDP profile store.
• tagDistribution — counts per derived tag (e.g. high_value, lapsed), busiest first.
• spend — { avgTotalSpend, avgAov, currency } averaged across the base.
• recentEvents — { since, sinceDays, byEventType }, event volume per type over the recent window.
• degraded — { unomi }; see the note below.
• coverage — { since, note }, the brand's order-data coverage floor. totals and spend are CDP-witnessed since this date (the earliest order the CDP has materialized for this brand, or null if none yet), not lifetime — distinct from recentEvents.since, which is your chosen event window.

Example prompts

Give me an overview of my customer base

How are my customers doing over the last 90 days?

Notes

• since_days is clamped (to a maximum of 365), not rejected — a larger value simply uses the cap.
• The Postgres-derived facts (customers, tags, spend, events) always return. If the profile store is briefly unavailable, the identified/anonymous counts come back null with degraded.unomi = true, and everything else still returns.
• A brand with no materialized profiles yet gets an empty-but-valid snapshot, not an error.
• The totals and spend figures reflect only orders the CDP has witnessed since coverage.since, not lifetime Shopify history — for lifetime order/spend questions, query the store directly with shopify_admin_graphql.