Skip to content
Snowplow event tracker for Android. Add analytics to your Android apps and games
Java Shell
Branch: master
Clone or download
Pull request Compare This branch is 7 commits ahead, 67 commits behind snowplow:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.travis
ci
gradle/wrapper
snowplow-demo-app
snowplow-tracker
testing
vagrant
.gitignore
.travis.yml
CHANGELOG
LICENSE
README.md
VERSION
Vagrantfile
build.gradle
gradle.properties
gradlew
gradlew.bat
settings.gradle

README.md

Android Analytics for Snowplow

Build Status Coverage Status Release License

Overview

Add analytics to your Java software with the Snowplow snowplow event tracker for Android snowplow. See also: [Snowplow Java Tracker] snowplow-java-tracker.

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

Quickstart

Building

Assuming git, [Vagrant] vagrant-install and [VirtualBox] virtualbox-install 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] techdocs-image ![i2] setup-image ![i3] roadmap-image ![i4] contributing-image
[Technical Docs] techdocs [Setup Guide] setup Roadmap roadmap Contributing contributing

Copyright and license

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

Licensed under the [Apache License, Version 2.0] license (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.

You can’t perform that action at this time.