Tool name measure_audiencesMeasures the reach of an audience by combining multiple cohorts - how many users are in it and how many page views they generate.
Example prompt
How many users and page views would I reach if I combined the luxury car cohort with the premium travel cohort, broken down by country?
Parameters One or more audience expressions to measure, each a string in LISP S-expression form. min 1 item.
Which breakdowns to include beyond total reach. each one of: cohort_contributions, domain_breakdown, device_breakdown, country_breakdown, workspace_breakdown.
Narrow the measured population to activity matching these dimensions. ISO 3166-1 alpha-3 country codes (e.g. GBR, USA). When set, only activity in these countries is counted.
Domain names (e.g. telegraph.co.uk). When set, only activity on these domains is counted.
Workspaces whose user-behaviour data is aggregated across. min 1 item.
Returns One measurement per measurable expression. Per-cohort contribution to this expression. Cohort’s standalone size within the restrict_to filters.
Cohort’s incremental contribution of unique users to the composed expression.
Users per country (ISO 3166-1 alpha-3 code) within this expression’s audience. Show CountryBreakdownEntry
ISO 3166-1 alpha-3 country code (e.g. GBR, USA).
Estimated unique users in this country.
Users per device type within this expression’s audience. Show DeviceBreakdownEntry
Device type (e.g. Desktop, Mobile, Tablet).
Estimated unique users on this device type.
Users per publisher domain within this expression’s audience. Show DomainBreakdownEntry
Estimated unique users on this domain.
The expression that was evaluated, echoed back so results can be paired with inputs.
total_reach
CohortReach object
required
Total reach for this expression across the requested workspaces, within the restrict_to filters. Estimated page views in the last 30 days.
Estimated unique users in the last 30 days.
workspace_breakdown
WorkspaceBreakdownEntry[]
Users per requested workspace within this expression’s audience. Show WorkspaceBreakdownEntry
Estimated unique users in this workspace matching the expression.
One of the requested workspace IDs.
Expressions that were not measured because one or more of their cohorts aren’t available in any of the requested workspaces. Show ExpressionUnavailable
The expression that could not be measured, echoed back so it can be paired with your input.
The cohort short ids in this expression that aren’t available in any of the requested workspaces. min 1 item.
