Get Data on a Mobile User Using Statistical ID

To get a mobile user's data using their Oracle BlueKai statistical ID, the query string must include these parameters: user agent (useragent), IP address (ipaddress), the campaign IDs (filterbycampids) if you want to return a specific set of campaigns (instead of all the campaigns), your Web Service User Key (bkuid), and the request signature (bksig).

Syntax

http://api.tags[.datacenter].bluekai.com/getdata/<site ID>/<version>?useragent=<user agent>&ipaddress=<ip address>[&filterbycampids=<campaignID_1>, <campaignID_2>, <campaignID_n>]&bkuid=<bkuid>&bksig=<bksig>

Note:

Tips for retrieving the user agent:

In a mobile web environment (m.com), you must retrieve the user agent from the current default browser.
In a mobile app environment, you must open a Webview and retrieve the user agent from it.

Example Request

This request passes the mobile user's user agent and IP address and gets the categories they qualified for in a single specific campaign. Parameter values are shortened for readability.

http://api.tags.snv.bluekai.com/getdata/1234/v1.2?useragent=Mozilla/5.0%20%28Linux;%20U;%20Android%204.1.2;%20en-us;%20HTC_PN07120/1.26.502.12%20Build/JZO54K%29%20AppleWebKit/534.30%20%28KHTML,%20like%20Gecko%29%20Version/4.0%20Mobile%20Safari/534.30&ipaddress=12.40.242.126&bkuid=abc31d39cf43&bksig=uB1t23WOA6%2BUL87%2Br00Y5c%3D