{"id":10961,"date":"2025-04-16T18:50:08","date_gmt":"2025-04-16T18:50:08","guid":{"rendered":"https:\/\/wiki.pontiac.media\/?docs=ctv-documentation\/creative-specs\/creative-macros"},"modified":"2026-05-04T19:38:15","modified_gmt":"2026-05-04T19:38:15","slug":"creative-macros","status":"publish","type":"docs","link":"https:\/\/wiki.pontiac.media\/?docs=ctv-documentation\/creative-specs\/creative-macros","title":{"rendered":"Creative Macros"},"content":{"rendered":"\n<p>Pontiac macros must be implemented using the exact supported format to ensure data is passed correctly. Incorrect formatting will result in missing data. For more information or support, please contact your Account Manager or the Help Center.<\/p>\n\n\n\n<div class=\"wp-block-group\"><div class=\"wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained\">\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:100%\">\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:100%\">\n<figure class=\"wp-block-table is-style-stripes\"><table class=\"has-fixed-layout\"><thead><tr><th>MACRO<\/th><th>DESCRIPTION<\/th><\/tr><\/thead><tbody><tr><td>${IP_HASH}<\/td><td>Salted encryption (blocked for GDPR compliance)&nbsp;<\/td><\/tr><tr><td>${LINE_ID}<\/td><td>Pontiac Line ID<\/td><\/tr><tr><td>${CREATIVE_ID}<\/td><td>Pontiac Creative ID<\/td><\/tr><tr><td>${HEIGHT}<\/td><td>Pixel height of the creative<\/td><\/tr><tr><td>${WIDTH}<\/td><td>Pixel width of the creative<\/td><\/tr><tr><td>${CAMPAIGN_ID}<\/td><td>Pontiac Campaign ID<\/td><\/tr><tr><td>${ADVERTISER_ID}<\/td><td>Pontiac Advertiser ID<\/td><\/tr><tr><td>${TAG_ID}<\/td><td>Unique identifier of the ad tag used for serving the impression<\/td><\/tr><tr><td>${SITE_DOMAIN}<\/td><td>The domain of the site or app where the impression is served<\/td><\/tr><tr><td>${GEO_POSTAL_CODE}&nbsp;<\/td><td>The postal or ZIP code of the user\u2019s location for the impression<\/td><\/tr><tr><td>${GEO_COUNTRY}<\/td><td>The country of the user\u2019s location for the impression<\/td><\/tr><tr><td>${GEO_REGION}<\/td><td>The state, province, or region of the user\u2019s location for the impression<\/td><\/tr><tr><td>${GEO_LAT}<\/td><td>Latitude of the user\u2019s location for the impression<\/td><\/tr><tr><td>${GEO_LONG}<\/td><td>Longitude of the user\u2019s location for the impression<\/td><\/tr><tr><td>${PUBLISHER_NAME}<\/td><td>The name of the publisher serving the impression<\/td><\/tr><tr><td>${PUBLISHER_ID}<\/td><td>Unique ID of the publisher serving the impression<\/td><\/tr><tr><td>${SERIES}<\/td><td>The series name associated with the content where the impression served<\/td><\/tr><tr><td>${CHANNEL]<\/td><td>The channel name or identifier where the impression served<\/td><\/tr><tr><td>${NETWORK}<\/td><td>The TV or media network associated with the impression<\/td><\/tr><tr><td>${GENRE}<\/td><td>The genre classification of the content (e.g., Sports, News, Entertainment)<\/td><\/tr><tr><td>${TITLE}<\/td><td>The specific title of the content where the impression served<\/td><\/tr><tr><td>${BID_PRICE}<\/td><td>The bid price<\/td><\/tr><tr><td>${BID_ID}<\/td><td>Unique identifier for the bid generated in the auction<\/td><\/tr><tr><td>${APP_BUNDLE_ID}<\/td><td>The app\u2019s bundle identifier where the impression served<\/td><\/tr><tr><td>${DEVICE_TYPE}<\/td><td>The numeric IAB category code representing the type of device (e.g., mobile, desktop, CTV, set-top)<\/td><\/tr><tr><td>${DEVICE_IFA}<\/td><td>Identifier for the device if available<\/td><\/tr><tr><td>${DEVICE_OS}<\/td><td>The numeric IAB category code representing operating system of the device (e.g., iOS, Android, Roku OS)<\/td><\/tr><tr><td>${DEVICE_MAKE}<\/td><td>Manufacturer of the device (e.g., Apple, Samsung, LG)<\/td><\/tr><tr><td>${DEVICE_MODEL}<\/td><td>Model of the device (e.g., iPhone 14, Fire TV Stick 4K)<\/td><\/tr><tr><td>${TIMESTAMP}<\/td><td>Timestamp of when the impression was served (UTC)<\/td><\/tr><tr><td>${DEAL_ID}<\/td><td>Identifier for the deal associated with the impression<\/td><\/tr><tr><td>${GDPR}<\/td><td>Flag indicating whether the impression falls under GDPR regulation<\/td><\/tr><tr><td>${CLICK_URL}<\/td><td>The destination click-through URL for the ad<\/td><\/tr><tr><td>${CLICK_URL_ENCODED}<\/td><td>The destination click-through URL encoded for the ad<\/td><\/tr><tr><td>${CACHEBUSTER}<\/td><td>Inserts a random number to prevent a browser from serving a cached version of an ad to ensure that every ad impression is counted accurately.<\/td><\/tr><tr><td>${SITE_PAGE}<\/td><td>The full URL of the page where the request originated.<br>Returned in lowercase and not URL-encoded.<\/td><\/tr><tr><td>${SITE_PAGE_ENC}<\/td><td>The full URL of the page where the request originated, URL-encoded.<br>Returned in lowercase and encoded using UTF-8 (e.g., https%3A%2F%2Fexample.com%2Fpage).<\/td><\/tr><tr><td>${SITE_REFERRER}<\/td><td>The referrer URL indicating the page that led to the current request.<br>Returned in lowercase and not URL-encoded.<\/td><\/tr><tr><td>${SITE_REFERRER_ENC}<\/td><td>The referrer URL indicating the page that led to the current request, URL-encoded.<br>Returned in lowercase and encoded using UTF-8.<\/td><\/tr><tr><td>${AUCTION_ID}<\/td><td>The auction ID of the impression.<\/td><\/tr><tr><td>${CONTENT_ID}<\/td><td>The content ID of the impression.<\/td><\/tr><tr><td>${EXCHANGE_ID}<\/td><td>The exchange ID serving the impression.<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div><\/div>\n\n\n\n<p><\/p>\n","protected":false},"author":17,"featured_media":0,"parent":9800,"menu_order":1,"comment_status":"closed","ping_status":"closed","template":"","doc_tag":[],"class_list":["post-10961","docs","type-docs","status-publish","hentry","no-post-thumbnail"],"comment_count":0,"_links":{"self":[{"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/10961","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/users\/17"}],"replies":[{"embeddable":true,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=10961"}],"version-history":[{"count":16,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/10961\/revisions"}],"predecessor-version":[{"id":13020,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/10961\/revisions\/13020"}],"up":[{"embeddable":true,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/9800"}],"next":[{"title":"Creative Macro Implementation Recommendations & Examples","link":"https:\/\/wiki.pontiac.media\/?docs=ctv-documentation\/creative-specs\/creative-macro-implementation-recommendations-examples","href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/11983"}],"prev":[{"title":"Creative Types","link":"https:\/\/wiki.pontiac.media\/?docs=ctv-documentation\/creative-specs\/creative-types","href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/11909"}],"wp:attachment":[{"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=10961"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_tag&post=10961"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}