Getting Started

ConvoSearch: Multi-Modal Search Integration

Welcome to ConvoSearch, the ultimate tool to enhance product search on your e-commerce website. Let’s walk through the journey of integrating ConvoSearch into your platform so you can offer your users a seamless, multi-modal search experience.

Step 1: Create Your ConvoSearch Account

The first step is creating an account on our dashboard. Once you’ve signed up, log in to your personal dashboard. This will be your control center where you can manage all things search-related for your website.

Step 2: Build Your Product Index

Your website’s product inventory is key to making ConvoSearch work its magic. Once you're in the dashboard, navigate to the "Indices" section. Here, you'll upload an index — a collection of your product data containing product information like product name, category, labels, etc.

Click on the "Create New Index", give it some name and then upload your existing index in any of these formats - JSON, XML or CSV. More details here. Once submitted, our system automatically starts indexing your products. Think of this as a librarian categorizing all your books for easy retrieval.

In the future, should you need to update products, just call our Update Index API to upload your new index. To delete an index, simply go to "Indices" section on the left, and click on the three dots (⋮) corresponding to the index and then delete. Anytime you make changes to your inventory, ConvoSearch ensures your index stays up-to-date.

Step 3: Integrating ConvoSearch with Your Website

Now that your product catalog is indexed, it’s time to bring ConvoSearch to life on your website. This is done through our search API. You don’t need to worry about diving deep into code right now—we’ve made it simple. Head over to our API documentation to find the details on how to embed this into your site.

All you need to do is integrate the API with your existing search bar. Every time a customer types in a search term, ConvoSearch will scan your indexed products and deliver the most accurate results, whether it’s a “sunset sneakers” or “blue yoga mat.” The API ensures your users get exactly what they’re looking for, with no hassle.

Step 4: Tracking User Actions

Once ConvoSearch is running on your site, you’ll want to capture user behavior to optimize their experience further. That’s where our tracking events come into play. These events allow you to monitor how users are interacting with your site, from searching to purchasing.

Creating a Session

Every time a visitor lands on your website, you will need to call the create session API to generate a unique session ID for them. This ID helps us track their journey, making sure every action is connected and analyzed. Learn more about session creation here.

Track Search Result Click

Imagine a user searches for "red shoes". After seeing the results, they click on one. This action, called a “search result click,” tells you which product caught their attention. Understanding these clicks helps refine what products to show in future search results. More on tracking clicks.

Track Product Viewed

When users land on a product page after clicking, we track it as a “document viewed” event. This event helps you analyze which products get the most interest and whether your product pages are doing their job. Learn more about tracking views.

Track Add to Cart

This is one of the most critical events. Every time a customer adds a product to their cart, ConvoSearch tracks it. It’s not just about counting carts; this data helps you understand the intent behind their purchases and adjust your offerings accordingly. More details on cart tracking.

Track Conversion

Finally, when a user completes their purchase, we track that as a conversion event. This is the most vital metric for any e-commerce business—knowing which searches lead to sales. ConvoSearch helps you optimize for more of these conversions by analyzing the search journey leading up to the purchase. Learn more about tracking conversions.

Step 5: Test & Optimize

Once your tracking events are live, it’s time to see how everything performs. Use your ConvoSearch dashboard to monitor user behavior, see how often products are clicked, added to carts, and ultimately purchased. With these insights, you can make informed decisions to continuously optimize the search experience on your website.

If you need any help, our support team is always available to assist you.