How Branded Short Links Drove 3.2B Clicks and Transformed Marketing Analytics

// Comprehensive branded link implementation
class BrandedLinkManager {
  constructor(apiKey, domain) {
    this.apiKey = apiKey;
    this.domain = domain;
    this.baseUrl = 'https://api.dev.me/v1/short-url';
  }

  async createBrandedLink(originalUrl, options = {}) {
    const {
      campaign,
      source,
      medium,
      content,
      alias,
      expiresAt
    } = options;

    const requestBody = {
      originalUrl,
      domain: this.domain,
      alias: alias || this.generateAlias(),
      metadata: {
        campaign,
        source,
        medium,
        content,
        createdAt: new Date().toISOString()
      },
      expiresAt
    };

    const response = await fetch(this.baseUrl, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${this.apiKey}`
      },
      body: JSON.stringify(requestBody)
    });

    return await response.json();
  }

  async trackAnalytics(shortCode, timeRange = '30d') {
    const response = await fetch(`${this.baseUrl}/${shortCode}/analytics?range=${timeRange}`, {
      headers: {
        'Authorization': `Bearer ${this.apiKey}`
      }
    });

    return await response.json();
  }

  generateAlias() {
    return Math.random().toString(36).substring(2, 8);
  }
}

// Usage example
const linkManager = new BrandedLinkManager('your-api-key', 'brand.co');

// Create a campaign link
const campaignLink = await linkManager.createBrandedLink(
  'https://example.com/product-launch',
  {
    campaign: 'spring2025',
    source: 'instagram',
    medium: 'social',
    content: 'product_video',
    alias: 'spring-launch'
  }
);

console.log('Branded link:', campaignLink.shortUrl);
// Output: https://brand.co/spring-launch

// Quick implementation example
const axios = require('axios');

async function createBrandedLink() {
  try {
    const response = await axios.post('https://api.dev.me/v1/short-url', {
      originalUrl: 'https://your-site.com/awesome-product',
      domain: 'yourbrand.co',
      alias: 'launch2025',
      metadata: {
        campaign: 'product-launch',
        source: 'twitter',
        medium: 'social'
      }
    }, {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
      }
    });

    console.log('Success! Your branded link:', response.data.shortUrl);
    // Output: https://yourbrand.co/launch2025

  } catch (error) {
    console.error('Error creating link:', error.response.data);
  }
}

createBrandedLink();