Icecat

Icecat Release Notes 198: Data Health Scores, Product Mapping API, and More

The release 198 includes several key features and enhancements designed to improve usability, functionality, and performance. Among the highlights are the introduction of the new Data Health Score functionality, the launch of the Product Mapping Rules API, the addition of dual-format output for Energy Labels, and the migration of Icecat.biz to Server-Side Rendering (SSR). These updates demonstrate our commitment to providing a robust and user-friendly experience for our users. For additional details, please refer to the previous Icecat Release Notes.

New Data Health Score Functionality

In this sprint, we are excited to announce the release of the first user interfaces for the new Data Health Score functionality in Icecat Vendor Central. This new feature allows users to list, create, and update data health scores, providing a comprehensive tool to manage the quality and completeness of product data.

New Menu Addition

We have added a new menu item in Icecat Vendor Central called “Data health score”. This menu item opens a new page where all data health score settings are collected and managed. This centralized location makes it easy for users to access and modify data health scores.

Data Health Scores List Interface

The data health scores list interface is equipped with several tools for managing scores. Initially, all scores are inactive, but users can activate them through this interface. Users can also designate a main health score for all Icecat editors to use across all products. This ensures consistency and prioritization of key data quality metrics.

Creating and Managing Health Scores

The new functionality allows users to create health scores tailored to the specific requirements of our partners. For example, if a product needs to be described for Amazon, editors can consider both Icecat’s main score and Amazon’s additional health score during the product description process.

Create a New Data Health Score Interface

The interface for creating a new data health score is divided into three parts:

  1. Score Name: The first part is for entering the score name.
  2. Mandatory and Optional Parameters Management and Calculations: The second part is where users manage parameters and perform calculations. This section is split into two columns—Mandatory and Optional. Parameters are added to the Mandatory column by default but can be moved to the Optional column by dragging and dropping.
  3. Additional Parameters: The third part contains additional parameters that can be added to the second part.

Each parameter has a percentage field that defines its share value in the product. Parameters added to the second part cannot have values less than 0% or more than 100%, and the total sum of all parameters must equal 100%.

Specific Parameter Settings

Some parameters allow for more specific settings. For example, the “Product model description: Local” parameter has a “Local dependent” setting. This setting indicates that the locale will be considered in the calculation of the local data health score, ensuring all possible locales are included in the product description.

The “Local dependent” setting informs the system that the parameter’s locale will be considered in the calculation of the local data health score. This ensures that all possible locale-specific information is included in the product description. For instance, if a product has a “Product model description” in both English and French and a “Description” in English only, both assets (Product model description and Description) should ideally include both locales. If these assets are marked as “Local dependent,” the system expects the presence of both locales for a complete score. However, if a locale is not included in any of the “Local dependent” assets, it is not counted towards the score.

LocaleEnglishFrenchGermanMax. score per parameterActual score per parameter
Product model description: Local++10%10%
Description block: Description+10%5%

Initial Parameters

Currently, the health score interface includes five parameters:

  • Product code
  • Brand
  • Category
  • Product model description
  • GTIN

Additional parameters will be added in future sprints.

Adjusting Existing Scores

When a new data health score is created, users are returned to the data health scores list. Here, users can adjust existing scores by clicking on “Settings.” Changes can be saved by clicking the “Update Settings” button. Note that a score cannot be deleted if it is set as the main score for Icecat.

Change History

The interface also includes a “History” icon. Clicking this icon opens a new window displaying the change log for the specific data health score. The log includes:

  • User who made the change
  • Action (insert, update, delete)
  • Parameter name
  • Old settings
  • New settings
  • Period

This new functionality enhances the user experience by providing a more organized and efficient way to manage product data quality. By centralizing the data health score settings and offering detailed management tools, users can ensure their product data meets specific requirements and maintains high standards. This leads to better data quality, improved product descriptions, and greater satisfaction for our partners and customers. We hope you find the new Data Health Score functionality useful and look forward to your feedback as we continue to enhance Icecat Vendor Central.

