audience-management

Query and segment RUM users and accounts via the Datadog Audience Management API.

5|2|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/lauhon/pi --skill audience-management-lauhon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audience-management
Source: https://github.com/lauhon/pi/tree/main/skills/audience-management
Command: npx skills add https://github.com/lauhon/pi --skill audience-management-lauhon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Analyzing and segmenting your user base requires writing complex API calls against Datadog's RUM Audience Management API, and enriching audience data with external CRM or reference table sources involves intricate connection configuration that is easy to get wrong. ## Core Features & Use Cases - User and Account Querying: Search, filter, sort, and wildcard-match users and accounts using flexible query syntax, including event-filtered queries based on RUM behavior like errors or slow page loads. - Facet and Mapping Discovery: Retrieve value distributions for any attribute and inspect available entity attributes before building queries. - Data Connection Management: Create, update, list, and delete connections that join CRM or reference table data (subscription tier, lifetime value) to user and account profiles, with confirmation safeguards for write and delete operations. - Use Case: A customer success manager asks to find enterprise accounts with declining engagement, then enriches the results with CRM health scores to prioritize outreach. ## Quick Start Ask the agent to find all US users who experienced errors in the last week and show their email, error count, and last seen date.

Frequently Asked Questions about audience-management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query users in Datadog RUM Audience Management?

Send a POST request to /api/v2/product-analytics/users/query with a query string like "first_country_code:US AND session_count:>50", plus select_columns, sort, and limit parameters. The API supports exact match, wildcards, numeric comparisons, and AND/OR logic.

How do I filter users by RUM events like errors or slow page loads?

Use the event-filtered query endpoint at /api/v2/product-analytics/users/event_filtered_query. Provide an event_query with RUM search syntax and a time frame, combined with user property filters, to find users matching both behavioral and attribute criteria.

How do I enrich Datadog audience data with CRM fields?

Create a connection via POST /api/v2/product-analytics/{entity}/mapping/connection, specifying a join attribute like user_email and the fields to import, such as customer_tier or lifetime_value. Enriched custom fields are then queryable with an @ prefix.

What credentials does the Datadog Audience Management API require?

It requires three environment variables: DD_API_KEY for the Datadog API key, DD_APP_KEY for the application key, and DD_SITE for the Datadog site, which defaults to datadoghq.com. Missing credentials produce an explicit error.

Is the Datadog Audience Management API stable for production use?

The API is v2 marked as x-unstable and in preview, meaning it is subject to breaking changes without notice. Implement robust error handling, version your integration, and monitor the API changelog before relying on it for critical workflows.