A monodroid binding for the Google Analytics API.
Follow these steps to use the Google Analytics SDK in your Mono for Android app.
- Add a reference to the GoogleAnalytics.Monodroid Assembly
- Add the libGoogleAnalyticsV2.jar file (found in the Jars directory) to your app project and set its build action to "AndroidJavaLibrary"
- Update your manifest with the INTERNET and ACCESS_NETWORK_STATE permissions
After performing the previous two steps you need to add a new resource file to the app with the following contents:
<resources xmlns:tools="https://schemas.android.com/tools" tools:ignore="TypographyDashes">
<bool name="ga_reportUncaughtExceptions>true</bool>
<string name="ga_trackingId">UA-XXXX-Y</string>
<string name="ga_autoActivityTracking">true</string>
</resources>
The ga_trackingId can be obtained by registering a new tracking profile at: http://support.google.com/analytics/bin/answer.py?hl=en&answer=2614741
Name the resource file analytics.xml and make sure that the build action for the file is set to AndroidResource!
To use the tracking logic, you need to add two pieces of code in your activity
using Com.Google.Analytics.Tracking.Android;
public class MyActivity: Activity
{
protected override void OnStart()
{
base.OnStart();
EasyTracker.Instance.ActivityStart(this);
}
protected override void OnStop()
{
base.OnStop();
EasyTracker.Instance.ActivityStop(this);
}
}
For convenience there's a base type TrackableActivity included in the assembly. The use of this base type is not required.
All analytics calls from within an activity are tracked. If you have to make calls from other components, you may have to use EasyTracker.Instance.Context = <myActivityInstance>
If you're using the Google analytics SDK in your app and want to debug the logic to track activity in your app, you may have to modify the ga_dispatchPeriod parameter in the analytics.xml. By default the dispatch period is 30 minutes, this is however much longer than you want during debugging. So instead you can specify
<!-- Dispatch period is specified in seconds -->
<integer name="ga_dispatchPeriod">20</integer>
Make sure you remove the setting when you run in production mode. A shorter dispatch period costs extra battery and processor cycles, thus reducing the performance of the app.
This readme file covers the basics. There's a lot more you can do. Check out the following sources for more information: