Macros List for 3rd Party Pixels
Supported wrapper formats
Brackets | [adunitid] |
Curly Braces | {adunitid} |
Percent | %adunitid% |
Double Dollar | $$adunitid$$ |
Dollar with Curly | ${adunitid} |
You can use the following Frequency Macros for 3rd party pixels, all these placeholders are case sensitive and should be used as it is.
Macros | Placeholders | Description |
Ad Unit Id | {adunitid}, [adunitid], ${adunitid}, %adunitid%, $$adunitid$$
{zoneid}, [zoneid], ${zoneid}, %zoneid%, $$zoneid$$ | Unique identifier for the specific ad slot or placement where the ad appears |
Ad Unit Name | {adunitname}, [adunitname], ${adunitname}, %adunitname%, $$adunitname$$
{adunit}, [adunit], ${adunit}, %adunit%, $$adunit$$ | Human-readable name of the ad unit, providing context about where the ad was served (e.g., "Pre-roll", "Mid-roll"). |
Creative Id | {creativeid}, [creativeid], ${creativeid}, %creativeid%, $$creativeid$$
{bannerid}, [bannerid], ${bannerid}, %bannerid%, $$bannerid$$ | Unique identifier for the specific ad creative asset being served |
Creative Name | {creativename}, [creativename], ${creativename}, %creativename%, $$creativename$$
{creativeslug}, [creativeslug], ${creativeslug}, %creativeslug%, $$creativeslug$$
{filename}, [filename], ${filename}, %filename%, $$filename$$
{bannername}, [bannername], ${bannername}, %bannername%, $$bannername$$ | Human-readable name of the creative asset, useful for identification in reports without needing to reference IDs. |
Listener Id | {listenerid}, [listenerid], ${listenerid}, %listenerid%, $$listenerid$$
{listener_id}, [listener_id], ${listener_id}, %listener_id%, $$listener_id$$
{uid}, [uid], ${uid}, %uid%, $$uid$$ | Anonymized identifier for the individual podcast listener, enabling frequency capping and cross-episode listener behavior analysis. |
Device Id | {deviceid}, [deviceid], ${deviceid}, %deviceid%, $$deviceid$$ | Mobile advertising ID (IDFA/AAID) or device-specific identifier, allowing for cross-app attribution and retargeting (subject to privacy regulations). |
Site Id | {siteid}, [siteid], ${siteid}, %siteid%, $$siteid$$ | Identifier for the publishing entity or platform where the podcast was accessed, enabling publisher-specific reporting. |
Advertiser Id | {advertiserid}, [advertiserid], ${advertiserid}, %advertiserid%, $$advertiserid$$ | Unique identifier for the advertiser running the campaign, useful for cross-campaign analysis and billing. |
Ext Ad Server | {extadserver}, [extadserver], ${extadserver}, %extadserver%, $$extadserver$$ | Identifier for external ad serving systems when multiple ad servers are involved in the delivery chain. |
Latitude | {latitude}, [latitude], ${latitude}, %latitude%, $$latitude$$
{lat}, [lat], ${lat}, %lat%, $$lat$$ | Approximate geographic latitude of the listener at the time of ad delivery |
Longitude | {longitude}, [longitude], ${longitude}, %longitude%, $$longitude$$
{lng}, [lng], ${lng}, %lng%, $$lng$$ | Approximate geographic longitude of the listener at the time of ad delivery |
Timestamp | {ts}, [ts], ${ts}, %ts%, $$ts$$
{timestamp}, [timestamp], ${timestamp}, %timestamp%, $$timestamp$$ | Exact date and time when the ad impression occurred |
Cache Buster | {cachebuster}, [cachebuster], ${cachebuster}, %cachebuster%, $$cachebuster$$
{random}, [random], ${random}, %random%, $$random$$
{cb}, [cb], ${cb}, %cb%, $$cb$$ | Exactly what it sounds like. Random number generated on each impression to prevent browser/server caching and ensure accurate impression counting. |
Privacy | {gdpr}, [gdpr], ${gdpr}, %gdpr%, $$gdpr$$
{gdpr_pd}, [gdpr_pd], ${gdpr_pd}, %gdpr_pd%, $$gdpr_pd$$
{us_privacy}, [us_privacy], ${us_privacy}, %us_privacy%, $$us_privacy$$
{gdpr_consent_110}, [gdpr_consent_110], ${gdpr_consent_110}, %gdpr_consent_110%, $$gdpr_consent_110$$
{gdpr_consent_278}, [gdpr_consent_278], ${gdpr_consent_278}, %gdpr_consent_278%, $$gdpr_consent_278$$
{gdpr_consent_508}, [gdpr_consent_508], ${gdpr_consent_508}, %gdpr_consent_508%, $$gdpr_consent_508$$
{gdpr_consent_68}, [gdpr_consent_68], ${gdpr_consent_68}, %gdpr_consent_68%, $$gdpr_consent_68$$
{gdpr_consent_755}, [gdpr_consent_755], ${gdpr_consent_755}, %gdpr_consent_755%, $$gdpr_consent_755$$
{gdpr_consent_77}, [gdpr_consent_77], ${gdpr_consent_77}, %gdpr_consent_77%, $$gdpr_consent_77$$
{gdpr_consent_78}, [gdpr_consent_78], ${gdpr_consent_78}, %gdpr_consent_78%, $$gdpr_consent_78$$ | Consent flags and privacy compliance information, indicating whether user has provided consent under various regulatory frameworks (GDPR, CCPA/CPRA). |
IP Address | {ip}, [ip], ${ip}, %ip%, $$ip$$
{ipv4}, [ipv4], ${ipv4}, %ipv4%, $$ipv4$$ | Listener's IP address (often partially masked for privacy), enabling geolocation and bot filtering. |
User Agent | {useragent}, [useragent], ${useragent}, %useragent%, $$useragent$$
{ua}, [ua], ${ua}, %ua%, $$ua$$ | Information about the listener's device, browser, and app used to access the podcast, enabling technical compatibility analysis. |
Order Id | {orderid}, [orderid], ${orderid}, %orderid%, $$orderid$$ | Identifier linking the impression to a specific order in the ad trafficking system |
Campaign Id | {campaignid}, [campaignid], ${campaignid}, %campaignid%, $$campaignid$$ | Unique identifier for the advertising campaign |
Player | {playername}, [playername], ${playername}, %playername%, $$playername$$ | Information about the podcast player or app used to play the episode (e.g., Apple Podcasts, Spotify, web player). |
Domain | {domain}, [domain], ${domain}, %domain%, $$domain$$ | Website domain or app bundle ID where the podcast was played, providing context about the listening environment. |
Demographic Ids | {demographicids}, [demographicids], ${demographicids}, %demographicids%, $$demographicids$$ | Segments or demographic categories associated with the listener (when available and privacy-compliant). |
Partner Id | {0}, [0], ${0}, %0%, $$0$$ | Identifier for business partnerships or attribution partners relevant to the transaction. |
Campaign Name | {sa_campaign_name}, [sa_campaign_name], ${sa_campaign_name}, %sa_campaign_name%, $$sa_campaign_name$$ | Human-readable name of the campaign for easier identification in reporting interfaces. |
Geo | {sa_geo_city}, [sa_geo_city], ${sa_geo_city}, %sa_geo_city%, $$sa_geo_city$$ | City-level geographic information about the listener's location during impression. |
Region | {region}, [region], ${region}, %region%, $$region$$ | State, province, or regional information about the listener's location. |
Publisher Id | {publisherid}, [publisherid], ${publisherid}, %publisherid%, $$publisherid$$ | Unique identifier for the podcast publisher or network, essential for revenue attribution. |
Publisher Name | {publishername}, [publishername], ${publishername}, %publishername%, $$publishername$$ | Human-readable name of the podcast publisher or network. |
Placement Id | {placementid}, [placementid], ${placementid}, %placementid%, $$placementid$$
{stationid}, [stationid], ${stationid}, %stationid%, $$stationid$$ | Specific placement identifier within the podcast, often distinguishing between different ad positions. |
Placement Name | {placementname}, [placementname], ${placementname}, %placementname%, $$placementname$$
{stationname}, [stationname], ${stationname}, %stationname%, $$stationname$$ | Human-readable name of the ad placement or position (e.g., "First mid-roll", "Post-roll"). |
Episode Id | {episodeid}, [episodeid], ${episodeid}, %episodeid%, $$episodeid$$ | Unique identifier for the specific podcast episode where the ad was served. |
Episode Title | {episodetitle}, [episodetitle], ${episodetitle}, %episodetitle%, $$episodetitle$$ | Title of the podcast episode where the ad was served. |
Content Language | {contentlanguage}, [contentlanguage], ${contentlanguage}, %contentlanguage%, $$contentlanguage$$ | Language of the podcast content, important for language targeting verification. |
Podcast Id | {podcastid}, [podcastid], ${podcastid}, %podcastid%, $$podcastid$$ | Unique identifier for the podcast show or series. |
Delivery Time | {deliverytime}, [deliverytime], ${deliverytime}, %deliverytime%, $$deliverytime$$ | Timestamp recording when the ad was delivered to the player (may differ from impression time). |
Advertising Tags | {advertisingtags}, [advertisingtags], ${advertisingtags}, %advertisingtags%, $$advertisingtags$$ | Keywords or category tags associated with the ad content for contextual relevance analysis. |
iTunes Category | {itunescategory}, [itunescategory], ${itunescategory}, %itunescategory%, $$itunescategory$$ | Apple Podcasts category classification of the podcast, useful for content categorization. |
Media URL | {mediaurl}, [mediaurl], ${mediaurl}, %mediaurl%, $$mediaurl$$ | URL of the podcast media file being played, helpful for technical troubleshooting. |
RSS URL | {rssurl}, [rssurl], ${rssurl}, %rssurl%, $$rssurl$$ | URL of the podcast's RSS feed, providing distribution channel information. |
Session Id | {sessionid}, [sessionid], ${sessionid}, %sessionid%, $$sessionid$$ | Unique identifier for the listening session, allowing tracking of continuous listening behavior. |
DMA Id | {dmaid}, [dmaid], ${dmaid}, %dmaid%, $$dmaid$$ | A unique numeric code assigned to each media market region for identification. |
DMA Name | {dmaname}, [dmaname], ${dmaname}, %dmaname%, $$dmaname$$ | The name of the geographic region (usually based on a major city) representing the media market. |
Last Updated: July 1st, 2025
Third Party Macros
These macros are not used by Frequency for internal data mapping, They are utilized by third party system (Triton) for their data processing and integration purposes. Frequency UI will accept them and will not show a warning on these.