Ad Tags
content_pasteMacros for Ad Serving
content_pasteAMP HTML Ads
Campaign Setup
Good To Know
License & Billing
Native Ads
Reports
Targeting
Tutorials

Macros for Ad Serving

menu_book Knowledge Base chevron_right Ad Tags
AdGlare Ad Server

AdGlare comes with some built-in macros that you can use in Third Party tags or Landing URLs. These type of macros are commonly used for cache-busting.

They can also be used to pass on valuable information to the Landing Page of an ad. For example, the page the ad has been shown on, or ad server specific identifiers like the zone ID, campaign ID, creative ID, etc.

Find below a list of all macros AdGlare supports.

Commonly Used Macros

VariableDescriptionExample
{ts}The Unix timestamp.
1600712010
{rnd}Random 10 character alpha-numeric string.
34GJGDWB3R
{zID}The Zone ID.
1234567890
{cID}The Campaign ID.
1234567890
{crID}The Creative ID.
1234567890
{pID}The Contact ID.
1234567890
{ip}IPv4 address of the visitor.
34.234.223.162
{width}Width of the creative.
468
{height}Height of the creative.
60
{device}The visitor's device type.
pc | mobile
{referer}The URL on which the campaign is displayed.
http://domain.com/abc
{referer_esc}The escaped/encoded referer URL.
http%3A%2F%2Fdomain.co
{ua}The browser's user agent string.
Mozilla/5.0 (Linux; Andro...
{ua_esc}The escaped/encoded browser's user agent string.
Mozilla%2F5.0+%28Linux
{subdomain}The subdomain on which the campaign is displayed.
www.domain.com
{domain}The domain on which the campaign is displayed.
domain.com
{zone_name}The zone name (URL encoded).
my+zone+name
{campaign_name}The campaign name (URL encoded).
my+campaign+name
{creative_name}The creative name (URL encoded).
my+creative+name
{landing_url}Expands to the Landing URL entered during setup.
-
{click_url}Tracks clicks and redirects to appending URL.
-
{click_url_esc}An escaped click URL macro.
-
{click_url_esc_esc}A double escaped click URL macro.
-

Geolocation Macros

VariableDescriptionExample
{geo_country}The country name of the visitor.
United States
{geo_country_iso2}ISO 3166-1 alpha-2 country code of the visitor.
US
{geo_country_iso3}ISO 3166-1 alpha-3 country code of the visitor.
USA
{geo_region}The region of the visitor. It can be a number.
Nevada
{geo_city}The city name of the visitor.
New York
{geo_latitude}The latitude of the visitor.
37.751
{geo_longitude}The longitude of the visitor.
-97.822
{geo_dma_code}United States DMA. Empty otherwise.
501
{geo_continent_code}The visitor's 2-letter continent code.
NA

Conversion Macros

VariableDescriptionExample
This macro is available when you've enabled conversion tracking for your campaign.
{agcid}A unique click ID to track the conversion.
fTFwa1FXMDIkPCEt...

Cookie Macros

VariableDescriptionExample
Cookie macros are available for Display Ads of which the ad tag has been directly added to the web page.
{cookie_mykey}The value of the cookie with the key 'mykey'.
myvalue
{cookie_esc_mykey}The escaped value of the cookie with the key 'mykey'.
x%3A1

Create your own Macros

VariableDescriptionExample
Custom macros are available when their keys have been passed to the ad tag URL. Example:
http://yourname.engine.adglare.net/?123456789&ag_custom_mykey=red
{ag_custom_mykey}The value of the key 'mykey'.
red

External Resources

Share This
Article!

emoji_peopleTogether we can build wonderful ad serving technology!

Since 2013, AdGlare powers the ad serving stack of hundreds of brands and publishers worldwide. With ideas and suggestions coming from Publishers, AdOps and Marketeers like you, we're proud to offer one of the easiest and fastest ad servers in the market. We adhere to IAB's LEAN Ads Program and Google's Coalition for Better Ads.

Are you a publisher or brand? Reach out to see how we can help you.

 
menu_book
Docs
chevron_left
Previous
double_arrow
Next
star_border
Favorite
share
Share
print
Print
Feel free to
get in touch