Unified Chat Platform

Comprehensive Metrics Dashboard

🎯 Command Center

Operational

Updated: --

📅 Time Range:

🔒 Security

📈 Total Requests

-- req/min

⚡ Latency (P95)

ms response time

✅ Success Rate

0 errors

💬 Active Sessions

in last 5 minutes

🪙 Tokens Used

in: -- / out: --

💵 Est. Cost

$0.00

~$0/day

🗄️ DB Pool

/ -- max

🤖 Anthropic Cache

/ -- max

🌐 HTTP Pool

-- max conn

⚡ Redis

-- max

Request Volume & Latency

Model Distribution

All Clients Usage

Client	Requests	Tokens	Cost	Last Active	Status
Loading...

Total Clients

Healthy

Warning

Critical

Client Health Overview

Client	Health Score	Requests	Avg Latency	Timeout Rate	Error Rate	Cost	Last Activity	Status
Loading...

Total Requests

Timeouts

Errors

Overall Error Rate

Error Timeline

Errors by Client

Recent Errors

Time	Client	Type	Latency	Message Preview
Loading...

Traffic Heatmap (Requests by Hour/Day)

Top Peak Hours

Top Peak Days

Requests This Week

Sessions This Week

Active Clients

Avg Latency (ms)

Week-over-Week Comparison

Requests

vs last week

Sessions

vs last week

Clients

vs last week

Latency

vs last week

Tokens

vs last week

Daily Trend (Last 14 Days)

Intent Distribution

Language Distribution

Select Clients to Compare:

Metric	Client 1	Client 2	Client 3
Select clients and click Compare

Total Services

Healthy

Degraded

Down

Total Services

With Activity (24h)

Lookback: Category:

All Services Usage (from Cloud Monitoring)

Service	Category	Requests	Avg Latency	Last Activity
Loading...

💬 Total Sessions

🟢 Active Sessions

📊 Avg Messages/Session

⏱️ Avg Duration

🚪 Abandonment Rate

single-message sessions

Message Distribution

Sessions by Client

💾 Cache Hit Rate

0 hits / 0 misses

🔍 RAG Usage Rate

0 RAG requests

💰 Haiku Savings

$0.00

0 Haiku requests

Model Routing Distribution

Avg Latency by Model

🎤 Voice-Enabled Rate

0 voice requests

📊 Total Audio Generated

-- MB

⚡ Avg TTS Latency

-- ms

📦 Avg Audio/Request

-- KB

Voice Usage by Client

Client	Voice Requests
No voice data yet

💵 Total Cost

$0.0000

$0 per request

⏰ Cost/Hour

$0.00

Cost Projections

Daily

$0.00

Weekly

$0.00

Monthly

$0.00

Cost by Model

Hourly Cost Trend

Cost by Client

Client	Cost
No cost data yet

✅ Success Rate

📝 Avg Response Length

-- chars

⏱️ Timeouts

0% timeout rate

🥶 Cold Starts

avg -- ms

Error Breakdown

Response Length Distribution

Recent Errors

Time	Client	Endpoint	Error
No recent errors

⚡ Requests/Second

📊 Last Minute

🟢 Active Sessions

Recent Activity by Client

Live Activity Feed

No recent activity

💬 Total Messages

👥 Unique Sessions

🏢 Unique Clients

⚡ Avg Latency

-- ms

🪙 Total Tokens In

🪙 Total Tokens Out

Lookback:

Client:

View:

Messages by Client

Hourly Message Trend

Recent Conversations

Time	Client	User Message	AI Response	Model	Latency
Loading...

📝 Total Submissions

⏳ Pending Review

needs attention

🔍 In Review

✅ Approved

🟢 Live

⏱️ Avg Review Time

-- hrs

Admin Key: Not set

Filter by Status:

+ New Onboarding

Onboarding Submissions

Business Name	Slug	Website	Status	Submitted	Actions
Loading...

🚨 Escalated

needs manual review

⏳ Pending

in queue

🔄 In Progress

✅ Completed

❌ Failed

📊 Total Jobs

🔑 API Key: Not set

📖 ONB-003: Manual Scraping Workflow

✅ Backend Deployed

What is this?

Jobs are escalated when our automated scraper (HTTP → Playwright → L7 proxy) cannot extract data from a bot-protected website. These jobs require manual intervention using Playwright MCP in Claude Code.

🔧 Workflow

Claim an escalated job from the table below

Use Playwright MCP in Claude Code:

mcp__playwright__browser_navigate → navigate to the URL
mcp__playwright__browser_snapshot → capture the page content

Extract business data (name, phone, hours, etc.)
Complete the job with extracted data, or Release it back to queue

