Catalog:
A catalog is a collection of catalog objects. In an e-commerce context, the catalog would contain all the products available for sale.
Catalog Objects:
Catalog objects are the individual items within the catalog. Each catalog object represents a key business entity that users can interact with, such as individual products.
Let's create a catalog and some catalog objects for an e-commerce website.
Catalog: Products
This catalog contains all the products available in the e-commerce store.
Catalog Objects:
Catalog Object: Product 1
Name: "Apple iPhone 14"
Labels: "Electronics", "Smartphones"
Custom Attributes:
Brand: "Apple"
Price: "$999.99"
SKU: "APL-IP14-001"
Color: "Space Gray"
Related Catalog Objects:
Accessories: "Apple AirPods Pro", "Apple MagSafe Charger"
Similar Products: "Samsung Galaxy S21", "Google Pixel 6"
Catalog Object: Product 2
Name: "Nike Air Max 270"
Labels: "Clothing", "Footwear"
Custom Attributes:
Brand: "Nike"
Price: "$150.00"
SKU: "NK-AM270-002"
Size: "10"
Color: "Black/White"
Related Catalog Objects:
Other sizes: "Nike Air Max 270 Size 9", "Nike Air Max 270 Size 11"
Similar Products: "Adidas Ultraboost", "Puma RS-X"
Catalog Object: Product 3
Name: "Instant Pot Duo 7-in-1"
Labels: "Home Goods", "Kitchen Appliances"
Custom Attributes:
Brand: "Instant Pot"
Price: "$89.99"
SKU: "IP-DUO-003"
Capacity: "6 Quarts"
Related Catalog Objects:
Accessories: "Instant Pot Silicone Lid", "Instant Pot Tempered Glass Lid"
Similar Products: "Ninja Foodi 8-in-1", "Crock-Pot Express"
Catalog (Products): The overarching structure that holds all product-related catalog objects.
Catalog Objects (Individual Products): Each product is a catalog object with specific attributes (like name, brand, price) and relationships to other catalog objects (like accessories or similar products).
A user visits the e-commerce website and views the "Apple iPhone 14".
The system tracks this interaction and may recommend related catalog objects, such as accessories like "Apple AirPods Pro" or similar smartphones like the "Samsung Galaxy S21".
If the user then views the "Nike Air Max 270" next, the system again tracks this behavior and might recommend other sizes of the same shoe or similar footwear like "Adidas Ultraboost".
Catalog: A structured collection of all relevant business objects (e.g., a catalog of products).
Catalog Objects: Individual items within the catalog, each representing a specific business entity (e.g., individual products).
Configuration: Each catalog object is configured with attributes (like name, brand, price) and related objects (like accessories or similar products).
User Behavior Tracking: The platform tracks how users interact with these objects and uses this data to personalize the user experience.
How attributes are related to catalog and Catalog Object?
Catalog Object: Product
Product 1: "Apple iPhone 14"
Attributes:
Name: "Apple iPhone 14"
URL: "https://example.com/apple-iphone-14"
Price: "$999.99"
Inventory Count: 50
Image URL: "https://example.com/images/iphone-14.jpg"
Date Added: "2024-01-01"
Image Alt Text: "Apple iPhone 14 in Space Gray"
Archived: false
PromotionState: "Included"
Expiration Date: "2025-01-01"
Published Date: "2024-01-01"
Product 2: "Nike Air Max 270"
Attributes:
Name: "Nike Air Max 270"
URL: "https://example.com/nike-air-max-270"
Price: "$150.00"
Inventory Count: 100
Image URL: "https://example.com/images/nike-air-max-270.jpg"
Date Added: "2023-12-01"
Image Alt Text: "Nike Air Max 270 in Black and White"
Archived: false
PromotionState: "Included"
Expiration Date: "2024-12-01"
Published Date: "2023-12-01"
For a catalog object to be promoted and appear in Personalization Recommendations, it must:
Archived Attribute: Be false.
PromotionState Attribute: Not be Excluded.
Expiration Date: Not be in the past.
Published Date: Not be in the future.
Mandatory Attributes:
Have values for name and url.
For Products:
Price must be greater than zero.
Inventory Count must be greater than zero.
Image URL must have a value.
Product 1: "Apple iPhone 14"
Archived: false (meets condition)
PromotionState: "Included" (meets condition)
Expiration Date: "2025-01-01" (meets condition, future date)
Published Date: "2024-01-01" (meets condition, current date or past)
Name and URL: Present (meets condition)
Price: $999.99 (meets condition, greater than zero)
Inventory Count: 50 (meets condition, greater than zero)
Image URL: Present (meets condition)
Product 2: "Nike Air Max 270"
Archived: false (meets condition)
PromotionState: "Included" (meets condition)
Expiration Date: "2024-12-01" (meets condition, future date)
Published Date: "2023-12-01" (meets condition, current date or past)
Name and URL: Present (meets condition)
Price: $150.00 (meets condition, greater than zero)
Inventory Count: 100 (meets condition, greater than zero)
Image URL: Present (meets condition)