0CodeKit icon

0CodeKit

A toolbox of no-code utilities

Actions132

Operator → Build UTM Link

AI-generated

Overview

The "Build UTM Link" operation in the Operator resource constructs a URL with appended UTM parameters. This is useful for marketers and analysts who want to track the effectiveness of campaigns by tagging URLs with campaign-specific information. By adding UTM parameters such as source, medium, campaign, term, and content, users can monitor traffic sources and user engagement in analytics platforms like Google Analytics.

Practical examples:

  • Creating a link for a newsletter email campaign with source set to "newsletter" and medium to "email".
  • Generating URLs for social media posts with specific campaign names and content tags.
  • Tracking paid search ads by setting term and content parameters accordingly.

Properties

Name Meaning
Base URL The original URL to which UTM parameters will be added (e.g., https://example.com/page).
UTM Source Identifies the source of the traffic, e.g., "newsletter", "google".
UTM Medium Specifies the marketing medium, e.g., "email", "social".
UTM Campaign Names the campaign, e.g., "summer-sale", "product-launch".
UTM Term Used for paid search to identify keywords, e.g., "discount-shoes", "running-gear".
UTM Content Differentiates similar content or links within the same ad, e.g., "header-banner", "footer-link".

Output

The node outputs JSON data containing the constructed URL with all specified UTM parameters appended correctly. The output field json will include the full URL string ready for use in marketing campaigns or analytics tracking.

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for authentication to the external service at https://prod.0codekit.com.
  • The node sends a POST request to the endpoint /operator/utmbuild with the input parameters to generate the UTM link.
  • No additional environment variables are explicitly required beyond the API key credential.

Troubleshooting

  • Empty or invalid Base URL: If the base URL is missing or malformed, the generated link may be incorrect or the API might return an error. Ensure the Base URL is a valid URL.
  • Missing API key or authentication failure: The node requires a valid API key credential. Authentication errors will prevent link generation.
  • Incorrect parameter formatting: Although optional, providing empty strings for UTM parameters is allowed but may result in incomplete tracking. Make sure to fill relevant fields appropriately.
  • API service downtime: Since the node relies on an external API, network issues or service outages could cause failures.

Common error messages might include HTTP 401 Unauthorized (invalid credentials), HTTP 400 Bad Request (invalid parameters), or network timeouts. Resolving these involves verifying credentials, checking input values, and ensuring network connectivity.

Links and References

Discussion