Every time someone sees search results on your site, EasyFinder sends an event with useful info: what they searched for, how many results came back, and how many filters they used. With a little setup in Google Tag Manager (GTM), you can capture all of it and forward it to the tools you use, like Google Analytics, Meta Pixel, or any other tag.
What EasyFinder Sends #
Each time a search result page is shown, EasyFinder pushes this event to the data layer:
// Example event from EasyFinder
{
event: "view_search_results",
search_term: "running shoes",
ef_total_exact_results: 24,
ef_total_relaxed_results: 8,
ef_search_method: "search",
ef_total_active_filters: 2,
ef_source: "easyfinder"
}
Here’s what each field means:
| Field | What it tells you |
|---|---|
search_term |
The word or phrase the user searched for. |
ef_total_exact_results |
Number of results that exactly match the search. |
ef_total_relaxed_results |
Extra results found through smart (semantic) matching. |
ef_search_method |
Which part of EasyFinder triggered the search (for example search or widget). |
ef_total_active_filters |
How many filters the user had active at that moment. |
ef_source |
Always easyfinder. Handy to separate these events from other search events. |
Step 1. Open Google Tag Manager #
Log in to tagmanager.google.com and open the container connected to your website.
If you don’t have GTM installed yet, set that up first by following Google’s quick-start guide.
Step 2. Add the EasyFinder Fields as Variables #
GTM needs to know which fields to read from the event.
Go to Variables → New → Data Layer Variable.
Create one variable per field. For each one, fill in the Data Layer Variable Name exactly like this:
search_termef_total_exact_resultsef_total_relaxed_resultsef_search_methodef_total_active_filtersef_source
Give each variable a clear name (e.g. DLV - search_term) and save.
Step 3. Create a Trigger #
Now tell GTM when to react.
Go to Triggers → New → Custom Event.
Fill in:
- Event name:
view_search_results - This trigger fires on: All Custom Events
Save it as CE - view_search_results.
Step 4. Create a Tag #
Now build the tag that sends the event to the tool of your choice. The most common setup is a Google Analytics (GA4) tag.
Go to Tags → New → Google Analytics: GA4 Event.
Fill in:
- Measurement ID: your GA4 ID (looks like
G-XXXXXXX) - Event Name:
view_search_results
Under Event Parameters, add a row for each field:
| Parameter Name | Value |
|---|---|
search_term |
{{DLV - search_term}} |
ef_total_exact_results |
{{DLV - ef_total_exact_results}} |
ef_total_relaxed_results |
{{DLV - ef_total_relaxed_results}} |
ef_search_method |
{{DLV - ef_search_method}} |
ef_total_active_filters |
{{DLV - ef_total_active_filters}} |
ef_source |
{{DLV - ef_source}} |
Under Triggering, pick the CE - view_search_results trigger. Save the tag.
Step 5. Test and Publish #
Click Preview in GTM and open your site. Do a search and check that the event fires and all values look correct.
When everything looks good, click Submit and publish your container.
view_search_results exactly. It’s case-sensitive.That’s it. Your EasyFinder events are now flowing through Google Tag Manager and ready to be used in any tool you connect.
ef_* fields visible in your reports. Check out our guide on capturing EasyFinder events in Google Analytics.