Actions108
- AI Actions
- Transcribe
- Detect Brand
- Extract Contact Information
- Mood Detection
- Detect Adult Content
- Enitity Detection
- Language Detection
- Too Long To Read
- Check Content Policy
- Detect Faces
- Generate Python Code
- Picture Text Recognition
- Detect Color
- Generate Image
- PDF OCR
- Translation
- Detect Email Type
- Generate Javascript Code
- Picture Object Recognition
- Business Actions
- Calculate Actions
- Code Actions
- Convert Actions
- Crypto Actions
- Date & Time Actions
- Generate Actions
- Image Actions
- Operator Actions
- PDF Actions
- Storage Actions
- Text Actions
- User Actions
Overview
The "Operator" resource with the "UTM" operation in this node provides utilities to either build or parse UTM (Urchin Tracking Module) parameters in URLs. This is useful for marketers and analysts who want to track the effectiveness of campaigns by appending UTM parameters to URLs or extracting them from existing URLs.
Common scenarios include:
- Constructing URLs with specific UTM parameters to track source, medium, campaign, and content.
- Parsing an existing URL to extract UTM parameters for analysis or reporting.
For example, you can build a URL like https://example.com?utm_source=newsletter&utm_medium=email&utm_campaign=spring_sale or parse such a URL to retrieve the individual UTM components.
Properties
| Name | Meaning |
|---|---|
| Build or Parse UTM? | Choose between building a URL with UTM parameters or parsing UTM parameters from an existing URL. Options: "Build a URL", "Parse UTM From Url". |
| Url | The URL to either add UTM parameters to (when building) or extract UTM parameters from (when parsing). |
| UTM Source | The value for the utm_source parameter when building a URL. |
| UTM Medium | The value for the utm_medium parameter when building a URL. |
| UTM Campaign | The value for the utm_campaign parameter when building a URL. |
| UTM Content | The value for the utm_content parameter when building a URL. |
| Code Variables | A collection of code variables that can be used in conjunction with code editor functions (not directly related to UTM but available as input). |
Output
The node outputs JSON data representing the result of the UTM operation:
- When building a URL, the output JSON contains the constructed URL string with appended UTM parameters.
- When parsing a URL, the output JSON contains the extracted UTM parameters as key-value pairs, e.g.,
utm_source,utm_medium,utm_campaign, andutm_content.
No binary data output is involved in this operation.
Dependencies
- Requires an API key credential for the external service powering the node's operations.
- The node makes HTTP POST requests to endpoints corresponding to the resource and operation (e.g.,
operator/utm/buildoroperator/utm/parse). - No additional environment variables are explicitly required beyond the API authentication.
Troubleshooting
- Invalid URL format: If the provided URL is malformed, the node may throw an error. Ensure the URL is properly formatted.
- Missing required fields: For building a URL, if mandatory UTM parameters are missing or empty, the resulting URL might not include those parameters.
- API errors: Network issues or invalid API credentials will cause request failures. Verify API key validity and network connectivity.
- Parsing unexpected URLs: If the URL does not contain UTM parameters, the parsed output will be empty or missing expected keys.
Links and References
- Google Analytics UTM Parameters Guide
- UTM Parameter Best Practices
- n8n Expressions Documentation (for using expressions in variable inputs)