Can I create Events, Traits & Properties on my own?

It depends:

Do you want to check your current set-up for events? Under the heading Current set-up you will find an explanation.

Traits

Yes. User traits (sometimes called “attributes”) can get created via the User Management API.

While certain traits are built into the Spotler ActivatePro platform, our customers can also create their own custom traits via API call.

Example:

{
"name": "traits.example",
"attributeType": "STRING"
}

Traits come in the following six data types: STRING, INTEGER, FLOAT, DATETIME, BOOLEAN or ARRAY

But in order to use the API you might need to use an API client (e.g. Insomnia) and need to know the Master API key for your account/environment.

Events

No.

Certain events are built into the Spotler ActivatePro platform, while others must be custom created. Currently, Spotler ActivatePro does not enable customers to create custom events and properties (kind of) in self service. However, reach out to our Customer Experience team at any time via Service Desk and we will be happy to create whatever events and properties you may require.

An event that the system doesn’t know yet will get declined by the API with the status code 400 and “UNKNOWN_VALUE”.

Event-Properties

Yes (technically), but you still might need the support from Spotler ActivatePro afterwards, so also kind of “no”.

Event properties can technically get created with the same method like user traits, the only difference is, that user traits begin with “traits” and event properties with “properties”. 

If a property does not exist yet, but is send with some events, then the indexer will ignore these properties. Once the system knows of the existence of a property, it will index it for new incoming events that use that property.

Usually we don’t recommend to create event properties yourself, because you need to know what you are doing and also:

If you want to use the property for segmentation, it needs to get activated/made visible for the event. This can not be done via API, so you need to contact the ActivatePro Support team for that.

Current setup

If you want to know what your current setup is, you can check some things in the App and some via API.

Events

To check existing built-in events you need to go to “System Setup”

and check the tab “Event reference”

Here you can find an overview of events that exist in your account, sorted into different categories (system internals, integration specifics, custom etc.).

Unfortunately we can’t display the connected properties of these events. If you need this information, please reach out to the ActivatePro Support team.

Properties and Traits

To check for the existing attribute list (traits and properties) in your account, you will need to make an API call to fetch the list like this:

The result then looks something like this (sample):