🔌 API Endpoints (artemis-consolidated)

GET /admin/scraping/stats - Queue statistics
GET /admin/scraping/jobs/escalated - Jobs needing manual review
GET /admin/scraping/jobs/pending - Pending jobs
POST /admin/scraping/jobs/{id}/claim - Claim for manual processing
POST /admin/scraping/jobs/{id}/complete - Complete with extracted data
POST /admin/scraping/jobs/{id}/release - Release back to queue
POST /admin/scraping/jobs/{id}/retry - Queue for auto-retry

⚡ Quick Claim & Complete Example

# Claim a job
curl -X POST "https://artemis-consolidated-388610795169.us-east4.run.app/admin/scraping/jobs/{job_id}/claim" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"admin_id": "your-name"}'

# Complete with extracted data
curl -X POST "https://artemis-consolidated-388610795169.us-east4.run.app/admin/scraping/jobs/{job_id}/complete" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"extracted_data": {"business_name": "...", "phone": "...", "hours": {...}}}'

Escalated Jobs

Job ID	URL / Domain	Strategy	Retries	Status	Failure Reason	Assigned To	Created	Actions
Set API key and click Refresh

Total Orders

Pending

Confirmed

Expired

Client:

Status:

Tracking	Client	Customer	Service	Pickup	Status	Created	Actions
Click tab to load relay orders

Total Users

Sessions

Page Views

Active Now

Period: Service:

Services with GA4 Tracking

Service	Users	Sessions	Page Views	Bounce Rate	Avg Session	Active Now
Loading...

Top Traffic Sources

Select a service to view traffic sources

Top Pages

Select a service to view top pages

➕ Register New GA4 Service

Service Name (slug)

Display Name

GA4 Property ID (numeric)

GA4 Measurement ID

📊 Google Analytics 4 Integration

This dashboard pulls data directly from Google Analytics 4 via the Data API.

To add a new service:

Register the service using the form above
Go to Google Analytics Admin → Property Access Management
Add this service account as Viewer: 388610795169-compute@developer.gserviceaccount.com

Total Projects

API Configured

🔥

Heatmaps

📹

Session Recordings

Registered Clarity Projects

Service	Project ID	API Status	Dashboard	Actions
Loading...

➕ Register New Clarity Project

Service Name (slug)

Display Name

Clarity Project ID

API Token (optional)

🔥 Microsoft Clarity - Free Behavioral Analytics

Clarity provides session recordings, heatmaps, and user behavior insights at no cost.

To set up Clarity for a new service:

Go to clarity.microsoft.com and create a new project
Copy the Project ID from Settings
NEW: Generate an API token at Settings → Data Export → Generate new API token
Register the project using the form above (include API token for metrics)
Copy the tracking script and add it to your landing page

Features: Session recordings, Heatmaps (click, scroll, movement), Rage clicks, Dead clicks, Quick backs, and more!

API Metrics (NEW): With an API token, view Traffic, Users, UX Issues, Device breakdown directly in this dashboard!

Viewable Impressions

Engagement Rate

Avg Attention (sec)

Total Clicks

Period: Client:

Ad Creative Performance

Creative / Campaign	Impressions	Viewable (2s+)	Avg Attention	Interactions	Clicks	Engagement Score
No display ad tracking configured. See setup instructions below.

Attention Duration Distribution

Interaction Types

Top Placements by Attention

Data will appear after tracking is configured

Device Performance

Data will appear after tracking is configured

➕ Register New Ad Creative

Creative ID (slug)

Campaign Name

Client

Ad Size

🎯 Display Ad Performance Tracking

Track engagement quality metrics directly from your HTML5 display ads. Unlike basic impression/click tracking, this captures:

👁️ Viewability

Track when ads are actually seen (50%+ visible for 2+ seconds)

⏱️ Attention Duration

Measure how long users actively engage with your ad

🖱️ Interaction Depth

Track hovers, carousel swipes, video plays, and more

📊 Engagement Score

Composite quality metric to identify high-intent placements

Quick Start: Register a creative above to get the tracking code, then paste it into your HTML5 ad.

📚

API Docs

🔐

Client Portal

🛠️

Admin Tools

🚀

Deployment

🔐 Client Portal System

NEW - December 2025

The Client Portal allows your clients to view their chat performance metrics through a secure, bookmarkable URL.

How It Works

Admin creates an API key for a client using the admin endpoint
Client receives a URL: /portal/dashboard?key=portal_xxx
Client bookmarks this URL and can view their metrics anytime
All data is tenant-isolated - clients only see their own data

Portal Features

