NAV

Crossroads

Luigi's Box is a product discovery suite for e-commerce. This section will help you understand the full scope of the integration and help you choose the best way to integrate for your use case.

For successful integration, you need to integrate several different processes. We list the most used options for each process here and discuss its pros and cons. We are available at support@luigisbox.com if you need a consultation or feel that you have a special use case that is not covered here.

Analytics

Search analytics is the foundation of a successful integration. It provides data for the AI for all services (autocomplete, search, recommender) and on the other hand lets you see the impact that Luigi's Box has on your e-commerce store monetary performance. Analytics should be the first thing you integrate even before you start to integrate the actual product discovery services.

JSON+LD

Recommended for robustness

By generating a simple descriptive standard JSON you will let Luigi's Box and other services understand the content on your website. In this JSON you will describe the search and/or recommendation results that your users see on the web.

You can find more details in its separate documentation here: JSON+LD Analytics

Events API

For mobile and demanding web apps

The Events API is designed for more advanced use-cases such as mobile apps or for demanding websites which do not want to pull 3rd party script dependencies.

You can find more details in its separate documentation here: Events API

Analytics implemented by Luigi's Box team

For smaller businesses

For less demanding customers, or for customers without a dedicated development team, Luigi's Box team can implement the analytics tracking completely on our side, without any development effort on your side.

If you are interested in this option, contact us on support@luigisbox.com. The integration is usually done for free.

Data synchronization

Luigi’s Box needs to have up-to-date data about products, categories, brands and (optionally) articles. You can use feeds or API to synchronize the data. To help you decide, here are the main differences.

Content Updates API

For real-time data synchronization

You will be pushing data to our servers. There is practically no delay in data synchronization. The communication is efficient, you are only sending updates to products when they change, there is a lot less data transfer between our systems.

Integrating via the API will probably take much more time on your side than generating the feeds. You’ll have to identify all the codepaths that trigger product change and react to them by updating the product in Luigi’s Box via API.

You can find more details in its separate documentation here: Content Updates API

Feeds

For smaller businesses without dev team

We will periodically pull data from your servers: we will download a file (XML or JSON) and make its contents searchable. If there is a change to the product, we will not know about it until the feed is processed next time.

We can schedule feed processing at arbitrary intervals: most of our clients use 3 hours intervals, we have some clients where we process the feeds every 30 minutes. More frequent processing = higher costs on our side = higher price for the client. Exact pricing depends on the volume of the data, but for reference, for an average client, the extra price for processing every 30 minutes will be 50-100€

Keep in mind that it’s you who have to generate the feeds. If you ask for 30m processing, you will have to regenerate the feeds every 30 minutes and probably incur a higher cost on your side.

You can find more details in its separate documentation here: Feeds

Autocomplete

Luigi's Box widget

Recommended

Easiest and most performant integration, where you simply configure the provided JavaScript widget.

You can find more details in its separate documentation here: Autocomplete widget

Backend integration

For rare use-cases

You can find more details in its separate documentation here: Autocomplete API

Frontend integration via your custom widget

For demanding web apps

You can find more details in its separate documentation here: Autocomplete API

Implemented by Luigi's Box team

For smaller businesses without dev team

Search & Recommender

Luigi's Box Libraries

Recommended

You use Luigi's Box libraries - search.js and recco.js where you provide configuration and custom HTML templates.

Backend integration

For demanding web and mobile apps

You will use Luigi’s Box API directly. You pass the API the user’s query + filters, or the recommendation context and get back the IDs of the products. You will then load the product information using the IDs from your database, take the filtering information from the API and render the search results page or recommender boxes.

You can find more details in its separate documentation here: Search API, Recommender API

Implemented by Luigi's Box team

For smaller businesses without dev team