![]() |
ParselyAndroid
1.0
The Parsely Android Toolkit
|
Adding Parsely to your Android app is easy!
parsely
directory (under src/com
) to your project's top-level package directory (in a default Eclipse project, this is com
.) The directory tree should look like src/com/parsely/parselyandroid
.jackson-core
and jackson-mapper
JAR files into your project's libs
directory.Add the following lines to your AndroidManifest.xml file:
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
In any file that uses the Parsely SDK, be sure to add the line
import com.parsely.parselyandroid.*;
at the top of the file.
Before using the toolkit, you must initialize the Parsely object with your public api key. This is usually best to do in the MainActivity
's onCreate
method.
@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); ParselyTracker.sharedInstance("examplesite.com", this); }
The this
parameter is necessary to give Parsely access to the app's context.
The Parsely toolkit maintains a queue of pageview events and periodically flushes it to the servers. This helps extend the battery life of your users' Android devices. As a result of this design, there may be some pageview events remaining in the queue at the time the user exits your app. To make sure all of the queued events are flushed to the server at this time, make sure to include a call to flush()
in your main activity's onDestroy()
method:
@Override protected void onDestroy() { ParselyTracker.sharedInstance().flush(); super.onDestroy(); }
To register a pageview event with Parsely, simply use the track
call.
ParselyTracker.sharedInstance().trackURL("http://examplesite.com/something-whatever.html");
This call requires the canonical URL of the page corresponding to the post currently being viewed.
You can also use
ParselyTracker.sharedInstance().trackPostId("1987263412-12783461234");
which requires a string uniquely identifying the post to Parsely's systems.