Personalized Search API Endpoints for SuiteCommerce

Starting in SuiteCommerce Advanced 2021.2, a new feature allows administrators to enable personalized Search API endpoints for more tailored item searches. This boolean setting can enhance the shopping experience by delivering user-centric search results for items, which is especially beneficial for eCommerce applications.

How to Enable Personalized Search API Endpoints

To activate the personalized Search API endpoints, navigate to the following path in the SuiteCommerce interface:

• UI location: Shopping Catalog > Personalized Search API Endpoints

The configuration parameter for this setting is captured under the ID isNewSearchApiEnabled.

Understanding Personalized API Endpoints

The personalized search API endpoint allows your application to retrieve tailored item information based explicitly on the customer's profile. This can be crucial for improving customer engagement and boosting conversion rates.

Benefits of Personalized Endpoints

• User-Centric Results: Fetches results that are customized to individual user preferences.
• Enhanced Shopping Experience: Facilitates a dynamic and personalized shopping experience, potentially increasing customer loyalty and sales.

Additional Context on Item Search API

The Item Search API is typically accessed via an AJAX client, utilizing frameworks like jQuery to make HTTP requests. The base URL for the API follows the format:

http://www.mywebstore.com/api/items

Here are the key components of the base URL:

• Custom Domain: Your unique webstore URL (e.g., www.mywebstore.com).
• Items: This part of the URL is fixed and cannot be altered. It specifies that you want to query item records.
• Parameters: You can include search parameters in your requests, enabling you to filter results precisely. For example, fieldset=details. These parameters are separated by an ampersand (&).

Cacheable vs. Personalized Endpoints

In addition to general item searches, the API offers two distinct endpoints:

• /cacheable/items: Responses are cached, optimizing performance for frequently accessed data.
• /personalized/items: This endpoint retrieves unique item information for customers without caching, ensuring results are always relevant to individual users.

Note: To enable cross-domain AJAX requests when utilizing the Item Search API, developers may utilize JSONP. This allows for the response to be wrapped in a JavaScript variable included in a script tag.

Conclusion

Enabling personalized Search API endpoints can significantly enhance your eCommerce platform by providing tailored item search functionality based on user behavior and preferences. This feature is especially advisable for merchants focusing on improving customer engagement through personalized experiences.

Source: This article is based on Oracle's official NetSuite documentation.

Key Takeaways

• Enable personalized Search API endpoints for user-specific item searches.
• Configuration is found under Shopping Catalog settings.
• Utilize AJAX for seamless integration with the Item Search API.