Link Management

Create links that work smarter. Build A/B testing campaigns with geo-routing, automatic winner detection, and conversion tracking—all from one simple dashboard.

Create your first smart link — Free 14-day trial

---

Creating Links

Basic A/B Test

The simplest way to test two destinations:

1. Click "New Link" in your dashboard
2. Enter a descriptive name
3. Add two variants:
   • Variant A (Control): Your current landing page
   • Variant B: Your new test page
4. Set weights to 50/50 for equal traffic split
5. Create the link

Example:

Name: Homepage Headline Test
Slug: headline-test

Variant A:
  Label: control
  URL: https://example.com/home
  Weight: 50%

Variant B:
  Label: new_headline
  URL: https://example.com/home-new
  Weight: 50%

Custom Slugs

Choose memorable, branded URLs:

• klinky.io/summer-sale
• klinky.io/webinar-jan
• klinky.io/qr-menu

Tips:

• Keep it short for easy sharing
• Use hyphens for readability
• Avoid special characters
• Check availability before announcing

Multiple Variants

Test up to 5 variants simultaneously:

Variant A: 40% (control)
Variant B: 20% (test 1)
Variant C: 20% (test 2)
Variant D: 20% (test 3)

Use cases:

• Testing multiple headlines
• Comparing different offers
• Evaluating pricing pages

---

Variant Configuration

Traffic Weights

Distribute traffic according to your risk tolerance:

Strategy	Weights	Best For
Equal	50/50	Confident tests
Conservative	90/10	Risky changes
Moderate	70/30	Balanced approach
Multi-variant	40/30/30	Exploring options

Important: Weights must sum to exactly 100%.

Variant Labels

Use clear, descriptive labels:

• Good: control, green_cta, shorter_form
• Avoid: a, b, variant1, test

Labels appear in analytics and help you identify performance at a glance.

Destination URLs

Requirements:

