Below is a list of frequently used macros supported by third-party ads in Authorized Buyers.
More information
For a full list of macros, including detailed information on creating a bid response with real-time bidding, see Building the Response. If you have additional macro implementation questions, please contact us.
| Macro | Description |
|---|---|
AUCTION_ID |
This macro inserts the unique ID of the auction into the URL. This number will be unique each time the macro is loaded. Note: This macro is not supported by Protocol buffer for Authorized Buyers |
CACHEBUSTER |
String representation of a random unsigned 4 byte integer. |
CLICK_URL_ESC |
The escaped click URL for the ad. Use this instead of CLICK_URL_UNESC if you need to first pass the value through another server that will then return a redirect. |
CLICK_URL_ESC_ESC |
Allows two redirects. |
CLICK_URL_UNESC |
The unescaped click URL for the ad. In the snippet, an escaped version of the third party click URL should directly follow the macro. |
SCHEME |
Resolves to http: or https:, depending on the inventory type. Only the HTML tag’s text provided to Authorized Buyers will be adapted, so fourth-party calls outside the HTML tag’s text will not be adapted by this macro. This macro is not supported for VAST in-stream video. |
SITE |
The URL-escaped domain of the content URL. |
TZ_OFFSET |
Timezone offset. |
VERIFICATION |
This macro is used to differentiate creative pings that come from the verification process versus serving. Note: For all ad formats, this macro can be appended in the |
WINNING_PRICE |
The encoded impression cost (that is, CPI rather than CPM) in micros of the account currency. For example, a winning CPM of $5 USD corresponds to 5,000,000 micros CPM, or 5,000 micros CPI. The decoded value of WINNING_PRICE in this case would be 5,000. The winning price is specified in CPI. |
WINNING_PRICE_ESC |
URL-escaped WINNING_PRICE. |
AMPHTML Ads
| Macro | Description |
|---|---|
WINNING_PRICE |
Supported in |
To allow Google to track clicks and easily share with your publishers, your third-party tags must use a Google click macro. Learn how to implement the Google click macro.