📊 Total conversations & messages with period comparison
📈 Activity trend chart (configurable: 7/14/30/90 days)
🏷️ Top conversation topics
💬 Recent conversation history
⏰ Peak usage hour detection

Admin Endpoints

POST /api/admin/portal/keys?client_id=laundryluv
GET  /api/admin/portal/keys
DELETE /api/admin/portal/keys/{id}

Quick Start: Create a Client Portal Key

# Create key for a client
curl -X POST "https://api.cwadagency.com/api/admin/portal/keys?client_id=laundryluv&display_name=LaundryLuv%20Portal"
# Response includes the API key (save it - only shown once!):
{
  "api_key": "portal_laundryluv_abc123...",
  "portal_url": "/portal/dashboard?key=portal_laundryluv_abc123..."
}

🔑 Portal Key Management

Client	Key Prefix	Display Name	Status	Last Used	Actions
Click Refresh to load keys

➕ Create New Portal Key

Client ID *

Display Name

Expires (days)

📡 API Reference

Method	Endpoint	Description
POST	`/api/chat/{client_id}/message`	Send chat message
GET	`/api/chat/{client_id}/health`	Client health check
GET	`/landing/{client_id}`	Serve client landing page
GET	`/portal/dashboard?key=xxx`	Client portal dashboard
GET	`/portal/api/metrics?key=xxx`	Portal metrics API
POST	`/api/admin/portal/keys`	Create portal API key
GET	`/api/admin/portal/keys`	List portal API keys
DELETE	`/api/admin/portal/keys/{id}`	Revoke portal API key
GET	`/health`	Platform health check
POST	`/api/admin/cache/flush`	Flush Redis cache

📖 Documentation Library

🚀 Getting Started

Quick start guide for new partners and clients.

Platform overview
Account setup
First chat widget integration

Read Guide →

➕ Adding New Tenants

Step-by-step guide for onboarding new clients.

Configuration setup
Knowledge base creation
Widget customization

Read Guide →

💬 Widget Integration

Embed the chat widget on any website.

Script installation
Customization options
Event callbacks

Read Guide →

🔌 API Reference

Complete API documentation for developers.

Chat endpoints
Portal API
Admin endpoints

Read Guide →

🛠️ Developer Handover

Complete technical docs for new developers.

Architecture & codebase
Environment setup
Deployment process

Read Guide →

🎯 Display Ads Tracking

Advanced HTML5 ad performance tracking.

Viewability & attention metrics
Engagement scoring
Implementation guide

Read Guide →

🏗️ Platform Architecture Documentation

NEW - January 2026

Comprehensive documentation for the entire Cullari & Wardell platform ecosystem - Artemis, Superior UI, Unified Chat, and all 71 Cloud Run services.

🏠 Platform Overview

Complete architecture overview and documentation index.

System architecture diagram
Technology stack
Quick reference

Read Documentation →

⚡ Artemis Backend API

AI-powered targeting with 4,260 segments.

Multi-model AI routing
API endpoints
Connection pool rules

Read Documentation →

📦 Services Inventory

All 71 Cloud Run services with URLs.

Core platform services
Chat agents (20+)
Landing pages (30+)

Read Documentation →

🚀 Deployment Guide

CI/CD procedures and rollback.

Deployment script usage
Protected services
Rollback procedures

Read Documentation →

🗄️ Database Schema

PostgreSQL tables and queries.

Core tables
Common queries
Connection setup

Read Documentation →

🏢 Artemis Accounts API

Centralized account database API.

143 accounts (Laundry, Artemis, CWAD)
GET, POST endpoints
Greenmen/Dorito IDs

Read Documentation →

🎯 Display Ads Performance Tracking Documentation

NEW - January 2026

Overview

The Display Ads Tracking system provides advanced performance insights beyond basic impressions and clicks. By embedding a tracking snippet in your HTML5 ads, you can measure viewability, attention duration, interaction depth, and calculate engagement scores that predict ad effectiveness.

Key Metrics Explained

Viewable Impressions

MRC-compliant: 50% of pixels visible for 1+ second. This is the industry standard for ad viewability.

Attention Duration

Total time the ad was in the active viewport. Higher attention = more brand recall opportunity.

Engagement Score (0-100)

Composite score based on attention time, hovers, clicks, and scroll depth. 70+ indicates high engagement.

Interaction Depth

Tracks hovers, clicks, and scroll activity within expandable/carousel ads.

Implementation Steps