Product Mapping Rules API

In this sprint, we are excited to announce the addition of the ability to create and run product mapping rules via the new REST API, ProductMapRules. This update includes four new endpoints, enhancing the functionality and flexibility of product mapping.

Endpoints Overview

The new ProductMapRules REST API includes the following endpoints:

  1. POST ProductMapRule: Create a new product mapping rule.
  2. GET ProductMapRule: Retrieve information about a specific product mapping rule.
  3. POST ProductMapRules/Jobs: Run a product mapping rule.
  4. GET ProductMapRules/Jobs/{JobId}: Check the status of a product mapping rule run.

Creating Product Mapping Rules

Product mapping rules can be created individually using the POST ProductMapRule endpoint. When creating a new rule, users need to specify the following details:

  • Rule Name: The name of the mapping rule.
  • Brand ID: The source product brand identifier.
  • Map Brand ID: The destination product brand identifier.
  • MPN: The source product code.
  • Map MPN: The destination product code.
  • Order Number: The order number for the mapping rule.

Upon successful creation of a map rule, the API will return a Product Map Rule ID in the response.

Retrieving Mapping Rule Information

Users can retrieve information about a created mapping rule using the GET ProductMapRule endpoint. This allows users to verify the details and status of the mapping rules they have set up.

Running Mapping Rules

To execute a mapping rule, users should use the POST ProductMapRules/Jobs endpoint. The following information is required to run a rule:

  • Rule Name: The name of the mapping rule.
  • Brand ID: The source product brand identifier.
  • Map Brand ID: The destination product brand identifier.

Running a mapping rule is an asynchronous process. Upon initiating the mapping run, the user will receive a Job ID in the response. This Job ID can be used to check the status of the mapping rule run using the GET ProductMapRules/Jobs/{JobId} endpoint.

Checking Mapping Run Status

The status of a mapping rule run can be checked using the GET ProductMapRules/Jobs/{JobId} endpoint. The mapping run can have one of the following four statuses:

  • New: The mapping job has been created but not yet started.
  • Running: The mapping job is currently in progress.
  • Completed: The mapping job has finished successfully.
  • Failed: The mapping job encountered an error and did not complete.

Access

Access to use this REST API is restricted to brand users’ auto-imports, ensuring that only authorized personnel can create and manage product mapping rules.

The new Product Mapping Rules API significantly enhances the ability to automate and manage product mapping processes. This functionality is crucial for maintaining accurate and up-to-date product information across different brands and marketplaces. By providing a robust and flexible tool for creating and running mapping rules, we empower users to streamline their workflows, reduce manual effort, and improve data accuracy. We hope you find the new Product Mapping Rules API valuable.

Energy Labels Output in PDF and Image Formats

In this sprint, we have developed a new feature that enhances the handling of Energy labels by converting them into additional formats automatically. This development applies to both EU and UK Energy labels and is designed to improve the versatility and accessibility of Energy labels across various formats for our channel partners.

Automatic Conversion of Energy Labels

  • PDF to Image Conversion: When a user adds an Energy label in PDF format, it will be automatically converted to JPEG format.
  • Image to PDF Conversion: Conversely, if a user adds an Energy label in Image format, it will be automatically converted to PDF format.

This dual-format availability ensures that users have access to Energy labels in their preferred format, enhancing usability and integration capabilities.

Review in Icecat Vendor Central

Both the original and converted Energy label files can be reviewed in the corresponding multimedia object card within Icecat Vendor Central. This allows users to easily access and verify the formats available for each Energy label.

Integration with External Formats

The benefits of having Energy labels in both formats extend beyond Icecat Vendor Central users. Users of XML, JSON, CSV, and Personalized Content Files (PCF) can now review both the original and converted Energy labels in their output files.

