Search & Recommendations

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude

Introduction

Search & Recommendations extension enhances selected Sales Channels by optimizing Product Listing Pages (PLPs), refining search word predictions, and improving filters. The data flow involves transferring information from the platform to Algolia, where it is stored and powers storefront listing pages. While the data can be obtained through a catalog data loader, the Algolia extension elevates accuracy in results and search predictions, optimizing search-to-result time.

Key functionalities include indexing, sorting, and mapping for effective data organization. The Auto Complete Menu provides quick, intuitive suggestions, and Search Analytics offers insights into user behaviour. The Data Loader ensures seamless data transfer, while the File Uploader simplifies file uploads. In summary, the Algolia extension comprehensively enhance the search experience, optimizing the functionality and efficiency of Sales Channels in e-commerce.

Steps to use Search & Recommendations Extension

1. Go to Extensions in Fynd Commerce.

2. Open Search & Recommendations.

3. Choose from the available integrations:

• Common – Manage global settings.
• Algolia – Optimise search using Algolia APIs.
• Google Retail Search – Sync and manage search with Google.

Using Algolia in Search & Recommendations

The Algolia integration provides advanced tools to configure search ranking, sort orders, rules, relevance, analytics, and more. Open Algolia to get started.

Set up Algolia Credentials

To activate the integration, first set up your credentials:

1. Open Credentials.

2. Enter the Algolia's API Keys in this section to complete the setup for the Algolia extension.

3. Go to algolia.com.

4. Select Dashboard > Overview.

5. Select the company from the drop-down. Here, we have selected Fynd company.

6. Go to API Keys.

7. Copy the Application ID and paste it into the Application ID field on the Fynd Commerce.

8. Copy the Search API Key and paste it into the Search-Only API Key field on the Fynd Commerce.

9. Copy the Write API Key and paste it into the Admin API Key (or Write Key) field on the Fynd Commerce.

10. Select the Search module from the left side panel and go to Index under Configure.

11. Go to the Index drop-down in the header and select the relevant index from the drop-down menu, and copy the Index Name.

1. Add Global Context. This refers to universal settings that impact the overall behaviour of search functionalities across the entire application. This field is non-mandatory.

2. Add Target Mart. It is specific to Jio. Target Mart can be either Jio or Smart. This field is non-mandatory.

Fill in the following fields with the copied details:

Click Save to store the credentials.

Configure Sort & Replica Mapping

Control how your products are sorted and displayed in search results.

Steps to Configure Sort Options

1. Select Sort & Replica Mapping from the Algolia dashboard.

2. Review available sort options such as:

• Price Low to High
• Popularity
• Discount High to Low
• Latest
• Discount Low to High
• Price High to Low
• Rating
• Size Depth (High to Low)

3. Select the sorting option and then in the Settings section:

• Update its Index Name (e.g. "AK_INDEX_PRICE_L_H").

4. Click Save.

Enable Search Analytics

Use Search Analytics to track user behaviour and improve search performance.

1. Go to Search Analytics from the Algolia dashboard.

2. Enable Click Analytics to start sending query_id from Algolia to the front end, enabling click and conversion tracking.

3. It enable Search Analytics to view:

• Total searches
• No result rate
• Daily search activity

4. Click Visit Algolia Dashboard to access these insights directly on Algolia.

Upload Rules Using File Uploader

Create and sync bulk rules in Algolia using a structured Excel upload.

Steps to Upload Rules

1. Go to File Uploader under Algolia.

2. Download the Algolia Rules Demo Excel file.

3. Fill in the spreadsheet using the format below:

4. Click Upload File and select the completed .xls or .xlsx file.

5. Monitor the upload status under Uploaded Rules:

• Success
• Failed
• In Progress

Configure Relevance Settings

Relevance settings allow you to fine-tune the way search results appear to customers. These settings define how queries are interpreted, how results are ordered, and which terms are treated as equivalent.

Go to Relevance under Algolia.

To configure relevance settings, you will be redirected to the Algolia Dashboard by clicking the Set up in Algolia Dashboard button.

Searchable Attributes

Defines which fields of your data are searchable, and in what order.

Example Configuration:

[
 "product_name",
 "category",
 "brand",
 "description"
]

Custom Ranking

Controls how matched results are ordered after applying the search logic.

Example Configuration:

[
 "desc(bestseller)",
 "desc(rating)",
 "desc(views_count)"
]

Synonyms

Synonyms expand or unify search intent by telling Algolia which words are considered equivalent.

Manage PromoRules Context

This section allows you to assign context to rules, so they can be triggered conditionally based on customer behaviour, device type, or other metadata.

Steps to Use PromoRules Context

1. Go to PromoRules Context from the Algolia dashboard.

2. View previously synced rules, including their:

• Rule ID
• Context (e.g. testing)
• Type (e.g. all)

3. Use the search bar to find specific rule contexts.

4. Click the Bin Icon to delete a context.

Enable and Track User Events

User Events: help track and measure key customer actions on your storefront. These events can be used to optimise search relevance and enable personalisation.

Steps to use User Events

1. Go to User Events in the Algolia section.

2. Toggle the switch at the top right to enable.

3. You'll now see a list of predefined events:

4. Toggle each event to enable it based on your tracking requirements.

5. Click Save.

Google Retail Search

Google Retail Search enables enhanced product discovery by leveraging Google’s search intelligence. With this integration, merchants can optimise cataloguing, indexing, and personalisation, improving customer experience and search conversion rates.

Go to Google Retail Search section.

Set Up Google Retail Search Credentials

