Skip to main content
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

PropertyTypeDescriptionEvents
promotionIdstringPromotion or campaign identifierview_content, add_to_cart, purchase
promotionNamestringPromotion display nameview_content, add_to_cart, purchase
creativeNamestringCreative or ad variant nameview_content, add_to_cart, purchase
creativeSlotstringCreative placement positionview_content, add_to_cart, purchase
locationIdstringStore, affiliate, or location identifierAll 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