analyst-segments

Analyze and define Braze audience segments with filter logic and sizing.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/delta-and-beta/braze-agency --skill analyst-segments
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: analyst-segments
Source: https://github.com/delta-and-beta/braze-agency/tree/main/skills/analyst-segments
Command: npx skills add https://github.com/delta-and-beta/braze-agency --skill analyst-segments

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Helps analysts and marketers reliably define, size, and troubleshoot Braze audience segments so campaigns and Canvases reach the intended users without unexpected exclusions, delivery errors, or overly complex queries.

Core Features & Use Cases

  • Audience construction & filter logic: Guidance on building segments using demographic, behavioral, app, and regex filters with best-practice operator use (AND/OR) and exclusion groups.
  • Advanced targeting: When to use Segment Extensions, SQL Segment Extensions, or CDI segments and how to meet each type's requirements (external_user_id, casting, refresh behavior).
  • Sizing, suppression & troubleshooting: Explain estimated vs exact statistics, reachable users by channel, suppression list behavior, and remediation for "Target Audience Too Complex" or byte-limit errors.
  • Use case: Analyze a campaign's target audience that returned unexpectedly low reachable users, identify filter or suppression causes, and recommend whether to simplify filters, convert regex to CSV, or migrate to SQL/CDI extension.

Quick Start

Analyze the segment "Lapsed Users - 30 days" for sizing discrepancies, list likely causes, and recommend a corrective plan including suppression checks and whether to use SQL or CDI.

Frequently Asked Questions about analyst-segments

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

FAQPage Schema
Why does my Braze segment show unexpectedly low reachable users?

Braze SQL Segment Extensions are best for complex audience queries exceeding standard filter limits, ensuring external_user_id casting meets output requirements. Use them when standard segmentation causes 'Target Audience Too Complex' errors or needs advanced behavioral logic.

How do I fix the 'Target Audience Too Complex' error in Braze campaigns?

Fix 'Target Audience Too Complex' errors by simplifying AND/OR filter logic, converting regex filters to CSV lists, or migrating the audience to SQL or CDI segments to bypass byte-limit and query complexity constraints.

When should I use Segment Extensions versus standard filters for audience targeting?

Use Segment Extensions over standard filters when you need advanced behavioral targeting or SQL queries. Standard filters suit simple demographic or app usage segmentation, while extensions handle complex logic but require understanding their specific refresh behavior.

How do suppression lists affect Braze audience sizing and campaign delivery?

Suppression lists directly reduce Braze audience sizing by permanently excluding specific users from campaign delivery. Verify suppression list behavior alongside standard filter exclusions to accurately troubleshoot unexpected drops in reachable users across channels.

Can I use regex modifiers in Braze segment filters without hitting byte limits?

Regex modifiers in Braze segment filters can trigger byte-limit errors if the query becomes too complex. Convert regex filters to CSV lists or migrate to SQL Segment Extensions to maintain accurate audience targeting without exceeding technical constraints.