• Must be valid URLs (http:// or https://)
• Maximum 2048 characters
• Should be publicly accessible
• Avoid redirect chains

Tip: Test your URLs before creating the link to ensure they work.

---

Geo-Routing

Send visitors to location-appropriate destinations.

Use Cases

Regional Stores

US visitors → US store (USD pricing)
UK visitors → UK store (GBP pricing)
EU visitors → EU store (EUR pricing)
Others → Global store

Language Localization

ES, MX, AR visitors → Spanish site
FR, BE, CH visitors → French site
DE, AT, CH visitors → German site
Others → English site

Compliance

EU visitors → GDPR-compliant page
CA visitors → CCPA-compliant page
Others → Standard page

Setting Up Geo-Routing

1. Create a new link
2. Change "Routing Type" to "Geo"
3. Add variants for each region
4. Configure geo rules:

{
  "US": "us_store",
  "CA": "us_store",
  "GB": "uk_store",
  "DE": "eu_store",
  "FR": "eu_store",
  "default": "global_store"
}

Requirements:

• Use ISO 3166-1 alpha-2 country codes (2 letters)
• Must include a default variant
• All referenced variants must exist

Country Code Reference

Common codes:

Code	Country	Code	Country
US	United States	GB	United Kingdom
CA	Canada	DE	Germany
AU	Australia	FR	France
JP	Japan	ES	Spain
BR	Brazil	IT	Italy
IN	India	NL	Netherlands

Full list of ISO country codes

---

Auto-Winner Detection

Automatically optimize traffic distribution based on performance.

How It Works

1. Traffic splits according to your weights
2. Klinky tracks conversions for each variant
3. When one variant significantly outperforms others:
   • Statistical significance is calculated
   • Winner is declared
   • 100% of traffic routes to winner

Configuration

Enable Auto-Winner:

1. Edit your link
2. Check "Auto-detect winner"
3. Set threshold (minimum clicks before declaring)
4. Save

Threshold Guidelines:

Conversion Rate	Recommended Threshold
1-2%	500+ clicks
3-5%	200+ clicks
5-10%	100+ clicks
10%+	50+ clicks

Higher thresholds reduce false positives but take longer to reach a decision.

Understanding Statistical Significance

Klinky uses statistical methods to ensure winners are real, not random fluctuations:

• Confidence level: 95% (industry standard)
• Minimum detectable effect: Varies by traffic
• Test duration: At least one full business cycle

Manual Winner Selection

If you prefer to analyze results yourself:

1. Review analytics regularly
2. Compare conversion rates
3. Consider secondary metrics (revenue, engagement)
4. Manually adjust weights or pause underperformers

---

Managing Links

Activating and Pausing

Control link availability:

• Active: Link works normally
• Paused: Visitors see "Link unavailable" page

Use cases:

• Seasonal campaigns (pause off-season)
• Limited-time offers
• Maintenance windows

Editing Links

You can modify:

• Link name
• Variant URLs
• Traffic weights
• Auto-winner settings
• Geo rules

Cannot change:

• Slug (would break existing shares)
• Variant IDs (would affect analytics continuity)

Deleting Links

Deleting a link:

• Makes it immediately inaccessible
• Preserves analytics data
• Cannot be undone

Alternative to deleting: Pause the link instead.

Duplicate Links

Create similar links quickly:

1. Find the link to copy
2. Click "Duplicate"
3. Modify as needed
4. Save with new slug

---

Link Organization

Naming Conventions

Consistent naming helps find links later:

[Channel] [Campaign] [Element] [Date]

Examples:
- Email Q1 Launch CTA Jan24
- Social Summer Sale Image Jul24
- Ads Homepage Test Feb24
- QR Menu Spring Update Mar24

Tags and Search

Use the search bar to find links by:

• Name
• Slug
• Creation date

Tip: Include campaign IDs or project codes in link names for easy filtering.

---

Best Practices

Before Creating

1. Define your goal — What are you testing?
2. Plan variants — What will you measure?
3. Set duration — How long will you run the test?
4. Check URLs — Ensure all destinations work

During the Test

1. Don't change weights mid-test — Let data accumulate
2. Monitor for issues — Check that all variants load
3. Wait for significance — Don't act on early results
4. Document changes — Note when you make adjustments

After the Test

1. Analyze results — Look beyond conversion rate
2. Implement winner — Apply learnings broadly
3. Archive or pause — Clean up finished tests
4. Plan next test — Continuous improvement

---

Troubleshooting

Variants Not Receiving Traffic

• Check that weights sum to 100%
• Verify variant URLs are valid
• Ensure link is active (not paused)
• Check for geo-routing misconfiguration

Uneven Traffic Distribution

• Small variations are normal (probabilistic routing)
• Large discrepancies may indicate:
  • Caching issues
  • Bot traffic
  • Geo-routing rules

Conversions Not Tracking

• Verify pixel is installed correctly
• Check that pixel fires on conversion action
• Allow 1-2 minutes for data sync
• Test the conversion flow yourself

Geo-Routing Not Working

• Verify country codes are correct (2-letter ISO)
• Ensure default variant is set
• Check that variant labels match exactly
• Test from different locations using VPN

---

Advanced Topics

URL Parameters

Pass through query parameters to destinations:

Short link: klinky.io/sale?utm_source=email
Routes to: https://example.com/sale?utm_source=email

Use this to:

• Track traffic sources
• Pass campaign IDs
• Maintain attribution

Deep Linking

For mobile apps, use deep links as destinations:

myapp://product/123
https://myapp.com/product/123 (with universal links)

QR Codes

Generate QR codes for any Klinky link:

1. Create your link
2. Click "QR Code" in link details
3. Download or embed the code

Benefits:

• Track offline-to-online conversions
• Easy mobile access
• Measurable print campaigns

---

API Automation

Create and manage links programmatically:

import requests

# Create link with variants
response = requests.post(
    'https://klinky-api.fly.dev/api/v1/public/links',
    headers={'X-API-Key': 'your-api-key'},
    json={
        'name': 'API Test',
        'slug': 'api-test',
        'variants': [
            {'label': 'a', 'destination_url': 'https://a.com', 'weight': 50},
            {'label': 'b', 'destination_url': 'https://b.com', 'weight': 50}
        ]
    }
)

See API Documentation for details.

---

Next Steps

• Analytics Guide — Understand your link performance
• API Documentation — Automate link management
• FAQ — Common questions answered

Start building smarter links — Create your first A/B test today