Analytics - Using Localytics

Localytics is a Mag+'s preferred analytics vendor. In addition to being focused squarely on apps, it has the most robust implementation with Mag+, the most intuitive dashboards and, in addition to analytics, it offers a suite of marketing services including segmented in-app and push messaging and install tracking.

Best of all, Localytics is free up to 10,000 users; you can see the rest of the pricing here.

Note: As of Mag+ v4.1, Localytics will not report events captured while the app is in the background. This will specifically affect the Issue Delivered event, as that will no longer include Newsstand-delivered downloads. Please use the download stats in the Mag+ Publish portal instead.

How to Set-Up Localytics

1. Go to <> and sign up for one of its plans.

Once you've completed sign up, you will set up your app by entering its name and category. Afterwards, Localytics will supply you a key, which you can find by clicking the Settings icon Tab, the Applications.

2. In Localytics, find and copy your app Key by going to Settings > Apps.

3. In the Mag+ Publish portal, go to Apps > Analytics Configuration.

Note: Analytics Configuration is available under the iOS and Android tabs.

4. Choose Localytics from the drop-down menu (Label 1) and paste your app key into the Analytics Key field (Label 2).

Note: Localytics supports Offline Reporting by default, therefore the checkbox has no effect.

5. Click "Save" to save your options.

6. (iOS Only) Go to Build Options > Third Party Integrations and click the box next to "Localytics".

7. (iOS Only) Click on "Save" to save your settings.

Note: You must rebuild your app and submit it to your app marketplace in order to begin receiving data.

8. Analyze your data by logging into Localytics and choosing the app you want to see from the menu in the upper right corner (Lable 1).

Data Available in Localytics

For a full walkthrough of Localytics capabilities, it's best to reach out to your Localytics representative. Mag+ can speak to our integration specifically and how our customers use it. The Localytics dashboard is broken into three sections:

  • Analytics: View information about users and how they are using the app and content.
  • User Insights: Create segments of users and event funnels, track retention and lifetime value.
  • Marketing: Send targeted messages to segments of users, track installs from ad campaigns and remarket.


In the Analytics section, you can see information on Usage, Engagement and specific Events. For each metric, you define a time window and can split by one of the following criteria:

User Information

  • New vs Returning
  • Country
  • Language


  • Device
  • Platform
  • App Version
  • Carrier/Network
  • OS Version
  • Jailbroken
  • Push Enabled

Customer Acquisition

  • Acquisition Source
  • Acquisition Campaign


  • Monthly Cohort
  • Weekly Cohort

Custom Dimensions

  • Subscriber
  • Issue


In Usage, you'll see stats about the number and qualities of the users using your app. Some stats to notice here:

  • (Label 1) The first drop-down menu at the top left lets you segment data by unique users, or unique sessions (ie, one user opening the app three times in the selected date range is three sessions)
  • (Label 2) The second drop-down menu lets you sort that data by any of the metrics listed above.
  • (Label 3) The Split drop-down menu lets you further choose another metric to split the data by. 
  • (Label 4) In the upper right corner, you can filter the data by the same metrics and can choose your time period.


In Engagement, you can learn what users are doing in your app:

  • Session Length shows both the median and the average - it's important to note the difference between these. Median will usually be lower because it's pulled down by all the very short sessions. Average is a clearer indication of how long people are spending in the app in a session (defined by the time the app is open and the device is awake - when someone backgrounds the app, the session ends).
  • Session Interval shows how much time elapses between sessions. You could see, for example, if a majority of repeat sessions happen within the same hour.
  • Loyalty shows how many times users repeatedly open the app. Here you can see, for example, that more than 10,000 of your total sessions are the 51st to 100th session for those users.


Events are where you can dig a little deeper into how people are using your content in the app. These events have all been added by Mag+ into the standard code base. There is no way for you to add additional events into the white-label app. If there are events that are not here that you would like tracked, reach out to support and we will investigate whether it's something we can add. If you don't see an event in your dashboard that is listed below, it is likely because there is no data for that event yet.

In Event Overview, you'll see all of the events. To learn more about any given event, click on it. When you get into the Event Detail page, look at the Attributes drop-down menu: here you can see the specific attributes capture for each event. Note that you can still filter and split all this data by the same criteria as above, so you can, for instance, see the article views for a particular issue, or how subscribers click a link versus non-subscribers. 

