> ## Documentation Index
> Fetch the complete documentation index at: https://docs.signalbridgedata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Get started with SignalBridge in 10 minutes

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

<Steps>
  <Step title="Create Your Pixel">
    1. Go to your [SignalBridge Dashboard](https://www.signalbridgedata.com/dashboard)
    2. Click **"Create Pixel"**
    3. Enter your website domain (e.g., `yourbrand.com`)
    4. Choose a subdomain for tracking (e.g., `tracking.yourbrand.com`)
    5. Click **"Create"**

    <Note>
      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`).
    </Note>
  </Step>

  <Step title="Configure DNS">
    Add a CNAME record in your DNS provider pointing your subdomain to `pixel.signalbridgedata.com`.

    <CodeGroup>
      ```dns Cloudflare theme={null}
      Type: CNAME
      Name: tracking (or your chosen subdomain)
      Target: pixel.signalbridgedata.com
      Proxy: Enabled (orange cloud)
      TTL: Auto
      ```

      ```dns GoDaddy theme={null}
      Type: CNAME
      Host: tracking
      Points to: pixel.signalbridgedata.com
      TTL: 1 Hour
      ```

      ```dns Namecheap theme={null}
      Type: CNAME Record
      Host: tracking
      Value: pixel.signalbridgedata.com
      TTL: Automatic
      ```
    </CodeGroup>

    <Warning>
      DNS propagation can take up to 24 hours, but usually completes within 5-10 minutes.
    </Warning>
  </Step>

  <Step title="Install Tracking Code">
    Add this code to your website's `<head>` section, before any other scripts for more accurate blocking detection:

    <CodeGroup>
      ```html HTML theme={null}
      <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>
      ```

      ```jsx React/Next.js theme={null}
      // 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;
      }
      ```
    </CodeGroup>

    <Tip>
      Replace `YOUR_PIXEL_ID` with your actual Pixel ID from the dashboard.
    </Tip>
  </Step>

  <Step title="Track Your First Event">
    Track a conversion event (e.g., purchase, signup):

    ```javascript theme={null}
    // Track a purchase
    sb_track('Purchase', {
      value: 99.99,
      currency: 'USD',
      user_data: {
        email: 'customer@example.com',
        phone: '+1234567890'
      }
    });
    ```
  </Step>

  <Step title="Connect Ad Platforms">
    Connect your ad accounts in the dashboard to start sending server-side events.

    1. Go to **Dashboard → Pixels → Your Pixel → Integrations**
    2. Click **"Connect"** next to Facebook, Google Ads, TikTok, or GA4
    3. Follow the authorization prompts
  </Step>

  <Step title="Verify Setup">
    Check that everything is working using the dashboard or browser console.

    <Accordion title="Check DNS Configuration">
      ```bash theme={null}
      # Check if DNS is configured correctly
      nslookup tracking.yourbrand.com

      # Should return: pixel.signalbridgedata.com
      ```
    </Accordion>

    <Accordion title="Check Tracking Code">
      1. Open your website in a browser
      2. Open Developer Tools (F12)
      3. Go to Console tab
      4. Look for: `SignalBridge: Initialized with ID YOUR_PIXEL_ID`
    </Accordion>
  </Step>
</Steps>

## Common Issues

<AccordionGroup>
  <Accordion title="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
  </Accordion>

  <Accordion title="SSL certificate error">
    **Cause:** DNS not propagated yet or SSL not provisioned

    **Solution:**

    * Wait 5-10 minutes for DNS propagation
    * SSL certificates are auto-provisioned within 15 minutes
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Track Custom Events" icon="code" href="/development">
    Learn how to track custom events
  </Card>

  <Card title="View Analytics" icon="chart-line" href="https://www.signalbridgedata.com/dashboard">
    See your conversion data
  </Card>
</CardGroup>
