Skip to content
Audienzz Documentation

Priority Creative IDs

Priority Creative IDs is a feature that allows specific ad creatives to be given priority in the auction process. This ensures that certain creatives will always win the auction when they are available, regardless of their bid price.

How It Works

Section titled “How It Works”

When a creative ID is added to the priority list, htag will:

  1. Check if any bids in an auction match the priority creative IDs
  2. If a match is found, that bid automatically wins the auction
  3. The winning bid is rendered directly, bypassing the normal auction process

This mechanism is particularly useful for guaranteed campaigns or direct deals that must be delivered regardless of competing bids. The list of priority creative IDs is updated dynamically during page load or after ad refresh.

Priority Creatives That Claim Companions

Section titled “Priority Creatives That Claim Companions”

A skin, fireplace or any other creative that claims companion placements — through roadblock or high-impact configuration, on its seat or through a bid config extension — does not take its placement in the step above. It is handed to the allocator instead, which is the only stage that can blank the companions along with it. Being on the priority list still means its price is not weighed against what it displaces:

  • It is allocated before the revenue comparison, so its companions are blocked however little it bid. A priority creative that won its own placement first would end up competing against itself, and its companions would never be blocked — it would render underneath them.
  • If any placement it claims is already held by another priority or override winner, it is discarded and renders nowhere. Two direct deals overlapping is a booking conflict, and the alternative is two creatives rendering on top of each other.
  • When two priority creatives claim the same placements, the higher CPM takes them. The other is reported with console.error, which is visible on an ordinary production page.

A roadblock whose companions do not resolve claims nothing, and stays an ordinary priority creative that keeps refreshing on its own placement.

Publisher Control

Section titled “Publisher Control”

handlePriorityCreative is consulted once per auction for every priority creative, whichever stage owns it. Returning nothing skips a plain priority creative; for one that claims companions it stops the creative being allocated ahead of the revenue comparison, and it competes on CPM like any other bid.

Section titled “Related Methods”
Section titled “Related Concepts”
  • Roadblock: How a bid claiming companions is allocated
  • High Impact: Mutually exclusive ad format competition across placements