Event Properties

Track custom dimensions for your events and get deeper insights into visitor behavior.

What are Event Properties?

Event Properties let you add extra data to your events. For example, an "affiliate_click" event can contain information about which product, category, or partner was clicked.

Besökskollen uses a whitelist system for properties. This means only properties you've registered in advance will be saved. This ensures data minimization and GDPR compliance.

Suggested properties

For affiliate sites, we recommend the following properties:

PropertyDescriptionExample
product_idUnique product IDabc123
product_slugURL-friendly product nameiphone-15-skal
category_slugProduct categorymobilskal
brand_slugBrandapple
partner_slugAffiliate partner/storeteknikdelar
pricePrice at click199
currencyCurrencySEK
positionPosition in list3
page_typePage typeproduct_page

Add properties

  1. 1. Go to SettingsEvent Properties
  2. 2. Select which site you want to configure
  3. 3. Click Add all to add all suggested properties
  4. 4. Or type a property name and click Add for custom properties

Send events with properties

Once you've registered your properties, you can send them with your events:

// Send event with properties
va('event', 'affiliate_click', {
  product_id: 'abc123',
  product_slug: 'iphone-15-skal',
  category_slug: 'mobilskal',
  brand_slug: 'apple',
  partner_slug: 'teknikdelar',
  price: 199,
  currency: 'SEK'
});

Only properties registered for your site will be saved. Other properties are silently ignored.

Limitations

Name formatsnake_case (a-z, 0-9, _, -)
Must start withA letter (a-z)
Value typesStrings, numbers (converted to string)
WhitelistOnly registered properties are saved

Using property data

When properties are saved, you can use them via the Public API to:

  • Fetch popular products based on actual clicks
  • See which categories are trending
  • Analyze which partners drive the most traffic
  • Filter by specific values (e.g. only one category)

GDPR and data minimization

The whitelist system ensures that only data you've explicitly chosen to save is actually stored. This helps you:

  • Follow GDPR's principle of data minimization
  • Avoid accidentally storing personal data
  • Have full control over what data is collected

Never send personal data

Never send personally identifiable information (PII) such as email addresses, phone numbers, social security numbers, or credit card numbers as property values.