Swrve tracks user behavior by means of events. Each time one of your app users performs an action you’re interested in, you send Swrve an event to track it. You can use app-generated events to trigger campaigns, while app- and server-generated events help you define segments and power analytics. Swrve analyzes these events and produces reports that tell you exactly how your users are interacting with your app. You are limited to 1000 events per app, therefore it is important to properly manage the events that your app sends to Swrve.
The Event Management screen enables you to view, register and manage events. To access this screen, on the Manage menu, click Events.
The Event Management screen groups events by state—Registered, Unregistered and Archived. On the Registered events tab, the Count column shows how many times the event has been received since it was registered. On the Unregistered events tab, the Estimated Recent Count column shows an estimate of how many times the event was received within the last 24 hours. The Description field enables you to include a brief description of the event. To edit this field, click the text in the Description field and edit the content as needed.
Swrve only processes registered events. To make events available in the dashboard for reporting, segmentation and campaign targeting purposes, they must be registered.
By default, Swrve automatically registers unregistered events, up to the 1000 event limit. Events on the Unregistered tab are automatically registered on an hourly basis, until the event limit is reached. A message is displayed on the Registered tab informing you of the current number of unregistered events that will be automatically registered. Auto-registration is an optional feature, so if you would like it disabled for your app, please contact your Customer Success Manager at firstname.lastname@example.org.
Additionally, there are three ways to manually register events:
- Add individual events.
- Import a CSV file of events.
- Add events from the Unregistered or Archived tab.
Add Individual Events
To add an individual event:
Step 1: On the Registered tab, click Events and select Add.
Step 2: In the Register New Event dialog, enter the Event Name and add a Description (optional).
Step 3: To save the event, click Add.
tutorial start) are not valid. For more information on event requirements, see the relevant Integration guide.
To import a CSV file of events:
Step 1: Click Documents () and select Import CSV.
Step 2: In the Import CSV dialog, select an option to either have the CSV file replace only the duplicate events in the file or to overwrite all existing events with the events contained in the file. (Note: The second option archives any currently registered events in the database that are not in the CSV file.)
Step 3: Click Choose File, navigate to and select the CSV file on your computer, and then click Open.
Step 4: To import the selected file, click Import.
Add Unregistered or Archived Events
To add unregistered or archived events:
Step 1: On the Unregistered or Archived tab, select the event(s) you want to register.
Step 2: Click Events and select Register Selected.
Step 3: The Register Events dialog is displayed and prompts you to confirm the number of events you want to register. Click Confirm to proceed.
Registered Event Limits
After your app reaches the event limit, the “This app currently exceeds Swrve’s 1000 event limit.” message is displayed. You cannot add any more events until you archive others.
If you try to upload a CSV file that will cause your events to exceed the 1000 limit, the “Cannot import events: this import would increase your event count past the event limit of 1000.” message is displayed. For auto-registration, Swrve randomly adds unregistered events up to the point where the limit is reached.
Unregistered events are events sent from your app to Swrve that are not Registered or marked as Archived. In most cases, events on the Unregistered tab are automatically registered on an hourly basis, until the event limit is reached. If auto-registration is not enabled on your app, you must manually select the events you want to register or archive.
Archived events are events that have been specifically marked as archived and are not processed by Swrve. If you archive an event that was previously registered, it is removed from the Registered list and the event is no longer processed by Swrve or displayed in the dashboard.
To archive events:
Step 1: On the Registered or Unregistered tab, select the event(s) that you want to archive.
Step 2: Click Events and then select Archive Selected.
Step 3: The Archive Events dialog is displayed and prompts you to confirm the number of events you want to archive. Click Confirm to proceed.
The Events Management screen enables you to export a CSV file of event names and descriptions, by event type.
To export a list of events:
Step 1: Click the tab for the type of events you want to export.
Step 2: To export only a selected group of events, select the check boxes of the desired events. Otherwise, leave the check boxes clear to export all.
Step 3: Click Documents () and select Export Selected or Export All.
Step 4: The Export CSV dialog is displayed and prompts you to confirm that you want to download the selected or all events. Click Download to proceed.