AdVision watches the video and image creatives that reach the Elemental TV Ad Server and returns what a reviewer would: who the advertiser is, what the ad is about, which IAB and sensitive categories apply, whether it is safe for families, and what it says. Publishers see it in the Creative Library, filter and block on it and report on it. Platforms get the same analysis over one API call.
| Field | Presence | What it tells you |
|---|---|---|
| advertiser | always | Primary advertiser or brand. |
| adomain · adomain_confidence | always | Advertiser domain, and a 0.0–1.0 confidence in it. A domain you already know can be passed in and is preferred. |
| categories | always | IAB Content Taxonomy codes, tier 2 where possible (e.g. IAB2-3). |
| sensitive_categories · sensitive_categories_version | always | Zero or more of 18 exchange-agnostic values — alcohol, gambling, sports betting, lottery, tobacco, vaping, firearms, weapons, sexual and reproductive health, pharmaceuticals, supplements, nudity, pornography, cosmetic procedures, body modification, cannabis, CBD. An empty array means none detected. Versioned so the enum can grow without surprises. |
| advision_approved_for_families | always | Family-safe gate. |
| offensive_content · unreasonable_claims · acceptable_quality | always | Offensive or NSFW material; claims a reviewer would flag; overall quality flag. |
| split_ad | always | Several distinct ads stitched into one creative. |
| language · content_type | always | Language of the creative (ISO 639-1) and content type, e.g. advertisement. |
| duration · width · height | always | Duration in seconds (0 for a still image) and pixel dimensions. |
| transcription · summary_text | always | Spoken and on-screen text, and a short summary of the ad. |
| secondary_brands | always | Other brands that appear in the creative, each with website and category. |
| is_political · political{} | when detected | Political inventory: advertiser type (candidate, PAC, party, issue advocacy), the issues raised and the sentiment. |
| is_coppa · kids_content_score · coppa{} | when detected | Child-directed inventory: a 0.0–1.0 kids-content score, child-directed flag, data-collection, personalization and social-signup cues, and the rule results behind them. |
Political and COPPA blocks are attached on the same call only when the creative qualifies — no extra requests, and ordinary creatives carry no empty blocks. They are signals for your own review and rules, not a legal certification. New fields may be added over time; ignore keys you do not know.
Pipelines that always need the political or COPPA block can call the dedicated /analyze/creative/political and /analyze/creative/coppa endpoints instead; same key, same body, same polling. Write to support@elementaltv.com for a key.
AdVision's job is to turn a creative file into facts the Ad Server can act on. The analysis already returns more than the Creative Library exposes — political and child-directed signals, sensitive categories, the transcript and summary. The next releases close that gap and add the controls publishers have asked for.
