URL Parameters

Pass data through URLs to create dynamic, personalized video experiences. URL parameters let you personalize content in real-time without pre-uploading contact lists.

What Are URL Parameters?

URL parameters are key-value pairs added to the end of a video URL that pass data directly to the video. They allow for instant personalization without requiring data to be uploaded beforehand.

Basic URL Parameter Structure

Standard Format

https://your-video-url.com/video?parameter=value&parameter2=value2

Example URLs

https://app.blings.com/video/abc123?name=John&company=Acme
https://app.blings.com/video/abc123?first_name=Sarah&industry=Technology&budget=50000
https://app.blings.com/video/[email protected]&role=Manager&size=Enterprise

Common URL Parameters

Personal Information

?first_name=John
?last_name=Smith
[email protected]
?phone=[phone]

Company Information

?company=Acme Corporation
?industry=Technology
?company_size=Enterprise
?job_title=Marketing Director
?department=Marketing

Custom Data

?customer_id=12345
?product_interests=analytics,automation
?budget_range=50000-100000
?timeline=3_months
?use_case=lead_generation

Using URL Parameters in Your Videos

Text Personalization

Insert URL parameter values into your video content:

Examples:

• "Hello, {{first_name}}!" (from ?first_name=John)

• "Welcome to {{company}}!" (from ?company=Acme)

• "As a {{job_title}}, you'll love..." (from ?job_title=Manager)

Conditional Content

Show different content based on URL parameters:

Examples:

• {{if company_size = "Enterprise"}}Enterprise features{{else}}Standard features{{/if}}

• {{if industry = "Healthcare"}}HIPAA-compliant solutions{{else}}Standard security{{/if}}

• {{if budget_range = "50000-100000"}}Premium package{{else}}Basic package{{/if}}

Dynamic CTAs

Customize call-to-action buttons:

Examples:

• "Schedule a demo for {{company}}" (from ?company=Acme)

• "Get {{personalized_offer}} now" (from ?personalized_offer=20% discount)

• "Contact {{sales_rep}}" (from ?sales_rep=Sarah Johnson)

Real-World Examples

Sales Outreach

https://app.blings.com/video/abc123?first_name=John&company=Acme&industry=Technology&budget=75000&sales_rep=Sarah

Video content:
"Hi {{first_name}}! I noticed {{company}} is in the {{industry}} space.

Given your {{budget}} budget, I think you'd be perfect for our Enterprise plan.

{{sales_rep}} from our team would love to show you how we can help."

Product Demo

https://app.blings.com/video/def456?name=Mike&role=CTO&company_size=Startup&use_case=scaling

Video content:
"{{name}}, as a {{role}} at a {{company_size}} company, I know you're focused on {{use_case}}.

Let me show you how our platform can help you scale efficiently..."

Event Invitation

https://app.blings.com/video/ghi789?first_name=Lisa&industry=Finance&location=New York&event_date=March 15

Video content:
"{{first_name}}, we're hosting a {{industry}} summit in {{location}} on {{event_date}}.

As a leader in the {{industry}} space, we'd love to have you join us..."

Best Practices

URL Structure

• Keep it clean — Use simple, descriptive parameter names

• Encode special characters — Use URL encoding for spaces and special characters

• Limit parameter count — Too many parameters can make URLs unwieldy

• Use consistent naming — Follow a standard format across all URLs

Data Handling

• Validate parameters — Check for required parameters and valid formats

• Provide fallbacks — Have default values for missing parameters

• Sanitize input — Clean and validate all parameter data

• Handle errors gracefully — Show appropriate content for invalid parameters

Security Considerations

• Don't include sensitive data — Avoid passwords, API keys, or personal identifiers

• Use HTTPS — Always use secure URLs for parameter passing

• Validate on server side — Don't trust client-side parameter validation

• Log parameter usage — Track which parameters are being used

Advanced URL Parameter Features

Multiple Values

Pass arrays or multiple values:

?interests=analytics,automation,reporting
?products=product1,product2,product3
?features=feature1&features=feature2&features=feature3

Encoded Values

Handle special characters and spaces:

?company=Acme%20Corporation (space encoded as %20)
?name=Jos%C3%A9 (accented character encoded)
?message=Hello%20World (multiple spaces encoded)

Dynamic URL Generation

Create URLs programmatically:

JavaScript Example:

const params = new URLSearchParams({
  first_name: 'John',
  company: 'Acme',
  industry: 'Technology'
});
const url = `https://app.blings.com/video/abc123?${params}`;

Integration Examples

CRM Integration

Generate personalized URLs from your CRM:

https://app.blings.com/video/abc123?first_name={{contact.first_name}}&company={{contact.company}}&industry={{contact.industry}}

Email Marketing

Include personalized video links in emails:

"Hi {{first_name}}, check out this personalized demo: https://app.blings.com/video/abc123?name={{first_name}}&company={{company}}"

Website Integration

Pass visitor data to videos:

https://app.blings.com/video/abc123?referrer=website&page=product&interest={{current_product}}

Common Use Cases

• Sales outreach and demos

• Email marketing campaigns

• Website personalization

• Event invitations

• Product recommendations

• Customer onboarding

• Lead nurturing

---

Want to combine multiple data sources? Learn about variables and data enrichment for richer personalization.