Register Your Creative - Use the Display Ads tab to register a new ad creative with client ID, name, size, and campaign.
Get Tracking Code - After registration, copy the generated tracking snippet (JavaScript).
Embed in Your Ad - Paste the snippet inside your HTML5 ad, just before the closing </body> tag.
Add Container Attribute - Ensure your main ad container has data-ad-container attribute or is the parent of the script.
Deploy & Monitor - Publish your ad and view metrics in the Display Ads dashboard tab.

Tracking Code Example

<!-- Display Ad Tracking - [Your Creative Name] -->
<script>
(function() {
  var TC = "YOUR_TRACKING_CODE";  // Generated when you register
  var EP = "https://api.cwadagency.com/api/ads/track/display-ad";
  var sid = 'ad_' + Math.random().toString(36).substr(2, 9);

  // State tracking
  var state = {
    impressionSent: false,
    viewableStart: null,
    totalViewTime: 0,
    interactions: { hover: 0, click: 0, scroll: 0 }
  };

  // ... (full tracking code is auto-generated)
})();
</script>

Events Tracked

Event Type	Trigger	Data Collected
`load`	Page load complete	Load time in milliseconds
`viewable_impression`	50%+ visible for 1 second	View ratio percentage
`click`	User clicks the ad	Click coordinates, element type
`engagement`	Page unload/visibility change	Attention ms, hovers, clicks, scroll depth, engagement score

Engagement Score Calculation

The engagement score (0-100) is calculated as:

Attention: 1 point per 2 seconds of view time (max 30 points)
Hovers: 5 points per hover interaction (max 15 points)
Clicks: 20 points per click (max 40 points)
Scroll Depth: Up to 15 points based on scroll percentage

Score Interpretation: 0-30 = Low, 31-60 = Medium, 61-80 = High, 81+ = Excellent

API Endpoints

Method	Endpoint	Description
POST	`/api/dashboard/display-ads/register`	Register new creative, returns tracking code
GET	`/api/dashboard/display-ads?period=7d`	Get performance metrics
GET	`/api/dashboard/display-ads/clients`	List clients with ad creatives
POST	`/api/ads/track/display-ad`	Receive tracking events (auto-called by snippet)

Client Reporting Guide

When presenting metrics to clients, translate technical data into business value:

Viewability Rate

"X% of your ads were actually seen by users, not just served to bots or below-the-fold."

Average Attention

"Users spent an average of X seconds looking at your ad, which is Y% above industry benchmark."

Engagement Score

"Your creative achieved a score of X/100, indicating high user interest and interaction."

Top Placements

"Your ads performed best on [site X], suggesting audience alignment worth exploiting."

ℹ️ Platform Information

Service: unified-chat-platform

Region: us-east4

Support: support@cullarimedia.com

Request Volume & Latency

Model Distribution

All Clients Usage

Client Health Overview

Error Timeline

Errors by Client

Recent Errors

Traffic Heatmap (Requests by Hour/Day)

Top Peak Hours

Top Peak Days

Week-over-Week Comparison

Daily Trend (Last 14 Days)

Intent Distribution

Language Distribution

Client Comparison

All Services Usage (from Cloud Monitoring)

Message Distribution

Sessions by Client

Model Routing Distribution

Avg Latency by Model

Voice Usage by Client

Cost Projections

Cost by Model

Hourly Cost Trend

Cost by Client

Error Breakdown

Response Length Distribution

Recent Errors

Recent Activity by Client

Live Activity Feed

Messages by Client

Hourly Message Trend

Recent Conversations

Individual Messages

Onboarding Submissions

Submission Details

📖 ONB-003: Manual Scraping Workflow

What is this?

🔧 Workflow

🔌 API Endpoints (artemis-consolidated)

⚡ Quick Claim & Complete Example

Escalated Jobs

Complete Scrape Job

📋 Extracted Business Data

Services with GA4 Tracking

Top Traffic Sources

Top Pages

➕ Register New GA4 Service

Registered Clarity Projects

📊 Clarity Metrics - --

📱 Device Breakdown

🌐 Browser Breakdown

➕ Register New Clarity Project

Clarity Tracking Script

🔑 Update API Token

Ad Creative Performance

Attention Duration Distribution

Interaction Types

Top Placements by Attention

Device Performance

➕ Register New Ad Creative

HTML5 Ad Tracking Code

🔐 Client Portal System

How It Works

Portal Features

Admin Endpoints

Quick Start: Create a Client Portal Key

🔑 Portal Key Management

➕ Create New Portal Key

📡 API Reference

📖 Documentation Library

🏗️ Platform Architecture Documentation

🎯 Display Ads Performance Tracking Documentation

Overview

Key Metrics Explained

Implementation Steps

Tracking Code Example

Events Tracked

Engagement Score Calculation

API Endpoints