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 ishttps://www.mywebsite.com
, the URL to use the Ad Inspector must behttps://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. | |
HB bidder** | The name of the bidder that won the header bidding auction in this ad slot. | |
HB CPM** | The CPM of the highest bid that won the header bidding auction in this ad slot. | |
HB creative ID** | The ID of the creative from the highest bid that won the header bidding auction in this ad slot. | |
HB currency** | The currency of the highest bid that won the header bidding auction in this ad slot. | |
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. | |
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. | |
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. |
|
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 ). |
|
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. |
|
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. |
|
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 |