Event Trigger listener

Event Trigger listening allows you to pick up on certain changes and throw an event when they happen. Such event can then be caught by things that are waiting for that event to be thrown, for example dialogues.

Adding a new Event Trigger listener

  1. Click Listeners in the Navigation bar.
  2. Click Add listener.
  3. A pop-up window appears. Check the Show all box. Enter “event trigger” in the Search bar. Click Event Trigger listener.
  4. The Event Trigger listener page opens. You can expand or collapse metadata fields (favorite, labels, and description) by clicking the gray + or .

Configuration

  1. Optional: enter the channels and / or pages where you want the listener to be active.
  2. Click Add event and rule to add a new event and the rule that decides when to throw that event. These are the options:
    • Content rule will trigger an event based on the content of the page or based on a JavaScript variable

      • Click define event. A popup opens. Select an existing event or enter a new event name and select Create new event. Click Ok to close the popup.
      • Click define content area. A popup opens. Select the source that should be compared; either a Content area defined by a selector, a Javascript variable on the page or Custom javascript.
      • Click contains to toggle between "contains" and "exactly matches".
      • Click define words. A popup opens. Define the text or specific words that should be matched. Click Ok to close the popup.
      • Click no delay to enter the number of milliseconds that should pass between the click and the event being thrown. Leave empty for no delay.


    • Click rule will trigger an event based on the click behavior of the visitor

      • Click define event. A popup opens. Select an existing event or enter a new event name and select Create new event. Click Ok to close the popup.
      • Click HTML. A popup opens. Select the source that should be compared; either a Content area defined by a selector, a Javascript variable on the page or Custom javascript.
      • Click contains to toggle between "contains" and "exactly matches".
      • Click any text. A popup opens. Define the text or specific words that should be matched. Click Ok to close the popup.
      • Click define click area to define the area where the visitor will click with a jQuery selector or with the Visual picker.
      • Click no delay to enter the number of milliseconds that should pass between the click and the event being thrown. Leave empty for no delay.

Privacy Management

Listeners can be added to Objectives, allowing for privacy management of the information that is being picked up. The listener will only update a profile if the visitor consented to at least one of the objectives that it is linked to.

Using events

Once you have added events and have configured when they will be thrown, you will want to take action based on them. There are two ways of using events: in a a dialogue or in javascript.

Using events in a dialogue

  1. Open you dialogue.
  2. Click the When tab.
  3. Click Add rule and select Show on event.
  4. Scroll through the list of events and activate the checkbox for your event
  5. Click Save

The dialogue will now only fire when the event is thrown by the event listener.

Using events in javascript

The BlueConic front-end Javascript API provides the function event.subscribe() to subscribe to your event. See the documentation for a full code example.

 

The Event Trigger listener is a standard plugin.