Product Traits

Item Traits

Item traits define the structure and behavior of individual products, services, or offers tracked on your site.

They are used in multiple events such as product views, list views, and filtered lists to provide detailed item-level insights.

Item JSON Structure

Describes the attributes of a key item (product, service, or offer) when viewed or engaged with.

Name Type Description
item_id   String Unique identifier for the item.
item_name   String Name of the item.
affiliation   String Product affiliation (e.g., supplying company or store location).
coupon   String Coupon name or code associated with the item.
discount   Number Unit discount value applied to the item.
item_brand   String Brand of the item.
item_category   String Primary product category.
item_category2   String Secondary category (optional).
item_category3   String Third-level category (optional).
item_category4   String Fourth-level category (optional).
item_category5   String Fifth-level category (optional).
item_variant   String Variant, color, or unique descriptor.
item_size   String Item size (e.g., S, M, L).
location_id   String Physical location or store associated with the item.
price   Number Unit price of the product (excluding tax and shipping).
quantity   Number Quantity of the item. Defaults to 1 if not specified.
url   String Full product detail page URL.
image_url   String URL of the product image.
customParam1   – customParam5   String Custom item parameters for additional data.

Example:

{  "item_id": "SKU_12346",  "item_name": "Grey Women's Tee",  "affiliation": "Main Store",  "coupon": "SUMMER_FUN",  "discount": 3.33,  "index": 1,  "item_brand": "Summer",  "item_category": "Apparel",  "item_category2": "Adult",  "item_category3": "Shirts",  "item_category4": "Crew",  "item_category5": "Short sleeve",  "item_variant": "gray",  "item_size": "S",  "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",  "price": 21.01,  "promotion_id": "P_12345",  "promotion_name": "Summer Sale",  "quantity": 2,  "url": "https://myweb/shirt",  "image_url": "https://myweb/images/shirt.jpg",  "customParam1": "margin_A" }

view_item  

Triggered when a visitor views a specific product or service page.

Name Type Description
currency   String Currency of the items (3-letter ISO 4217 code).
value   Number Total value of the event (sum of price × quantity   for all items). Excludes tax and shipping.
items   Array List of viewed items (using the Item JSON structure).

Example:

ppopAPI.sendTraits('view_item', {  currency: "USD",  value: 30.03,  items: [    {      item_id: "SKU_12345",      item_name: "Stan and Friends Tee",      affiliation: "Main store",      coupon: "SUMMER_FUN",      discount: 2.22,      index: 0,      item_brand: "Summer",      item_category: "Apparel",      item_category2: "Adult",      item_category3: "Shirts",      item_category4: "Crew",      item_category5: "Short sleeve",      item_list_id: "related_products",      item_list_name: "Related Products",      item_size: "S",      item_variant: "green",      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",      price: 10.01,      quantity: 3    }  ] });

view_item_list  

Triggered when a visitor views a product list or category page.

Name Type Description
currency   String Currency of the items (3-letter ISO 4217 code).
list_category   – list_category5   String Category hierarchy being viewed.
item_list_id   String ID of the product list displayed.
item_list_name   String Name of the product list displayed.
items   Array List of items shown in the list.

Example:

ppopAPI.sendTraits('view_item_list', {  currency: "USD",  item_list_id: "related_products",  item_list_name: "Related products",  list_category: "Adult",  list_category2: "Shirts",  items: [    {      item_id: "SKU_12345",      item_name: "Stan and Friends Tee",      affiliation: "Main store",      coupon: "SUMMER_FUN",      discount: 2.22,      index: 0,      item_brand: "Summer",      item_category: "Apparel",      item_category2: "Adult",      item_category3: "Shirts",      item_category4: "Crew",      item_category5: "Short sleeve",      item_list_id: "related_products",      item_list_name: "Related Products",      item_size: "S",      item_variant: "green",      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",      price: 10.01,      quantity: 3    }  ] });

filter_item_list  

Send this event when a visitor applies filters or sorting on a product list or category page.

Trait Type Description
item_list_id   String Product list being viewed.
item_list_name   String Name of the list where the filter was applied.
list_category   – list_category5   String Product categories being viewed.
filters   Array Product filters used by the visitor.
filters.type   String ID of the filter type (e.g., department, price).
filters.value   String Selected filter value.
sorts   Array Product sorting applied.
sorts.type   String ID of the sort type (e.g., price, popularity).
sorts.value   String Sort order (ascending, descending).
items   Array List of items displayed after applying filters/sorting.

Want to explore more?

Check out our guide on Promotions to learn how Powerpop tracks and

optimizes promotional events across your site.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.