Kapitalwise | Support Documentation
Back to Dashboard App
Home > Tags

Tags

- 1 minute to read
Also known as External Events, these are custom events created by you on the Kapitalwise app. You have the flexibility to create your own events that you would like to capture and use in Kapitalwise platform. These events pretty much behave similarly as the other events that are captured and managed by Kapitalwise such as Signals, Campaign Events etc. The only difference is that these are defined by you.

Event with Triggers

These events are meant for tracking activities on your web pages. You can choose from a wide range of available triggers and use them to create an event.
Follow the steps below to create an Event with Triggers:
  1. Click Create Events under the menu Tags.
  2. Enter event name and description.
  3. Check the Webpage checkbox.
  4. From the triggers dropdown select the triggers you want to associate with this event. You can select multiple triggers.
  5. Click the Save button.
Once you save the event, you will see that a script appeared just below the save button. Copy that script and add that in the web page you want to track. You need to add this script only once. Now, whenever an action that your triggers are listening to is detected, we will capture this event and save it on your Kapitalwise app.

Event with Schema

These events are flexible custom events that you can publish to the Kapitalwise application using a REST API. These are useful if you have some internal events and you want to make them available in your Kapitalwise application. For example, if you capture branch visits by your contacts, you may create an event in kapitalwise called “Branch Visit”. And, whenever a contact visits your branch you may publish that event in Kapitalwise. You may use this event to trigger a workflow for sending feedback emails.
Follow these steps to create an event with schema:
  1. Click Create Events under the Tags menu.
  2. Enter the name and description.
  3. Keep the webpage checkbox unchecked.
  4. Now, you need to define the schema (attributes) of this event. Enter the attribute name and select the data type of that attribute from the next dropdown. If this attribute is optional you can check the optional checkbox.
  5. You can click on add new to define more attributes of your event. Please note that only characters, numbers and underscores are allowed in attribute names.
  6. When you are done, click save.
Once you save the event, you will see that a company key appears just below the save button. Please copy and save it somewhere because this key is required for calling the API to publish the event on Kapitalwise. Please contact your Kapitalwise Relationship Manager for more information on API.

View an Event

You can view a previously created event by following these steps:
  1. Click All Events under the Tags menu.
  2. Click the preview icon of the event you want to view.
  3. You will see the event details including the generated script or company key depending on the type of the event.

List an Event

For each event, you can see for which of your contacts it has occurred till now. To list an event:
  1. Click All Events under the Tags menu.
  2. Click the List icon of the event for which you want to see the list.

Triggers

A trigger listens to your web page for certain types of actions like form submissions, button clicks, or page views. The trigger tells an event to fire when the specified action is detected. Every web page event must have at least one trigger in order to fire.
We have different types of triggers available and for each trigger type you can select trigger filters which specify when a trigger fires.
  1. Page View
  2. Clicks
  3. Form Submission
  4. Input Textbox
  5. Web Analytics*
*Web Analytics is a special type of trigger. Detailed information on Web Analytics Trigger is included in this guide below.

Web Analytics Trigger

This trigger is used to generate extensive web analytics for your web pages. Below are some important points to know for web analytics trigger:
  1. This is a special kind of trigger that doesn’t need to be associated with an event.
  2. When you create a Trigger of type web analytics and save it, you will get a script directly. This script needs to be added to each of the web pages you want to track and generate web analytics.
  3. By default we add this script on each of your web pages published using Kapitalwise Web Page Campaigns.
  4. We generate tracking data such as page views, clicks, user sessions, session duration etc. using this web trigger. You can visit Dashboard menu on Kapitalwise application to see your web analytics.

Create a Trigger

Follow these steps to create a trigger:
  1. Click Create Trigger under Tags menu.
  2. Enter name and description for the trigger.
  3. Select a trigger type you would like to create from the dropdown.
  4. If you selected the Web Analytics trigger type, Click Save Trigger Button. A script would appear on the page. You can add this script to your web page directly.
  5. If you selected some other trigger type, choose the filters you want to associate with your selected trigger type. Click Add New to add more filters.
  6. Once you are done, click Save Trigger.
Now, you can use the created trigger to create a web page event.

View/Edit a Trigger

To view/edit an existing trigger:
  1. Click All Trigger under the Tags menu.
  2. Click the edit icon for the trigger you want to edit.
  3. Edit the field as needed. Click Save Trigger once done.