You are here:
Create a Custom Catalog Object
Personalization collects behavioral data in the context of the catalog that you create and uses catalog objects to assess and analyze customer engagement and affinities. You can add more detail to your catalog by using custom objects. The more detailed you make your catalog, the more granular your insights are regarding customer engagement and affinity.
Required Editions
| Permissions Needed | |
|---|---|
| To create a custom catalog object: | A role with Configure permissions |
When creating a custom catalog objects, keep these considerations in mind.
- You can create up to 20 custom catalog objects.
- Personalization uses the catalog object name in the sitemap, and for ETL data storage and updates.
- You can’t change the Name value after you save the catalog object.
- Catalog objects and user profile objects can’t have the same name.
- For a catalog object to appear as one of the four object types in the Affinities graph, assign the Style, Brand, or ItemClass object type as the custom catalog object Name value.
To create a custom object:
- From the main navigation, select Settings | Catalog and Profile Objects.
- Next to Catalog Object Types, click +.
- Enter a name for the catalog object up to 30 letters and starting with a capital letter.
- For Label, enter the text that you want users to see when representing the catalog object in the Personalization application. The label doesn’t affect data capture or storage.
-
(Optional) For Description, describe the catalog object and
its purpose.
If your description is more than 200 characters, Personalization truncates the text and adds an ellipsis (...).
-
(Optional) Add an attribute to the catalog object.
- In the Attributes section, click New Attribute and enter a name and label.
- Select the attribute type.
-
Click the checkmark (
).
-
(Optional) Associate an existing custom catalog object with the new catalog
object.
Note Associating a built-in catalog object with a custom catalog object is not supported.- In the Related Catalog Objects section, click Add Related Catalog Object.
- In the Related Catalog Object column, select the object.
-
In the Relationship Cardinality column, select the relationship
cardinality.
Item Description One per Object - If an item action event includes the relatedCatalogObject type, Personalization sets the catalog objects for that type on the item, replacing any existing catalog objects for that type. If there’s more than one object type in the event, Personalization uses only the first in the list, and also tracks statistics for the catalog object.
- If an item action event doesn’t include the relatedCatalogObject type, Personalization tracks statistics for an existing catalog object of that type if one exists for the item.
Many per Object - If an item action event includes the relatedCatalogObject type, Personalization adds it to the item's set of catalog objects. Personalization also tracks statistics for all the catalog objects for that type associated with the item.
- If an item action event doesn’t include the relatedCatalogObject, Personalization tracks statistics for all existing catalog objects of that type associated with the item.
-
Confirm your selections in the Output/Preview column, and then click the
checkmark ().
- In the upper-right corner of the Catalog and Profile Objects page, switch the object state to Enabled.
- Click Save.
- In Personalization main navigation, click Catalog and select the catalog object that you created.
- In the upper-right corner of the object page, click New <Catalog Object>.
- Define attributes and other settings for the catalog object.
- Save your work.
Did this article solve your issue?
Let us know so we can improve!
