Skip to main content

AudienceGPT Documentation

AudienceGPT is an AI-powered audience taxonomy classification platform for digital advertising. It classifies audience segments through a 7-layer intent taxonomy engine and pushes them to major DSP platforms -- enabling data providers, agencies, and ad tech companies to build, manage, and activate high-quality audience data at scale.


What AudienceGPT Does

AudienceGPT takes raw audience topic names -- such as "Electric Vehicle Buyers" or "Enterprise Cloud Computing" -- and classifies them into a structured taxonomy with seven analytical layers:

  • Intent Type -- Brand, product, service, solution, and 7 more signal types
  • Intensity -- From dormant interest to critical need (7 levels)
  • Awareness Stage -- Eugene Schwartz's 5 stages of buyer awareness
  • Segment Type -- B2B, B2C, B2B2C, B2E, or B2G classification
  • Sensitivity -- Flags regulated categories (cannabis, gambling, health, etc.)
  • Buyer Journey -- Purchase ready, active evaluation, or research discovery
  • Composite Score -- Combined 0-100 score with funnel stage and action signal

Each classified topic receives platform-specific segment names formatted for LiveRamp, Trade Desk, Index Exchange, and custom DSP platforms -- ready to push with a single click.


Key Features

AI-Powered Classification

Classify individual topics through the conversational chatbot, or process thousands in bulk via CSV import. AudienceGPT uses Claude AI with structured outputs and optional web search to verify brands and products before classifying.

41-Category Taxonomy

A comprehensive taxonomy spanning 13 top-level groups and 41 parent categories with IAB content codes, from Automotive to Travel and Leisure. Each category includes domain signals, example topics, and audience type labels.

Segment Activation

Push classified segments directly to LiveRamp Data Marketplace, Trade Desk Taxonomy API, and Index Exchange via SFTP/S3. The activation pipeline handles batching, retry, name uniqueness, and error tracking.

Campaign Brief Analysis

Upload campaign briefs (PDF, Word, PowerPoint, or images) and let AudienceGPT recommend 3-5 audience topics extracted from the brief. Select a recommendation to start the classification flow.

Matrix Generation

Generate combinatorial audience segments from dimension crosses -- such as "all US states x age ranges" -- creating hundreds of classified topics in one batch with 22 built-in demographic, geographic, and firmographic dimensions.

Global Catalog

Browse and search the global topic catalog with over 14,000 pre-classified audience segments. Add topics to your organization's library directly from the chatbot or catalog interface.

Data Hygiene

Monitor pushed segments for staleness, detect outdated engine versions, and refresh stale activations individually or in bulk. The hygiene dashboard provides a unified view of data health across all connections.

Configurable Output Templates

Customize segment naming and description formats per platform using template fields and separators. Built-in templates for Trade Desk (Koa-optimized), LiveRamp, and Internal formats, with support for custom templates.


Documentation Sections

Customer Guide

End-user documentation for dashboard users -- classification, library management, imports, sync, activations, and more.

API Reference

Technical documentation for developers integrating via API or SDK -- authentication, endpoints, request/response schemas, and error codes.

Admin Guide

Superadmin operations -- global topic management, dedup/merge, taxonomy tree, output templates, and background jobs.

Integrations

Platform-specific integration guides for LiveRamp, Trade Desk, Index Exchange, and building custom connectors.


Quick Start for Common Tasks

TaskWhere to Go
Classify your first topicCustomer Guide: Classification
Import topics from CSVCustomer Guide: CSV Import
Upload a campaign briefCustomer Guide: Campaign Briefs
Push segments to LiveRampIntegrations: LiveRamp
Push segments to Trade DeskIntegrations: Trade Desk
Set up API authenticationAPI Reference: Authentication
Manage global topicsAdmin Guide: Global Topics
Customize output templatesAdmin Guide: Output Templates
Build a custom connectorIntegrations: Custom Connectors

Developer Setup

For developers working on the AudienceGPT codebase:

ResourceDescription
Quick StartEnvironment setup and first run
ArchitectureSystem design and classification pipeline
Field MappingDB-to-TS field swap convention
Taxonomy Structure7-level hierarchy and taxonomy tree

ResourceURL
Applicationapp.audiencegpt.ai
GitHubkotovos/taxonomy_advisor