Skip to main content

Conversion Tracking

Track when users complete valuable actions (purchases, sign-ups, etc.) after clicking your links.

How It Works

  1. Enable conversion tracking on your link
  2. A unique click_id is appended to the destination URL
  3. When a conversion happens, send the click_id back to Linquid
  4. Linquid attributes the conversion to the original click

Setup

{
  "conversionTracking": true,
  "trackingType": "pixel"  // or "s2s"
}

Destination URL Transformation

Your destination URL:
https://example.com/product?utm_source=email
Becomes:
https://example.com/product?utm_source=email&click_id=lw_ck_abc123

Tracking Methods

JavaScript SDK (Pixel)

Add to your conversion page:
<script src="https://cdn.linquid.io/pixel.js"></script>
<script>
  // Basic conversion
  linquid.track('conversion');

  // With value
  linquid.track('conversion', {
    value: 99.99,
    currency: 'USD'
  });

  // Custom event
  linquid.track('signup', {
    plan: 'pro'
  });
</script>

Server-to-Server (S2S)

Send conversions from your server:
curl -X POST https://api.linquid.io/conversions/s2s \
  -H "Content-Type: application/json" \
  -d '{
    "click_id": "lw_ck_abc123",
    "event": "purchase",
    "value": 99.99,
    "currency": "USD",
    "order_id": "ORD-12345"
  }'
Response:
{
  "success": true,
  "data": {
    "conversionId": "conv_xyz789",
    "attributed": true,
    "linkId": "link_abc123",
    "campaignId": "campaign_def456"
  }
}

Conversion Events

Track different types of conversions:
EventDescription
conversionGeneric conversion
purchaseCompleted purchase
signupUser registration
leadLead form submission
installApp installation
customCustom event

Revenue Tracking

Include revenue data:
linquid.track('purchase', {
  value: 149.99,
  currency: 'USD',
  orderId: 'ORD-12345',
  items: [
    { sku: 'WIDGET-1', price: 49.99, quantity: 2 },
    { sku: 'GADGET-2', price: 50.01, quantity: 1 }
  ]
});

Attribution Window

Conversions are attributed within:
  • 7 days - Default window
  • 30 days - Pro plans
  • Custom - Enterprise plans

Deduplication

Prevent duplicate conversions:
linquid.track('purchase', {
  value: 99.99,
  orderId: 'ORD-12345'  // Unique per order
});
The orderId prevents the same conversion from being counted twice.

Postback URLs

For affiliate networks, configure postback URLs:
https://network.com/postback?click_id={click_id}&amount={value}
Placeholders:
  • {click_id} - Original click ID
  • {value} - Conversion value
  • {currency} - Currency code
  • {event} - Event type
  • {timestamp} - Unix timestamp

Analytics

View conversion data in the dashboard:
  • Conversion rate by link/campaign
  • Revenue and ROI
  • Top converting sources
  • Conversion funnel visualization

Best Practices

Server-to-server tracking is more reliable than pixel tracking, especially with ad blockers.
Prevents duplicate conversions and enables refund handling.
Track the full funnel: page view → signup → trial → purchase.