š NOTE: It is assumed you know how to create custom Dashboards and Charts, and have an understanding of chart Types, Presets, and Metrics. 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).
āļøĀ TIP: You can add one or multiple Group By and Filter options to dissect the data how you see fit. Generally speaking, you'll select Group By options to view a specific slice of data, and, if needed, use Filters to dig deeper.
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 is being searched 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 available for discussion posts only.
- Search Source Key / Search Source Label - View a breakdown of searches against each Federated Search connector that is configured.
- Subcommunity ID / Name - See which subcommunity was searched.
- Knowledge Base ID / Name - See which knowledge base was searched.
Type
Each Search activity logged has aĀ type.Ā The type parameter defines the type of content.
- All
- Discussions
- Articles
- Places
- Members
Use theĀ 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 that has been configured for your community. These options allow you to track your federated searches.
š NOTE: The Search Source Key never changes.
- For integrations built with our Custom API Connector, the Search Source Key is the ID you configured.
- The Zendesk Guide connector will always have the Zendesk Search Source Key.
User options
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
