Suggest Import
Summary
The Suggest import page lets you specify how and where Suggest obtains its data.
Suggest import is represented as an individual tab for the Suggest page.
The terms shown in Suggest are stored in a dedicated Suggest database. This database is separate from the search database and smaller in size, so queries can be answered quickly.
Each Suggest type except search terms requires data from the product data feed. If a field is not imported here, Suggest cannot use it.
You can also import additional fields for two purposes:
Additional search data can be used to extend matching behavior.
Additional return data can be used to pass values such as price or article number back to the shop.
Create your required Suggest types before configuring this page. Then assign source fields to those types here.
Return fields are not displayed by FactFinder in its internal search. To show them in the shop, the shop integration must support them.
Recommended order
For a first setup, use this order:
Assign product data fields to the required Suggest types.
Add source fields if additional Suggest types or fields are needed.
Decide whether search history should be included.
Adjust duplicate removal and priority settings.
Save the transaction and re-import Suggest data.
Configure suggestion sources
Product database
Each source field can be assigned to a Suggest type.
For example: if brandName is assigned to the type Brand, the Suggest window can display brand suggestions from that field.
Available settings:
Active: if checked, the configured product fields are used in Suggest.
Prevent zero-hit suggestions: excludes suggestions that would lead to no results.
Limit fields used from product database: restricts the search to selected fields only.
Each source field row contains:
Product data field: the imported product field used as a source.
Suggestion type: the Suggest type assigned to the field.
Additional search data: additional fields that may be searched together with the source field.
Additional return data: additional values returned to the shop together with the suggestion.
Use Add source field to add another source mapping.
If no mappings exist, the page shows No source fields are configured.
Preconfigured Suggest types often already have source fields assigned. This assignment can be changed in edit mode.
Additional search data
Additional search data can be used to broaden the matching behavior of Suggest.
For example, a manufacturer suggestion can also return matching product suggestions from that manufacturer.
Additional return data
Additional return data contains values that are passed back with the suggestion result.
Typical examples:
price
article number
custom attributes needed by the shop frontend
Search history
Suggest can also use data from the log files of recent days.
This option is active by default. It allows FactFinder to react automatically to user behavior by adding relevant user-generated search terms to the Suggest database.
If required filters are set, only suggestions using one of those filters are imported. The corresponding field and value pair is included as an attribute.
Available settings:
Active: enables or disables search history as a source.
Minimum score: defines the minimum relevance score for imported suggestions.
Minimum search count: defines the minimum number of searches required.
Minimum number of characters: defines the minimum query length.
Required filters: limits imported suggestions to searches using selected filters.
Use Add field to add required filters.
Refine suggestion quality
Duplicate removal
Suggestions can come from multiple sources, so duplicates can appear.
Duplicate removal is enabled by default. FactFinder removes duplicates:
within the same Suggest type
across different Suggest types
Example: if your catalog contains both Adidas products and an Adidas category, Suggest may otherwise display both entries.
If identical suggestions are found, FactFinder keeps the one with the higher priority.
The default priority order is:
product name
brand
category
search term
other types
Available settings:
Active: enables or disables duplicate removal.
Mode: defines whether duplicates are removed across the entire list or only within the same Suggest type.
Extended priority determination
By default, suggestions are mainly ordered by relevance.
When Extended priority determination is active, the priority is also influenced by frequency of use.
Available settings:
Active: enables or disables extended priority calculation.
Maximum enhancement: defines the maximum allowed enhancement.
Hit count and preview image calculation
By default, hit counts and preview images are calculated with a ranked search database.
If this is not desired, the option can be disabled here.
Available settings:
Active: enables or disables hit count and preview image calculation.
Min. amount of records: defines the minimum number of matching records.
Use a ranked search database: uses ranked search data for the calculation.
Calculating hit counts and preview images can increase import cost and runtime.
Control import behavior
Suggest import settings
Cleanup options:
Trim whitespace: removes leading and trailing spaces and duplicate spaces between terms.
Remove HTML code: replaces HTML markup with spaces and decodes HTML entities.
Replace special characters with ISO counterparts: normalizes special characters.
Deduplicate field values: removes repeated values within a field.
Deduplicate Suggest search content: removes duplicated search content across Suggest entries.
Scheduling options:
Import on startup: starts a Suggest import when the application starts.
Import Suggest in product import interval: runs Suggest import together with the regular product import interval.
Import interval: defines the interval used for scheduled Suggest imports.
Activating or deactivating these settings can have serious consequences. If you are unsure, contact the FactFinder Service Desk or your integration partner before changing them.
Apply your changes
After changing the settings on this page, save the transaction and re-import the Suggest data.
Suggest data manual import
The Suggest database is usually updated automatically.
Manual import is usually only required after configuration changes.
1. Open the Import page
Open the Import area from the main menu.
2. Choose a channel
Select the required channel, or choose All Channels.
3. Select Suggest
Choose Suggest from the import type selector.
4. Start the import
FactFinder re-imports the data based on your Suggest configurations.
Preview image and hit count calculation can be resource intensive during Suggest import. Run manual imports outside peak traffic periods.
Any changes will require saving the transaction. Suggest changes only become active after the Suggest data is re-imported.
Last updated
Was this helpful?