Technical Notes on Events and Properties

Have you ever wondered if Events are case sensitive? Or how many unique Property names you can have? This document has more information about the technical limitations related to Events and Properties.

Events

  • Keep event names under 255 characters.
  • Commas (,) and colons (:) will be changed to spaces, so an event “foo:bar,baz” will be saved as “foo bar baz”.
  • Event names are not case sensitive. For example “Signed Up” and “signed up” will be treated as the same event.
  • Events that share the same name will be aggregated.
  • Each KM product has an upper limit of 65,535 unique event names. We recommend starting with just a few key events. You can find out more information about how to structure your events in this support document.
  • We keep data from 2009, going forward. We will not be able to store your imported data from 2008 or before.

Properties

  • Keep property names under 255 characters.
  • Commas (,) and colons (:) will be changed to spaces, so a property “foo:bar,baz” will be saved as “foo bar baz”.
  • Property names are not case sensitive. For example “Plan Type” and “plan type” will be treated as the same property.
  • Properties that share the same name will be aggregated. For example, if the “Billed Amount” is set in three different areas, it will all contribute to the same “Billed Amount” property.
  • Each KM product has an upper limit of 65,535 unique property names.
  • The value of a property is case sensitive. Example, if you set “Plan Type” : “Premium” and “Plan Type” : “premium”, you’ll see both values — “Premium” and “premium” — for the property “Plan Type”.
  • The values of properties can be text or numbers: 512 characters. We do not support JSON-structured values.
  • We keep data from 2009 on. We will not be able to store your imported data from 2008 or before.
  • The property type is determined by the value. If you pass in a string “123”, Kissmetrics will treat that as the integer 123.
  • Currency should be passed to Kissmetrics without a currency symbol. Introducing a symbol makes it so that Kissmetrics no longer interprets the value as an integer. Consequently, it loses the ability to make calculations on those values (e.g., when calculating the total or average value of a property)