New Keys and Tags in JSON and XML

We have introduced the following new keys and tags in JSON and XML to accommodate the converted Energy labels:

  • ConvertedURL: The URL of the converted Energy label.
  • ConvertedContentType: The content type of the converted Energy label.
  • ConvertedSize: The file size of the converted Energy label.

XML view:

JSON view:

CSV and PCF Enhancements

In product CSV and Personalized Content File (PCF), the converted link is added to the same cell as the original link. These links are separated by a pipeline symbol “|” for clear distinction.

This new feature enhances the flexibility and accessibility of Energy labels by providing them in both PDF and Image formats automatically. This ensures that users can easily access the necessary format for their specific needs, whether for web display, printing, or integration into other systems. By supporting multiple formats, we increase the usability and convenience of the Energy labels, thereby improving user experience and satisfaction.

We believe that the automatic conversion of Energy labels into PDF and Image formats will significantly enhance the functionality and accessibility of these labels for our users.

Icecat.biz Migration to SSR

In this sprint, we focused on improving the performance and SEO of Icecat.biz by addressing issues and enhancing our infrastructure. One of the major tasks was the migration of Icecat.biz to Server-Side Rendering (SSR). This migration revealed several SEMrush errors, warnings, and notifications that were previously hidden by the older homepage. In addition, we developed a new REST API for collecting statistics on the new product page, ensuring better performance monitoring and analytics.

SEMrush Error Fixes

As part of the migration to SSR, the new homepage exposed multiple SEO-related issues that were not apparent on the previous page. Over the course of this sprint, we successfully identified and resolved a total of 27 errors, warnings, and notifications reported by SEMrush. These fixes included:

  • Addressing broken links and incorrect redirects.
  • Optimizing meta tags and descriptions for better search engine visibility.
  • Resolving issues related to page speed and load times.

New REST API for Product Page Statistics

We developed a new REST API designed to collect and report statistics on the new product page. This API will provide valuable insights into user interactions and page performance, helping us to continuously improve the product page experience. Key features of the new REST API include:

  • Data Collection: Automatically gathers data on page views.
  • Autotest Coverage: The new API has been thoroughly tested with automated tests to ensure reliability and accuracy.
  • Integration: Seamlessly integrates with our existing analytics infrastructure, providing comprehensive insights into product page performance.

The migration to SSR and subsequent fixes significantly enhance the performance and SEO of Icecat.biz. By addressing the SEMrush errors, we have improved our website’s search engine ranking, making it easier for potential customers to find our service. Additionally, the new REST API for product page statistics ensures that we have the necessary data to make informed decisions about future improvements and optimizations.

This sprint has brought significant improvements to our platform, addressing critical areas such as data health, product mapping, content accessibility, and website performance. We believe these updates will provide substantial value to our users, enhancing their experience and efficiency. We are committed to continuously improving our platform and look forward to delivering even more enhancements in the future.

Olena Vasylynenko

Recent Posts

Unold Enhances Online Presence with Open Icecat Sponsorship

About Unold AG Unold, established in 1966 and headquartered in Hockenheim, Germany, has a long…

3 hours ago

5 Automation Tools Every Online Retail Business Should Know

Automation has become an essential component of online retailers’ success. With so many tools available,…

1 day ago

Icecat Keeps ASUS on Top with the New Copilot Key Attribute

The world of technology is constantly evolving, and so is the data that describes it.…

5 days ago

The Benefits of Full Automation of Your E-commerce Processes with Icecat Commerce

For medium and large-scale businesses, e-commerce automation is absolutely essential. It can be incredibly challenging…

6 days ago

Why Should You Invest In Mobile Commerce?

Mobile commerce has been steadily growing over the years and is projected to reach 43.4%…

1 week ago

Strong Growth in The Turkish E-commerce Market

Turkey's e-commerce market experienced a rebound in 2023, with online spending more than doubling compared…

1 week ago