Sample code
// the event name used here will automatically
// appear in the goal and audience builders
Txt.track({
eventName: 'purchase',
eventValue: 29.99
})
The track function sends an event to Unless' system. The event can be connected in the dashboard to an audience (to join the audience) or a goal (to achieve the goal).
Txt.track(options)
The options object is required and should be structured as follows:
| Key | Type | Description |
|---|---|---|
| eventName | string required | The name of the event. |
| eventValue | number optional | Used in case of a goal achievement to store the value of the goal conversion. |
| data | array optional | Record additional traits to the visitor, see the updateProfile function for a description of the data format. |
| callback | function optional | callback function that will be executed after sending the event to our server. |
Joining or leaving an audience using a specified audience ID
Using an event to join an audience like described above is usually the preferred method because you don't have to know the exact audience ID. Alternatively, you can also join an audience directly using the audience ID by using the following API call.
Txt.joinAudience(audienceId)
You can also force a visitor to leave a specific audience. Remember, the visitor can re-join the audience at any time.
Txt.leaveAudience(audienceId)