Products: Overview

Products are the products with which profiles can interact. The products stored in Spotler Activate can be found under Products. Products consist of product fields and can be saved in multiple languages.
Overview.png

By default, a product that is no longer in the feed is placed on disabled and removed after 7 days.

If you do not want this, you can activate the “Don't cleanup products” option in settings.

Overview

By clicking on a product, you can view the product fields of the product. These values ​​are filled by the product feed that is connected to your Spotler activate account. In case of a standard connector, the fields are automatically mapped. If you are using an XML feed, check the required naming of the values ​​described below.

Product information.png

Product fields are fields of products in which product information is stored. The products stored in Spotler Activate can be found under the Products > Overview. Products will be removed from Spotler Activate if they are not part of the Product Feed for seven days.

By clicking on a product, you can view the product fields of the product. And it is possible to change the name of custom product fields. Please note that this field must then also be processed under this name in the Product Feed. It is not possible to delete custom product fields in Spotler Activate.

The following fields are mandatory to correctly save a product:

SKU/Product ID

The SKU is the unique identifier of the product. The SKU is a mandatory product field to store products in Spotler Activate.

In the events and product feed the name id is used for this field

Based on the SKU, Spotler Activate identifies the products that have been interacted with in the events. Attention: the product id in the events should correspond with the SKU of the products in Spotler Activate.

  • A profile triggers the following event:
    SKU_productfields.png
  • Spotler Activate interprets the product id as '1'
  • Spotler Activate searches the database for the product with SKU '1'
  • When the product is present, Spotler Activate can make the link between the event and the product fields of product 

Are you getting no results from the search? :arrow_right: Check the implementation of the product feed

Name
The product name is the name of the product. The name is a mandatory product field to save products in Spotler Activate.

Note: in the product feed the name title is used for this field.
URL

The product URL is the website link where the product is displayed. The URL is a mandatory product field to store products in Spotler Activate. Please note that in the product feed the name link is used for this field.

 

The following fields are optional to add to provide more information about the product:

Images

The product images are the images of the product. The images are not a mandatory product field. However, the field is strongly recommended as it is frequently used in product sets and personalizations.

Note: In the product feed, the terms image_link and image_links are used for this field.

Price

The product price is the price of the product.

The price is not a mandatory product field. However, the field is strongly recommended as it is frequently used in product sets and personalizations.

Note: In the product feed, this field is processed together with the currency.

Currency

The product currency is the currency of the product's price.

The currency is not a mandatory product field. However, the field is recommended and is even crucial when products are offered in multiple currencies. In such cases, products must have a separate SKU per currency, and you can contact the Help Center for support.

Note: In the product feed, this field is processed together with the price.

Availability

The product availability is the availability of the product.

The availability is not a mandatory product field. However, the field is strongly recommended as it is frequently used in product sets and personalizations.

Inventory

The product inventory is the stock of the product.

The inventory is not a mandatory product field. However, the field is strongly recommended as it is frequently used in product sets and personalizations.

Parent ID

The parent ID is the SKU of the overarching product. Products with the same parent ID are considered variants of the overarching product.

The parent ID is not a mandatory product field. However, it is crucial for merging product variants under a main product. Common examples of product variants include sizes, colors, or configurations.

For example, suppose you have three products on the website:

  • Blue trousers
  • Blue trousers size S
  • Blue trousers size M

Using the following setup, you can ensure in Spotler Activate that these products are linked:

  • Blue trousers with SKU 1 and parent_id 1
  • Blue trousers size S with SKU 100 and parent_id 1
  • Blue trousers size M with SKU 101 and parent_id 1

Important!

To optimally accumulate parent and child conversions, it is recommended to assign the parent product's own SKU as its parent ID. In the example above, the trousers with SKU 1 also have parent_id 1.

Categories

Categories represent the groups to which a product belongs. Based on categories, products are grouped together in Spotler Activate.

Categories is not a mandatory product field. However, the field is strongly recommended as it is used to determine the favorite category in profile data and is frequently used in product sets and personalizations.

How can I check the categories of a product in Spotler Activate?

Based on the categories field, products are grouped into categories. In Spotler Activate, you can view all existing categories under Categories. In this overview, you will find the following details:

  • ID: The ID of the category
  • Name: The name of the category

For more information on how to manage and configure categories, go to Products > Categories.

Brand

The product brand is the brand of the product.

The brand is not a mandatory product field. However, the field is recommended as it is used to determine the favorite brand in profile data and is frequently used in product sets and personalizations.

Size

The product size is the size of the product.

The size is not a mandatory product field. However, the field is recommended as it is frequently used in product sets and personalizations.

Color

The product color is the color of the product.

The color is not a mandatory product field. However, the field is recommended as it is frequently used in product sets and personalizations.

Description

The product description is the description of the product.

The description is not a mandatory product field. However, the field is recommended as it is frequently used in personalizations.

Sale Price

The product sale price is the promotional price of the product. The sale price is not a mandatory product field. However, the field is needed if you want to display the sale price in personalizations.

Note: The sale price automatically inherits the (if applicable) currency from the price field.

Condition

The product condition is the condition of the product.

The condition is not a mandatory product field.

% Discount

The product % Discount is the difference between the price and the sale price of the product, expressed as a percentage.

This field is calculated on the backend and is not specified as a product field.

Popularity Score

Sometimes you want to promote certain products on your website, for example on the homepage. This can be done with product sets such as Most Sold, Most Viewed, but it’s mostly a combination of events that determines a product’s popularity.

How to use a popularity score?