Adding events in profiles

You can add events to a profile manually. This is useful when you want to:

• test your configuration, for example, trigger a workflow that starts with a specific event,
• record an activity that was not tracked automatically, for example, correct the loyalty points when a customer returns products after a complaint.

You can't edit existing events in the profile view. To add an event similar to an existing one, use the Duplicate event option in the event details or import it from JSON. To change an existing event, you must overwrite it by using the API. For details and requirements, see Overwriting events.

Adding an event

1. Go to Behavioral Data Hub > Profiles.
2. Find a target profile. To make it faster, you can use the search box.
3. Go to the profile by clicking its name.
4. At the bottom of the activity list, click Add event.
   Result: The Add new event window opens. The Added by and Profile ID fields are filled in automatically.
5. From the Action dropdown list, select an event to add to the profile. The list contains all tracked events.
   
   TIP: You can find the whole list of the events and their parameters in Data Modeling Hub > Event List.
   
6. Optionally, in Time, select the date and time of the event. If you leave this field empty, the event gets the current time.
7. To add an event parameter, in the Additional parameters section, click Add.
8. From the Type dropdown list, select the data type of the parameter: Text, Number, Boolean, Date, List, JSON, or Null.
9. In Name, enter the name of the parameter.
10. In Value, enter the value of the parameter.
    If you add a parameter that does not exist in the system, it is added to the event's configuration system-wide. To learn more about event parameters, see Event parameters and enrichment.
11. To add more parameters, repeat steps 7-10. To remove a parameter, click the X icon next to it.
12. To complete the process, click Apply.
    Result: An event appears on the activity list.

To clear all fields of the form except Added by and Profile ID, click Clear all.

Importing an event from JSON

Instead of filling in the form manually, you can import the event from JSON. This is useful when you want to re-create an event that already exists in a profile. You can copy the JSON of an existing event with the Copy JSON or Copy parameters option in the event details.

1. In the Add new event window, click Import JSON.

2. Paste the JSON into the editor. You can use one of the following formats:

   • Full event JSON, the same format you get with the Copy JSON option. The action and the parameters from the params object are filled in. Other properties, such as eventUUID, unique, createDate, and label, are removed.

     {
       "action": "product.buy",
       "eventUUID": "3e733363-d313-4211-819d-378ed5da2722",
       "unique": 3893684571,
       "createDate": 1790849759539,
       "label": "",
       "params": {
         "$sku": "123",
         "brand": "Nike"
       }
     }
     

   • Parameters only, the same format you get with the Copy parameters option. Only the parameters are filled in. You must select the action manually.
     

     {
       "$sku": "123",
       "brand": "Nike"
     }
     

   The type of each parameter is set based on its JSON value. For example, "1" is imported as Text and 1 as Number

3. When the Correct syntax message appears under the editor, click Import.
   Result: The Add new event window opens with the imported data. Parameters that you entered in the form before the import are overwritten.
4. Optionally, modify the action, time, and parameters. The time is not imported, so if you leave the Time field empty, the event gets the current time.
5. Click Apply.
   Result: An event appears on the activity list.