| Stage | Sessions | % of Visitors | To Next | Drop-off |
|---|---|---|---|---|
| Loading data... | ||||
utm_source and utm_medium parameters.
| Source / Medium | Sessions | % Traffic |
|---|---|---|
| Loading data... | ||
| Page Path | Views | Unique |
|---|---|---|
| Loading data... | ||
| Event Name | Count | Last Fired |
|---|---|---|
| Loading data... | ||
System Overview
Home2Smart uses a comprehensive tracking system powered by Supabase to capture, analyze, and optimize every user interaction across our digital ecosystem. All data flows directly to the database with intelligent business entity linking.
2384221445259822Tracking API:
https://h2s-backend-nrgjyhn31-tabari-ropers-projects-6f2e090b.vercel.app/api/trackDatabase:
Supabase (PostgreSQL)Tables:
h2s_tracking_visitors, h2s_tracking_sessions, h2s_tracking_events, h2s_tracking_funnel_attribution
Conversion Funnel Structure
Our 5-stage funnel tracks users from initial awareness to loyal customers:
- Visitor -> First interaction with any page (PageView event)
- Browser -> Engaged viewing (ViewContent event, 3+ seconds on page)
- Engaged -> Multiple pages visited or interaction events (CTA clicks, chat opens)
- Lead -> Contact form submission or phone click (Lead event)
- Customer -> Completed purchase (Purchase event with value)
Tracked Pages & Events
Homepage (homev2.html)
- Page Type:
homeorlanding_page - Events: PageView, ViewContent ("Home Landing Page"), Lead (form), Contact (phone click)
- UTM Tracking: Yes (all parameters captured)
- Advanced Matching: Email, phone, name (when form submitted)
Shop (shop.html)
- Page Type:
shoporproduct - Events: PageView, ViewContent (per product), AddToCart, InitiateCheckout
- Product Tracking: content_name, content_ids, value, currency
- Advanced Matching: Full user data on checkout
Security (securityv3.html)
- Page Type:
securityorservice - Events: PageView, ViewContent (delayed 3s), Lead, Contact
- Service Tracking: content_name = "Security Installations"
- CTA Tracking: All button clicks tracked
TV Mounting (tvmountingv3.html)
- Page Type:
tvmountingorservice - Events: PageView, ViewContent, wizard step tracking
- Special: Multi-step funnel with step completion events
Smart Integrations (smart.html)
- Page Type:
automationsorsmart - Events: PageView, ViewContent, service interest tracking
- Focus: High-value automation packages
UTM Parameter Structure
All campaigns must include these parameters for proper attribution:
?utm_source=[source] &utm_medium=[medium] &utm_campaign=[campaign_name] &utm_content=[ad_creative_id] &utm_term=[keyword]
UTM Source Values:
google- Google Adsfacebookormeta- Facebook/Instagram Adsemail- Email campaignsdirect- Direct traffic (no UTM)organic- Organic search
UTM Medium Values:
cpc- Cost-per-click adssocial- Social media organic/paidemail- Email marketingdisplay- Display advertisingvideo- Video ads (YouTube, etc.)
Meta Pixel Event Catalog
Standard Events We Track:
- PageView - Every page load (automatic)
- ViewContent - Product/service page views (3s engagement)
- Lead - Form submissions, phone clicks
- Contact - Direct contact interactions
- AddToCart - Product added to cart (shop only)
- InitiateCheckout - Checkout process started
- Purchase - Completed transaction with value
Custom Events:
- ChatWidget_Open - User opens chat
- CTA_Click - Call-to-action button clicked
- Step_[N]_Complete - Wizard step completion (TV mounting)
Campaign Setup Best Practices
seedAllTrackingData() in Apps Script to verify dashboard displays correctly.
For Google Ads:
- Use
utm_source=google - Set
utm_medium=cpc - Campaign name should describe objective:
utm_campaign=smart_home_nc_search - Use
utm_term={keyword}for dynamic keyword insertion - Track final URL in Ad Group settings
For Facebook/Instagram Ads:
- Use
utm_source=facebook(or instagram for IG-specific) - Set
utm_medium=socialorutm_medium=cpc - Campaign name:
utm_campaign=smart_lighting_promo_nc - Use
utm_content={{ad.id}}for ad-level tracking - Meta Pixel will automatically capture with Advanced Matching
Landing Page Best Practices:
- Always direct to
homev2.htmlfor general awareness - Use
shop.htmlfor product-specific campaigns - Use service pages (security, tvmounting, smart) for targeted service campaigns
- Include UTM parameters in ALL ad links
- Test links with
?test=1parameter to verify tracking fires
AI Campaign Briefing Prompt
Copy this prompt to use with ChatGPT/Claude when planning new campaigns:
You are a performance marketing expert for Home2Smart, a smart home installation company serving North Carolina and South Carolina. BUSINESS CONTEXT: - Services: Smart home automation, security systems, TV mounting, lighting control - Target Market: NC & SC homeowners, 35-65 years old, household income $75k+ - Unique Value: Professional installation, local expertise, 24/7 support - Service Area: Charlotte, Raleigh, Charleston, Columbia, Greensboro (+ surrounding areas) TRACKING INFRASTRUCTURE: - Meta Pixel ID: 2384221445259822 - We track 5-stage funnel: Visitor -> Browser -> Engaged -> Lead -> Customer - All pages have Meta Pixel + Google Apps Script tracking - Dashboard auto-refreshes every 30 seconds with real-time data TRACKED PAGES: 1. Homepage (homev2.html) - General awareness, page_type: "home" 2. Shop (shop.html) - Product catalog, page_type: "shop" 3. Security (securityv3.html) - Security services, page_type: "security" 4. TV Mounting (tvmountingv3.html) - TV installation wizard, page_type: "tvmounting" 5. Smart Integrations (smart.html) - Automation packages, page_type: "automations" UTM STRUCTURE REQUIRED: ?utm_source=[google/facebook/email/direct] &utm_medium=[cpc/social/email/display] &utm_campaign=[descriptive_campaign_name] &utm_content=[ad_creative_id] &utm_term=[keyword_or_targeting] TRACKED EVENTS: - PageView (all pages, automatic) - ViewContent (3+ seconds engagement) - Lead (form submission, phone click) - Contact (direct interactions) - AddToCart (shop only) - Purchase (conversion with value) CAMPAIGN OBJECTIVES: [Specify your goal: Awareness / Lead Generation / Sales / Service Promotion] TARGET AUDIENCE: [Define demographics, interests, behaviors] BUDGET & TIMELINE: [Budget amount and campaign duration] CREATIVE REQUIREMENTS: [Ad formats needed: image/video/carousel, copy angles, CTAs] YOUR TASK: Create a comprehensive campaign strategy including: 1. Campaign structure (campaigns > ad sets > ads) 2. Audience targeting recommendations 3. Ad copy variations (headlines, descriptions, CTAs) 4. Landing page assignment per ad set 5. Complete UTM tracking URLs for each ad 6. Budget allocation recommendations 7. Success metrics and KPIs to monitor in dashboard 8. A/B testing plan Ensure all tracking URLs follow our UTM structure and align with our funnel stages.
Dashboard Metrics Explained
Meta Pixel Performance Section:
- Total Pixel Events: All events fired (PageView + ViewContent + Lead + etc.)
- Unique Users: Distinct individuals tracked (via User_ID or External_ID)
- Top Content by Engagement: Event type with most fires (usually PageView)
- Total Conversion Value: Sum of all Purchase event values
Event Type Distribution:
Shows breakdown of all Meta Pixel events by type. Healthy distribution:
- PageView: 60-70% (highest - every page loads)
- ViewContent: 20-30% (engaged users)
- Lead: 5-10% (qualified prospects)
- Purchase: 1-3% (conversions)
Page Type Performance:
Shows which pages drive most engagement. Use this to optimize ad targeting:
- High
hometraffic = Good top-of-funnel awareness - High
shoptraffic = Product interest, optimize checkout - High
security/tvmounting= Service-specific demand
Traffic Source Attribution:
Tracks performance by utm_source. Use this to allocate budget:
- Compare cost-per-lead across sources
- Identify highest-converting traffic sources
- Adjust budget allocation monthly
Quick Reference Links
- Supabase Dashboard: View Database
- Tracking Events Table: Query
h2s_tracking_eventsin Supabase SQL Editor - Funnel Attribution: Query
h2s_tracking_funnel_attributionfor conversion data - Meta Events Manager: View in Facebook
Testing Commands
Use these curl commands or test in browser console:
# Test tracking endpoint health
curl https://h2s-backend-nrgjyhn31-tabari-ropers-projects-6f2e090b.vercel.app/api/track-ping
# Send a test event
curl -X POST https://h2s-backend-nrgjyhn31-tabari-ropers-projects-6f2e090b.vercel.app/api/track \
-H 'Content-Type: application/json' \
-d '{
"event": "test_event",
"visitor_id": "test-visitor-123",
"session_id": "test-session-123",
"page_url": "https://home2smart.com/test",
"page_path": "/test",
"metadata": {"test": true}
}'
# Query events in Supabase SQL Editor:
SELECT * FROM h2s_tracking_events
ORDER BY occurred_at DESC
LIMIT 100;
# Query funnel attribution:
SELECT * FROM h2s_tracking_funnel_attribution
WHERE conversion_type = 'purchase'
ORDER BY converted_at DESC;
seedAllTrackingData() before presenting dashboard to clients or stakeholders. It populates realistic data so you can demonstrate functionality and insights.
Copy these URLs directly into your ad sets. All parameters auto-populate from your campaign.
Facebook/Instagram Ads:
https://shop.home2smart.com/bundles.html?utm_source=facebook&utm_medium=cpc&utm_campaign={{campaign.name}}&utm_content={{ad.id}}&utm_term={{adset.name}}
All parameters auto-populate from Facebook. Zero manual work.
Google Ads:
https://shop.home2smart.com/bundles.html?utm_source=google&utm_medium=cpc&utm_campaign={campaignid}&utm_content={creative}&utm_term={keyword}
All parameters auto-populate from Google Ads. Zero manual work.
Base URLs (No UTM):
- Bundles Shop - https://shop.home2smart.com/bundles.html
- Homepage - https://home2smart.com/
- TV Mounting Wizard - https://home2smart.com/tvmounting
Support & Troubleshooting
- Dashboard not updating? Check Auto-Refresh is enabled (30s default)
- Page Type showing "No Data"? Ensure pages send
page_typefield in payload - UTM not tracking? Verify URLs include
?before utm_source (not&) - Meta Pixel not firing? Check browser console (F12) for
fbq(...)logs - Events not appearing? Check Supabase
h2s_tracking_eventstable directly
AI AI-Powered Marketing Insights
Meta Pixel Performance Loading...
Analytics Context & Performance
Event Type Distribution
Page Type Performance
Traffic Source Attribution
Key Performance Indicators
Conversion Funnel
Analytics Charts
Revenue Over Time
Traffic by Device
Top Customers by Lifetime Value
| Total Orders | Lifetime Revenue | Last Purchase | Status |
|---|