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.

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

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

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.

Technical Docs	Setup Guide	Roadmap	Contributing
Technical Docs	Setup Guide	Roadmap	Contributing

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.