<% var v = snap || {}; var bd = v.breakdown || {}; var hasRun = v.visibilityScore != null; var plats = v.platforms || []; var appc = v.appearedCount, ansc = v.answersCount; var quiet = plats.filter(function(p){ return p.visibility==null && p.noOverview > 0; }); var dead = plats.filter(function(p){ return p.visibility==null && !(p.noOverview > 0); }); var _total = (typeof totalRuns !== 'undefined') ? totalRuns : 0; var _isStaff = !!(locals.showStaff); %>
AI Search / AI Visibility
<%- include('../partials/range-picker') %>

<%= title %>

<% if (ansc && appc) { %>

AI named you in <%= appc %> of the <%= ansc %> answers we checked.

<% } else if (ansc) { %>

None of the <%= ansc %> answers we checked named you.

<% } else if (hasRun && v.visibilityScore > 0) { %>

You score <%= v.visibilityScore %> out of 100 across the connected engines.

<% } else if (hasRun) { %>

The last run found you in no answer at all.

<% } else if (_total) { %>

No run falls inside this date range.

<% } else { %>

No AI Visibility run yet.

<% } %>

<% if (hasRun) { %>From the run on <%= snap && snap.date ? h.date(snap.date) : 'the latest date in this range' %>.<% } else if (_total) { %>No run in this period. Show the last 12 months.<% } else { %>Your figures appear here after the first run.<% } %>

