v1

latestOpenAPI 3.0.42026-08-06124112344.5 KB

AdHawk

Gets media impressions (OTS - Opportunity To See) data aggregated by media file. Joins audience/impression data with play logs to determine which audience members had an opportunity to see specific media content during playback.

get/adhawk/mediaimpressions

startDatestring date-time

Start date for the query (required)

endDatestring date-time

End date for the query (required)

deviceIdstring[]

Optional list of device IDs to filter by

fileIdstring[]

Optional list of file/media IDs to filter by

minDwellThresholdinteger

Minimum dwell time in milliseconds to count as "viewed" (default: 100ms)

limitinteger

Maximum number of results (default: 100, max: 10000)

file_idstring nullable

The file/media ID

file_namestring nullable

The file/media name

total_impressionsinteger

Total number of impressions that occurred during media playback

unique_device_countinteger

Number of unique devices that played the media with audience present

net_reachinteger

Net reach - count of impressions with dwell time > 100ms (actually viewed)

ots_percentagenumber double nullable

OTS (Opportunity To See) percentage - ratio of net reach to total impressions

ots_per_devicenumber double nullable

OTS count per unique device

avg_dwell_timenumber double nullable

Average dwell time in seconds for impressions with dwell > 100ms

male_countinteger

Count of male impressions

female_countinteger

Count of female impressions

unknown_gender_countinteger

Count of impressions with unknown gender

avg_agenumber double nullable

Average age of audience members (if available)