Creative Macros
Macros are available within the Creative's Target URL and CAG fields (e.g. headline, description, etc).
Target URLs
An example of using macros within the creative target URL:
http://tracking.com?aff_click_id={{adverseClickId}}&adv_sub={{adId}}
When the Creative is rendered, the {{adverseClickId}}
and {{adId}}
macros will be replaced with the value of the Adverse Click ID. For example:
http://tracking.com?aff_click_id=cjrlxwohg0000q9pppznx9q1v&adv_sub=abcdef
Note: The url will actually become
http://tracking.com?aff_click_id=cjrlxwohg0000q9pppznx9q1v&adv_sub=abcdef&adverseClickId=cjrlxwohg0000q9pppznx9q1v
becauseadverseClickId={{adverseClickId}}
is always appended to the target URL
CAG Fields
Here's an example of adding geo information to a Creative that is using a CAG with a "headline" field:
Headline:
Check out the best deals for lion tamers in {{geoCity}}, {{geoState}}!
This depending on the visitor's location this will become something like:
Check out the best deals for lion tamers in Los Angeles, CA!
Available Macros
Available macros for the creative target URL and CAG fields:
- Any provided criteria (provided via
data-*
attributes,lincx-*
&adverse-*
url query paramaters, or thewindow.adverse()
JavaScript method -- see documentation on passing criteria for more information) - Key/values placed on the ad itself (when editing an ad entity)
- Platform provided values:
geoState
- "CA"geoCity
- "Los Angeles"geoCountry
- "US"geoRegion
- "CA"geoPostal
- "90068"scoreKey
* - zone score key from the client script data atttributedata-score-key="rich"
timestamp
* - visitor local timestamp, example2019-02-01T15:00:33+03:00
utcHour
* - for example12
visitorHour
* - for example15
zoneId
* - unique zone identificatoradId
* - unique ad identificator
- Not available for CAG Fields