Retrieve traffic signal events for a domain. Detects significant traffic changes (month-over-month, quarter-over-quarter, year-over-year) and new market entries based on configured traffic signal thresholds. Data is monthly, released ~6th of the following month. Without date parameters, returns the latest available snapshot.
Possible output fields:
domain: Domain the signal was detected for
metric: Traffic metric the signal reports on (e.g., MonthlyVisits, PaidSearchVisits, TotalBounceRate). For the engagement sub-type, one of the engagement metrics (BounceRate, PagesPerVisit, AvgVisitDuration, VisitsPerVisitor)
sub_type: Sub-type of the signal: getting_traction (traffic grew), losing_traction (traffic declined), engagement (engagement metric changed), or new_markets (metric crossed a threshold for the first time in 24 months)
marketing_channel: Display name of the marketing channel (e.g., Paid Search, Organic Social, Direct). Present only for channel-specific metrics; omitted for overall traffic and engagement metrics
direction: Direction of change: Grew or Declined. Present only for getting_traction, losing_traction, and engagement; omitted for new_markets
period: Comparison period: qoq, mom, or yoy. Present only for getting_traction, losing_traction, and engagement; omitted for new_markets
country: Country for the traffic signal (e.g., United States). Worldwide when the signal is global
current_metric_value: Current value of the traffic metric (raw number)
change: Change as a raw fraction (e.g., 0.125 = +12.5%). Present only for getting_traction, losing_traction, and engagement; omitted for new_markets
threshold: Threshold value crossed for the first time in 24 months. Present only for new_markets; omitted otherwise
message: Human-readable description of the event
event_date: Date the signal event occurred (YYYY-MM-DD)
