Product release
SRP Listing Badge — Carvia Score on Search Results
Put your Carvia Score on every search results listing — a compact, cache-warmed badge that differentiates your inventory at browse stage and drives qualified clicks to your VDP.
Release Overview
Your Carvia intelligence no longer waits for the click. The SRP Listing Badge puts your Carvia Score directly on search results pages — the grid where most shoppers browse before they ever reach a VDP.
Until now, Carvia lived on the vehicle detail page. Shoppers scrolled through dozens of identical listing cards — photo, price, mileage — with no signal that your dealership offers transparent, data-backed vehicle intelligence. Competitors without Carvia looked the same as you on the search grid. The differentiation only appeared after the click.
The SRP Listing Badge changes that first impression. A compact, branded score strip — Carvia logo plus a color-coded mini score ring — renders inline on each listing card. Shoppers see trust before they commit a click. When they do click through, they land on the full Widget Carousel experience they were already primed to expect.
srp-listing-badge
The Problem We Solved
Search results pages are where buying decisions begin — but Carvia was absent from that moment.
The invisible differentiation problem
Dealers invest in Carvia to stand out with transparency — history, valuation, AI insights, and a proprietary Carvia Score that summarizes vehicle quality at a glance. But all of that intelligence was locked behind the VDP click. On the search grid, your 92-score Accord looked identical to a competitor's listing with no score at all. Shoppers had no reason to click yours first.
The full-carousel-on-SRP problem
Embedding the full widget carousel on every listing card would be technically prohibitive. A search page with 24–48 vehicles cannot load 24–48 full AI-powered carousels — each with insights, valuation, history, and specifications. The performance cost would destroy page load times and shopper patience.
The cold-start problem
Even a lightweight score badge fails if it has to cold-resolve every VIN on every page load. With hundreds of active listings and inventory changing daily, on-demand-only resolution would mean slow badges, missing scores, and a poor first impression — the opposite of what trust signals are supposed to deliver.
What's New
SRP Listing Badge widget
A purpose-built embed for search result listing cards. Displays the Carvia Score logo alongside a color-coded mini score ring — Excellent (85–100), Good (60–84), Fair (35–59), or Poor (0–34). Designed for minimal vertical footprint so it fits naturally beneath a photo or price on standard dealer SRP templates. Accessible with proper ARIA labels (“Carvia Score 92 out of 100”). Optional link to the vehicle VDP when your template supports it.
Score-only cache warming
Inventory import now warms Carvia Score data per changed listing — without resolving the full widget carousel. For badge-only clients, a lightweight warm path calls POST /api/widgets/srp-listing-badge/resolve and persists a score-only cache body. Scores are ready before any shopper loads your SRP.
Batch resolve API
SRP pages hydrate badge data in bulk: up to 50 VINs per batch request, with bounded concurrency (5 parallel live resolves). Cache hits are served instantly from Redis or inventory-import DB; only cache misses trigger live score resolution. Your SRP loads fast even with a full page of listings.
Three-tier cache-first resolution
Every badge resolve checks caches in order: Redis carousel cache (fastest) → inventory-import DB cache (durable tier) → live score resolve (fallback). Badge data is extracted from the same cache bodies the widget carousel uses — one warm path, multiple read paths.
Independent or carousel deployment modes
Two deployment paths, one badge component. Clients with the full Widget Carousel get score data from existing carousel warm — no duplicate work. Clients with badge access only get the lighter score-only warm path. Both render the same SRP Listing Badge.
Inventory-driven score updates
When your inventory import detects a changed listing — new vehicle, price update, mileage change — a change event triggers automatic score re-warming. Badges stay current without manual intervention. Price drops on Saturday mean refreshed scores by Sunday morning.
Widget analytics instrumentation
The badge embed wraps success-state renders in EmbedAnalyticsShell — tracking renders, viewable impressions, and engagement through the same first-party analytics pipeline as your VDP widgets. SRP badge performance appears in Widget Analytics & Impact Reports.
Graceful degradation
When a score is unavailable — missing VIN data, service timeout, or inventory not yet warmed — the badge renders a subdued Carvia logo with a dash instead of a broken layout or empty space. Your SRP never shows a broken embed; it shows a professional fallback until data is ready.
How It Works
From inventory import to shopper eyeballs — five steps, mostly automated.
- Inventory import runs. Your DMS feed syncs. Carvia detects new, updated, or changed listings and creates warming change events for each affected VIN.
- Score cache warms. For each changed listing, Carvia resolves the Carvia Score and stores it in cache. Full carousel clients get a complete carousel warm (score included). Badge-only clients get a score-only warm — faster, lighter, purpose-built for SRP scale.
- SRP page loads. Your website template requests batch badge data for all visible listings — up to 50 VINs in a single API call, with mileage and listing price from your inventory feed.
- Cache-first hydration. The batch resolver checks Redis and inventory-import DB caches first. Cache hits return instantly. Misses resolve live with bounded concurrency — never more than 5 simultaneous live score calls per batch.
- Badge renders on each card. The compact score strip appears inline on each listing. Shoppers see the Carvia Score ring before they click. Click-through leads to the VDP with the full widget carousel — insights, valuation, history, and everything else.
widgets-host/app/embed/srp-listing-badge) that auto-resizes to fit your listing card layout. Your web team places the embed snippet in your SRP template; Carvia handles score resolution and rendering.
Built for Inventory Scale
SRP pages are the highest-traffic, highest-listing-count pages on your site. The badge architecture was designed for that reality.
Why not the full carousel on SRP?
A typical dealer SRP shows 24–48 vehicles per page. Loading a full AI-powered carousel — insights generation, valuation orchestration, history parsing, specifications — for each card would mean 24–48 concurrent AI pipelines on a single page load. Page weight, time-to-interactive, and server cost would all spike. The SRP Listing Badge delivers the one signal that matters most at browse stage — the score — in a fraction of the payload.
Score-only warm path
Badge-only clients do not pay the cost of full carousel resolution during inventory import. The warm service calls the dedicated SRP badge resolve endpoint and persists only widgets.score in the inventory cache — enough for the badge, nothing more. This keeps import warming fast even for dealers with 500+ active listings.
Carousel clients reuse existing cache
If you already have the widget carousel on your VDPs, your inventory import already warms full carousel data — including the score widget. The SRP badge reads that same score slice directly. No duplicate warm, no duplicate API calls, no extra import time.
Batch API design
Instead of 24 individual HTTP requests on page load, your SRP makes one batch call. The resolver processes listings with cache-first logic and caps live concurrency at 5 — preventing thundering-herd load spikes when a page has many cache misses (e.g., first load after a large inventory refresh).
What Shoppers See
A trust signal in the browsing moment — before commitment.
The score strip
Each listing card shows a compact horizontal strip: the Carvia Score logo on the left, a color-coded circular score ring on the right. The ring color communicates quality at a glance — green for Excellent, lime for Good, amber for Fair, red for Poor. No paragraphs to read. No tabs to click. One number that answers: “How does this vehicle stack up?”
Loading state
While score data resolves, the badge shows a subtle pulse skeleton — professional, not jarring. Once data arrives, the skeleton transitions to the live score ring. Shoppers on a well-warmed inventory page typically see scores appear near-instantly from cache.
Click-through to depth
The badge is a preview, not the full story. When a shopper clicks through to the VDP, they get the complete Carvia experience — AI insights, market valuation, history highlights, ownership cost, and the option to Get My Full Report. The SRP badge primed the click; the VDP carousel closes the sale.
Consistent scoring
The score on the SRP badge is the same Carvia Score on the VDP widget. Same algorithm, same data sources, same cache. Shoppers never see 88 on the search grid and 72 on the detail page — consistency builds trust.
Value by Role
For general managers
Differentiation on the page that matters most.
- Competitive edge on SRP — your listings show Carvia Scores; competitors' do not
- Inventory quality visible — high-scoring vehicles stand out in the grid without sales intervention
- Zero ongoing maintenance — scores update automatically with inventory import
- Flexible deployment — badge-only for SRP focus, or badge + full carousel for end-to-end coverage
Scenario: A shopper compares three similar SUVs on your SRP. Two have no score. Yours shows a green 91. That shopper clicks yours first — and arrives on the VDP already primed to trust your transparency story.
For marketing and internet directors
Extend your Carvia investment to the highest-traffic page on your site.
- SRP is your top-of-funnel — most shoppers browse search results before visiting any VDP
- Brand consistency — Carvia logo and score ring on every listing reinforce your transparency positioning
- Measurable impact — badge renders and impressions tracked in widget analytics
- Performance-safe — batch API and cache warming protect Core Web Vitals on inventory-heavy pages
Scenario: Your paid search campaign drives traffic to SRP filtered by make/model. Every listing in that grid now carries a Carvia Score — turning a generic inventory page into a differentiated shopping experience that supports your “transparent dealer” brand promise.
For sales professionals
Shoppers arrive on the VDP already curious about the score.
- Conversation starter — “Did you see the Carvia Score on that one? Let me walk you through what it means.”
- High-score prioritization — green-ring vehicles on SRP attract more clicks; be ready on those units
- Trust transfer — the score they saw on SRP is the same score on the VDP carousel — no bait-and-switch
- Full report follow-up — interested shoppers who clicked a high-score listing are prime candidates for Get My Full Report
Scenario: A be-back customer says they were “just browsing online.” You ask which vehicles caught their eye. They mention the one with the high Carvia Score. You already know which unit — and you open the full carousel report before they finish their sentence.
For web and technology teams
The badge is a self-contained iframe embed with auto-resize messaging — no custom CSS integration required beyond placement in your SRP template. Batch API reduces client-side request fan-out. Cache warming happens server-side during inventory import, not on the critical rendering path. Rate limiting (120 batch requests per minute per client) protects against accidental overload.
Analytics & Measurement
The SRP Listing Badge is fully instrumented through Carvia's first-party widget analytics SDK — the same pipeline that powers VDP widget measurement.
- Renders — how many times badges loaded on SRP listing cards
- Viewable impressions — badges actually seen by shoppers (50% visible for 1+ second)
- Engagement time — how long shoppers viewed score badges before clicking or scrolling away
- Conversion events — badge clicks and downstream VDP visits attributed to SRP exposure
SRP badge metrics roll into your weekly and monthly impact emails alongside VDP carousel data — giving you a complete picture of Carvia reach from browse to buy.
Release Timeline
srp-listing-badge widget key, pricing, and access migration for active clients.EmbedAnalyticsShell on badge embed; SRP metrics in impact reporting pipeline.Getting Started
The SRP Listing Badge requires separate client access configuration and an embed snippet for your SRP template.
-
Confirm badge access. Your Carvia account team enables
srp-listing-badgewidget access on your client account. Active widget partners may already have access granted via the June 2026 migration — ask your account team to verify. - Ensure inventory import is running. Score warming depends on your inventory feed syncing regularly. Changed listings trigger automatic score cache updates. Without import, badges fall back to slower live resolves.
- Receive your embed snippet. Carvia provides the iframe embed code and batch API integration pattern for your SRP template. Your web team places one badge embed per listing card (or uses the batch API for client-side hydration).
- Configure batch hydration. For best performance, your SRP should call the batch resolve endpoint with all visible VINs, mileage, and listing prices in a single request — not individual per-card resolves.
- Verify verified domains. Cache warming runs per verified embed origin. Confirm your SRP domain is registered in your Carvia client portal so warm caches match your live traffic partition.
- Monitor in analytics. After launch, check your first impact email for SRP badge render and impression data. Confirm badges are appearing and shoppers are engaging.
- Pair with VDP carousel. The badge drives clicks; the Widget Carousel closes them. Ensure your VDP embed is current so the post-click experience matches the SRP promise.
The SRP Listing Badge extends Carvia trust to the moment shoppers are deciding where to click — turning your search results page from a commodity grid into a differentiated, data-backed shopping experience.