Beehiiv Integration

Beehiiv supports custom HTML through their HTML Snippet feature, making it easy to add BannerTrackr tracking to your newsletters.

Prerequisites

• A BannerTrackr account with at least one placement created
• Your Pixel ID from the placement
• Beehiiv paid plan (Scale or Max) for HTML Snippet access

Method 1: Smart Image (Recommended)

Use a single URL for image hosting, impression tracking, and click tracking.

Step 1: Set Up Your Placement

1. Go to your BannerTrackr dashboard
2. Create or edit a placement
3. Upload the sponsor's banner image
4. Set the destination URL (sponsor's landing page)
5. Copy your Smart Image URL: https://bannertrackr.com/api/track/img/YOUR_PIXEL_ID

Step 2: Add HTML Snippet in Beehiiv

1. Open your Beehiiv post editor
2. Type / to open the block menu
3. Under Premium, select HTML Snippet
4. Paste this code:

<a href="https://bannertrackr.com/api/track/img/YOUR_PIXEL_ID" target="_blank">
  <img
    src="https://bannertrackr.com/api/track/img/YOUR_PIXEL_ID"
    alt="Sponsored by [Sponsor Name]"
    width="100%"
    style="max-width: 600px; height: auto; display: block; margin: 0 auto;"
  />
</a>

5. Replace YOUR_PIXEL_ID with your actual Pixel ID
6. Update the alt text with your sponsor's name

Step 3: Preview

Use Beehiiv's preview to check your banner looks correct in both email and web views. The HTML Snippet shows a preview right in the editor.

Method 2: Impression Tracking Only

If you're using Beehiiv's built-in ad network or want to host images elsewhere:

Add a Tracking Pixel

Add an HTML Snippet near your sponsored content:

<img
  src="https://bannertrackr.com/api/track/px/YOUR_PIXEL_ID"
  width="1"
  height="1"
  alt=""
  style="opacity: 0; position: absolute;"
/>

This gives you BannerTrackr impression analytics alongside Beehiiv's built-in stats.

Method 3: Styled Sponsor Block

For a polished sponsored section with a label:

<div style="background: #f9f9f9; padding: 20px; margin: 20px 0; text-align: center;">
  <p style="font-size: 11px; color: #888; margin: 0 0 10px 0; text-transform: uppercase; letter-spacing: 1px;">
    Sponsored
  </p>
  <a href="https://bannertrackr.com/api/track/img/YOUR_PIXEL_ID" target="_blank">
    <img
      src="https://bannertrackr.com/api/track/img/YOUR_PIXEL_ID"
      alt="Sponsor Name"
      style="max-width: 100%; height: auto;"
    />
  </a>
</div>

HTML Snippet Limitations

Beehiiv's HTML Snippet has some important limitations:

• No scripts — JavaScript won't run in emails
• No interactive elements — Forms, videos with controls won't work
• Web and email compatibility — Avoid mixing web-only and email-only HTML elements in the same snippet

Stick to basic HTML and inline CSS for best results. BannerTrackr's tracking URLs work perfectly within these constraints.

Styling Examples

Rounded Corners

<a href="https://bannertrackr.com/api/track/img/YOUR_PIXEL_ID">
  <img
    src="https://bannertrackr.com/api/track/img/YOUR_PIXEL_ID"
    alt="Sponsor"
    style="max-width: 100%; border-radius: 8px;"
  />
</a>

With Border

<a href="https://bannertrackr.com/api/track/img/YOUR_PIXEL_ID">
  <img
    src="https://bannertrackr.com/api/track/img/YOUR_PIXEL_ID"
    alt="Sponsor"
    style="max-width: 100%; border: 1px solid #eee;"
  />
</a>

Centered with Max Width

<a href="https://bannertrackr.com/api/track/img/YOUR_PIXEL_ID" style="display: block;">
  <img
    src="https://bannertrackr.com/api/track/img/YOUR_PIXEL_ID"
    alt="Sponsor"
    width="100%"
    style="max-width: 600px; height: auto; margin: 0 auto; display: block;"
  />
</a>

Common Placement Positions

Where to put sponsor banners in your Beehiiv newsletters:

On Free Plans?

If you're on Beehiiv's free plan and don't have access to HTML Snippets:

1. Use Beehiiv's standard image block for your banner
2. Link the image using Beehiiv's link feature
3. Set the link to your BannerTrackr click URL: https://bannertrackr.com/api/track/click/YOUR_PIXEL_ID

This tracks clicks but not impressions (similar to Substack).

Beehiiv vs BannerTrackr Analytics

Beehiiv provides its own analytics. Here's how they compare:

Use both: Beehiiv for overall newsletter performance, BannerTrackr for sponsor-specific reporting.

Troubleshooting

HTML Snippet not available?

The HTML Snippet feature requires a paid Beehiiv plan (Scale or Max). Check your plan in Beehiiv settings.

Banner not displaying?

1. Check your Pixel ID is correct
2. Ensure you've uploaded an image in BannerTrackr
3. Preview the email in Beehiiv
4. Make sure you're using https:// URLs

Tracking not working?

1. Verify the placement isn't paused
2. Check your monthly impression limit
3. Make sure the URL has no extra spaces or characters

Different stats than Beehiiv?

This is normal — different systems count differently:

• Beehiiv counts email opens
• BannerTrackr counts actual image loads (more accurate for ad impressions)
• Proxy traffic (like Apple Mail Privacy Protection) is handled differently

Next Steps

• UTM Tracking — Track conversions in Google Analytics
• Advertiser Portal — Give sponsors access to their stats
• Reports — Generate PDF reports for sponsors