The Playboard section lets you configure the Empathy Platform Playboard.

You can customize the Playboard for the customer, set up the filters that merchandisers and analysts use to narrow the data shown, determine the Playboard features to activate, and link the Playboard to the product catalog.

warning

Only Playboard users with permissions for Instance Management can set up and edit the Playboard settings.

When you access the Playboard configuration form for the first time, a Deactivated label is displayed next to the Playboard section in the side menu. This means that there is no active configuration for the service yet. Once you have created the configuration, you need to turn on the Playboard microservice.

To set up the Playboard, you complete these sections:

1. Choose the endpoints to be used when creating configurations with the Playboard tools in the Endpoints section.
2. Customize the dashboard with your customer’s branding in the Customization section.
3. Link the product catalog with the Playboard tools in the Catalog section.
4. Grant permissions for the Playboard features in the Permissions section.
5. Set up filters to narrow the data shown to merchandisers in the Filters section.
6. Choose the KPIs to display in the Playboard in the KPIs section.
7. Set up the Playboard features available in the instance in the Features section.
8. Turn on the Playboard microservice.

The order doesn’t matter, but bear in mind that the information needs to be consistent (for example, the IDs must match in multiple fields) to configure the microservice correctly.

Choosing endpoints

This section lets you choose which endpoints are to be used by the different Playboard management tools when setting up new configurations for your instance.

• Endpoint ID: endpoint identifier for your instance.
• Display name: name for the endpoint that will be displayed in the Playboard tooling.
• Context: context for which the endpoint applies. There are two possible contexts:
  • Query: the endpoint relates to search parameters, specifically, queries.
  • Filter: the endpoint relates to browse parameters, specifically, attributes and attribute values (categories and subcategories) when applicable.

Customizing the dashboard

This section lets you customize the Playboard in line with the company’s branding. You can change the display name that you provided when you requested the new instance. You can choose the logo used in the top left corner of the Playboard, which identifies the instance in the Instances landing page.

• Instance display name: Descriptive name used for the instance. This is particularly useful when there are several instances for the same customer.
• Logo URL: Link to the logo to be used in the Playboard. The image is used in the Instance landing page, the Instance panel when you click the Instance selector, and as the logo in the top right corner of the Playboard. The link must be a public absolute path. The image can be SVG, PNG, or JPG. If you leave this field empty, the Empathy logo is used in the top right corner and the Instance display name is used to identify the instance in the Instance landing page and the Instance panel.
• Responsive logo URL: Link to the isotype to be used in the Playboard. The image is displayed when the Playboard menu is minimized and in the Instance selector.
  The link must be a public absolute path. The image can be SVG, PNG, or JPG. If you leave this field empty, the first two letters of the Instance display name are used.
• Imagotype logo URL: Link to the imagotype to be used in the Playboard. The link must be a public absolute path. The image can be SVG, PNG, or JPG.

Design tips

Image format Use SVG format for better rendering.

Image size The image occupies the available space depending on the location where it's used, usually according to the maximum height and/or maximum width of the container.
For example, in the Instance landing page, a 650 x 426px logo is rendered as approximately 188 x 125px, occupying the maximum height available in the container and calculating the width according to the image's aspect ratio.

Isotypes as responsive logos If your customer’s branding doesn't have a specific isotype and uses a wordmark or a combination mark only, use a fragment of that wordmark (like the first letter) to represent the brand rather than the standard logo.

Linking the catalog

This section connects the product catalog with the Playboard. It determines the product fields to use with the different features in the Playboard. It also maps the fields used for product results from the Search microservice so they can be used in Results Ranking.

Product catalog fields can be marked as Rankable, allowing that field to be used in Results Ranking. This lets merchandisers boost or bury individual products or entire ranges by selecting the attribute and entering a value. For example, if you want to use color as an attribute to boost or bury product results using the Results Ranking tool, you must include the Color field ID in this section and set it as rankable.

To configure the product catalog fields:

1. Enter a valid ID in Product catalog field.

   note

   The IDs are case-sensitive. The Playboard ignores any unrecognized product catalog field IDs.

2. If you want to display a descriptive name rather than the product catalog field ID, enter a value in the Name field.
3. Select the field type by turning on or off the rankable toggle.
4. Click the + icon to add the field. The field is displayed as a row below the Product catalog fields section.

