Search through more than a hundred articles on every aspect of User.com

Dawid Gulbicki
Written by Dawid Gulbicki

Products and their attributes

Basics of the section "Products"


Managing your product catalog in User.com

Products in User.com store information about user interactions with specific items, such as views, cart additions, and purchases. While regular events capture each instance of an interaction and its associated data, product events focus on maintaining the latest attribute values within the product profile. This design is optimized for handling high event volumes efficiently, such as tens of millions of product-related interactions each month.

However, this approach comes with a limitation: past values of product attributes, such as price or availability, are not retained, and only the most recent data is visible. For this reason, it’s important to create separate products for each variation, such as size or color, to ensure accurate tracking and differentiation between variants.

Understanding Attribute Data Types

The products section in User.com allows you to define and manage attributes that store essential product information. These attributes can have different data types to suit various use cases. Choosing the right data type is crucial for maintaining accurate and organized product data. Below are the available attribute data types and their practical applications:

  • Boolean: Use for attributes with a true/false value, such as Is bestseller.

  • Fixed Choices: Define a set of predefined options.

  • String (Max 256 Characters): Use for short text-based attributes, like product names or brief descriptions.

  • Date: Record specific dates, such as Release Date or Expiration Date.

  • Datetime: Store date and time information for events, such as Promotion Start Date or Flash Sale End Time.

  • Integer: Use for whole numbers, such as Stock Quantity.

  • Floating-point Number: Record numerical values with decimals, like Price or Product Weight.

  • JSON File Format: Use for complex, structured data, such as Price by POS.

Best Practices for Attribute Configuration

Configuring attributes with the correct data type is essential for maintaining accurate and functional product data. For instance, numerical values like Price should be defined as Floating point number to ensure seamless data handling and avoid potential errors during updates or calculations. By carefully selecting appropriate data types, you can optimize the way products and their attributes are stored and updated within User.com, improving overall data reliability and usability.

How to Create Custom Product Attributes

Custom attributes allow you to expand the default set of product attributes in User.com, tailoring product data to specific business needs. While default attributes such as Name, Custom id, Product url, and Special price are already available, you can create additional custom attributes as needed.

Steps to Create Custom Product Attributes

  1. Access the Product Attribute Settings
    Navigate to Settings > App Settings > Products > Product Attributes in your User.com account.

  2. Add a New Attribute
    Click "Create attribute" to create a new custom attribute. Assign a name, meaningful description and select a data type that aligns with the data the attribute will store (e.g., String for URLs or Floating point number for different price values).

  3. Save the Configuration
    Once configured, save the new attribute. It will become available across the product catalog and can be used in product data entries.

  4. Review and Test the Attribute
    Verify that the new attribute is functioning as expected by adding a test value to a product and ensuring it appears correctly.

When creating a product attributes Name and Custom id are required.

How to Import Your Product Catalog to User.com

Importing your product catalog into User.com allows you to manage and synchronize product data efficiently. You can connect a product feed or perform a bulk import using a CSV file.

Using Product Feeds

A product feed is a file containing all the product information, such as attributes for segmentation and personalization. You can connect feeds like Google Merchant Product Feeds or .xml files hosted on your server. Product feeds are automatically synchronized daily, ensuring up-to-date product data.

For detailed steps on preparing and connecting a product feed, refer to Product Feed Integration Guide.

Bulk Import via REST API

You can also import products in bulk by uploading a CSV file through the REST API. The file must have standardized attribute names in the header row. You can track the progress of your import using API endpoints.

For a step-by-step guide, refer to the Bulk Product Import Documentation.

Overview of the Products Section

The Data >Products section in User.com provides an organized view of your product catalog, allowing you to manage and analyze product data effectively. Settings in this section, such as column selection and display order, are individualized for each agent, ensuring a personalized view tailored to their workflow.

Customizing Product Display

In the Data > Products section, you can customize the product table by selecting which columns to display and arranging them in your preferred order using the Select Columns option.

Managing Product Data

The Manage toggle offers several tools for working with product data:

  • Export Product Information: Download product details as a file.

  • Export Product Events: Export data about user interactions with your products.

  • Bulk Remove Products: Delete multiple products from the catalog at once.

Filtering and Segmentation

Use the filters panel on the right side of the screen to filter products by any attribute. You can save these filters as dynamic segments, which are recalculated automatically at specified intervals.

Product Segments: Dynamic segments allow you to group products based on shared characteristics or criteria, enabling personalized user paths. For example:

  • Products with active discounts.

  • Products on sale until tomorrow.

Working with Product Events

Product events in User.com track specific user interactions with products, such as views, purchases, and cart additions. These events help you gain valuable insights into user behavior and product performance.

Sending Product Events

Product events can be created programmatically in User.com using the JavaScript SDK or the REST API, making it easy to track user interactions with products.

For detailed guides on how to create and manage product events, refer to the following resources:

Filtering Users Through Product Events

You can filter users based on product-related events to analyze trends or create targeted campaigns. Follow these steps to filter users through product events:

  1. Access the People Section
    Navigate to Data > People in your User.com account.

  2. Open the Filter Menu
    Click the filter icon on the right-hand side of the page to access filtering options.

  3. Find the Products Events section
    Scroll down to the Product Events section in the filter settings.

  4. Specify the Event Type and Attributes
    Select the desired event type (e.g., add to cart, purchase, or view). Optionally, filter further by product attributes such as category or price.

Summary and Best Practices

In User.com, products enable you to manage product data, define attributes, and track user interactions through product events. By configuring attributes thoughtfully and using product events effectively, you can ensure your data is accurate and actionable.

Key Takeaways

  • Use appropriate data types for attributes to maintain accuracy and consistency. For example, set Price as an Integer to prevent errors.

  • Track user interactions, such as purchases or views, by creating product events programmatically via the JavaScript SDK or REST API.

  • Customize your product data by adding attributes that align with your business needs, allowing for more precise tracking and analysis.

By managing your products strategically, you can unlock valuable insights and improve the effectiveness of your marketing and engagement strategies.

Related Articles

Categories: