Contact support

Troubleshoot ad delivery with Equativ Ad Inspector

Overview 

The Equativ Ad Inspector, also known as "Debug console" is a powerful tool to investigate issues related to ad delivery on websites. It helps developers, webmasters, campaigns managers etc. by providing detailed information (names, identifiers, parameters etc.) about the placements on a website, the delivered insertions/creatives, the delivered deals, header bidding winners etc. 

Prerequisites

To be able to use the debug console, the website to be investigated must be tagged with Equativ ad tags and must have Equativ’s smart.js library implemented (see Tagging guide: get started for more details). This is the case for customers using Equativ’s direct campaign and RTB offer, including customers using the unified auction and managed unified auction offers.

Enabling the Equativ Ad Inspector

To enable the Equativ Ad Inspector:

  • make sure you are investigating a website with the smart.js library integrated, as explained under “Prerequisites” above)
  • open the website
  • in the browser bar, attach the parameter /?equativ_debug to the URL; for instance, if the website is https://www.mywebsite.com, the URL to use the Ad Inspector must be https://www.mywebsite.com/?equativ_debug
  • reload the page

Floating banners

If the Equativ Ad Inspector is enabled, an orange floating banner is displayed in the top left corner of each ad slot (placement) on the page.

The table below describes the information displayed on each floating banner. 

Element Description Related documentation
Creative ID* The Creative ID of the delivered creative. Add and manage creatives 
Deal ID* The Deal ID from which an ad was delivered in the ad slot. Create private auction and preferred deal   
Format ID The format ID of the ad slot.

Tagging guide: get started 

Create placements

HB bidder** The name of the bidder that won the header bidding auction in this ad slot.

Set up and manage unified auction

Set up and manage unified auction (managed)

HB CPM** The CPM of the highest bid that won the header bidding auction in this ad slot.

Set up and manage unified auction

Set up and manage unified auction (managed)

HB creative ID** The ID of the creative from the highest bid that won the header bidding auction in this ad slot.

Set up and manage unified auction

Set up and manage unified auction (managed)

HB currency** The currency of the highest bid that won the header bidding auction in this ad slot.

Set up and manage unified auction

Set up and manage unified auction (managed)

Insertion ID* The ID of the insertion delivered in the ad slot. Create direct insertion: general settings and delivery
Link to the insertion in Monetization* The direct Monetization link to the insertion delivered in the ad slot.

Create direct insertion: general settings and delivery 

Use creative template library 

Network ID The ID of the Equativ customer’s network in Monetization (account at Equativ). Tagging guide: get started 
Site ID The site ID of the ad slot.

Tagging guide: get started 

Create placements

Tag ID The ID of the container that contains the ad slot. By default, the tag ID name is sas_<formatId> (e. g. if the Format ID is 123, the corresponding tag ID is sas_1234). Tagging guide: implementation 
Targeting The keyword / key=value targeting criteria of the ad slot; multiple items are separated by semicolon Set keyword targeting

* Available only if the delivered ad is from an insertion that uses an official creative template; more about official creatives templates in Use creative template library 

** Available only if unified auction / managed unified auction is used, i. e. bids from Equativ’s demand partners compete with bidders from prebid header bidding.

Console

In addition to the floating banners displayed on each ad slot, the console at the bottom of the page displays the ad objects (if an ad was served) and/or the noad objects (if no ad was served) with more details.

Click on ad / noad / formats to expand and display further details.

The table below describes the information displayed in the console for each ad / noad. object.

Element Description Related documentation
formatId The format ID of the ad / noad object.

Tagging guide: get started 

Create placements

formats All format IDs and tag IDs of the Onecall on the given page.The tag ID is the container ID of the ad / noad object. By default, the tag ID name is sas_<formatId> (e. g. if the Format ID is 123, the corresponding tag ID is sas_1234).

Tagging guide: get started 

Create placements

isOnecallJSON:true A boolean indicating if OneCall (true) or Standard Call (false) is used. Tagging guide: implementation 
originalFormatId In most cases, identical to the format ID; e. g. may be different in case of Private Marketplaces n/a
pageId The page ID of the ad / noad object.

Tagging guide: get started 

Create placements

pageName The page name of the ad / noad object; only displayed if used for the given site. POST Ad API integration: parameter reference 
siteId The site ID of the ad / noad object.

Tagging guide: get started 

Create placements

tagId The container ID of the ad / noad object. By default, the tag ID name is sas_<formatId> (e. g. if the Format ID is 123, the corresponding tag ID is sas_1234). Tagging guide: implementation 
target The keyword / key=value targeting criteria of the ad / noad object, separated by semicolon. Set keyword targeting