Listening is a tool for monitoring digital conversations. It helps you understand what customers are saying about brands, products, and industries.
After setting up a keyword-based query, Emplifi Social Marketing Cloud allows you to monitor digital content. The outcomes of such a query are listening mentions and you can:
- analyze them in Analytics or Content modules of the Emplifi platform
- respond to them in Community
How to create a query?
Based on keyword based conditions, the queries define what content we collect for you, what sources we monitor, and for what date range we collect data.
You input these parameters in a four step process:
- Choosing the keywords
- Defining data sources
- Previewing the mentions
- Summing up the query
The following text describes the steps in detail.
1. Choose your keywords
Keywords are the basic part of your query. They’re a set of conditions that define what listening mentions you’ll collect from social media and the web.
A keyword can be a plain text word or a word combination, a #hashtag, or a @mention. You enter them by typing into the text field and pressing enter.
Keywords are not case-sensitive, so there’s no need to type both KEYWORD and keyword.
You can use AND and OR conditions when setting up the query conditions. This way, you can define:
- Keywords (and their combinations) that must be present in the text.
- Keywords (and their combinations) that cannot be present in the text.
Each query must be based on at least one “include condition”. Queries consisting solely of excluding conditions are not supported.
2. Define data sources
Choose digital sources you want to monitor for listening mentions. You have 5 options you can combine:
- YouTube
- Web
By default, all 5 sources are selected. You can keep all of them, proceed with only one of them or combine them as you wish. Additional settings options for each source allow you to enrich the data set or narrow it down.
Learn more about the data sources and the advanced options of their combinations.
3. Preview mention examples
Depending on the settings of your data source, you can get a preview of the mentions your query may collect and an estimate of their amount.
The preview is based on Twitter data from the last 30 days and it shows tweets matching the query settings and filters.
If you turn off Twitter as a data source, you would still see mention examples based on Twitter data. However, Twitter usually generates the majority of the results, so it can be used to estimate the expected amount of data for your query.
Data is accurate for historical data, which is available only for Twitter.
If the estimate indicates you would exceed your mention limit, you can regulate the number of mentions for your query. Go to step 4 to learn more
4. Sum up the query
The last step allows you to:
- Name the query
- Set up for how long it would collect data
- Enable listening data for community management
- Regulate the volume of mentions
Name and date range of the query
We recommend naming the query in a way that’s understandable and easy to find for later use. There are no limitations, though.
By default, the start date is set to 'now' and the end date as 'forever'. However, you can let the query run for a limited time and schedule the start and end to a specific day in the future. For example, if you’re planning a short time campaign.
Twitter historical data
Historical data is available only for Twitter. Once you create a query and add Twitter as a data source, you can choose to collect historical data from the last 30, 90 or 365 days.
Please note that the historical mentions are deducted from the current billing cycle and you can hit your maximum mention limit almost immediately.
Community management
When you know your colleagues managing your social media community will need to work with the mentions, make sure you allow the community management.
Turning the community management on will list the query mentions in Community feeds and allow agents to respond to them (when possible).
If you’re not sure how Listening could affect their work, we recommend checking up with them first.
Regulating the number of collected mentions
All queries in your account share the mention limit of your Listening package. Once you reach this limit, all queries get temporarily suspended and they will not renew until the beginning of the following billing period.
By regulating the number of mentions, you can avoid reaching the limit in case your query is too broad and avoid the suspension of your active queries.
Maximum number of queries and mentions
The maximum limit of queries and mentions depends on your account settings.
The limit for queries takes into account only queries that are considered active. Active queries are those that are running, regulated, suspended, or scheduled.
The limit for the number of mentions counts every mention collected during a month. If you hit the limit, all your queries get suspended. They start collecting data at the beginning of the following month when the limit renews.
In case you need to increase those limits, please reach out to your customer success manager.
The maximum length of a query
For Instagram, Facebook, and YouTube, there is no limit in query length.
For Twitter, a query can be up to 2 048 characters long; for Web, the limit is 4 000 characters maximum. Both numbers are a technical limitation of those sources.
Sometimes the actual length of the query may not be obvious. The length considers the query in its complexity, including the profile names, countries and languages used as a filter. On top of that, some parts of it may not be visible to you, for example, the logical operators and include/exclude conditions.
When you’re not using any filters, you can use up to approximately 1 900 characters when defining the keywords.
Emplifi automatically calculates the query length. If you reach the limit, we return an error message and ask you to reduce the query conditions.
If there’s no way of reducing the query, we suggest breaking the query down into multiple queries.
Query statuses
Based on the selected date range and your account limits, the query can be found in a couple of different statuses. There are two basic types of queries: active and inactive ones. Your account limit only considers active queries; inactive queries are not limited.
Active queries
- Running – The query is collecting data within the specified date range.
- Scheduled – The query will start collecting listening mentions on the scheduled date.
- Regulated - The query hit the annual mentions limit set for the query. The query is run again at the beginning of the next billing period.
- Suspended – The query isn’t collecting any data because of reaching the annual limit for the number of listening mentions. The data collection will be renewed at the beginning of the next billing period.
Inactive queries
- Paused – The query was paused by the user and it isn’t collecting any listening mentions.
- Done – The query has reached the end date and it isn’t collecting any listening mentions.
Query sets, a way to organize your queries
Use query sets to categorize your queries and let them follow your desired structure. You can assign one query to multiple query sets if necessary. It may help you manage the queries and analyze the whole query sets or combination of a query and query set.
For example, this way you can split your queries geographically, per brand, or by topic.
When does the data collection start and how long do you keep the data?
The query starts collecting data depending on the date you choose in the last step of the query wizard: immediately (if you select “now” as the start date) or on the scheduled date.
Depending on the sources of the query, in Analytics and Content Hub mentions are available for further use in less than an hour. In Community, data is usually available almost immediately, but it can take up to a few minutes.
You can learn more about data download and processing in a specialized article here.
Who can create query sets and queries?
Only users with the right to manage queries and query sets can create and edit them.
Users without this permission can only view already created query sets and queries in the respective sections.
Account admins have permission to create query sets and queries by default.
