Skip to content
Woopra SDK for Android
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Woopra Android SDK

Instantiate Tracker Object

To setup your tracker SDK, configure the tracker instance as follows (replace with your website):

WoopraTracker tracker = Woopra.getInstance(this /* context (e.g. activity) */).getTracker("");

To add custom visitor properties, you should edit the visitor object:

tracker.setVisitorProperty("name", "User Name");
tracker.setVisitorProperty("email", "");


Map<String,String> visitorProps = new HashMap<String,String>();
visitorProps.put("name", "User Name");
visitorProps.put("email", "");

Event Tracking

To track an event, you must setup a WoopraEvent object and track it:

// setup event
WoopraEvent event = new WoopraEvent("appview");
event.setProperty("view", "home screen");
event.setProperty("title", "Home Screen");

// track event


You can send an identify call without tracking an event by using the tracker.push() method:

tracker.setVisitorProperty("name", "User Name");
tracker.setVisitorProperty("email", "");
//Visitor data has not been sent to Woopra
//visitor data has been sent to Woopra, but no event has been tracked

Advanced Settings

To add referrer information, timestamp, and other track request properties, look at the WoopraTracker and WoopraEvent class public methods for an exhaustive list of setter methods. Here are some common examples:

Tracker Settings

If you want to keep the user online on Woopra even if they don't commit any event between the last event and the idleTimeout, you can enable auto pings:

tracker.setPingEnabled(true); // default is false

Track Referrer:

tracker.setReferer(<REFERRER_STRING>); //for legacy of this SDK as well as the HTTP, you can use both referer or referrer methods but it will be stored as referer

You can update your idle timeout (default: 30 seconds) by updating the timeout property in your WTracker instance:

tracker.setIdleTimeout(180); // in seconds

Event Settings

Explicitly Set Timestamp:

event.setTimestamp(<LONG_UNIX_MS_TIMESTAMP>); //Note this is unix epoch time in milliseconds


Except as otherwise noted, the Woopra Android SDK is licensed under the Apache License, Version 2.0 (

Ruby on Rails is released under the MIT License

You can’t perform that action at this time.