items array you pass inside conversion events.
How it works
Hardal extracts item data from any event that includes anitems array: purchase, add_to_cart, view_item, begin_checkout, and others. The Items report aggregates this across all purchases.
What your events need
Include anitems array in your purchase event at minimum. The more fields you provide, the richer the breakdown.
Required vs optional fields
| Field | Required | Description |
|---|---|---|
item_id | Yes | Unique product identifier |
item_name | Yes | Product name |
price | Yes | Unit price at time of purchase |
quantity | Yes | Number of units |
item_brand | No | Brand name |
item_category | No | Primary category |
item_category2 | No | Secondary category |
item_category3 | No | Tertiary category |
item_sku | No | Stock keeping unit |
item_variant | No | Variant name (e.g. colour, size) |
item_variant_id | No | Unique variant identifier |
item_first_price | No | Original price before discounts |
item_tax | No | Tax for this item |
Common setup issues
| Symptom | Likely cause | Fix |
|---|---|---|
| Items report is empty | items array missing from purchase | Add items to your purchase event |
| Product revenue is wrong | price × quantity not matching | Ensure price is the unit price, not line total |
| Same product appears twice | Different item_id values used | Use a consistent product identifier across all events |
| Categories not showing | item_category not passed | Add category fields to your items |
View Items report
See your live product performance in the analytics dashboard