Android Analytics for Snowplow

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

Technical Docs	Setup Guide	Roadmap	Contributing

Copyright and license

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.

Stonepaw / snowplow-android-tracker