In this article you can read more about:
- How to build a keyword query.
- The logic behind our Advanced Query Builder.
- What actions you have when using several conditions.
- Important notes on how to set up a search query.
- Explanation of the different properties.
Searches and filters are used in Engagor:
- When setting up a topic, to define which mentions are tracked.
- When filtering within your tracked data using the search field (upper right corner).
In this article we focus on defining a keyword search for a topic, but most of it also applies to searching within Engagor data, setting up a smart tag or automation rule, etc. We work with the example Telenet, a Belgian telecom operator.
Step 1: opening the keyword search settings
Go to settings > topics and create or edit the keyword search of a topic by clicking 'Add' next to 'Keyword Search'
Step 2: searching for mentions containing either telenet or "tele net"
Make sure you select the 'Advanced' tab on top. That's the easiest way to create a keyword search.
Let's say people often talk about this brand as "tele net", in two words. This means we have to search for two keywords: telenet or "tele net". Let's insert these keywords.
- Set the green dropdown to 'contains any', ensuring that mentions containing any of the specified words are a match.
(Note that using 'contains all' would mean both words have to be present in order for the mention to come in to Engagor, while 'contains not' would exclude mentions containing any of the keyword(s))
- Add the words telenet and "tele net", using double quotes for the latter (this means you want to monitor that exact combination of words):
Step 3: add conditions for country and language (if you want)
Given we are only interested in mentions from Belgium, we can filter on country.
- Click the + sign on the right of the existing condition to add a new condition below it.
- Set the new condition to say respectively 'country', 'is' and 'Belgium, like this:
Now, Engagor doesn't know location for all the mentions it tracks. (more information on that in the support article on location)
This means we would miss out on the mentions that don't have a location but do come from Belgium. That's why it's always useful to also include mentions without a specific location (location is unknown) in the languages from the country you're interested in (in this case, language is Dutch). Here's how:
- Click the symbol on the very right of the 'country' condition (the one after the +).
- A new condition for 'text' appears
- On the new condition 'text', click the symbol on the right again
- Again a new condition appears and your query will look like the one underneath. Now fill in the newly created conditions like this:
- country is unknown
- language is Dutch
- You've now created a nested query with an 'or' in front of it. This means that one of the two conditions that follow has to be fulfilled:
- either the mention comes from Belgium
- or the mention, in case country is unknown, is in Dutch
This will make your search broader, including both mentions from Belgium, and mentions that have no specific location but are in Dutch. You can do this with whatever country and whatever language(s) you need.
Step 4: watch preview and save query
Before a newly created/edited query can be saved, Engagor asks you to click 'Preview', to double-check that it results in relevant mentions. So, to save your query:
- Click the preview button at the bottom of the dialog. A list of mentions matching the search appears on the right. If nothing appears, no problem, we're not always able to show you exemplary mentions.
- Click the add/save button.
Each grey bar shown is a condition, consisting of
- The property of a mention (e.g. 'text', 'country', 'language')
- What the condition looks like (e.g. contains all, contains any, contains not)
- The specific value the condition is about: in the example on top 'telenet or "tele net"' (text), 'Belgium' (country), etc.
- The mention has to contain telenet or "tele net"
- The mention has to come from a specific location. Mind this is a 'nested' condition: it's introduced by OR. This means that one of the two subconditions that follow has to be fulfilled:
- either the mention comes from Belgium
- or (and then again a nested condition), in case it's from an unknown location, it has to be in Dutch
The following actions can be performed on conditions:
Click the + icon on the right to add a new condition.
- Click the - icon to remove a condition
- Click the 'group and indent' icon (the icon next to +) to make a condition 'nested'. A nested condition can be introduced by OR or AND, which you can change yourself by clicking on the arrow next to OR or AND.
- Condition bars can be dragged to a different position by dragging them using the 'ribbed' handle on the left side.
Some general notes that apply to all keyword searches in Engagor:
Searches can be negative, to exclude keywords. Use 'is not' or 'contains not' in the middle dropdown to exclude keywords, countries, languages...
Keywords are case-independent. A keyword like telenet matches both 'Telenet' and 'TELENET'
- Put words beween double quotes (") if you only want to monitor that exact combination of words: E.g. "Amnesty International" or "tele net".
- Proximity: proximity means, setting a condition that different words have to appear within x words from each other in the text. You can do this for the distance between individual words, but you can't do this for word groups. You can't say that "amnesty international" and "world peace" have to appear within 20 words of each other. What you can say: I want amnesty and international to appear within 20 words from each other. Like this:
Be careful to attach ~20 immediately after the words between quotes (without a space).
- Keyword complexity: there is a maximum limit to how many keywords you can track in one query/topic. This is related to the number of OR conditions of your text, though combinations of different OR conditions can make the complexity increase rapidly. See the article on keyword complexity for a more detailed explanation.
Note that, when a keyword query is not allowed because its complexity, you can always split it up in two different topics to ensure you are monitoring every keyword you wish.
- Underlying the advanced query builder is a 'raw' query, which you can view and edit in Expert Mode. Please refer to this support article for more info.
These are the properties conditions can have:
- Text: the keywords you want to monitor
- Author: if you only want to include mentions by certain authors (= their exact user names on social media)
- Category: if you only want to monitor a specific source (blogs, forums, news, etc.)
- Content: the keywords you want to monitor but that have to be part of a mention's content (and thus not its title)
- Country: the country the mentions have to come from
- Full Name: if you only want to include mentions by certain people (= their full name on social media. For example: author is folke / full name is "folke lemaitre"
- Language: the language the mentions have to be in
- Source domain: the website the mentions have to come from (Note! Always insert websites like this: www.engagor.com and like this: engagor.com, just to be sure you don't miss out on any mentions ;-))
- Title: the keywords you want to monitor but that have to be part of a mention's title (and thus not its content)