Note: Most of these events will have a huge pool of data that will not be visible in the simple graph here. To see all data, click on the Save icon in the upper right corner [Label 1] and choose Export as CSV. This will export all the data for the particular query you're viewing into a spreadsheet, where you can further analyze it.
  • Article Viewed: Shows you how many people read a particular article. Article in this case is defined as a vertical, a single InDesign document in your issue. The article name is the Vertical ID, as set in your InDesign plug-in at time of issue creation. Be sure to assign IDs that are easily sortable  
  • Article attribute shows the specific article—this is how you find out that 42,046 people viewed a particular vertical. What's shown is the vertical ID as set by you in the plug-in.
  • Duration shows in buckets how long articles were read for. So, for example, 44 percent of your articles are looked at for between 10-60 seconds. Note that 0-10 seconds will usually be the biggest because it includes people swiping by an article. Actual Duration shows the specific duration, un-bucketed; Rounded Duration shows the same but rounded to the nearest  
  • Issue shows which issue the article viewed events took place in
  • Percent Read shows the how much of a given vertical people look at. Note that this goes by vertical scrolling, so if your article has no vertical scrolling, it will read 100 percent—that is, people looked at all of what could be looked at.  
  • Slide shows the number of B-layer slides (full screens of content) the user viewed.
  • Gesture: Shows how often people are performing specific gestures in your app. Here are the specific gestures captured:
    • Interactive Content Tap Gesture: shows how often people tap the screen to activate a particular action, such as playing a movie, activating a link or revealing a pop-up
    • Non Content Tap Gesture: Tapping the screen for navigation—to call up the navigation or to choose a page in the scrubber, for instance
    • Toggle Tower Double Tap Gesture: Turning the A layer on and off by double-tapping the screen (you can disable this feature in the plug-in)
    • Long Press Gesture: Calling up the navigation via long press rather than single tap
    • Horizontal Nav Tap Gesture: if you tap the right or left sides of the screen to advance or go back a page
    • Vertical Nav Tap Gesture: if you tap the bottom or top of the screen to advance or go back a page vertically
    • Bookmark Tap Gesture: Tapping the upper right corner to bookmark a page 
  • App Exit: Tracks the closing of the app
  • Issue Opened: Registers just that, and the only attribute is the name of the issue
  • Link Area: Shows stats about people clicking hotspots in your issue. These can be links, jump links, movies, audio or popups—any tap on a clickable area will register here.
  • Link Target shows you the name of the link clicked. To get value out of this for popups, you must give the popup block a descriptive name, such as "12_Sunglasses." Same goes for media files.
  • Article and Issue attributes show where the link occurred. But to see all the links clicked in a particular issue, use a filter or Split instead.
  • Video Played: Will track embedded video (and audio) events. With the attributes you can see specific videos, as well as duration watched across all video plays (i.e. 48 percent watch between 20-40% of the video)
  • Localytics In-App Displayed: Captures the event of an in-app message sent through Localytics Marketing being displayed.
  • Localytics Push Opened: Tracks users clicking on a push message you have sent through Localytics Marketing.
  • Purchased Issue: Tracks users buying issues through in-app purchase in the in-app store. Attributes include Currency, Issue and Price.
  • Article Saved: Tracks the number of times an article was bookmarked using the built-in bookmarking function. Attributes are Issue and Article.
  • Purchased Subscription: Tracks users buying subscriptions through in-app purchase in the in-app store. Attributes are Subscription, Price and Currency.
  • Issue Delivery Failed: Sometimes an issue fails to finish downloading on a device for a number of reasons; this tracks downloads initiated but not finished.
  • Article Shared: Tracks the usage of the built-in Share function, if you have that turned on. You can see which articles were shared most, which issues had the most share events, and how people are sharing (ie, Twitter or email)


This shows you how a user moves through the app by capturing what screens they viewed. Screens are the spaces the user can go to in the app by tapping buttons in the bottom navigation, and include Issues, Live, My Account. Note that if you change the name of these screens, you will see the names you assign to them. The MIBIssueViewController is the reader—that means being inside an issue. 


Location gives you a breakdown of users and sessions by country and by major city.


User Insights is where you can define users by profile or segment and view information about them


Profiles are a way to segment your audience based on particular criteria. Localytics automatically builds a profile for each user and collects certain attributes for that user so that you can then market to that cohort. Right now, Mag+ supports Auto-Profiles, which means the attributes collected are those set automatically by Localytics. Custom Profiles allow you to set your own attributes and will be supported in a future release. You can read more about Profiles here. Current attributes are:

  • Last Country
  • Last Session Date
  • User Type
  • Last Time Zone
  • Last City
  • Last OS Version
  • First Session Date
  • Total Number of Sessions
  • Last Session Date
  • Last App Version
  • Push Enabled
  • Last Subscriber
  • Last Issue
  • Seconds Since Last Session
  • Last In-App Displayed
  • Last Push Opened


Segments are where you can define groups of users based on events from your analytics and profile data. For example, you can select all the people who have opened a particular issue in the last seven days and send a message only to that group. Or all people who have downloaded your app but never opened an issue or purchased anything.


Funnels allow you to create stepped paths—i.e. my account > issues > issue open—to see what percentage of users make it through that chain. It is a useful way to see the ROI on your messaging campaigns, for instance, to track how many people view a message and then go purchase a subscription or download content. Or how many people who viewed an ad then clicked the link in that ad.


Retention shows you how many users return to your app (or perform a different action) X number of days after completing a particular action. It allows you to see how retention is related to particular actions.

LTV (Lifetime Value)

LTV is not supported by the current integration. If you have in-app purchases in your app, you can track those in iTunes Connect or Google Play.


The Marketing section contains a suite of tools that help you drive deeper user engagement and better drive downloads and conversions to paid users.


Messaging is where you can create custom messages to send to targeted groups of users via push message, in-app message or, soon, email. You will first choose the audience segment you want to receive the message [see below]. After you choose your audience segment, you can create the message. In-app messages can be straight text or designed, or you can upload your own HTML. You can also then schedule messages to go out on a regular basis.


Here you'll define the audience segments that you can use for messaging or other areas like funnels. You can build an audience on any of the analytics Localytics captures and you can combine multiple criteria and time periods to very specifically define segments. Here are some examples of groups you could make:

  • Everyone who's downloaded the app but never opened an issue
  • Everyone who's received a particular push message in the past.
  • Everyone who's opened a particular issue, page or link.
  • Everyone who's been active or not active in the past 30 days.


This is where you can track the success of ad campaigns that drive installs of your app. Localytics supports all major ad networks, including Facebook. You can see the number of app installs and subsequent behavior of those users by source of acquisition. By using Localytics to track this information, you don't need any additional SDKs to be installed in the app.

Have more questions? Submit a request


Article is closed for comments.
Powered by Zendesk