Tracking Conversions

Overview

Click counts tell you which A/B test variant attracted more visitors. Conversion tracking tells you which variant actually drove revenue or leads. This guide covers how to send conversion events from your partner site to TyrionURL using your API key.

Prerequisites

Before setting up conversion tracking:

✅ You have created an A/B test on a TyrionURL short link
✅ You have generated an API key in Settings
✅ You have access to add code to the landing page or checkout confirmation page on your partner site

How Conversion Tracking Works

User clicks TyrionURL short link
     ↓
TyrionURL assigns them to Variant A or B
     ↓
User lands on the variant's destination page
     ↓
User completes a purchase / form / sign-up
     ↓
Partner site sends conversion event to TyrionURL API
     ↓
TyrionURL attributes the conversion to the variant
     ↓
Data appears in your A/B test analytics

Sending a Conversion Event

On your confirmation page (order thank-you page, lead form success page, etc.), make a server-side API call to TyrionURL:

const response = await fetch('https://api.tyrionurl.com/api/abtest/convert', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${process.env.TYRIONURL_API_KEY}`
  },
  body: JSON.stringify({
    shortCode: 'your-short-code',   // The short code of the A/B tested link
    eventType: 'purchase',          // 'purchase' | 'lead' | 'signup'
    revenue: 49.99,                 // Optional: revenue amount in your currency
    currency: 'USD',                // Optional: ISO 4217 currency code
    metadata: {                     // Optional: any additional context
      orderId: 'ORD-12345',
      productId: 'prod-abc'
    }
  })
});

import requests
import os

response = requests.post(
    'https://api.tyrionurl.com/api/abtest/convert',
    headers={
        'Content-Type': 'application/json',
        'Authorization': f'Bearer {os.environ["TYRIONURL_API_KEY"]}'
    },
    json={
        'shortCode': 'your-short-code',
        'eventType': 'purchase',
        'revenue': 49.99,
        'currency': 'USD',
        'metadata': {
            'orderId': 'ORD-12345'
        }
    }
)

$response = file_get_contents('https://api.tyrionurl.com/api/abtest/convert', false, stream_context_create([
    'http' => [
        'method' => 'POST',
        'header' => [
            'Content-Type: application/json',
            'Authorization: Bearer ' . getenv('TYRIONURL_API_KEY')
        ],
        'content' => json_encode([
            'shortCode' => 'your-short-code',
            'eventType' => 'purchase',
            'revenue' => 49.99,
            'currency' => 'USD'
        ])
    ]
]));

Always send conversion events from server-side code (not client-side JavaScript) to protect your API key from being exposed in browser source code.

TODO: Needs Product Verification — Confirm the exact conversion API endpoint path, request schema, and supported eventType values with the TyrionURL engineering team.

Conversion Event Fields

Field	Type	Required	Description
`shortCode`	string	Yes	The short code of the A/B tested link that referred the visitor
`eventType`	string	Yes	Type of conversion: `purchase`, `lead`, or `signup`
`revenue`	number	No	Revenue value associated with the conversion
`currency`	string	No	ISO 4217 currency code (e.g., `USD`, `INR`, `EUR`)
`metadata`	object	No	Any additional key-value pairs for your own reference

Passing the Short Code Through Your Funnel

For TyrionURL to attribute the conversion to the correct variant, your landing page needs to know which short code referred the visitor. The recommended approach is to append the short code as a URL parameter when linking from TyrionURL: Example destination URL in Variant A:

https://yourstore.com/landing?ref=tyrion&sc=summer-sale

Your landing page reads the sc parameter and passes it through your checkout flow (via a hidden form field or session cookie) to the confirmation page, where the conversion event is sent.

Viewing Conversion Data

After conversion events are flowing, view results in your link’s A/B test analytics panel:

Metric	Description
Conversions per variant	Count of conversion events per destination URL
Revenue per variant	Sum of revenue values attributed to each variant
Conversion rate	Conversions ÷ Clicks for each variant
Revenue per click	Total revenue ÷ Total clicks per variant

A/B test results with conversion and revenue data

Best Practices

Start sending conversion events from day one of an A/B test — retroactive attribution isn’t possible for past clicks.

Use the metadata field to store order IDs so you can cross-reference TyrionURL conversions with your own order management system.

Only fire the conversion event on confirmed completions (e.g., order confirmation page) — not on button clicks or form starts.

A/B Testing Setup

Configure your split test before tracking.

API Keys

Generate and manage your integration credentials.

Introduction

Getting Started

URL Shortening

Link Management

Analytics

A/B Testing

QR Codes

Bio Pages

Products

Custom Domains

Account & Settings

Tracking Conversions

Overview

Prerequisites

How Conversion Tracking Works

Sending a Conversion Event

Conversion Event Fields

Passing the Short Code Through Your Funnel

Viewing Conversion Data

Best Practices

A/B Testing Setup

API Keys

​Overview

​Prerequisites

​How Conversion Tracking Works

​Sending a Conversion Event

​Conversion Event Fields

​Passing the Short Code Through Your Funnel

​Viewing Conversion Data

​Best Practices

​Related Pages

A/B Testing Setup

API Keys

Overview

Prerequisites

How Conversion Tracking Works

Sending a Conversion Event

Conversion Event Fields

Passing the Short Code Through Your Funnel

Viewing Conversion Data

Best Practices

Related Pages