> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upstackdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Promotional Properties

> Properties for tracking promotions, campaigns, and affiliate activity — promotion IDs, creative names, and location tracking.

Promotional properties help track on-site promotions, campaigns, and affiliate activity.

## Properties

<CardGroup cols={3}>
  <Card title="promotionId" icon="fingerprint" href="/pixel/events/properties/promotion-id">
    Promotion/campaign identifier.
  </Card>

  <Card title="promotionName" icon="tag" href="/pixel/events/properties/promotion-name">
    Promotion display name.
  </Card>

  <Card title="creativeName" icon="palette" href="/pixel/events/properties/creative-name">
    Creative/ad variant name.
  </Card>

  <Card title="creativeSlot" icon="table-cells" href="/pixel/events/properties/creative-slot">
    Placement position on page.
  </Card>

  <Card title="locationId" icon="location-dot" href="/pixel/events/properties/location-id">
    Store/affiliate/location ID.
  </Card>
</CardGroup>

## Quick Reference

| Property        | Type   | Description                              | Events                                 |
| --------------- | ------ | ---------------------------------------- | -------------------------------------- |
| `promotionId`   | string | Promotion or campaign identifier         | view\_content, add\_to\_cart, purchase |
| `promotionName` | string | Promotion display name                   | view\_content, add\_to\_cart, purchase |
| `creativeName`  | string | Creative or ad variant name              | view\_content, add\_to\_cart, purchase |
| `creativeSlot`  | string | Creative placement position              | view\_content, add\_to\_cart, purchase |
| `locationId`    | string | Store, affiliate, or location identifier | All events                             |

## Example

```javascript theme={null}
window._upstack('track', 'view_content', {
  items: [{ id: 'SKU_001', name: 'Running Shoes', price: 89.99 }],
  value: 89.99,
  currency: 'USD',
  promotionId: 'SUMMER_SALE_2026',
  promotionName: 'Summer Sale 2026',
  creativeName: 'hero_banner_v2',
  creativeSlot: 'homepage_hero',
  locationId: 'store_nyc_001'
});
```

## Use Cases

* **On-site promotions**: Track which banners and placements drive conversions
* **Affiliate tracking**: Identify which partners referred customers
* **Multi-location retail**: Attribute conversions to specific store locations