Android SDK

This project contains Lotame Platform Android SDK jar to be provided to clients to enable them to more easily send data from Android mobile apps.

Development Environment Set-up

Android Studio

To make changes to this project, you must first install the Android Studio http://developer.android.com/tools/studio/index.html

Open

Once Android Studio is installed, open the sdk project. Android Studio will prompt you for missing requirements such as google play services repository. Follow the steps it suggests.

Details for using the library are in the JavaDoc for the CrowdControl class, and in the help wiki at http://help.lotame.com/display/HELP/Mobile+SDK%27s

Building

Use gradle clean jar to build a jar file in the build\libs directory. Modify build.gradle to change the output file name.

Testing

It is advisable to test the device on an Android Virtual Device (AVD) AND on a native device.

Testing is done via the android_demo project

To install on an AVD:

Click run in Android Studio and choose an emulator

To install on a native device:

Option 1

• First, get your device on the Lotame wireless network.
• Then, on your android device, enable it so that you will be able to install applications from Unknown Sources.
  • Older versions: Go to Settings > Applications and check the "Unknown Sources" setting to allow you to install the app on your device.
  • 4.x: Go to Settings > Security and check the "Unknown Sources" setting to allow you to install the app on your device.
• Set up an http server on you local machine. If you have python installed, you can cd to the android_demo/bin directory and invoke the following command (this assumes that you have port 8080 open on your firewall).

python -m SimpleHTTPServer 8080

• Then, load your ip address in a browser on your phone. http://yourip:8080
• Click on the link for the android_demo.apk, when downloaded your device, click on it and it will ask you what to do with it. Open it with the package installer and install it on your phone.

Option 2

Click run in Android Studio and choose a connected device

To test:

• Select a client id that is collecting behaviors via bcp calls in Production. In this example, we will use 4170.
• Enter the following data in the demo application:
  • client: 4170 Type: b Value: 5990
• Click 'Start New Session' to set up the CrowdControl library
• Click 'Add'
• Click 'Send'
• This should send a bcp call with the male behavior for client 4710
• Click 'Extract'. Below the 'Start New Session' button you should see a JSON object representing the result of the audience extraction call similar to the following:

{"Profile":{"tpid":"606d0a5804c0224c7d5b575e73a11b71","Audiences":{"Audience":[{"id":"47280","abbr":"all"}]}}}

- Returning valid JSON indicates a successful test.