v2 is deprecated - support ended in 2016. v4 is newest version - Upgrade now.
Detector is easy to implement. We have collected a couple of 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), too avoid redundant requests.
Be aware of our terms.
$request = "http://detector-v2.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.1', :git => "ssh://git@github.com/parentnode/deardetector.git", :tag => "v0.1"
Usage
<%= browser_segment %>
Now you have a browser_segment variable you can insert in your code.
The gem always uses the latest version of the Detector API (http://detector.dearapi.com).
<script type="text/javascript" src="http://detector-v2.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.