v3 is deprecated - support ends in 2018. v4 is newest version - Upgrade now.
The Detector v3 API is easy to use. We have collected a couple of simplified implementation examples below. Please forward additional implementations, if you wish to share them with others.
Make sure you store the received segment (in session or similar), to avoid redundant requests.
Be aware of our terms.
$request = "http://detector-v3.dearapi.com/xml";
$request .= "?ua=".urlencode($_SERVER["HTTP_USER_AGENT"]);
$request .= "&site=#SITE_ID#";
$request .= "&file=".urlencode($_SERVER["SCRIPT_NAME"]);
$response = file_get_contents($request);
$device = simplexml_load_string($response);
$segment = $device["segment"];
Now you have a $segment variable you can insert in your code.
Include in Gemfile
gem 'deardetector', '~> 0.2', :git => "ssh://git@github.com/parentnode/deardetector.git", :tag => "v0.2"
Usage
<%= browser_segment %>
Now you have a browser_segment variable you can insert in your code.
<script type="text/javascript" src="http://detector-v3.dearapi.com/js-include"></script>
This will inject a CSS (seg_segment.css) and JavaScript (seg_segment.js) include with the segment of the current user. See APIs for additional settings.