To connect your Google Retail Search account with Fynd, you must provide key credentials.

1. Go to Credentials in the Google Retail Search section.

2. Enter the following information:

3. Click Save to complete the integration setup.

Track User Events for Google Retail

User Events: help you capture behavioural data such as searches, views, cart actions, and purchases. These insights are sent to Google Retail to improve search relevance and product recommendations.

1. Go to User Events in the Google Retail Search section.

2. Toggle the switch in the top-right corner to enable.

3. A list of available events will appear:

4. Use the toggle next to each event to enable tracking.

5. Click Save once configuration is complete.

Common Settings

The Common section allows you to configure and manage universal settings for search services across your store. These include pricing, catalogue sync, attributes, autocomplete, and more. This centralises configuration across both Algolia and Google Retail search engines.

Open Common.

Config – Price Internationalisation

Manage API-based currency conversion for product listings.

How to configure:

1. Go to Config in Common Settings.

2. Select the Exchange Partner from the dropdown & enter Open Exchange API Key.

• Exchange Partner Example: Open Exchange

• Open Exchange API Key Example: fynd-openex-12345678

4. Click Save to apply the settings.

Catalogue Sync

Synchronise products, collections, and currency data between Fynd Commerce and external search providers (Algolia or Google Retail).

Steps to Sync:

1. Go to Catalogue Sync in Common Settings.

2. Click Sync.

3. Choose options from the modal:

• Sync Type: Select Incremental or Full.
• Select Provider: Choose from Algolia, Google Retail, or Both.

4. Click Sync.

Sync History:

You’ll see a job list with the following details:

• Job Type: Products, Collections, Currency
• Status: SUCCESS / IN_PROGRESS
• Items Synced: Auto-filled after completion

Auto Complete Menu

Customise autocomplete suggestions shown in the search bar.

Go to Auto Complete Menu in Common Settings.

Available Auto Complete Menu Options:

Turn on the toggle to enable auto complete menu:

• Product Suggestion
• Brand Suggestion
• Category Suggestion
• Query Suggestion
• Departments Suggestion
• Fallback to Algolia (used if Vertex data is empty)

Example: Enable Query Suggestion and provide a Query Suggestion Index name like fynd_query_suggestions.

Custom Attributes

Create and manage custom attribute mappings for your product data.

Steps to configure:

1. Go to Custom Attributes in Common Settings.

2. Toggle Enable Custom Attributes.

3. Click Add New.

4. Fill in:

• Source: e.g., product_colour
• Destination: e.g., custom_colour

Optionally, toggle:

• Remain Original: Retains the original source field in the output.

Attributes

Select which attributes from your product data should be passed to Algolia.

Example:

• uid
• multi_size
• slug
• is_available
• algolia_facet

1. Go to Attributes in Common Settings.

2. Toggle Enable Attributes.

3. Enter or delete fields as needed.

4. Click Save.

Data Loader

Switch search-related data services from Fynd default to external providers.

Go to Data Loader in Common Settings.

Options available for:

• Product Listing
• Collection Listing
• Autocomplete Menu

Each row includes two dropdowns, select as per your preference:

• Mode:
• Fynd
• Ext Search Provider
• Search Provider:
• Algolia
• Google Retail
• Hybrid

A/B Testing Config

Split traffic between search providers for testing purposes.

Go to A/B Testing Config in Common Settings.

Configuration:

• Algolia Percentage: Set share of traffic (e.g., 50)
• Vertex Percentage: Remaining traffic (e.g., 50)
• Rotation Time: Time (in hours) after which user session switches provider

Analytics Stats:

Enter Start Time and End Time to filter A/B test metrics by time range.

Search Tool Pinning

The Search Tool Pinning feature allows you to assign a specific search engine to a particular user. This is helpful for internal QA, performance analysis, debugging, and A/B testing use cases.

Steps to Pin a Search Engine to a User ID:

1. Go to Search Tool Pinning.

2. Fill in the required fields:

3. Click Save to finalise the configuration.

Settings

The Settings section allows you to configure advanced zone-level options for your search setup, including pricing behaviour, real-time conversion, and Vertex branch selection.

Go to Settings in Common Settings.

Advanced Zone Configuration

Configure zone-wise pricing, enable real-time price conversion, and select your preferred Vertex branch for data synchronisation.

Click Save to apply the configuration.

Use case - Use this when you need zone-specific pricing logic or want to sync data from a specific Vertex branch for staging or production environments.

Audit Logs

The Audit Logs section provides a detailed record of all user actions performed across platform APIs, helping you monitor changes and maintain accountability.

Go to Audit Logs in Common Settings.

Viewing Audit Logs

The logs are displayed in a table with the following columns:

Use the Search by path or user bar to filter logs, or use the status dropdown (defaulting to All) to narrow results by response type.

Changes in Audit Record

Click on any log entry to view a Before and After comparison of the change made. This shows the exact JSON payload that was modified, making it easy to track configuration changes such as updates to hybrid search distribution or custom attributes.

Use case - Use Audit Logs to debug unexpected configuration changes, track who modified search settings, and review historical API activity.

Zenith Configuration

The Zenith Configuration section allows you to set up and synchronise Zenith to improve product catalogue and search capabilities.

Go to Zenith Configuration in Common Settings.

To know more about Internationalisation of price and how it works, click the info link at the top of the page.

Setup

Use your Zenith API Keys in this section.

Click Save to store the configuration.

Use case - Zenith Configuration connects your Fynd application to Google's Vertex AI infrastructure, enabling advanced ML-powered product discovery and catalogue synchronisation.