Configure Currencies With Multiprice Attribute

Multiprice

Doofinder supports multicurrency, but the new multiprice attribute introduces a more streamlined and efficient way to manage them. This feature allows you to handle multiple prices and currencies within a single search engine, simplifying operations and enhancing flexibility and enabling a more streamlined and efficient approach to managing multiple currencies and price configurations across regions.

This enhancement introduces a new multiprice field within the search engine index. The multiprice field is an object containing keys that represent different price labels (such as currencies or pricing tiers). These labels are accessed dynamically through the price_name parameter in search requests, ensuring flexibility and control.

With no multiprice functionality, you have on your store a unique search engine configured for every language/currency combination:

- EN/EUR  
- EN/USD  
- EN/GBP

The selection of search engines in the Live Layer is determined based on the following criteria:

1. Language: Defined by the lang attribute in the HTML tag of the page or an explicitly provided option in the layer configuration.
2. Currency: Optionally specified in the layer configuration for cases where the language code does not match any available search engine.

With multiprice functionality you now have the power to manage multiple currencies, managing a unique search engine for every language, and a specific attribute to deal with prices.

-  **EN/EUR - USD - GBP**

With multiprice configuration, you can now minimize the number of search engines needed, streamline unique feed generation and indexing, and reduce search engine operations like Business Rules and Indexing and others. Look at this example with only 2 Search Engines:

But 4 combinations

Each engine indexes 2 different currencies.

Configuration

Let’s get a little technical. Here is a step by step guide on how to configure your feed to benefit from this functionality.

1. Prepare Your Data Feed:
   Add the multiprice field to your feed. This field should include price values for different currencies, formatted as an object with currency codes and corresponding prices.

Example:

   {
      "multiprice": {
         "EUR": {"price": 24, "sale_price": 19},
         "USD": {"price": 26, "sale_price": 21}
      }
   }

1. Update Your Search Engine: Ensure you create a new search engine (multipricing only applies to new engines) or update the existing one to include the multiprice field in the indexing.

2. Configure Your Layer: Use the price_name parameter in your search layer configuration to dynamically access the correct currency based on user preferences or regional settings.

3. est the Setup: Verify that multiple currencies display correctly in your search results by testing with various price_name values.

4. Streamline Operations: Leverage the multiprice functionality to reduce the number of search engines needed and simplify your business rule and indexing processes.

Take a look at a TXT index example:

Example of the Multiprice Field

The multiprice object allows you to define price values for multiple currencies or pricing structures, as shown in the examples below:

Example:

{
  "multiprice": {
    "EUR": {"price": 10, "sale_price": 6, "best_price": 6},
    "COP": {"price": 9000, "sale_price": 5000, "best_price": 5000},
    "ARS": {"price": 10000, "sale_price": 5000, "best_price": 5000}
  }
}

This approach encapsulates all pricing information, for a unique language, in a single field, simplifying price management across multiple regions and currencies.

Conclusion

With Doofinder’s multiprice indexing, you now have the flexibility to: - Manage multiple currencies within a single search engine. - Reduce the complexity of maintaining unique feeds for different languages or currencies. - Dynamically control pricing attributes for diverse contexts, including sales and promotions.

Troubleshooting

Multiprice does only apply to new stores/search engines?

Yes, it only applies to new stores/search engines created.

What happens if a search engine is added to an existing store?

Search engines without multiprice functionality and those with multiprice capability can coexist across different search engines.