📝 NOTE: It is assumed you know how to create custom Dashboards and Charts. If not, read this article before proceeding.
When building your own Dashboard Charts, you can pull data from various data sources to view different types of analytics events.
- In this article, we're going to focus on the Search data source, which tracks all search activity across your Higher Logic Vanilla (Vanilla) community.
Overview
The Search data source tracks all search activity across your community. For each Search event logged, you can see:
- Various search details
- Information about the user who searched
Refer to the Filter Chart data section below for more information each of these.
Filter Chart data
Controlling what data is shown in a Chart is accomplished via the Group By and Filter options.
- The Group By options (available for pie graphs, line graphs, bar graphs, and tables) enable you to view data by content type, search term, location, and more.
- You can add Filters to your query to drill into or exclude specific types of Search events (e.g., exclude specific user searches or focus your Chart on searches performed in a specific country or subcommunity).
Let's learn about each of the available Group By and Filter options.
Search details
You can use the following Group and/or filter options to refine chart data:
- Type or Domain - View what type of content the user is searching for (e.g., discussions, articles, etc.).
- Search Terms - View each individual word typed into search.
- Original Query - View the full phrase searched.
- Search Results Count - See the number of results returned.
- Tag ID / Name - View the tags used to filter search. 📝 NOTE: Tags are only available for discussion posts.
- Search Source Key / Search Source Label - View a breakdown of searches against each Federated Search connector configured.
- Subcommunity ID / Name - See the subcommunity searched.
- Knowledge Base ID / Name - See the knowledge base searched.
Type
Each Search activity logged has a type. The type parameter defines the type of content:
- All
- Discussions
- Articles
- Places
- Members
Use the Type Group By or Filter option to understand the types of content being searched in your community.
Search Source
The Search Source Key and Search Source Label pertain to the source of each Federated Search connector you have configured for your community. These options allow you to track your federated searches.
The Search Source Key never changes.
- For integration built with our Custom API Connector, the Search Source Key is the ID you configured.
- Zendesk Connector will always have the Zendesk Search Source Key.
User info
The Search data source tracks details about each user who performs a search. You can Group and/or filter chart data by:
- User Name
- User ID
- User UUID
- User Role Type
- User Role Names
- User Role IDs
- User Rank
- Continent
- Country