<% var _shelf = [], _off = []; function _cell(l, val, xt, hlp) { _shelf.push({ l: l, v: val, x: xt || '', h: hlp || '' }); } function _blank(n, cta, href) { _off.push({ n: n, cta: cta, href: href || '' }); } if (plats.length) { var _mentions = plats.reduce(function (t, p) { return t + (p.mentions || 0); }, 0); var _cites = plats.reduce(function (t, p) { return t + (p.citations || 0); }, 0); _cell('Engines asked', plats.length, ''); if (ansc != null) _cell('Answers checked', ansc, '', 'One answer is one tracked question asked on one engine.'); _cell('Mentions', _mentions, ''); _cell('Citations', _cites, '', 'Links to your own pages that the engines cited in answers that named you.'); } if (!hasRun && _total) _blank('This period', 'No run recorded inside this date range', '?range=12m'); else if (!hasRun) _blank('AI Visibility run', 'No engine has been asked about you yet'); else if (!plats.length) _blank('Per-engine breakdown', 'This run recorded no per-engine rows'); else if (ansc == null) _blank('Answers checked', 'This run did not record how many answers it read'); %>
<% if (locals.showStaff) { %>
<% } else { %> See the prompts <% } %>
AI Visibility Score <%- h.ihelp('What this score is', 'One score for how visible you are across your connected AI engines, built from the signals on the right. ' + 'An engine that returns no answers is left out of the score.') %>
<% if(hasRun){ %><%= v.visibilityScore %>/100<% } else { %>—<% } %>
<% if(v.delta){ %>
<%= v.delta>=0?'▲':'▼' %> <%= Math.abs(v.delta) %> vs last run
<% } %> <% if(dead.length){ %>
<% if(_isStaff){ %><%= dead.map(function(p){return p.name;}).join(', ') %><% } else { %><%= dead.length %> engine<%= dead.length===1?'':'s' %><% } %> returned no answers and <%= dead.length===1?'is':'are' %> left out of this score.
<% } %> <% if(quiet.length){ %>
<%= quiet.map(function(p){return p.name;}).join(', ') %>: Google showed no AI Overview for these questions. Left out of the score.
<% } %>
<% var _st = locals.brandStanding; if(_st && _st.rank){ %>Rank #<%= _st.rank %> of <%= _st.total %> brand<%= (_st.total===1)?'':'s' %> named<% if(ansc){ %> · mentioned in <%= appc||0 %>/<%= ansc %> answers<% } %>.<% } else if(appc && ansc) { %>Mentioned in <%= appc %>/<%= ansc %> answers.<% } else if(ansc) { %>Not mentioned in any of the <%= ansc %> answers checked.<% } else if (_total) { %>No run in this period. Show the last 12 months.<% } else { %>No run yet. <% if (locals.showStaff) { %>Hit Refresh now to check the engines.<% } else { %>Your VOCTOS team checks the engines on a schedule.<% } %><% } %>
<% var bdl = [ [h.sigName('visibility'), 'visibility', 'The share of answers that named you.'], [h.sigName('authority'), 'authority', 'How often your own pages were cited as a source, out of 100.'], [h.sigName('citationQuality'),'citationQuality', 'The same citations on a narrower 0 to 100 scale.'], [h.sigName('sentiment'), 'sentiment', 'The share of answers that describe you favourably.'], [h.sigName('entityStrength'), 'entityStrength', 'How often your brand was named across the tracked questions, out of 100.'] ]; %> <% var _bdCols = (function (n) { if (n <= 3) return n; return Math.min(4, Math.ceil(n / 2)); })(bdl.length); %>
<% bdl.forEach(function(x){ var val = bd[x[1]]; var has = val != null; %>
<%= x[0] %><%- h.ihelp(x[0], x[2]) %>
<%- h.sigVal(x[1], has ? val : null) %>
<% if(has){ %>
<% } %>
<% }) %>
<% if (_shelf.length) { %> <% var _sw = { 1:'b4', 2:'b6', 3:'b4', 4:'b3', 6:'b2', 12:'b1' }[_shelf.length] || 'b2'; var _tints = ['sc-violet', 'sc-lime', 'sc-navy', 'sc-sky', 'sc-sand', 'sc-rose']; %> <% _shelf.forEach(function (s, i) { %>
<%= s.l %><%- s.h ? h.ihelp(s.l, s.h) : '' %>
<%= s.v %><%- s.x %>
<% }) %> <% } %> <% if (_off.length) { %>
Not connected yet
<% _off.forEach(function (o) { %>
<%= o.n %> <% if (o.href) { %><%= o.cta %><% } else { %><%= o.cta %><% } %>
<% }) %>
<% } %>

AI platforms

Last run on <%= snap && snap.date ? new Date(snap.date).toLocaleDateString('en-GB', { day: 'numeric', month: 'short', year: 'numeric' }) : '—' %>
<% if (!plats.length) { %>
No engine results for this period.
<% } else { %> <% plats.forEach(function(p){ %> <% }) %>
EngineVisibility vs last runAvg positionMentionsCitationsPositiveNeutralNegative
<%- include('../partials/engine-mark', { engine: p.name || p.code }) %><%= p.name %> <% if(p.visibility==null && p.noOverview > 0){ %>no overview shown <% } else if(p.visibility==null){ %>no answers <% } else { %> <%= p.visibility %>% <% if(p.delta!=null && p.delta!==0){ %><%= p.delta>0?'▲'+p.delta:'▼'+Math.abs(p.delta) %> <% } else if(p.delta===0){ %><% } %> <% } %> <%= p.avgPosition!=null ? p.avgPosition : '—' %> <%= h.int(p.mentions) %><%= h.int(p.citations) %> <%= p.pos!=null ? p.pos+'%' : '—' %> <%= p.neu!=null ? p.neu+'%' : '—' %> <%= p.neg!=null ? p.neg+'%' : '—' %>
<% } %>
<% var S = (typeof series !== 'undefined' && series) ? series : { points: [], engines: [] }; var runs = (S.points || []).filter(function(p){ return !p.future; }).length; var anyGap = S.engines.some(function(e){ return e.gaps > 0; }); var total = (typeof totalRuns !== 'undefined') ? totalRuns : runs; %>

Visibility history

<% var _n = (S.runs != null ? S.runs : runs); %> <% if(_n){ %><% if (S.grouped === 'quarter') { %>one point per quarter, <%= _n %> run<%= _n===1?'':'s' %> in this period<% } else { %><%= _n %> run<%= _n===1?'':'s' %> in this period<% } if (locals.droppedRuns) { %> · <%= droppedRuns %> early test run<%= droppedRuns === 1 ? '' : 's' %> not shown<% } if(S.projected){ %> · dashed line: what each engine could reach<% } %><% } else { %>per engine<% } %>
<% var _years = (typeof years !== 'undefined' && years) ? years : []; %> <% if (_years.length) { %>
Jump to
<% _years.forEach(function(y){ var from = y.year + '-01-01', to = y.year + '-12-31'; var on = range.from === from && range.to === to; %> <%= y.year %> <% }) %> Last 12 months
<% } %>
<% if (!S.engines.length) { %>
<% if(runs){ %> No per-engine results in these runs. <% } else if(total) { %> No run in this period. <% if(typeof nearestRun!=='undefined' && nearestRun){ %>The most recent one was <%= h.date(nearestRun) %>. Show the last 12 months.<% } %> <% } else { %> No runs yet. Each AI Visibility run adds a point per engine<% if (locals.showStaff) { %>, so hit Refresh now<% } %>. <% } %>
<% } else { %>
<% S.engines.forEach(function(e){ %> <%- include('../partials/engine-mark', { engine: e.name || e.code, size: 'sm', bare: true }) %><%= e.name %> <% if(e.last!=null){ %><%= e.last %>%<% } %> <% if(e.delta!=null && e.delta!==0){ %><%= e.delta>0?'▲':'▼' %><%= Math.abs(e.delta) %> over <%= e.measured %> reading<%= e.measured === 1 ? '' : 's' %><% } %> <% }) %>
<% var _pdfPts = (S.points || []).map(function (p, i) { if (p.future) return null; return { label: p.label, rows: (S.engines || []).map(function (e) { var v = (e.values || [])[i]; return { k: e.name, v: v == null ? '' : v + '%' }; }) }; }).filter(Boolean); %> = 2) { %>data-points="<%= JSON.stringify(_pdfPts) %>"<% } %> data-labels="<%= JSON.stringify((S.points||[]).map(function(p){ return p.full || p.label; })) %>" data-future="<%= JSON.stringify((S.points||[]).map(function(p){ return !!p.future; })) %>"> 100 50 0 <% if(S.dividerX && S.projected){ %> <% } %> <% S.engines.forEach(function(e){ var p = e.line || { d: '', dots: [] }; var f = e.forecast; %> <% if(f){ %> <% if(f.line && f.line.d){ %><% } %> <% } %> <% if(p.d){ %><% } %> <% p.dots.forEach(function(dt){ %><% }) %> <% }) %> <% if(S.dividerX && S.projected){ %> live expectations <% } %>
<% var _seen = null; S.points.forEach(function(pt){ var dup = pt.label === _seen; _seen = pt.label; %><% var _cls = (pt.future ? 'fut ' : '') + (dup ? 'rep' : ''); %> title="<%= pt.full || pt.label %>"><%= dup ? '·' : pt.label %><% }) %>
<% var _hasVerdict = S.engines.some(function(e){ return e.last != null; }); %> <% if (_hasVerdict) { %>
What's reachable how far each engine could get<% var _any = (S.engines.find(function(e){return e.forecast;}) || {}).forecast; if (_any) { %> by <%= _any.endLabel %><% } %>, with the work behind it
<% S.engines.forEach(function(e){ var f = e.forecast, u = e.unreadable; if (e.last == null) return; var cap = f ? f.ceiling : 100; var pctNow = Math.max(0, Math.min(100, Math.round(((e.last || 0) / cap) * 100))); var pctGain = f ? Math.max(0, Math.min(100 - pctNow, Math.round((f.gain / cap) * 100))) : 0; %>
<%- include('../partials/engine-mark', { engine: e.name || e.code, size: 'sm', bare: true }) %><%= e.name %> <% if((f && f.declining) || (u && u.declining)){ %> falling now <% } %> <% if (f) { %> <%= e.last %>% today <% if (f.gain > 0) { %> ▲<%= f.gain %> <%= f.mostLikely %>% <% } else { %> at its ceiling <% } %> <% } else { %> <%= e.last %>% today <% } %>
<% if (f) { %>
could reach <%= f.mostLikely %>% (<%= f.low %>–<%= f.high %>%) by <%= f.endLabel %> · from <%= f.basedOn %> reading<%= f.basedOn===1?'':'s' %>
<% } else { %>
<% if (u && u.atCeiling) { %> at the top of its range This engine already names you in <%= u.current %>% of answers, the highest we have measured for it. The goal here is to hold it. <% } else if (u && u.reason === 'swings') { %> too changeable to estimate This engine's answer moves by <%= u.avgJump %> points between runs on average, too much to draw a reliable trend. <% } else if (u) { %> too scattered to estimate The readings swing by <%= u.spread %> points across <%= u.basedOn %> runs, too wide for a useful estimate. <% } else { %> not enough runs yet <%= e.measured %> reading<%= e.measured === 1 ? '' : 's' %> so far. An estimate needs <%= S.minPoints %>. <% } %>
<% } %>
<% }) %>
<% var _fc = (S.engines.find(function(e){ return e.forecast; }) || {}).forecast || {}; var _fromLeader = _fc.ceilingFrom === 'leader'; %>
What each engine could reach by <%= _fc.endLabel %> with the planned content, citation and authority work. how this is worked out How this is worked out The ceiling is <%= _fc.ceiling %>%<% if (_fromLeader) { %>, the share the best-performing brand holds today<% } else { %>, a little above the best level this engine has held<% } %>.

The gain depends on the direction of the readings and how many there are (<%= _fc.basedOn %> so far). The pale part of each bar and the shaded area on the chart show it.

Engines whose readings swing too widely get no estimate.
<% } else if (runs >= 2 && S.canProject) { %>
Why there are no expectations yet Why there are no expectations yetEstimates appear after <%= S.minPoints %> runs per engine.
<% } %> <% if (runs === 1) { %>
One run in this period (<%= S.points[0].label %>), so each engine shows as a single dot. <% if (total > 1) { %> There <%= total===2?'is':'are' %> <%= total %> run<%= total===1?'':'s' %> in total. Show the last 12 months. <% } else { %> The next run adds the second point. <% } %>
<% } %> <% if (anyGap) { %>
Breaks in a line Breaks in a line A break in a line is a run where that engine returned no answers<% if (_isStaff) { %> (a quota limit or an outage on the day)<% } %>. That run is left blank.
<% } %> <% } %>