Skip to content

Behavioral Data Browser

The Behavioral Data Browser (BDB) is FanFest's audience intelligence tool. It gives channel administrators a real-time, filterable view of every user in their channel -- who they are, where they are, what they have done, and how engaged they are. Beyond viewing data, the BDB lets you run targeted email campaigns directly against filtered audience segments.

Accessing the BDB

Open the BDB from the channel admin settings dropdown:

  1. Navigate to your channel
  2. Click the Settings gear icon in the channel header
  3. Select Behavioural Data Browser from the dropdown menu

Interface Overview

The BDB interface has two main areas:

  • Sidebar (left) -- Time range selector, activity filters, and experience filters
  • Content area (right) -- User table with column headers for searching and sorting, plus action buttons for export and audience activation

Filtering Your Audience

The BDB provides two categories of filters: sidebar filters that control which users appear in the table, and table header filters that refine results by user attributes.

Time Range

Set a date range to scope all data to a specific period. The default range is the last 30 days. Click the calendar button to open a date picker where you can select start and end dates.

Community Filter

Filter users by community membership. Select one or more communities from the dropdown to see only users who belong to those communities. The dropdown shows all communities configured for your channel.

Action Filters

Filter by the types of actions users have performed. The BDB supports two filter categories:

  • Actions -- Platform-level actions (e.g., watching a show, answering a quiz, joining a raffle). These are the built-in engagement actions that FanFest tracks automatically.
  • Channel Actions -- Custom actions specific to your channel, configured through the leaderboard admin. These are actions tracked via the SDK or API integration.

The action filter mode controls how multiple selected actions combine:

  • AND mode -- Users must have performed all selected actions
  • OR mode -- Users must have performed at least one of the selected actions

Experience Filters

Narrow results to users who participated in specific content:

FilterWhat It Matches
Onsite EventsUsers who attended specific real-world events
ShowsUsers who watched specific live shows
QuizzesUsers who participated in specific quizzes
RafflesUsers who entered specific raffles
ThreadsUsers who engaged with specific discussion threads

Each dropdown lists all available items for that content type, showing the title and creator.

Table Header Filters

The table header row provides column-level filtering and sorting:

Type in the search field to find users by name or username. The search filters results in real time as you type.

Location (Country)

Click the Location column header to open a country filter dropdown. Select one or more countries to filter by user location. The dropdown only shows countries that exist in your current user base. Each column header also has a sort toggle (ascending/descending/unsorted).

Language

Click the Language column header to filter by user language preference. Like the location filter, only languages present in your audience are shown.

Points (Minimum Threshold)

Enter a minimum points value to filter out users below a certain engagement threshold. This is useful for targeting your most active fans.

Sorting

Every table column supports sorting. Click the arrow icon in any column header to cycle through:

  1. Ascending (arrow up)
  2. Descending (arrow down)
  3. Unsorted (neutral)

Available sort columns: User Info, Location, Language, and Points.

Exporting Data

Click the Export as CSV button above the table to download the current filtered results as an Excel file (.xlsx). The export respects all active filters -- sidebar filters, table header filters, sorting, and date range -- so you get exactly the audience segment you see on screen.

The exported file includes: username, email, country, language, and points for each user in the filtered set.

Audience Activations (Email Campaigns)

The BDB goes beyond passive analytics by letting you send targeted email campaigns to your filtered audience. This is called an activation.

How Activations Work

  1. Filter your audience using the sidebar and table header filters
  2. Click the Reward Fans dropdown button
  3. Select an activation type
  4. Choose specific content to promote
  5. Review the campaign recap
  6. Send a test email or send to the full audience

Activation Types

The Reward Fans dropdown offers these activation types:

TypeDescription
OfferPromote a specific offer or deal to the filtered audience
ShowInvite users to an upcoming or live show
ThreadDrive engagement to a discussion thread
Onsite EventPromote a real-world event
RaffleEncourage participation in a raffle
QuizDrive quiz participation
PollPromote a poll for community input

Activation Flow

After selecting an activation type:

  1. Choose content -- Browse a list of available items for the selected type and pick the one you want to promote
  2. Review recap -- See a summary of the activation including the content details, target audience size, and campaign title
  3. Set campaign title -- Give the email campaign a descriptive name
  4. Send test email -- Send a test email to yourself first to verify the content and formatting
  5. Send to audience -- When satisfied, send the activation to all users matching your current filters

TIP

Always send a test email before sending to your full audience. The test email goes only to you, so you can verify the content, formatting, and links before reaching your fans.

Pagination

The BDB displays up to 1,000 users per page. Use the pagination controls at the bottom of the table to navigate through larger audiences. All filters persist across pages.

Best Practices

  • Start broad, then narrow -- Begin with a wide date range and progressively add filters to find the audience segment you need.
  • Use AND mode for high-value segments -- When you want users who have done multiple things (e.g., watched a show AND entered a raffle), switch to AND mode for action filters.
  • Export before campaigns -- Export your filtered audience to review the list before sending an activation, especially for large audiences.
  • Test first -- Always send a test email before launching a campaign to your full audience.
  • Combine community and activity filters -- Filter by community first to scope to a segment, then add activity filters for more precision.

Released under the MIT License.