Events

Events are applicable for In-Product surveys & Prototype Test.

In Qwary, Events are crucial in triggering in-product projects, prompting their display to the user. All Web and Mobile in-product surveys require an event to serve as the trigger. Additionally, Events can be utilized as audience filters, enabling you further to refine the respondents' eligibility for the project.

An Event represents an action or occurrence within your website or application that allows you to track user behavior. There are several examples of Events, including:

1. Visiting a page

2. Spending a specified time on a page

3. Reaching a certain number of page visits

4. Scrolling the page

5. Preparing to exit the page

By leveraging Events, you gain valuable insights into user actions, enabling you to enhance user engagement and tailor your projects accordingly.

Adding Events

• Log into Qwary account and go to menu --> events.

• Click "Create Event"

There are two types of events supported in Qwary

1. Auto-trigger event

2. Manual trigger event

Auto-trigger Events

Auto-trigger events offer a convenient way to configure Qwary for triggering web studies without modifying the server's source code.

Auto-trigger events provide five distinct selection methods to determine when an event occurs:

1. Visiting a page: This method triggers an event when the browser views a specific page. You can specify the page by entering its URL.

2. Spending a specified time on a page: With this method, an event is triggered when the user pays a defined amount of time on a particular page or across all pages. You can set the time duration as a condition.

3. Reaching a certain number of page visits: This method triggers an event when the user visits a specific number of pages, as defined in the condition.

4. Scrolling the page: An event is fired when the user scrolls a defined percentage on the page.

5. Preparing to exit the page: This method triggers an event when the user is on the verge of leaving the page.

Above selected method works as an 'AND' condition when more than one method is selected for the events.

Let's say you have defined the '/pricing' URL of a visit page and have 60 seconds time defined in 'After user spends specified time on page'; then the event will get triggered when your user spends 60 seconds on the pricing page.

These selection methods provide flexibility and customization options for triggering events based on specific user actions or conditions.

Create an Auto-trigger Event

1. From events page, click 'Create Event' & select 'Auto-trigger Event'.

2. Enter the event name and event description (optional).

3. Define where you would like to trigger this event. If you select 'All pages,' the event will be triggered for all the pages. You can also select and enter a value for the other methods.

   • Visiting a page: This method triggers an event when the browser views a specific page. You can specify the page by entering its URL.

   • Spending a specified time on a page: With this method, an event is triggered when the user pays a defined amount of time on a particular page or across all pages. You can set the time duration as a condition.

   • Reaching a certain number of page visits: This method triggers an event when the user visits a specific number of pages, as defined in the condition.

   • Scrolling the page: An event is fired when the user scrolls a defined percentage on the page.

   • Preparing to exit the page: This method triggers an event when the user is on the verge of leaving the page.

4. Click 'Save'

How to test the event

1. Perform the user behavior as required to trigger the event.

2. Click on the "Reload Browser" button to refresh the contents of the Events page.

3. On the Events page, look "Daily Usage" column for the event. You should observe that an event has been received and displayed.

Manual-Trigger Events

Manual-trigger events are specifically designed for Web and Mobile applications. There are two methods available to add events to Qwary:

1. Create the Code Event in Qwary: With this approach, you can directly create the event within the Qwary platform by defining the event details.

2. Send an event from the SDK: Alternatively, you can instruct your developer to send the event from the software development kit (SDK). By integrating the Qwary SDK into your application, your developer can send custom events programmatically, providing more flexibility in capturing specific user actions or behaviors.

Create manual-trigger event

• From events page, click 'Create Event' & select 'Manual-trigger Event'.

• Enter the event name and event description (optional).

• Click 'Save'

// Sample code for manual trigger event
<script>
qwTracking.track('<ENTER_NAME_OF_EVENT>');
</script>