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.

Conversion Funnel Structure

Our 5-stage funnel tracks users from initial awareness to loyal customers:

1. Visitor -> First interaction with any page (PageView event)
2. Browser -> Engaged viewing (ViewContent event, 3+ seconds on page)
3. Engaged -> Multiple pages visited or interaction events (CTA clicks, chat opens)
4. Lead -> Contact form submission or phone click (Lead event)
5. Customer -> Completed purchase (Purchase event with value)

Tracked Pages & Events

Homepage (homev2.html)

• Page Type: home or landing_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: shop or product
• 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: security or service
• 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: tvmounting or service
• Events: PageView, ViewContent, wizard step tracking
• Special: Multi-step funnel with step completion events

Smart Integrations (smart.html)

• Page Type: automations or smart
• 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 Ads
• facebook or meta - Facebook/Instagram Ads
• email - Email campaigns
• direct - Direct traffic (no UTM)
• organic - Organic search

UTM Medium Values:

• cpc - Cost-per-click ads
• social - Social media organic/paid
• email - Email marketing
• display - Display advertising
• video - 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

For Google Ads:

1. Use utm_source=google
2. Set utm_medium=cpc
3. Campaign name should describe objective: utm_campaign=smart_home_nc_search
4. Use utm_term={keyword} for dynamic keyword insertion
5. Track final URL in Ad Group settings

For Facebook/Instagram Ads:

1. Use utm_source=facebook (or instagram for IG-specific)
2. Set utm_medium=social or utm_medium=cpc
3. Campaign name: utm_campaign=smart_lighting_promo_nc
4. Use utm_content={{ad.id}} for ad-level tracking
5. Meta Pixel will automatically capture with Advanced Matching

Landing Page Best Practices:

• Always direct to homev2.html for general awareness
• Use shop.html for product-specific campaigns
• Use service pages (security, tvmounting, smart) for targeted service campaigns
• Include UTM parameters in ALL ad links
• Test links with ?test=1 parameter 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 home traffic = Good top-of-funnel awareness
• High shop traffic = 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_events in Supabase SQL Editor
• Funnel Attribution: Query h2s_tracking_funnel_attribution for 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;

https://shop.home2smart.com/bundles.html?utm_source=facebook&utm_medium=cpc&utm_campaign={{campaign.name}}&utm_content={{ad.id}}&utm_term={{adset.name}}

https://shop.home2smart.com/bundles.html?utm_source=google&utm_medium=cpc&utm_campaign={campaignid}&utm_content={creative}&utm_term={keyword}

Support & Troubleshooting

• Dashboard not updating? Check Auto-Refresh is enabled (30s default)
• Page Type showing "No Data"? Ensure pages send page_type field 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_events table directly