Get Help Your Way

OR

Updated: Oct 20, 2025

Knowledge Base

Implementing the beehiiv Pixel for advertisers

Implementing the beehiiv Pixel for advertisers

Disclaimer: This guide is for advertisers on the beehiiv Ad Network. If you're a publisher using beehiiv but not placing ads as an advertiser, this doesn’t apply. If you’re looking to add tracking pixels to your publication site, refer to this article.

The beehiiv Pixel is a piece of code on your website that can help you better understand the effectiveness of your newsletter campaign and the actions taken on your site as a result of your campaign.

As more people take action based on ads in various newsletters, the beehiiv Ad Network will begin to learn which publications are driving business results, and start identifying more publications that drive results. When you implement the pixel through your entire sales funnel, and pass conversion and custom events through each pixel fire, you’ll be able to measure the true business impact of your campaign.


How to set up an advertiser pixel for Google Tag Manager (GTM) users

To follow these steps, you’ll need:

  • To know the unique pixel ID to use for your campaign. (You can get this from your beehiiv Ad Network point of contact.)
  • A GTM account with access to your website’s container.
  • Administrator access to your beehiiv ad platform account.

Step 1: Add the beehiiv Base Pixel Template

The beehiiv Base Pixel tracks pageviews and should fire on all page loads, including single-page app (SPA) history changes. To use this, you’ll first need to install the beehiiv Pixel V2 template: 

  1. Log in to Google Tag Manager.
  2. Select your container and navigate to Templates in the left sidebar.
  3. Click Search Gallery and search for ‘beehiiv Pixel V2’.
  4. Click Add to Workspace and confirm the addition.
  5. Go to Tags and click New.
  6. Click Tag Configuration > beehiiv Pixel V2.
  7. Configure the Tag Settings. Enter the Pixel ID value that you have received from your beehiiv Ad Network point of contact. 
  8. Select the pageview event.
  9. Set triggering to All Pages.
  10. Click Save

For single-page applications (SPAs)

If you have a single-page application, the tag must fire on all history changes.

  1. Go to Triggers > New.
  2. Select History Change Trigger.
  3. Name the trigger and save it.
  4. Assign this trigger to the beehiiv Base Pixel tag.

Step 2: Add additional event tags

You can track custom interactions like button clicks, form submissions, or video plays utilizing additional event tags.

  1. Go to Tags > New.
  2. Select Tag Configuration > beehiiv Pixel V2.
  3. Configure the Tag Settings: Enter the Pixel ID value that you have received from your beehiiv Ad Network point of contact. 
  4. Choose the Event Name (e.g., signup, button_click, purchase).
  5. (If relevant) set additional metadata like the purchase conversion value.
  6. For triggering, you’ll need to create a trigger for the specific event you want to track (e.g., button click, form submission).
    Go to Triggers > New.
    Choose Click – All Elements or Form Submission, depending on your use case.
    Set the trigger conditions (e.g., click on a button with a specific CSS selector).
  7. Save the trigger and apply it to the tag.

Step 3: Publish the changes

  1. Click Submit in the top right corner.
  2. Provide a name and description for the version.
  3. Click Publish to make the changes live.

Step 4: Verify the setup

  1. Use Google Tag Assistant to verify the pixel fires correctly.
  2. Test both pageviews and event tags in Preview Mode within GTM.
  3. Confirm the data is appearing in your beehiiv ad platform analytics.

Best practices for using a beehiiv Pixel with Google Tag Manager

  • Ensure the Base Pixel fires the pageview on all page loads and SPA history changes.
  • Use descriptive names for your Event Tags to keep reports organized.
  • Regularly test tags in Preview Mode before publishing.
  • Avoid duplicate tracking by verifying other pixels in use.
  • Confirm with your beehiiv point of contact that pixel data is being logged correctly. 

How to set up your advertiser pixel manually

If you’re not using Google Tag Manager, your web developer can install the pixel manually by following our manual implementation documentation

For the best results, make sure: 

  • The pixel is implemented to pass all conversion data fields that are associated with your business objective. 
  • Once set up, confirm with your beehiiv point of contact that all data is being logged accurately. 

Setting up an advertiser pixel for a Shopify site 

The beehiiv Pixel can be added to your website using either the manual steps above or Google Tag Manager to place a pageview event on your site. 

For tracking purchases, Shopify has their own specialized setup. Please see the Shopify advertiser integration guide for more details. 


Using magic links with the advertiser pixel

If you’re a publication running ads via the Ad Network (e.g. to grow your subscriber base), you can track conversions through magic links and your website.

  • The default landing page for a magic link will auto-track a pageview when a user subscribes to your beehiiv-hosted newsletter. 
  • You can choose a different redirect URL after they subscribe via magic link, like a thank-you page, and provide that URL to your beehiiv point of contact. 

 

Related Articles

Want More Features?

Upgrade your plan to access more beehiiv tools and supercharge your growth

the one place to build
the one place to build
the one place to build
the one place to build
the one place to build
the one place to build
the one place to build
the one place to build
the one place to build
the one place to build
the one place to build
the one place to build