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

# Trackable Links

> Create and manage tracked short links for your campaigns

## Overview

Trackable Links allow you to create branded short links that track every click with detailed attribution. Insert these links into DM campaigns and messages to measure engagement, understand customer behavior, and optimize your outreach.

<Info>
  Every link automatically tracks clicks with detailed metadata including location, device, browser,
  and per-user attribution through unique tracking parameters.
</Info>

## Key Features

<CardGroup cols={2}>
  <Card title="Click Tracking" icon="chart-line">
    Monitor every click with detailed analytics including geographic location, device type, and
    browser information.
  </Card>

  <Card title="Per-User Attribution" icon="user-check">
    Track which specific customers clicked your links using unique tracking parameters automatically
    added to each send.
  </Card>

  <Card title="Campaign Integration" icon="paper-plane">
    Insert links into DM campaigns to track performance.
  </Card>

  <Card title="Custom Domains" icon="globe">
    Use custom branded domains for your short links to build trust and brand recognition (available
    upon request).
  </Card>
</CardGroup>

## Creating Your First Link

<Steps>
  <Step title="Navigate to Links">
    Go to **Brand > Trackable Links** from the sidebar navigation.
  </Step>

  <Step title="Click Create Link">Click the **Create Link** button in the top-right corner.</Step>

  <Step title="Configure Link Details">
    Fill in the link information: - **Display Name**: A friendly label for the link (e.g., "Holiday
    Sale", "New Product Launch") - **Short URL**: Choose your custom slug (the part after the domain)

    * **Destination URL**: Where users will be redirected when they click the link

    <Tip>
      Choose descriptive slugs that are easy to remember and type, like `holiday-sale` instead of
      random characters.
    </Tip>
  </Step>

  <Step title="Select Domain">
    Choose which domain to use for your short link: - **brry.io**: The default Blueberry domain
    (always available) - **Custom domain**: Your branded domain (if configured)

    <Info>
      If you have multiple custom domains, select which one to use. Your primary domain is selected by
      default.
    </Info>
  </Step>

  <Step title="Create and Copy">
    Click **Create Link** to generate your tracked short link.

    <Check>
      Your new link appears in the list with a copyable short URL you can use immediately.
    </Check>
  </Step>
</Steps>

## Using Links in Campaigns

You can insert trackable links into your DM campaigns using the **Insert Link** button when composing messages. Blueberry automatically personalizes each link with unique tracking for every recipient.

### Link Tracking

Every time someone clicks a tracked link:

<Steps titleSize="h3">
  <Step title="Click Event Captured">
    Blueberry captures every click on a trackable link that is sent.
  </Step>

  <Step title="Attribution Applied">
    Blueberry uniquely maps each link click back to the user that clicked on the link, and the message
    the link was sent in. click.
  </Step>

  <Step title="Analytics Updated">
    Click data appears in your link analytics dashboard with a detailed breakdown by:

    <ul>
      <li>Total clicks</li>
      <li>Unique users</li>
      <li>Geographic location</li>
      <li>Device type and browser</li>
      <li>Click timestamps</li>
    </ul>
  </Step>

  <Step title="Contact Record Updated">
    The click is recorded on the contact's profile in their engagement history.
  </Step>
</Steps>

## Managing Links

### Viewing Analytics

<Steps titleSize="h3">
  <Step title="Access Analytics">
    Click on any link in your list to view detailed analytics.
  </Step>

  <Step title="Review Metrics">
    The analytics dashboard shows:

    <ul>
      <li>
        <strong>Total Clicks</strong>: All-time click count
      </li>

      <li>
        <strong>Recent Activity</strong>: Clicks in the last 7 days
      </li>

      <li>
        <strong>Click Timeline</strong>: Visual chart of clicks over time
      </li>

      <li>
        <strong>Geographic Distribution</strong>: Map of where clicks originated
      </li>

      <li>
        <strong>Device Breakdown</strong>: Desktop vs mobile usage
      </li>

      <li>
        <strong>Top Referrers</strong>: Where users found your link
      </li>
    </ul>
  </Step>

  <Step title="Export Data">
    Export click data for deeper analysis in your own tools.
  </Step>
</Steps>

## Custom Domains

Custom domains let you use your own branded domain for short links instead of brry.io, building trust and brand recognition.

<Info>
  **Custom domains are available upon request.** Contact Blueberry support to set up a custom domain
  for your brand.
</Info>

## Best Practices

<AccordionGroup>
  <Accordion title="Choose Memorable Slugs" icon="brain">
    **Create slugs that are:**

    * Short and easy to type
    * Descriptive of the content (e.g., `winter-sale`, `new-product`)
    * Consistent with your naming conventions
    * Free of special characters (use hyphens for spaces)

    **Good examples:**

    * `holiday-deals`
    * `summer-collection`
    * `free-shipping`

    **Avoid:**

    * Random characters: `a7f3k9x2`
    * Too long: `check-out-our-amazing-new-summer-collection-with-discounts`
    * Special characters: `sale_2024!`
  </Accordion>

  <Accordion title="Organize by Campaign" icon="folder">
    Create links specific to each campaign or initiative to make tracking easier:

    * `black-friday-2024` instead of a generic `sale`
    * `newsletter-march` instead of a generic `newsletter`
    * `instagram-ad-spring` to track specific channels

          <Tip>
            Use consistent naming conventions across campaigns to make analytics comparison easier.
          </Tip>
  </Accordion>

  <Accordion title="Test Before Sending" icon="flask">
    Always test your links before including them in campaigns:

    1. Click the link yourself to verify it redirects correctly.
    2. Check the destination page loads properly.
    3. Test on both mobile and desktop.
    4. Verify tracking parameters are working.

    <Check>
      Test clicks appear in your analytics dashboard within seconds.
    </Check>
  </Accordion>

  <Accordion title="Monitor Performance" icon="chart-mixed">
    Regularly review link analytics to understand what's working:

    * Compare click-through rates across different campaigns
    * Identify which offers or products generate the most interest
    * Analyze geographic and device data for targeting insights
    * Track conversion patterns over time

    **Use these insights to:**

    * Optimize future campaign messaging
    * Adjust targeting parameters
    * Test different offer types
    * Improve call-to-action language
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Link Not Working" icon="triangle-exclamation">
    If a link isn't redirecting properly:

    <Steps titleSize="h3">
      <Step title="Check Link Status">
        Ensure the link is active and not archived in **Brand > Links**.
      </Step>

      <Step title="Verify Destination URL">
        Confirm the destination URL is valid and accessible:

        * Visit the destination URL directly in a browser
        * Check for typos in the URL
        * Ensure the destination page is live and not behind authentication
      </Step>

      <Step title="Clear Cache">
        Try accessing the link in an incognito/private window to rule out browser caching issues.
      </Step>
    </Steps>

    <Warning>
      If the issue persists, contact Blueberry support with the specific link URL and error message.
    </Warning>
  </Accordion>

  <Accordion title="Clicks Not Tracking" icon="chart-line-down">
    If clicks aren't appearing in analytics:

    <Steps titleSize="h3">
      <Step title="Wait for Processing">
        Click data typically appears within 10-30 seconds, but can take up to 5 minutes during high traffic.
      </Step>

      <Step title="Check Click Source">
        Some clicks may not be tracked:

        * Link previews by messaging apps
        * Bot traffic (automatically filtered)
        * Clicks with ad blockers or privacy tools
      </Step>

      <Step title="Verify Integration">
        Ensure your link provider integration is active in **Brand > Settings**.
      </Step>
    </Steps>

    <Note>
      Blueberry filters bot traffic and link preview requests to show accurate human engagement only.
    </Note>
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Create DM Campaigns" icon="paper-plane" href="/dms/campaigns/types">
    Use your tracked links in automated DM campaigns to drive conversions.
  </Card>

  <Card title="Saved Offers" icon="tag" href="/dms/saved-offers">
    Combine tracked links with saved offers for powerful conversion campaigns.
  </Card>
</CardGroup>