You also need to determine the product result mapping to retrieve the product ID, product name, and product image that are used to display the results in the Playboard. These fields are determined as:

• Result ID: Field in the product catalog where the product ID is found.
• Result name: Field in the product catalog where the product name is found.
• Result image URL: Field in the product catalog where the product image URL is found.

note

All field names are case-sensitive. The Playboard ignores any unrecognized product catalog fields. The field isn't configured, and no action is taken.

interact

Search for a configuration by its ID using the search bar available on top of the list.

Granting Playboard permissions

This section lets you choose the features you want to make visible in the Playboard.

The features are grouped into three domains:

• Search: Determines features related to the search experience.
• Discovery: Determines features related to the browsing experience.
• Global: Determines features that apply to both search and browsing experiences in terms of Playboard administration.

note

You may need to configure some Playboard features in the Features section.

Search features

These features are related to the search experience and are displayed in the following order:

• Insights: You can turn on the Overall and Queries analytics features, which provide data on the evolution in search in terms of users, queries, and sessions, visualizing the KPIs you choose to turn on in the Playboard. Turn on the rest of the features, which relate to the data visualizations in Insights according to the customer’s needs. Some data visualizations use the metrics included as part of Analytics.

• Overall: Understand search evolution with metrics such as clicks, CTR, add to cart, and checkout.

• Queries: View metrics for all queries, queries with results, and queries with no results.

• Now: Explore the queries shoppers used and performance in terms of results and clicks.

• Categories: Explore success metrics across product categories and visualize queries by categories to maximize performance.

• Origins: Understand whether shoppers used organic searches, predictive, or refinement features.

• Terms: Detect popular terms used in search queries to offer relevant suggestions.

• Semantics: Analyze how Semantics reduces the no or low results for a query and increases shoppers' interactions.

• Prompt Metrics: Track prompt performance when leveraging synthetically created, natural-language-like suggestions.

• Play: You can activate multiple features to help merchandisers maximize findability and discoverability in the commerce store.

• Equalize: Configure the product attribute weighting used in ranking the results.

• Synonymize: Set up alternative terms for search queries.

• Blacklist: Hide specific terms as search suggestions.

• Promotion: Highlight specific products on the search engine results page (SERP). If you turn on this feature, you need to determine the type of promotion you want to use in the Features section.

• Redirection: Send shoppers directly to specific URLs from the search box.

• Results Ranking: Change product ranking on the SERP based on products and attributes. If you turn on this feature, you need to determine the pivot fields to be used in the Features section to restrict the impact of the tooling.

• Related Prompts: preview related prompts triggered by a specific query or check the available configurations for curated prompts.

• Related tags: Create and configure related tags.

• Next queries: Create and configure next queries.

• Explain: Understand how products are ranked organically and view any configurations that may be affecting positioning.

Discovery features

These features are related to the browsing experience and are displayed as follows:

