Aggregate social attention metrics across screens and time periods. Shows which venues and dayparts have the highest social amplification.
Queries observation_stream for social attention data and aggregates by the
requested dimension (venue, daypart, or screen), computing average SAF,
average cascade depth, average viral attention score, and event count.
WHEN TO USE:
- Understanding which venues generate the most social amplification
- Comparing daypart effectiveness for social contagion
- Identifying top-performing screens for attention cascading
- Planning campaigns that leverage social proof
RETURNS:
- data: Array of aggregated rows, sorted by avg SAF descending
- group_key: the dimension value (venue type, daypart, or screen ID)
- avg_saf: average social amplification factor
- avg_cascade_depth: average attention cascade depth
- avg_viral_attention_score: average viral attention score
- event_count: number of social attention events in the group
- metadata: { group_by, time_range, total_events }
- suggested_next_queries: Follow-up queries
EXAMPLE:
User: "Which venues have the highest social amplification this week?"
get_social_contagion_summary({ group_by: "venue", time_range: { start: "2026-03-09", end: "2026-03-16" } })
User: "Show me social attention by daypart over the last 7 days"
get_social_contagion_summary({ group_by: "daypart" })