Chrome DevTools Protocol

Methods

Ads.getAdMetrics

Retrieves ad metrics for the current page.

Return Object
metrics
AdMetrics

Ads.getAdScripts

Retrieves ad scripts for the current page. To minimize payload size, this only returns the newly tracked ad scripts since the last call to getAdScripts (i.e., the delta).

Return Object
newScripts
array[ AdScript ]

Types

Ads.AdFrameData

Ad frame data.

Type: object

properties
frameId
Page.FrameId

The DevTools frame token.

initialOrigin
string

The initial origin of the frame. To minimize the payload size, this is only sent once per frame.

networkBytes
number

The network bytes of the frame.

cpuTime
number

The CPU time of the frame, in milliseconds.

Ads.AdMetrics

Ad metrics for a page.

Type: object

properties
viewportAdDensityByArea
integer

The viewport ad density by area, represented as a percentage (an integer between 0 and 100).

averageViewportAdDensityByArea
number

The time-weighted average of the viewport ad density by area, measured across the duration of the page.

viewportAdCount
integer

The number of ads currently visible within the viewport.

averageViewportAdCount
number

The time-weighted average of the viewport ad count, measured across the duration of the page.

totalAdCpuTime
number

The total ad CPU usage, in milliseconds.

totalAdNetworkBytes
number

The total ad network bytes.

updateAdFrames
array[ AdFrameData ]

The list of ad frames that have been updated since the last event.

removeAdFrames
array[ Page.FrameId ]

The list of ad frame IDs that have been removed since the last event.

Ads.AdScript

An ad script. Note: when the script is a transitive ad script, we only fill in the immediate ancestor script in the provenance's adScriptAncestry field (as its first entry), rather than filling in the full ancestry. This saves work for the backend, and the frontend can reconstruct the full ancestry if necessary.

Type: object

properties
scriptId
Runtime.ScriptId

The script ID.

provenance
Network.AdProvenance

The ad provenance.