How Bulk URL Shortening API Saved Marketing Teams 127 Hours Weekly in Campaign Management

// Bulk generate campaign URLs from product catalog
async function generateProductCampaignLinks(
  products: Product[],
  campaign: CampaignConfig
) {
  const bulkUrls = products.map(product => {
    // Build UTM parameters from template
    const utmParams = {
      utm_source: campaign.channel,
      utm_medium: campaign.medium,
      utm_campaign: campaign.name,
      utm_content: product.sku,
      utm_term: campaign.audienceSegment,
      utm_id: campaign.crmCampaignId,
      affiliate_id: campaign.affiliateId || undefined
    };

    // Create branded short URL
    return {
      originalUrl: buildProductUrl(product, campaign.landingPageTemplate),
      domain: campaign.brandDomain || 'brand.link',
      slug: generateSlug(product, campaign), // e.g., "summer-sale-widget-pro"
      tags: {
        productId: product.id,
        sku: product.sku,
        category: product.category,
        campaignId: campaign.id,
        channel: campaign.channel,
        audience: campaign.audienceSegment
      },
      metadata: {
        createdAt: new Date().toISOString(),
        createdBy: 'automation-system',
        expiresAt: campaign.endDate
      },
      utmParams
    };
  });

  // Bulk create via API (10,000 URLs in one call)
  const result = await moduleAppClient.v1BulkShortUrls.v1BulkShortUrlsAction({
    urls: bulkUrls,
    waitForProcessing: true
  });

  // Return with metadata for campaign tracking
  return result.data.map((shortUrl, index) => ({
    ...shortUrl,
    productId: bulkUrls[index].tags.productId,
    sku: bulkUrls[index].tags.sku
  }));
}

// Usage: Generate Black Friday links for entire catalog
const blackFridayProducts = await fetchProductCatalog({
  category: 'all',
  status: 'active',
  sortBy: 'popularity'
});

const campaignLinks = await generateProductCampaignLinks(
  blackFridayProducts,
  {
    name: 'black-friday-2026',
    channel: 'email',
    medium: 'newsletter',
    audienceSegment: 'vip-customers',
    brandDomain: 'deals.brand.co',
    landingPageTemplate: '/products/{slug}?ref=bf2026',
    crmCampaignId: 'crm-bf26-001',
    affiliateId: 'partner-bf26',
    startDate: '2026-11-20',
    endDate: '2026-11-28'
  }
);

console.log(`Generated ${campaignLinks.length} campaign URLs`);
// Output: Generated 847 campaign URLs in 3.2 seconds

// Auto-generate personalized links from Salesforce campaigns
import { SalesforceClient } from '@salesforce/sdk';

async function syncCampaignLinks(campaignId: string) {
  // Fetch campaign from Salesforce
  const sfCampaign = await SalesforceClient.campaigns.retrieve(campaignId);

  // Get all campaign members with personalized content
  const campaignMembers = await SalesforceClient.campaignMembers.list({
    campaignId: campaignId,
    status: 'Sent'
  });

  // Bulk generate personalized links
  const personalizedLinks = campaignMembers.map(member => {
    const personalizedSlug = generatePersonalizedSlug({
      firstName: member.firstName,
      lastName: member.lastName,
      campaign: sfCampaign.Name,
      segment: member.Segment__c
    });

    return {
      originalUrl: sfCampaign.Landing_Page_URL__c,
      domain: 'links.brand.co',
      slug: personalizedSlug,
      tags: {
        salesforceCampaignId: campaignId,
        salesforceContactId: member.ContactId,
        leadId: member.LeadId,
        segment: member.Segment__c,
        personalized: 'true'
      },
      metadata: {
        sfCampaignMemberId: member.Id,
        personalizationVersion: 'v2'
      },
      utmParams: {
        utm_source: sfCampaign.Channel__c,
        utm_medium: sfCampaign.Medium__c || 'email',
        utm_campaign: sfCampaign.Name.toLowerCase().replace(/\s+/g, '-'),
        utm_content: member.Segment__c,
        utm_id: campaignId,
        sf_contact_id: member.ContactId,
        sf_lead_id: member.LeadId
      }
    };
  });

  // Bulk create links
  const createdLinks = await moduleAppClient.v1BulkShortUrls.v1BulkShortUrlsAction({
    urls: personalizedLinks
  });

  // Update Salesforce campaign members with short URLs
  const updatePromises = createdLinks.map(link => {
    const memberId = link.tags.sfCampaignMemberId;
    return SalesforceClient.campaignMembers.update(memberId, {
      Personalized_Link__c: link.shortUrl,
      Personalized_Link_Created_At__c: new Date().toISOString()
    });
  });

  await Promise.all(updatePromises);

  return {
    campaignId,
    linksCreated: createdLinks.length,
    processingTime: createdLinks.processingTime
  };
}

// Usage: Sync links when campaign launches
const result = await syncCampaignLinks('701S00000012345');
console.log(`Created ${result.linksCreated} personalized links in ${result.processingTime}ms`);
// Output: Created 12,847 personalized links in 8234ms

// Auto-expire campaign links when campaigns end
import { CronJob } from 'cron';

new CronJob('0 2 * * *', async () => { // Run daily at 2 AM
  const today = new Date();

  // Find campaigns that ended yesterday
  const endedCampaigns = await moduleAppClient.v1ListShortUrls.v1ListShortUrlsAction({
    tag: 'campaign_id',
    limit: 10000
  });

  const linksToExpire = endedCampaigns.data.filter(link => {
    const endDate = link.metadata.expiresAt;
    return endDate && new Date(endDate) < today;
  });

  if (linksToExpire.length > 0) {
    // Bulk update links to expired status
    await moduleAppClient.v1BulkUpdateShortUrls.v1BulkUpdateShortUrlsAction({
      ids: linksToExpire.map(l => l.id),
      updates: {
        active: false,
        expired: true,
        redirectTo: '/campaign-ended', // Preserve SEO value
        metadata: {
          expiredAt: today.toISOString(),
          expiredBy: 'automation-cleanup'
        }
      }
    });

    // Notify marketing ops team
    await sendSlackNotification({
      channel: '#marketing-ops',
      message: `Expired ${linksToExpire.length} campaign links from ended campaigns`
    });
  }
}).start();