Skip to main content

Product Impression

An event that describes the action of viewing a list of products in a page as the user is browsing.

Here's an example of a Product Impression:

pcdp("event", "track", {
"clientId": "kevel",
"siteId": "kevel.com",
"type": "productImpression",
"customFields": {
"debug": "true",
"role": "superuser"
},
"products": [
{
"itemGroupId": "p125",
"name": "My product",
"brand": "Nike",
"category": "Men/Shirts/Short Sleeve Shirts",
"categoriesList": [
"Men",
"Shirts",
"Short Sleeve Shirts"
],
"currency": "EUR",
"promotions": [
"WINTERSALE"
],
"adult": false,
"size": "S",
"sizeSystem": "EU",
"customFields": {
"color": "blue"
},
"id": "p125zc",
"price": 102.5,
"quantity": 1,
"discount": {
"value": 5,
"currency": "EUR"
},
"gender": "male",
"sku": "p125zc-5"
}
]
})

In more detail, the fields supported on every Product Impression are:

FieldRequiredTypeDefaultExampleDescription
clientIdstring"kevel"The client identifier.
siteIdstring"kevel.com"The client's site identifier.
typerequired"productImpression""productImpression"The event type.
customFieldsobject of string{...}An object with custom fields for extra metadata to be supplied in the event. The values within this object must all be strings.
facebookConversionTrackingFacebook Conversion Tracking Details{...}A description of a tracking event to send to Facebook using Facebook Conversions API.
productsrequiredarray of Product[...]An array of products being shown as part of the product impression event.

Facebook Conversion Tracking Details

A description of a tracking event to send to Facebook using Facebook Conversions API.

FieldRequiredTypeDefaultExampleDescription
pixel_idstring"396622227884531"The pixel ID to associate this Facebook tracking event with.
event_idstring"0c53d0b57"ID used to deduplicate events sent by both Facebook Pixel and Conversions API. More information about the usefulness of this ID is available at https://developers.facebook.com/docs/marketing-api/server-side-api/using-the-api/deduplicate-pixel-and-server-side-events.
event_namestring"AddToCart"A Facebook pixel Standard Event or Custom Event name. This field is used to deduplicate events sent by both Facebook Pixel and Conversions API. The available Standard Events are listed in https://developers.facebook.com/docs/facebook-pixel/reference#standard-events.
custom_dataobject{...}Parameters to send additional data Facebook can use for ads delivery optimization. More information about the fields that can be supplied here is available at https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/custom-data.

Product

Product details.

FieldRequiredTypeDefaultExampleDescription
itemGroupIdstring"p125"Identifier for a group of products that come in different versions (variants).
namestring"""My product"Product name.
brandstring"Nike"Product brand.
categorystring"Men/Shirts/Short Sleeve Shirts"Product category. If possible, 'categoriesList' should be filled instead of this field.
categoriesListarray of string["Men", "Shirts", "Short Sleeve Shirts"]A hierarchically sorted list of the sub-categories that this product belongs to. The first item on this list should be the most general sub-category, while the last should be the most specific. Any item on this list should correspond to a sub-category of the item immediately preceding it. If 'category' is present and this field is left undefined, the default value of this field will be a best effort derivation of 'category'.
currencyrequiredstring"EUR"The currency used in monetary values. Supported values: "PLN", "CAD", "HKD", "AUD", "SEK", "TRY", "BRL", "KRW", "CZK", "BGN", "ETH", "CLP", "GBP", "MXN", "THB", "ISK", "SGD", "CHF", "INR", "LTC", "CNY", "PHP", "RON", "BTC", "DKK", "XAU", "XAG", "JPY", "ARS", "HUF", "MYR", "USD", "RUB", "NZD", "IDR", "ILS", "NOK", "NAD", "EUR", "ZAR" and "HRK".
promotionsarray of string[]["WINTERSALE"]Vouchers applied in the purchase or displayed together with the product.
adultbooleanfalsefalseWhether the product includes adult content (alcohol, guns, gambling, sexually suggestive content...) and might not show up to some users.
sizestring"S"Product size.
sizeSystemstring"EU"Country of the size system used by your product.
customFieldsobject of string{"color": "blue"}Additional fields related to the product. The values within this object must all be strings.
idrequiredstring"p125zc"Product identifier.
pricenumber0102.5The product's price.
quantitynumber11Number of items purchased.
discountDiscount{...}Discount applied to the product.
genderstring"male"Gender for which the product is intended.
skustring"p125zc-5"Product SKU.

Discount

Discount applied to the product. One of Percentage Discount, Price Discount or Value Discount.

Percentage Discount

A discount description where the percentage discounted is provided.

FieldRequiredTypeDefaultExampleDescription
percentagerequirednumber0.25The percentage of the discount.

Price Discount

A discount description where the price after the discount is provided.

FieldRequiredTypeDefaultExampleDescription
pricerequirednumber42The price after the discount.
currencyrequiredstring"EUR"The currency used in monetary values. Supported values: "PLN", "CAD", "HKD", "AUD", "SEK", "TRY", "BRL", "KRW", "CZK", "BGN", "ETH", "CLP", "GBP", "MXN", "THB", "ISK", "SGD", "CHF", "INR", "LTC", "CNY", "PHP", "RON", "BTC", "DKK", "XAU", "XAG", "JPY", "ARS", "HUF", "MYR", "USD", "RUB", "NZD", "IDR", "ILS", "NOK", "NAD", "EUR", "ZAR" and "HRK".

Value Discount

A discount description where the value of the discount is provided.

FieldRequiredTypeDefaultExampleDescription
valuerequirednumber10The total value of the discount.
currencyrequiredstring"EUR"The currency used in monetary values. Supported values: "PLN", "CAD", "HKD", "AUD", "SEK", "TRY", "BRL", "KRW", "CZK", "BGN", "ETH", "CLP", "GBP", "MXN", "THB", "ISK", "SGD", "CHF", "INR", "LTC", "CNY", "PHP", "RON", "BTC", "DKK", "XAU", "XAG", "JPY", "ARS", "HUF", "MYR", "USD", "RUB", "NZD", "IDR", "ILS", "NOK", "NAD", "EUR", "ZAR" and "HRK".