Plugin - Forms
The Forms plugin allows you to pass necessary information into a hidden field on the form and then into the CRM system, including the Strala UUID. The Strala UUID is needed to tie Touchpoint Interaction Events to Conversion Events.
Plugin Usage
The forms
plugin will automatically fire an "event" on form submission (see the events plugin). The event can be configured with the following data attributes applied to the form:
IMPORTANT: If no event is configured, the default event that will be of typeconversion
Configuration Options (custom data attirbutes)
data attribute | description |
---|---|
data_strala-event_type | The type of event to be tracked ( touchpoint or conversion ) |
data-strala-event_id | The "id" of the event (default: "window.location.href") |
data-strala-event_source ( conversion only) |
The "source" of the event (default: "form") |
data-strala-event ( conversion only) |
The "event" for the event (default: "form submit") |
Firing an event on form submit can be disabled by applying the data attribute data-strala-event-disable
Basic Implementation
Once a form is created, the following code needs to be embedded on that page within the form tag.
<form ... data-strala-form> <input type="hidden" name="strala_uuid" value="" /> ... </form>
IMPORTANT: Note that each implementation has a hidden field of name
strala_uuid
. The form plugin will fail if this field is not included in the form
The data-strala-form
portion of the code is a flag to indicate the page is using the Form plugin.
The <input ... />
portion of the code creates a hidden field named strala_uuid
, which is a necessary placeholder to store the Strala UUID for downstream processing.