Snowplow event tracker for Android. Add analytics to your Android apps and games
Branch: master
Clone or download
Latest commit d3136e1 Aug 3, 2018

README.md

Android Analytics for Snowplow

Build Status Coverage Status Release License

Overview

Add analytics to your Java software with the Snowplow event tracker for Android. See also: Snowplow Java Tracker.

With this tracker you can collect event data from your Android-based applications, games or frameworks.

Quickstart

Building

Assuming git, Vagrant and VirtualBox installed:

 host$ git clone https://github.com/snowplow/snowplow-android-tracker.git
 host$ cd snowplow-android-tracker
 host$ vagrant up && vagrant ssh
guest$ cd /vagrant
guest$ ./gradlew clean build

Testing

Continuing from the instructions above:

guest$ echo no | android create avd --force -n test -t android-19 --abi default/armeabi-v7a
guest$ emulator -avd test -no-skin -no-audio -no-window &
guest$ ./ci/wait_for_emulator ## Note: This line can take quite a few minutes to execute
guest$ adb shell input keyevent 82 &
guest$ ./gradlew connectedCheck

Setting up a testing endpoint

You can now also setup a testing endpoint to send events to a local server using the combination of Ngrok and Mountebank.

guest$ cd /vagrant
guest$ chmod +x ./testing/setup.bash
guest$ ./testing/setup.bash ## Will launch Mountebank and Ngrok in the background

Then go to any browser in your host machine and type:

  • http://localhost:4040/ - Ngrok Web Interface
  • http://localhost:2525/ - Mountebank Web Interface

In the Ngrok interface take note of the tunnel URL, this is what you will use to send events.

Find out more

Technical Docs Setup Guide Roadmap Contributing
i1 i2 i3 i4
Technical Docs Setup Guide Roadmap Contributing

Copyright and license

The Snowplow Android Tracker is copyright 2015-2018 Snowplow Analytics Ltd.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this software except in compliance with the License.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.