> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bsy.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# UTM

> Track and analyze your marketing campaigns effectively with Bitsy UTM parameters.

**What are UTM Parameters?**

UTM (Urchin Tracking Module) parameters are tags added to URLs that help you track the effectiveness of online marketing campaigns. By using UTM parameters, you can analyze traffic sources and understand user behavior more effectively. This data is crucial for optimizing your marketing strategies and improving ROI.

**Optimize Your Campaign Tracking with UTM Parameters**

With Bitsy’s UTM feature, you can easily add UTM parameters to your links. This allows you to gather detailed insights about your traffic sources, helping you refine your marketing efforts and achieve better results.

### **How to Implement Bitsy UTM**

#### Step 1: Set Up Your Parameters

When configuring UTM parameters, you need to define specific fields for your links. The key parameters include:

* **`has_utm`**: Boolean indicating if UTM parameters are included.

* **`utm_source`**: UTM source for tracking (e.g., newsletter, social media).

* **`utm_medium`**: UTM medium for tracking (e.g., email, CPC).

* **`utm_campaign`**: UTM campaign for tracking (e.g., summer\_sale).

* **`utm_term`**: UTM term for paid search (optional).

* **`utm_content`**: UTM content for differentiating ads (optional).

#### Step 2: Define Your UTM Parameters

Here’s a simple structure for your UTM configuration:

1. Set `has_utm` to true to indicate that UTM parameters are included.

2. Provide values for `utm_source`, `utm_medium`, `utm_campaign`, and any optional parameters.

#### Example UTM Configuration

Here’s a sample of how you might structure your UTM configuration:

```json theme={null}
{
  "has_utm": true,
  "utm_source": "newsletter",
  "utm_medium": "email",
  "utm_campaign": "summer_sale",
  "utm_term": "shoes",
  "utm_content": "header_link"
}
```

#### Explanation of the Example

* **`has_utm`**: Indicates that UTM parameters are being utilized.
* **`utm_source`**: The source of your traffic (e.g., newsletter).
* **`utm_medium`**: The medium used to deliver your message (e.g., email).
* **`utm_campaign`**: The specific campaign associated with the link (e.g., summer\_sale).
* **`utm_term`**: Keywords for paid search (optional).
* **`utm_content`**: Used to differentiate between different ads (optional).

#### Step 3: Testing Your Setup

Before launching your campaigns, it's important to test your UTM parameters:

1. Click on your generated links and verify that the UTM parameters are correctly appended to the URLs.

2. Use Google Analytics or other tracking tools to ensure the data is being captured accurately.

#### Conclusion

Implementing Bitsy UTM parameters can greatly enhance your ability to track and analyze your marketing campaigns. By setting up clear parameters and testing your configuration, you can make data-driven decisions to optimize your strategies and improve campaign performance.

<CardGroup cols={2}>
  <Card title="Try our API" icon="code" href="/api-reference/bitsy-link/create-link">
    Learn how to Implement Bitsy UTM
  </Card>
</CardGroup>

***