Macros

What are macros?

Macros are placeholders inside URLs or ad tags that can be used to pass data from one system to another.

They can be used for a variety of purposes in ad serving, like ad tracking, targeting audiences, or customizing ad content based on user signals (like device, country, etc).

Example for publishers

Let's say that you received the following ad tag from an advertiser who's using Sizmek as their third-party ad server:

<script src="https://bs.serving-sys.com/Serving/adServer.bs?ncu=[TRACKING_LINK_ENCODED]</b>&c=12&cn=display&pli=874782337&w=300&h=600&ord=[TIMESTAMP]&z=0&ucm=true"></script>


As you can see, this code has 2 placeholders: [TRACKING_LINK_ENCODED] and TIMESTAMP.

Now you want to replace those placeholders with AdGlare's macros then will be expanded upon serving the ad. The relevant macros are {click_url_esc} and {ts} (see the list below).

After replacing the placeholders, the new ad tag will look like:

<script src="https://bs.serving-sys.com/Serving/adServer.bs?ncu={click_url_esc}&c=12&cn=display&pli=874782337&w=300&h=600&ord={ts}&z=0&ucm=true"></script>


Enter this modified tag as a creative in AdGlare, and you're good to go. If you're not sure which macro(s) to use, ask your advertiser for help.

Example for advertisers

Suppose that you're interested in knowing the user's device type after they click on your ad and are redirected to your landing page.

To do so, you can add the device type macro to your landing URL. Here's an example:

https://www.advertiser.com/landing-page?device={device}


Add this URL, containing the macro, as a landing URL in your AdGlare creative. When served, the macro will expand dynamically to the device type of the user loading the ad. For example:

https://www.advertiser.com/landing-page?device=mobile


List of supported macros

AdGlare supports a wide range of macros that you can use inside third-party ad tags or landing page URLs. Find below a complete list of all macros supported:

Reach out to emailAdGlare Support in case you need further help. You can expect a reply in less than 24 hours.