Quova Ambient Data Framework eXtension
The SDL Tridion Ambient Data Framework (ADF) is a framework for gathering and transforming website data, for example information about the user visiting the website and information about the current user session (referral, location, language etc). As such, the ADF can pick up a visitor's geo-location and merge it with additional information from backend or 3rd party systems, like weather information, buying power, language etc. Organizations can then use this accumulated intelligence to deliver a more relevant experience to their audience across both desktop and mobile sites.
This Ambient Data Framework cartridge delivers you just that information using Quovas REST API (http://developer.quova.com/docs). Quova provides the geographic location and network data for any Internet Protocol (IP) address in the public address space. Quovas REST API provides a simple RESTful (REST) interface that returns Quovas data over HTTP, including standard geograpical information (address, lattitude, longitude, etc.) as well as DMA (Designated Market Area), MSA (Metropolitan Statistical Area) and network information. The geolocation geographic location and network data is delivered as xml as shown in the picture on the right. All elements are stored in the Ambient Data Framework, available for reuse in your Web applications.
The Quova geographic location is directly reused in the cartridge to gather the current weather based on the Yahoo! Weather RSS Feed (http://developer.yahoo.com/weather/) by transforming the geolocation (latitude and longitude from the requestors IP address) into a Where On Earth ID (WOEID). This information is also stored in the Ambient Data Framework on session start of your request, so it too can be reused in any of your Web applications. The picture below shows the weather data as stored by the Ambient data Framework.
Installation
To install the Ambient Data Framework cartridge you need to make sure you have deployed and configured the Ambient Data Framework as described in our documentation. The next step is to deploy the cartridge (quova_claim_processors.jar) into your Web application. Then you can configure the cartridge in the cd_ambient_conf.xml file under the <Cartridges> section:
<Cartridges>
<CartridgeFile="/quova_cartridge_conf.xml"/>
</Cartridges>
The Quova Claim Processor has a separate configuration file (quova_conf.xml), this also needs to be made available in the same location as the cd_ambient_conf.xml file. In here you need to configure your Quova API Key and Shared Secret. These you can obtain by registering for an account at http://developer.quova.com/member/register.
This extension is delivered with full source, including example configuration files. It also contains a test JSP page (QuovaTest.jsp) to show the information which has been placed in the Ambient Data Framework.
Tags
:
quova,
ambient data framework,
geolocation,
java,
2011,
content delivery