UTM Tracking Guide

const response = await axios.post('https://snip.sa/api/urls', {
  originalUrl: 'https://example.com/product',
  customCode: 'spring-sale',
  utm: {
    source: 'newsletter',
    medium: 'email',
    campaign: 'spring_sale_2024'
  }
}, {
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'your_api_key_here'
  }
});

// Result: https://laghhu.link/spring-sale
// Redirects to: https://example.com/product?utm_source=newsletter&utm_medium=email&utm_campaign=spring_sale_2024

const response = await axios.post('https://snip.sa/api/urls', {
  originalUrl: 'https://example.com/product',
  title: 'Spring Sale - Email Campaign',
  utm: {
    source: 'mailchimp',
    medium: 'email',
    campaign: 'spring_sale_2024',
    term: 'discount_shoes',
    content: 'header_banner'
  },
  tags: ['email', 'spring-2024']
}, {
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'your_api_key_here'
  }
});

{
  utm: {
    source: 'mailchimp',
    medium: 'email',
    campaign: 'weekly_newsletter_jan_2024',
    content: 'cta_button'
  }
}

{
  utm: {
    source: 'facebook',
    medium: 'social',
    campaign: 'product_launch',
    content: 'video_ad'
  }
}

{
  utm: {
    source: 'google',
    medium: 'cpc',
    campaign: 'brand_keywords',
    term: 'url+shortener',
    content: 'ad_variant_a'
  }
}

{
  utm: {
    source: 'instagram',
    medium: 'influencer',
    campaign: 'summer_collab',
    content: 'influencer_name'
  }
}

class SnipUTMBuilder {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.baseUrl = 'https://snip.sa/api';
  }

  async createCampaignUrl(originalUrl, campaign) {
    const response = await axios.post(`${this.baseUrl}/urls`, {
      originalUrl,
      title: campaign.title,
      customCode: campaign.code,
      utm: {
        source: campaign.source,
        medium: campaign.medium,
        campaign: campaign.name,
        term: campaign.term,
        content: campaign.content
      },
      tags: campaign.tags || []
    }, {
      headers: {
        'Content-Type': 'application/json',
        'X-API-Key': this.apiKey
      }
    });

    return response.data;
  }
}

// Usage
const builder = new SnipUTMBuilder('your_api_key');

const campaign = await builder.createCampaignUrl(
  'https://example.com/product',
  {
    title: 'Spring Sale Email',
    code: 'spring-email',
    source: 'mailchimp',
    medium: 'email',
    name: 'spring_sale_2024',
    content: 'header_cta',
    tags: ['email', 'spring']
  }
);

// Get analytics for a campaign URL
const analytics = await axios.get(
  `https://snip.sa/api/analytics/${urlId}`,
  {
    headers: { 'X-API-Key': 'your_api_key_here' }
  }
);

console.log('Campaign Performance:');
console.log('Total Clicks:', analytics.data.data.totalClicks);
console.log('Top Countries:', analytics.data.data.topCountries);
console.log('Top Devices:', analytics.data.data.topDevices);