Quick Start

This guide will help you set up SignalBridge and start tracking events in about 10 minutes.

Create Your Pixel

Go to your SignalBridge Dashboard
Click “Create Pixel”
Enter your website domain (e.g., yourbrand.com)
Choose a subdomain for tracking (e.g., tracking.yourbrand.com)
Click “Create”

Your tracking subdomain should be on the same root domain as your website for best results (e.g., if your site is example.com, use tracking.example.com).

Configure DNS

Add a CNAME record in your DNS provider pointing your subdomain to pixel.signalbridgedata.com.

Type: CNAME
Name: tracking (or your chosen subdomain)
Target: pixel.signalbridgedata.com
Proxy: Enabled (orange cloud)
TTL: Auto

Type: CNAME
Host: tracking
Points to: pixel.signalbridgedata.com
TTL: 1 Hour

Type: CNAME Record
Host: tracking
Value: pixel.signalbridgedata.com
TTL: Automatic

DNS propagation can take up to 24 hours, but usually completes within 5-10 minutes.

Install Tracking Code

Add this code to your website’s <head> section, before any other scripts for more accurate blocking detection:

<script>
  (function() {
    window.sb_queue = window.sb_queue || [];
    window.sb_track = function(e, d) { 
      window.sb_queue.push({event: e, data: d}); 
    };
    
    // Initialize with your Pixel ID
    sb_track('init', 'YOUR_PIXEL_ID');
    
    // Track page view
    sb_track('PageView');
    
    // Load the tracking script
    var script = document.createElement('script');
    script.src = 'https://tracking.yourbrand.com/pixel.js';
    script.async = true;
    document.head.appendChild(script);
  })();
</script>

// components/SignalBridge.tsx
'use client'; // For Next.js 13+ App Router

import { useEffect } from 'react';

export default function SignalBridge() {
  useEffect(() => {
    // Initialize SignalBridge
    window.sb_queue = window.sb_queue || [];
    window.sb_track = function(e, d) { 
      window.sb_queue.push({event: e, data: d}); 
    };
    
    // Initialize with your Pixel ID
    window.sb_track('init', 'YOUR_PIXEL_ID');
    
    // Track page view
    window.sb_track('PageView');
    
    // Load the tracking script
    const script = document.createElement('script');
    script.src = 'https://tracking.yourbrand.com/pixel.js';
    script.async = true;
    document.head.appendChild(script);
  }, []);

  return null;
}

Replace YOUR_PIXEL_ID with your actual Pixel ID from the dashboard.

Track Your First Event

Track a conversion event (e.g., purchase, signup):

// Track a purchase
sb_track('Purchase', {
  value: 99.99,
  currency: 'USD',
  user_data: {
    email: 'customer@example.com',
    phone: '+1234567890'
  }
});

Connect Ad Platforms

Connect your ad accounts in the dashboard to start sending server-side events.

Go to Dashboard → Pixels → Your Pixel → Integrations
Click “Connect” next to Facebook, Google Ads, TikTok, or GA4
Follow the authorization prompts

Verify Setup

Check that everything is working using the dashboard or browser console.

Check DNS Configuration

# Check if DNS is configured correctly
nslookup tracking.yourbrand.com

# Should return: pixel.signalbridgedata.com

Check Tracking Code

Open your website in a browser
Open Developer Tools (F12)
Go to Console tab
Look for: SignalBridge: Initialized with ID YOUR_PIXEL_ID

Common Issues

Events not showing in dashboard

Possible causes:

DNS not configured correctly
Pixel ID is wrong
Tracking code not installed

Solution:

Check DNS with nslookup tracking.yourbrand.com
Verify Pixel ID in dashboard

SSL certificate error

Cause: DNS not propagated yet or SSL not provisionedSolution:

Wait 5-10 minutes for DNS propagation
SSL certificates are auto-provisioned within 15 minutes

Next Steps

Track Custom Events

Learn how to track custom events

View Analytics

See your conversion data

Getting Started

Concepts

Integrations

Features

Guides

Common Issues

Next Steps

Track Custom Events

View Analytics

​Common Issues

​Next Steps

Track Custom Events

View Analytics

Common Issues

Next Steps