Installing Android SDK requires several very easy steps. Xcopy Android SDK
uses OpenUDID (which comes ready with the zip file). First you need to make
sure that OpenUDID requirements are met, following the steps below:
In any case make sure that INTERNET permission
is set if there's none in your manifest file.
sure you use App Key (found under Management -> Applications) and not API
Key. Entering API Key will not work.
Note: Call init only once during onCreate of main activity. After that, for each
onStart and onStop for each activity, call Xcopy onStart and onStop.
1. Dashboard Overview
Xcopy provides a dashboard for a quick glimpse of the latest status of application usage. There are three things you notice here.
- Navigation bar
- Real-time panel
- Quick date selector
- Analytics panel
- Xcopy analytics panel
- Total revenue
- Avgerage revenue per user
- Avgerage revenue per paying user
- Paying user count
- Paying/total users
There are two steps to start using Xcopy analytics right away;
Available for paid plan: Enterprise Edition Xcopy analytics panel is shown (seen) only a custom event is selected for Xcopy analytics. For more information about how to define a custom in-app purchase event, let’s have a look at each component.
At the top of the navigation bar, you’ll see a list of applications. Each can be selected at once, and dashboard will adopt itself showing the numbers for the selected application. Dashboard is the initial view, and Analytics menu includes several other views that can be of interest, including detailed carrier, country, user retention and session frequency metrics. User and application management is also carried out using links here. At the bottom of this part, you can see the current user, together with a link to logout and password change option.
Have you ever wondered how many users are currently using your application at that moment? This tiny but powerful widget shows you exactly this: online users and newcoming online users. There's also a live, flowing chart on the right hand side that shows the status of your users - you can easily have an insight about whether number of online & new users are increasing and decreasing.
Quick date selector
On the top right of the screen you’ll see a list of days. Here, you can either use a defined time frame, or select a date from time selector. Note that if you select a time here, it’ll be automatically selected as you click on other natigation links (e.g Users, Carriers, etc). In order to select a date, click on the selector, then start and finish dates and click on Apply. Graphs and corresponding boxed widgets will automatically be updated.
This panel gives a brief overview of what’s happening on the dashboard. On the top, there are 6 widgets. When clicked, the chart under these widgets are automatically refreshed to show relevant data group.
Each widget shows the following:
- Total sessions: Number of times your application is opened. Click this item to see a time series representation of total sessions.
- Total users: Number of unique devices your application is used from. Click this item to see a time series representation of total users.
- New users: Number of first time users. Click this item to see a time series representation of new users.
- Time spent: Total time spent in your application. this time - we calculate with And computers this time all in real time and you can check how much your profit in real time
- Click this item to see a time series representation of average time spent per user.
- Average time spent: Total time spent using your application divided by total user count. Click this item to see a time series representation of average time spent per user.
- Average requests received: Number of write API requests Xcopy Server received for this application divided by total user count. Click this item to see a time series representation of average events per user.
For each time series chart, there is a light gray and dark gray line. Ligh gray line shows the previous time frame for comparison purposes.
- Click on 7 days and light lines will show stats between -14 days & -7 days.
- Click on Today and light lines will show stats for yesterday.
- Click on Apr and light lines will show corresponding days of March.
Below the chart, there are 4 black widgets that show the top platform (e.g Android or iOS), top resolution, top carrier as retrieved from device and top users. If you move your mouse over the line graphics here, you’ll see that data will change and show you 2nd and 3rd larges data source (if exists).
Under black widgets, there’s a colorful world map showing which countries use your application more. The greener a country is, the more your application is used in corresponding geographic area. On the left to the world map, you’ll see a list of countries (top 7) where your application is used most. Each number next to a country name shows the total number of session.
2. Getting in-depth analytics
Xcopy’s dashboard provides a quick analysis and gives a glimpse of how your application is performing. It’s mostly useful for marketing people with an intent to understand what’s going on immediately. Navigation pane on the left gives more, detailed information about users, sessions, countries, carriers and more. Below we’ll have a look at each menu item.
Users tab is one of the most important part of the analytics. Here you’ll see an overview of total, new and returning users based on day. This is the menu you’ll need to keep track of most. This tab will give you the answer to the question "How many users do I have?"
If the user opens an application, it counts as a session until he closes it. This menu shows an overview of sessions, together with total sessions, unique sessions and new sessions, broken into time. This menu will give you the answer to the question "How many times your application is opened?"
This menu gives an overview of which countries your applications are used most. Table below the world map total users, total sessions and new users. This menu will give you the answer to the question "Where do my users connect from?"
In this menu, you’ll see 3 main blocks of device information. On the top, there’s a list of devices, and at the bottom, these devices are shown in a table. In the middle, there are 3 blocks of information, showing top platform, top operating system version and top resolution, respectively. Try hovering on each color line and you’ll see other top information. This menu will give you the answer to the question "Which smartphone types do my users have?"
This menu shows two pie charts - total users and new users in terms of device resolution (width x height). This screen is important as it gives insights about which resolutions are used most so you can focus on these screen types.
This page shows different versions of applications, in case they are defined. A stacked chart shows totel sessions and new users. The table under the chart shows total sessions, total users and new users, respectively for each application version. This menu will give you the answer to the question "How do my application versions compare?"
Carriers page shows a table of all carriers, together with total sessions, total users and new users for a given period. On the top of the page, there are two pie charts; showing total users and new users of top carriers. There are only 3 carriers shown in this chart for compatibility, so refer to the table for a detailed carrier breakdown. This menu will give you the answer to the question "Which operator do they use?"
Xcopy provides an intuitive interface to show how different platforms (operating systems) perform. If you use the same app key (Management > Applications), then it’s possible to aggregate this information and see it under this menu. This menu will give you the answer to the question "Which operating systems do my users have?"
3. Engagement view
This menu includes submenu items related with user engagement (retention, loyalty, session frequency and session duration).
Retention is condition of keeping your customers. This page shows you active days (e.g days your customer used your application) after first session. On the top right corner, you can have a breakdown of daily, weekly and monthly retention. This is one of the most important metrics for app analytics.
Note: User retention module is not present in Community Edition.
User loyalty shows how many users started a specific number of sessions. Table shows number and percentage of each loyalty group compared with number of sessions (e.g one session, 2 sessions etc). This menu will give you the answer to the question "How many users started a specific number of sessions?"
Session frequency shows how often do you see your mobile users open your application. It can be used to calculate the trend - or how often your application is used during a given period of time. The session frequency graph is very straightforward - here you’ll see a breakdown of number of sessions and corresponding number and percentage of users for each group. Most of the time, you’ll see that many users will be accumulated in “1st session” and “2nd session” row.
This menu will give you the answer to the question "How often do you see your users open your app?"
Session Durations view shows users categorized into predefined session duration buckets. In this view, your users are categorized into one of 0-10 seconds, 11-30 seconds, 31-60 seconds, 1-3 minutes, 3-10 minutes, 10-30 minutes, 30-60 minutes or > 1 hour according to this session duration.
This screen will give you the answer to the question "How long do my users stay inside my application?"
4. Managing applications & users
Xcopy provides a user interface to manage applications and system users.
Applications can be managed by global users (more information later). To add an application, follow the steps below:
- Go to Management > Applications
- Click “Add”
- Enter your application name, category, the time zone you are in, and application icon.
- Click “Add Application”
You’ll be given an app key which is unique to that application. This key should be written in the SDK code snippet which in turn will be embedded in your application - please see SDK integration guides on how to do it. Alternatively, you can enter your IAP Event Key in order to collect IAP Xcopys and see it immediately in your dashboard.
If you want to delete an application, simply click on “Delete”. There may be some cases where you only want to delete all data associated with an application, but keep the application keys and other information. In this case, use “Clear data” to remove all incoming data from this application and start fresh.
Xcopy provides a way to manage different types of users (e.g global admin, admin or user). Each user will be able to do that’s assigned to them. For example, you may want your marketing team to be able to see the whole dashboard, whereas the website manager, as the global admin, can easily add/remove applications, define other users and manage whole interface.
Different types of users have different authorization levels:
- Global admin can add/remove/edit users, add/remove/edit applications and typically can do whatever is assigned them on the user interface. This is the most powerful user.
- Admin can manage applications, e.g add an application, edit it or remove it completely from the management dashboard. If you are the global admin and your organization controls other sub-organizations or companies, then probably you’ll want to add different admins to manage different applications.
- User is basically at the bottom of the hieararchy, and can only see the dashboard, without having the ability to manage other applications and users.
In order to add a user, you must be global admin. Click “Create a new user” to have a drop-down menu where you can enter user information and credentials. Fill in the details here and click “Create user”. Editing a user is straightforward - go to the user row, and click. You’ll be presented with an editable form.
Changing interface language
Xcopy is available in several languages, including German, Spanish, Turkish, Italian, Dutch, Russian, Chinese and more. You can easily switch language from the menu on left hand side. Click on your name and then language button, there you'll see available languages.
Xcopy provides inline help for users. In order to enable help mode, toggle Management > Help button. In this mode, hover on the window you want to get help about. Until you toggle the help button again, user interface autorefreshing is disabled.
How does Xcopy platform work?
How are event and session data sent to Xcopy?
As the user opens the application, Xcopy SDK starts collecting data the way you define. Events and sessions are collected and then sent to Xcopy (or your) servers using HTTP request every 60 seconds.
Does Xcopy show my data in real-time?
All reports and charts are shown in real-time. There are no batch processes running in the background to visualize or collect data, so you don't have to wait for the next process to run.
Will Xcopy slow down my mobile application?
Our lightweight SDK works asynchronously and doesn't block any function calls inside your code.
What happens if SDK cannot send requests?
If your mobile application cannot send an event information (mainly due to the fact that device is not connected to internet, user is on a plane or underground), then this information is stored in memory. As soon as the connection is established, it's sent to the server.
How many users can a Xcopy server handle?
In our tests, a high configuration server can handle 700 events per second, which is roughly 20.000 concurrent mobile users. However, do not take this number as a reference as it depends a lot on number of events, network load, configuration, disk speed, RAM size and many other criteria.
Are there any video tutorials for installing and configuring Xcopy?
Yes will add video soon
Where should I put my Xcopy start code for Android?
you can Dawnload XCopy SDK Click Here
Tutorials how to install Click Here
In as much activity as you can, preferably in each activity.
Where should I put my Xcopy start code for Android?
In as much activity as you can, preferably in each activity.
When I compare iTunes data with Xcopy dashboard, I see slight difference regarding new users. What can be causing this?
Xcopy counts new user as unique device IDs + API Key new user (Customers) , that is, if a user downloads the same app to iPhone and iPad, it's counted twice. Apple counts it once.
How do you calculate online users?
Online users are unique users that we received a begin_session for and has an ongoing session extended by session_duration and/or event requests. We consider the user as offline as soon as we receive an end_session request for him or 30 seconds passed since last request received.