• Browse Metrics: You can turn on Browse Metrics to access data on the evolution in navigation regarding product categories. <!-- ASG (Aug'25): The Browse section is now integrated into the tools themselves, so this permission is no longer needed.
• Configuration: You can activate multiple configuration features to help merchandisers maximize discoverability in the commerce store. You can change facet names and boost and bury products and product attributes in the browsing experience. -->

Global features

These features are used for Playboard administration to manage options performed in the Playboard.

• My Highlights: You can turn on the My Highlights homepage dashboard to enjoy a tailored and actionable experience with the Playboard features and KPIs that help you maximize your commerce search and discovery.
• Facets: You can turn on Facets to configure how your catalog products are grouped depending on certain characteristics, attributes, or attribute values (price, brand, fabric, etc.).
• Activity stream: You can turn on the Activity stream dashboard to monitor all the changes performed in the Playboard.

Setting up filters

This section lets you set up the filters that merchandisers and analysts use when visualizing Insights or using the Play tooling in the Playboard.

There are two types of filters that you can set up:

• Languages: Languages to be used as filters in the Playboard. The values selected here must match the product catalog languages.
• Custom filter fields: Additional filters that you may set up in the implementation of the Tagging and Search microservices. These filters are then used to narrow the data displayed in the Playboard. The filters set up in the Playboard should match those used in the Tagging and Search microservices. However, depending on your customer’s specific use case, the filters for the Search microservice may be different. You need to make sure the Tagging ID in this section matches that entered in the Name field in the Tagging section and ID contains the filter entered in the Search feature configuration. For example, Tagging ID must be store, catalog, scope, or section; however, the corresponding ID used in Search for section may be division. If this is the case, you need to specify the IDs for Search and Tagging in the Playboard section.
• Select multiple preview filters: Toggle to select, when activated, multiple filter values in product result lists' previews of Explain, Equalize, Results Ranking, and Browse configurations.

warning

You must define at least one language as a filter. For example, set Filter ID as lang and add EN as a language in the ID field for Filter value.

Adding a custom filter

To configure a filter, you need to add all the filter values for the filter and then add the filter itself:

1. In the Filter value, enter the ID and Tagging ID and click +. The ID and Name fields are added as a row below the Filter value section.
   If the definition of the filters is different in the Search microservice, then enter the filter value ID for search in the ID field and the filter value ID for tagging in the Tagging ID field. If the filters are the same for both tagging and search, then enter the ID in the ID field.

2. In the Custom Filter Fields, enter the ID and Tagging ID (if different from the ID used for Index & Search). If the definition of the filters is different in the Search microservice, then enter the filter ID for search in the ID field and the filter ID for tagging in the Tagging ID field. If the filter IDs are the same for both tagging and search, then enter the ID in the ID field.

   note

   The IDs are case-sensitive. The Playboard ignores any unrecognized field IDs. The field isn't configured, and no action is taken.

3. If you want to set a default value that is used where no value is provided in the search request, enter the value in Default value ID.

4. You can define in which group of tools of the Playboard your filters are displayed by selecting a value in Sections.

5. Once you have added all the values for the filter, click + beside the Filter section. The filter and filter values are shown as a row below the Custom filter fields section.

warning

Existing filters and values cannot be edited. To change a filter value, click the X icon beside the value or filter to remove the incorrect value and add the new value.

coding tip

Use the Name field in this form to change the labels for the filter and filter value in the Playboard. For example, you enter scope in the ID field, but you display this information as “Device” in the Playboard by entering Device in the Name field.

Choosing KPIs

You can choose which KPIs to turn on globally for the instance and determine which metrics to display in the reports.

The metrics you can make visible or hide individually are:

• Query: Metric to show the number of search requests performed.
• No result: Metric to show the number of queries that failed to provide results.
• Click: Metric to show the number of click actions on a product.
• Findability: Metric to show the number of clicks on the first page of SERP versus total queries.
• Add-to-cart: Metric to show the number of products added to the cart from a search result.
• Checkout: Metric to show the number of products purchased that were added to the cart from a search result.
• Session: Metric to show the number of grouped shopper interactions performed within a given time.

warning

By default, all metrics are shown in the Playboard.

If you choose to hide a specific metric, the metric is no longer shown in the Analytics screens and in the Insights data visualizations in the Empathy Platform Playboard. However, the data is still collected to calculate the metrics. You can choose to turn on the metric again at any stage. The analytics shown will reflect the current situation.

Setting up Playboard features

Several Playboard features you can turn on in the Permissions section require additional configuration.

You set up the following Search and Discovery features as follows:

Search features

• Promotion: You need to determine the type of promotion you want to use. You can choose to use only promoted results, only promotion banners, or both promoted results and banners.
• Results ranking: For Results Ranking, you need to determine the pivot fields to be used to restrict the impact of the tooling. In this case, the pivot fields must match a field in the product catalog and must be included as filters in the Tagging section.

Discovery features

• Configuration: For the browsing experience, you need to determine the pivot fields and attributes to be used with the tool.
  • Pivot fields: Product catalog field to use to segment the data.
  • Attributes: Product catalog field to use as an attribute. Merchandisers can use the fields indicated here to boost or bury the products within the browsing experience.

  note

  The ID field must match the product catalog field ID exactly. You can choose a different display name in the Name field.

Global features

• Facets: For the Facets management tool, you can configure the following:
  • Metadata config section for facets: This activates the configuration section to enrich with additional metadata the facets set up in the right-side panel of the Facets management tool.
  • Mandatory and not multi-select filters: Turn it on to make all configuration filters mandatory and single-select. Note that the Language filter is always mandatory and accepts only one value.

Turning on the Play microservice

Once you have entered all required configuration for the Playboard and saved the form, you need to turn on the Play microservice. To do this, click the On toggle switch located at the bottom of the screen.