Win notification macro

DSPs must include the ${AUCTION_PRICE} win notification macro and optionally the ${SUPPLY_FEE} macro in the adm or burl field of the Bid object. Bids without a win notification macro are rejected. The macro is replaced only if you win the auction and the creative is served to a user.

Include the following win notification macros in the creative that you send to Index Exchange (IX):

macro scope description

${AUCTION_PRICE}

Required

The winning price for the impression, in dollars.

${SUPPLY_FEE}

Optional

The revenue share percentage (%) that IX takes as margin from the buyer’s bid.
Include the ${SUPPLY_FEE} macro to receive IX's revenue share for individual transactions in real-time. For example, a 5% revenue share will result in a value of “5.0”. This macro is not enabled for all DSPs by default. To enable it, contact your IX Representative.
Note: If the seller does not allow fee disclosure, IX will not substitute the ${SUPPLY_FEE} macro with the IX revenue share and will return an empty macro.

If the DSP wins the auction, the win notification macro is evaluated and the bid price is sent to the DSP when the ad markup or burl is consumed by the browser, video player, or ads SDK. If the publisher allows fee disclosure and the ${SUPPLY_FEE} macro is included, the IX revenue share for that transaction is also provided. For more information, see win notification examples.

Encrypting clear prices

Some publishers require that any pricing information that is visible on the page to be encrypted. We support encryption of the clear price embedded in DSP win notifications using Google’s encryption algorithm, HMAC_SHA1.

Bid Response

To support encryption, you must append a custom suffix such as IEX to the clear price notification macro in the bid response using the OpenRTB standard in the following format:

price=${AUCTION_PRICE:IEX}

IX advises that all DSP partners support clear price encryption. Bid responses that do not support this are excluded from all auctions where a publisher requires encryption.

Win Notification

Use Google’s algorithm to decrypt an encrypted clear price. For more information, see Decrypt Price Confirmations in Google's Authorized Buyers documentation. We provide encryption and integrity keys; the decrypted values are displayed in micro USD. Refer to the decryption output below for an example:


Integrity Key: ed81b2e9466ec5fa4f1384272f634a0cb5262d2085e3b5262810eabc96051537
Value to Decode: Vs3pLAAAAADhyo6uRlLOWOL_BrmQYsSx-Uinbw
Decoded Value: 4534896 micro dollars = 4.534896 dollars

DSPs are notified of a winning bid (and the results) after each impression is served.

Creative Previews

If an encryption method is defined between IX and the DSP, then the creatives used for previews and approval will have the clear price notification macro replaced by the encrypted equivalent of 0$ or a custom value (for example, AUDIT). This helps DSPs differentiate creative previews from real traffic.