Ido ToolboxInstall

Overview

The "Get UTM Parameters From URL" operation extracts UTM (Urchin Tracking Module) parameters from a given URL. UTM parameters are commonly used in marketing and analytics to track the effectiveness of online campaigns by appending specific query parameters to URLs.

This node is useful when you want to analyze or process URLs to retrieve campaign tracking data such as source, medium, campaign name, term, and content. For example, it can be used to parse URLs collected from web traffic logs or form submissions to extract marketing attribution details automatically.

Practical examples:

• Extracting UTM parameters from URLs submitted via forms to segment leads by campaign.
• Processing URLs in bulk to generate reports on marketing channel performance.
• Automating workflows that adjust user experience based on campaign parameters.

Properties

Output

The output JSON object contains the following fields:

• originalUrl: The original input URL string.
• utmParameters: An object mapping each UTM parameter key to its corresponding value extracted from the URL. Only parameters starting with utm_ are included.
• parametersCount: The total number of UTM parameters found in the URL.

Example output JSON:

{
  "originalUrl": "https://example.com?utm_source=google&utm_medium=cpc",
  "utmParameters": {
    "utm_source": "google",
    "utm_medium": "cpc"
  },
  "parametersCount": 2
}

Dependencies

• No external API keys or services are required.
• The node uses the global JavaScript URL class for parsing URLs, which requires valid URL format input.

Troubleshooting

• Invalid URL format: If the provided URL is malformed or invalid, the node throws an error "Invalid URL format". Ensure the URL is correctly formatted and includes the protocol (e.g., http:// or https://).
• No UTM parameters found: If the URL does not contain any query parameters starting with utm_, the utmParameters object will be empty and parametersCount will be zero.
• Empty or missing URL input: The URL property is required; providing an empty string will cause an error.

Links and References

• Google Analytics Campaign URL Builder
• MDN Web Docs: URL API
• UTM Parameters Explained