# Context Variables #### Overview Context Variables are values describing the user's current environment. They are resolved before the creative is rendered and are available for binding directly in components. Context variables are divided into two categories: - ****Context Variables**** – Values obtained directly from backend services (Geo, Weather, Network, Bot, Time). - ****Advanced Context Variables**** – Values computed from one or more raw context variables. --- #### Variable Categories

Category	Source	Description
Geo	Backend	User location
Weather	Backend	Current weather conditions
Network	Backend	ISP, protocol, RTT
Bot	Backend	Bot detection
Time	Backend	Local time information
Device	Browser	Device characteristics
Viewport	Browser	Viewport dimensions
Derived	Backend	Computed contextual values

--- #### Context Variables #### Geo

Variable	Type	Description
`geo.country`	String	ISO country code
`geo.city`	String	City name
`geo.region`	String	State or region
`geo.lat`	Number	Latitude
`geo.lng`	Number	Longitude
`geo.timezone`	String	IANA timezone

--- #### Weather

Variable	Type	Description
`weather.temp`	Number	Temperature (°C)
`weather.feels_like`	Number	Feels-like temperature
`weather.humidity`	Number	Humidity (%)
`weather.condition`	String	Weather condition
`weather.icon`	String	Icon URL
`weather.text`	String	Description
`weather.is_day`	Boolean	Day/Night
`weather.precip`	Number	Precipitation
`weather.wind_speed`	Number	Wind speed
`weather.uv_index`	Number	UV Index
`weather.visibility`	Number	Visibility
`weather.sunrise`	String	Sunrise
`weather.sunset`	String	Sunset

--- #### Time

Variable	Type	Description
`time.timestamp`	Number	Unix timestamp
`time.hour`	Number	Hour (0–23)
`time.day_of_week`	Number	Day index
`time.timezone`	String	IANA timezone

--- #### Network

Variable	Type	Description
`network.isp`	String	ISP name
`network.asn`	Number	ASN
`network.protocol`	String	HTTP protocol
`network.rtt`	Number	Round-trip time

--- #### Bot

Variable	Type	Description
`bot.score`	Number \| Null	Bot score
`bot.is_bot`	Boolean	Bot detection
`bot.is_corporate_proxy`	Boolean	Corporate proxy

--- ### Advanced Context Variables #### Overview Advanced Context Variables provide higher-level contextual information that creatives can consume directly without implementing business logic. --- #### Weather

Variable	Parameters	Type	Possible Values	Description
`weather.temperature_band`	`temp`	String	`hot` , `warm` , `cold`	Categorizes the current temperature.
`weather.condition_type`	`condition`	String	`sunny` , `cloudy` , `rainy` , `stormy` , `snowy` , `foggy`	Normalizes weather conditions into common categories.
`weather.uv_level`	`uv_index`	String	`low` , `moderate` , `high` , `extreme`	Classifies UV intensity.
`weather.comfort_level`	`temp` , `humidity`	String	`comfortable` , `humid` , `hot_humid` , `cold`	Indicates perceived outdoor comfort.
`weather.wind_level`	`wind_speed`	String	`calm` , `moderate` , `windy` , `stormy`	Categorizes wind intensity.
`weather.is_daylight`	`is_day`	Boolean	`true` , `false`	Indicates whether it is currently daytime.
`weather.precipitation_level`	`precip`	String	`none` , `light` , `moderate` , `heavy`	Classifies precipitation intensity.
`weather.visibility_level`	`visibility`	String	`clear` , `moderate` , `poor`	Categorizes current visibility.
`weather.activity_suitability`	`temp` , `precip` , `uv_index` , `wind_speed`	String	`excellent` , `good` , `poor`	Indicates suitability for outdoor activities.

--- #### Time

Variable	Parameters	Type	Possible Values	Description
`time.daypart`	`hour`	String	`early_morning` , `morning` , `afternoon` , `evening` , `night`	Current part of the day.
`time.is_weekend`	`day_of_week`	Boolean	`true` , `false`	Indicates whether today is Saturday or Sunday.
`time.is_work_hours`	`hour` , `is_weekend`	Boolean	`true` , `false`	Indicates whether current time falls within typical work hours.
`time.is_commuting_hours`	`hour`	Boolean	`true` , `false`	Indicates typical commuting periods.
`time.meal_period`	`hour`	String	`breakfast` , `lunch` , `snack` , `dinner` , `late_night`	Current meal period.
`time.productivity_state`	`hour` , `is_work_hours`	String	`productive` , `relaxed` , `sleeping`	General activity state based on time.

--- #### Network

Variable	Parameters	Type	Possible Values	Description
`network.speed_tier`	`rtt` , `protocol`	String	`fast` , `moderate` , `slow`	Overall network performance classification.
`network.supports_rich_media`	`speed_tier` , `protocol`	Boolean	`true` , `false`	Indicates whether the connection is suitable for rich media.
`network.video_quality_tier`	`speed_tier`	String	`low` , `medium` , `high`	Recommended video quality tier.

--- #### Traffic

Variable	Parameters	Type	Possible Values	Description
`traffic.quality_tier`	`bot_score` , `is_bot` , `is_corporate_proxy`	String	`high` , `medium` , `low`	Overall traffic quality assessment.
`traffic.is_suspicious`	`bot_score` , `is_bot` , `is_corporate_proxy`	Boolean	`true` , `false`	Indicates potentially suspicious traffic.
`traffic.trust_score`	`bot_score` , `is_bot` , `is_corporate_proxy`	Number	`0–100`	Numeric trust score for the request.

--- #### Audience

Variable	Parameters	Type	Possible Values	Description
`audience.outdoor_score`	`temp` , `precip` , `uv_index` , `wind_speed` , `is_daylight`	Number	`0–100`	Indicates how suitable current conditions are for outdoor activity.
`audience.outdoor_likelihood`	`outdoor_score`	String	`high` , `medium` , `low`	Likelihood that the user is outdoors.
`audience.commerce_intent`	`hour` , `is_weekend` , `is_work_hours` , `daypart` , `temp` , `precip` , `condition_type`	String	`high` , `medium` , `low`	Estimated shopping intent.
`audience.engagement_likelihood`	`quality_tier` , `speed_tier` , `daypart` , `is_work_hours`	String	`high` , `medium` , `low`	Estimated likelihood of interacting with the creative.
`audience.mobility_state`	`hour` , `is_weekend` , `is_work_hours` , `daypart` , `activity_suitability`	String	`sleeping` , `commuting` , `working` , `leisure` , `stationary`	Estimated current mobility state.
`audience.session_mood`	`daypart` , `is_work_hours` , `is_weekend` , `mobility_state` , `condition_type`	String	`productive` , `relaxed` , `entertainment` , `rushed`	Estimated user mindset.
`audience.purchase_context`	`daypart` , `is_work_hours` , `is_weekend` , `mobility_state` , `condition_type`	String	`impulse` , `relaxed` , `functional`	Estimated purchasing context.

--- #### Device

Variable	Parameters	Type	Possible Values	Description
`device.rich_media_ready`	`speed_tier` , `trust_score`	Boolean	`true` , `false`	Indicates whether the device and connection are suitable for rich media experiences.
`device.experience_tier`	`speed_tier` , `trust_score` , `quality_tier` , `rich_media_ready`	String	`premium` , `standard` , `lite`	Recommended creative experience tier.

--- #### Media

Variable	Parameters	Type	Possible Values	Description
`media.video_quality`	`speed_tier` , `video_quality_tier`	String	`240p` , `480p` , `720p` , `1080p`	Recommended maximum video resolution for the current connection.