Conversion Destinations

track('purchase', { value: 99.99 })
       ↓
  Analytics Service
       ↓
  ┌────┴────┐
  ↓         ↓
Internal   Destinations
Storage    ├── Google Ads Offline Conversions
           ├── Meta Conversions API
           └── TikTok Events API

import { useAnalytics } from '@sylphx/sdk/react'

function CheckoutSuccess({ order }) {
  const { track } = useAnalytics()

  useEffect(() => {
    // Click IDs (gclid, fbclid, ttclid) are auto-captured from URL
    // User data (email, name) is auto-enriched from auth state
    track('purchase', {
      value: order.total,
      orderId: order.id,
    }, {
      destinations: ['google_ads', 'meta'],
      conversion: {
        value: order.total,
        currency: 'USD',
        orderId: order.id,
        // clickId, userEmail, userFirstName, userLastName
        // are all automatically included!
      }
    })
  }, [order])

  return <div>Thank you!</div>
}

import { useConversionTracking } from '@sylphx/sdk/react'

function CheckoutSuccess({ order }) {
  const { trackConversion, clickIds, primaryClickId } = useConversionTracking()

  useEffect(() => {
    // Simplest conversion tracking - auto-enriched with click IDs and user data
    trackConversion('purchase', {
      value: order.total,
      currency: 'USD',
      orderId: order.id,
    })
  }, [order])

  // Optional: Check if user came from ads
  if (primaryClickId) {
    console.log('User came from ad campaign')
  }

  return <div>Thank you!</div>
}

import { useAnalytics } from '@sylphx/sdk/react'

const { track } = useAnalytics()

// Override auto-enriched values
track('purchase', {
  value: 99.99,
  orderId: 'ORDER-123',
}, {
  destinations: ['google_ads'],  // Only forward to Google Ads
  conversion: {
    clickId: customClickId,      // Override auto-captured click ID
    userEmail: customEmail,       // Override auth state email
    userPhone: '+1234567890',     // Add phone (not in auth state)
    value: 99.99,
    currency: 'USD',
    orderId: 'ORDER-123',
  }
})

// Skip destinations entirely
track('internal_event', { data: '...' }, {
  skipDestinations: true
})

const { trackConversion } = useConversionTracking()

// Override auto-enrichment and specify destinations
trackConversion('purchase', {
  value: 99.99,
  currency: 'USD',
  orderId: 'ORDER-123',
}, {
  clickId: customClickId,         // Override click ID
  userEmail: customEmail,          // Override email
  destinations: ['google_ads'],    // Only forward to these destinations
})

Required credentials:
• Client ID (OAuth)
• Client Secret
• Refresh Token
• Customer ID (e.g., 123-456-7890)
• Conversion Action ID

Required credentials:
• System User Access Token
• Pixel ID

Required credentials:
• Access Token
• Pixel Code

Destination: Google Ads
├── Auto-forward: ✓ Enabled
├── Event filter: purchase, signup, add_to_cart
└── All events matching filter are forwarded automatically

// With auto-forward configured, this automatically goes to destinations
// Click IDs and user data are auto-enriched
track('purchase', {
  value: 99.99,
  orderId: 'ORDER-123',
})

// Skip auto-forward for specific events
track('internal_event', { data: '...' }, {
  skipDestinations: true  // Won't forward to any destination
})