Promotional Properties

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

Properties

promotionId

Promotion/campaign identifier.

promotionName

Promotion display name.

creativeName

Creative/ad variant name.

creativeSlot

Placement position on page.

locationId

Store/affiliate/location ID.

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

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

content_ids promotionId

⌘I

SDK

PIXEL EVENTS

IDENTITY

AUTOMATIC TRACKING

Properties

promotionId

promotionName

creativeName

creativeSlot

locationId

Quick Reference

Example

Use Cases

​Properties

promotionId

promotionName

creativeName

creativeSlot

locationId

​Quick Reference

​Example

​Use Cases

Properties

Quick Reference

Example

Use Cases