Overview
Live Monitor is a feature in Localytics that allows you to view every action a tracked device takes in your app. It's a great tool for QA and bug checks for engineers, as well a simple way to find the tagged names of certain actions with your app.
For example, if you'd like to build an audience of end users who visited a certain type of clothing—but you didn't know what the event was called within your app—you could use Live Monitor to view the item from your own device, and then check the logs to see the exact event tag within Localytics.
To use Live Monitor, select it from under the System heading within your dashboard menu.
Our first step will be the set up a new device.
Set Up a New Device
To pair a new device, make sure you've selected Live Monitor from the System menu. Click the Add New Device button on the Live Monitor landing page.
You'll have two options to pair your device:
Let's dive into each.
Scan a QR Code
Similarly to how we allow you to test your messages, you can scan a QR code provided by Localytics to link your device to Live Monitor.
To link your device, choose the Scan a QR Code option when prompted. Use the device you'd like to link to scan the QR code provided. Follow the steps provided, and you should be good to go!
Here's a quick video of the process.
After you've paired the device, you'll see it listed on the Live Monitor landing page. Select the Accept Pairing to accept the session and begin reviewing the details.
Perform a Gesture
Alternatively, you can perform a gesture to sync your device with Live Monitor. To choose this option, select Perform a Gesture when prompted to add your device.
Follow the steps provided. In this case, you'll want to forward and background your app 5 times in a row to alert Localytics to your device. Once finished, your device will be synced, and you'll be able to review your device's logs.
As with scanning a QR code, make sure you Accept Pairing on the Live Monitor landing page to view the logs.
Reviewing Your Device's Logs
After pairing your device, Localytics will begin pulling in data about your session. As you navigate your synced app, you'll see a live log (hence Live Monitor) of events update with each event fired.
There a few different types of events that are tracked in Live Monitor—like messages viewed, Place recorded, Session open/close, and tagged events. The events listed in your Live Monitor instance are linked to the tracked events within your app, so your listed events will be exclusive to your app. Here's an example of what we track in our Temps app.
Click into any of the tracked events for a deeper explanation of what happens on the backend. You have the option of scrolling through your events or using the search bar at the top of the page to find a specific event. Let's look at one.
In the above example, you can see that we recorded that this user qualified for 13 Places campaigns, all of which are ready to trigger whenever the end user enters the qualifying geofence. We list the campaign IDs as well as the type of message campaign.
Clicking into any of the events reveals specific information about the event—which we split into a Summary view, a Code view, and the State view. The Summary is a high-level overview of the code that is being fired for the event.
The Code view is pretty much what it sounds like—the code of the event within your app.
The State view shows you the state of the app when the event was fired. Keep in mind, the State view is event-agnostic—so it won't change depending on the type of event fired.
When you've finished tracking your session, hit the End Pairing Session button at the top of the page to cease event tracking.
To learn more about building Audiences or end-user experiences based around event criteria check out our Audiences article or our Workflows documentation.