get_social_attention
Query social attention contagion metrics from the observation stream. Returns windows where attention propagated between viewers (social amplification factor > 1).
Social attention data is produced by the AttentionGraphBuilder running on CTV edge devices, which models viewer attention as a directed graph and detects when one viewer looking at the screen triggers nearby viewers to also look (attention contagion / social amplification).
WHEN TO USE:
Finding moments where social proof drove collective engagement
Identifying which venues or dayparts exhibit highest attention contagion
Understanding cascading attention patterns (cascade depth)
Correlating social amplification with ad effectiveness (VAS)
RETURNS:
data: Array of observation_stream rows with socialAttention payload
payload.socialAttention.socialAmplificationFactor (SAF): ratio of actual-to-expected group attention (>1 = contagion detected)
payload.socialAttention.cascadeDepth: max depth of attention propagation chain
payload.socialAttention.viralAttentionScore: composite metric combining SAF and cascade depth
payload.socialAttention.contagionWindowMs: time window over which cascade occurred
payload.socialAttention.triggerViewerIndex: which viewer initiated the cascade
metadata: { result_count, time_range, min_saf_filter }
suggested_next_queries: Follow-up queries
EXAMPLE: User: "Show me moments where attention went viral in bar venues" get_social_attention({ min_saf: 2.0, venue_type: "bar" })
User: "Find the strongest social amplification events this week" get_social_attention({ min_saf: 3.0, time_range: { start: "2026-03-09T00:00:00Z", end: "2026-03-16T00:00:00Z" } })
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum results to return. Default: 20, max: 200. | |
| min_saf | No | Minimum social amplification factor threshold. Default: 1.5. Higher values return only stronger contagion events. | |
| screen_id | No | Filter by screen MongoDB ID. Optional. | |
| time_range | No | Time range filter. Defaults to last 24 hours. | |
| venue_type | No | Filter by venue type (e.g., "bar", "restaurant_qsr", "transit"). Optional. |