Updated: Feb 18, 2026
Article Contents
Knowledge Base
Using URL dynamic parameters for Ad Network tracking
When running ads through the beehiiv Ad Network, you can add parameters to your Click URLs to pass dynamic campaign data into your analytics tools.
This allows you to track performance at a granular level — including by publication, campaign, creative, and placement — inside platforms like Google Analytics, Northbeam, Rockerbox, or any other first-party reporting tool.
What are dynamic parameters?
Dynamic parameters (also known as macros or dynamic tags) are placeholders you add to your ad’s Click URL. When a newsletter is sent, beehiiv automatically replaces these placeholders with real values tied to that specific send. This ensures each click includes contextual data about where and how the ad appeared.
For example, the parameter: {{publication_alphanumeric_id}} is replaced with the ID of the publication that ran the ad.
Supported URL dynamic parameters for Ad Network tracking
To track your performance accurately, you can append the following dynamic parameters to your URL.
Field Name |
Dynamic Parameter |
Description |
|
Publisher ID (Required) | {{publication_alphanumeric_id}} | The unique ID of the beehiiv publication running your ad. |
|
Post ID (Optional) | {{resource_id}} | The specific newsletter post where the ad appeared. |
|
Campaign ID (Suggested) | {{ad_network_campaign_id}} | The unique ID of your overall ad campaign. |
|
Campaign Name<> (Optional) | {{ad_network_campaign_name}} | The human-readable name of your campaign. |
|
Creative ID (Suggested) | {{ad_network_advertisement_id}} | The unique ID for the specific ad creative used. |
|
Creative Name (Optional) | {{ad_network_advertisement_name}} | The name of the creative (e.g., Spring_Sale_Banner). |
|
Creative Type (Suggested) | {{ad_network_advertisement_kind}} | Indicates whether the ad placement was Primary or Secondary. |
|
Payout Type (Optional) | {{ad_network_payout_type}} | Identifies the bidding model used (CPC or CPM). |
|
Date of Open (Optional) | {{current_date_mdy}} | The date the reader opened the email (MM-DD-YYYY). |
How to implement dynamic parameters in your URL
To use these parameters, simply add them to your landing page URL as UTM parameters or custom query strings..
Example URL structure:
If your landing page is https://www.yourbrand.com/shop, your tracked URL should look like this:
https://www.yourbrand.com/shop?utm_source=beehiiv&utm_campaign={{publication_alphanumeric_id}}&utm_content={{ad_network_advertisement_kind}}
When an ad is served in an email, beehiiv will replace each dynamic parameter with real campaign values.
Best practices when using dynamic parameters
- Always include the Publisher ID. This is critical for cross-referencing performance with beehiiv’s internal reporting.
- Avoid spaces in name-based values. If you plan to pass campaign or creative names into URLs, use underscores instead of spaces (for example, Summer_Launch). This helps keep URLs clean and reduces reporting inconsistencies.
- Keep naming consistent. Using a standardized parameter structure across campaigns will make downstream reporting much easier.
- Test your URLs before launch. Confirm your site can accept any new URL parameters without breaking redirects or page load.