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
orExpiration Date
.Datetime: Store date and time information for events, such as
Promotion Start Date
orFlash Sale End Time
.Integer: Use for whole numbers, such as
Stock Quantity
.Floating-point Number: Record numerical values with decimals, like
Price
orProduct 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
Access the Product Attribute Settings
Navigate to Settings > App Settings > Products > Product Attributes in your User.com account.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 orFloating point number
for different price values).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.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:
Access the People Section
Navigate to Data > People in your User.com account.Open the Filter Menu
Click the filter icon on the right-hand side of the page to access filtering options.Find the Products Events section
Scroll down to the Product Events section in the filter settings.Specify the Event Type and Attributes
Select the desired event type (e.g.,add to cart
,purchase
, orview
). 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 anInteger
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.