> For the complete documentation index, see [llms.txt](https://themochi-app.gitbook.io/mochi-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://themochi-app.gitbook.io/mochi-docs/feature-and-settings/attribution-links.md).

# Attribution Links

Track exactly which setter sent which link to which lead and see who clicks your content.

## What It Does

Attribution links are branded short links (moch.me/your-slug) that Mochi automatically tracks when your setters send them in DMs. Every time someone clicks a link, Mochi records who clicked, when they clicked, what device they used, and how long it took them to click after receiving the message.

The system creates a unique tracking URL for each individual send, so there's no confusion about which lead clicked what. When a setter pastes "moch.me/discovery-call" into a DM, Mochi automatically rewrites it with a unique URL like "moch.me/discovery-call-A1B2C" before sending. This per-send tracking means even if you send the same link to 100 different leads, you'll know exactly which one clicked.

Mochi integrates with Dub.co for the link infrastructure and click tracking. All your links use your custom domain (like moch.me) and include rich previews with custom titles, descriptions, and images that show up nicely when pasted into Instagram DMs.

You can set up automated follow-up messages based on link clicks. Send a "thanks for clicking" message immediately when someone clicks, or send a "haven't seen you click yet" reminder after 2 hours. The system only sends follow-ups for links that actually reached Instagram, preventing phantom messages from failed sends.

The system also tracks anonymous visitors who click your canonical links from outside of tracked DMs (like from your Instagram bio or stories), giving you visibility into traffic from all sources.

## Setting It Up

### Creating Your First Link

1. Go to **Links** in your Mochi dashboard
2. Click **Create New Link**
3. Fill in the link details:
   * **Link Name**: Internal name like "Discovery Call" or "Free Training"
   * **Destination URL**: Where the link should redirect (your Calendly, YouTube video, etc.)
   * **Custom Slug**: The short part of your URL (e.g. "discovery" becomes moch.me/discovery)
   * **Title**: How the link appears when previewed in Instagram
   * **Description**: Preview text that shows below the title
   * **OG Image**: Upload an image for the link preview
4. Click **Save**

The link becomes available immediately. Your setters can now paste the full moch.me URL into DMs and Mochi will track every send and click automatically.

### Quick Link Creation

You can also create links quickly by pasting any URL into a DM. Mochi will automatically:

* Generate a unique slug
* Fetch the page's title and description
* Create a tracking link
* Replace the original URL with your branded short link

This works for any website - YouTube videos, Calendly pages, lead magnets, etc.

## How to Use It

### Sending Tracked Links

Setters simply paste the full moch.me URL into their DMs. When they type "moch.me/discovery-call" and hit send, Mochi automatically rewrites it to a unique tracking URL before it reaches Instagram. The lead receives a clickable link that looks normal but contains hidden tracking.

All tracked links appear in your dashboard so setters can easily copy and paste them. They can also type the URL from memory - any message containing your moch.me domain gets tracked automatically.

### Viewing Analytics

Go to **Links** in your dashboard to see your link performance:

**Link Overview:**

* Total links created across your organization
* Total link sends in the selected time period
* Total clicks including repeat clicks from the same lead
* Overall click rate (unique clicked sends divided by total sends)

**Individual Link Analytics:**

* **Summary Stats**: Sends, clicks, click rate, and average time to click
* **Geographic Data**: Top countries and cities where people clicked
* **Device Analytics**: Mobile vs desktop clicks, browser breakdown, and operating system data
* **Setter Performance**: Which team members get the highest click rates and send volumes
* **Recent Sends**: Timeline showing which lead clicked when, with click latency

### Setting Up Automations

Create automatic follow-up messages based on link behavior:

1. Go to **Links** → **Automations**
2. Click **Create Automation**
3. Choose your trigger:
   * **Link Clicked**: Send a message immediately when someone clicks (0 second delay)
   * **Link Not Clicked**: Send a reminder after a delay (minimum 60 seconds)
4. Set your wait time (for "not clicked" automations)
5. Choose which link triggers the automation (or leave blank for all links)
6. Write your follow-up message
7. Make sure the automation is set to **Active**

Automations only fire for messages that actually reached Instagram and have a delivery status of "DELIVERED", preventing follow-ups for failed sends.

### Lead Timeline Integration

When you view a lead's profile, their timeline shows link events:

* When each link was sent to them
* When they clicked (with device and location data)
* How long they took to click after receiving

This gives you complete visibility into each lead's engagement with your content and helps you understand their interest level.

### Anonymous Visitor Tracking

The system also tracks clicks from people who find your links outside of tracked DMs - like from your Instagram bio, stories, or other social media. These appear as anonymous visitors with pseudonymous names like "Silent Fox" to protect privacy while still giving you traffic insights.

## Tips

* Use clear, compelling custom slugs like "free-training" instead of random letters
* Set up rich previews with attractive images - they significantly improve click rates
* Create different links for different offers to track which content performs best
* Monitor your setter performance data to identify top performers and coach others
* Set up "not clicked" automations with 2-4 hour delays to re-engage interested leads
* Use the geographic data to understand where your audience is located for timezone-aware outreach
* Check your link analytics regularly to see which content resonates most with your audience
* The system prevents duplicate automations from firing, so you can safely create multiple automation rules
* Failed Instagram sends won't trigger follow-up automations, preventing confusion from phantom messages


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://themochi-app.gitbook.io/mochi-docs/feature-and-settings/attribution-links.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
