---
title: Promotion Viewed
slug: tracking-plan/promotion-viewed
docTags: 
createdAt: 2026-01-21T23:00:52.284Z
---

User viewed promotion.

**Suggested source:** website front-end

**Properties**

| Name               | Type       | Description                                                                                                                 | Required |
| ------------------ | ---------- | --------------------------------------------------------------------------------------------------------------------------- | -------- |
| **creative**       | `string`   | Promotion's creative (for example, top\_banner\_2)<br />                                                                    | no       |
| **name**           | `string`   | Promotion's name (for example, "75% store-wide shoe sale")<br />                                                            | yes      |
| **position**       | `string`   | Promotion's position (for example, home\_banner\_top)<br />                                                                 | no       |
| **promotion\_id**  | `string`   | Promotion's ID (for example, promo\_1)<br />                                                                                | yes      |
| **bundle**         | `boolean`  | Product belongs to a bundle<br />                                                                                           | no       |
| **description**    | `string`   | Short description of the product<br />                                                                                      | no       |
| **option\_values** | `string[]` | Option values of the product variant<br />                                                                                  | no       |
| **slug**           | `string`   | Slug of the product, often used in URLs (for example, "product-red")<br />                                                  | no       |
| **affiliation**    | `string`   | Product affiliation to designate a supplying company or brick and mortar store location (for example, "Google Store")<br /> | no       |
| **brand**          | `string`   | Brand associated with the product<br />                                                                                     | no       |
| **category**       | `string`   | Product category<br />                                                                                                      | no       |
| **coupon**         | `string`   | Coupon code associated with a product (for example, "MAY\_DEALS\_3")<br />                                                  | no       |
| **currency**       | `string`   | Currency code of the transaction (for example, "USD")<br />Pattern: `^[A-Z]{3}$`<br />                                      | no       |
| **price**          | `number`   | Price ($) of the product<br />                                                                                              | no       |
| **product\_id**    | `string`   | Database ID of the product<br />                                                                                            | no       |
| **quantity**       | `integer`  | Quantity of the product<br />                                                                                               | no       |
| **variant**        | `string`   | Name of the product variant<br />                                                                                           | no       |

**Example**

```json
{
    "creative": "top_banner_2",
    "name": "15% off spring seeds",
    "position": "home_banner_top",
    "promotion_id": "promo_1",
    "affiliation": "My Plant Store",
    "brand": "Green Thumb Nurseries",
    "bundle": false,
    "category": "Vegetable Seeds",
    "coupon": "SPRING15",
    "currency": "USD",
    "description": "High-quality heirloom carrot seeds that produce sweet and crunchy carrots, perfect for home gardening.",
    "image_url": "https://example.com/images/carrot-seeds.jpg",
    "option_values": [
        "Nantes",
        "Danvers",
        "Imperator"
    ],
    "price": 3.99,
    "product_id": "987654321",
    "quantity": 1,
    "sku": "CARROT-002",
    "slug": "heirloom-carrot-seeds",
    "url": "https://example.com/seeds/carrot",
    "variant": "Nantes"
}
```

&#x20;



## option\_values\[] array

Option values of the product variant

Option value (for example, "red")

**Item Type:** `string`