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.

quova_xmlThis Ambient Data Framework cartridge delivers you just that information using Quova�s 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. Quova�s REST API provides a simple RESTful (REST) interface that returns Quova�s 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.

weather_claim

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.


Developer
:    Bart Koopman
Company
License agreement
Tags
:    quova,  ambient data framework,  geolocation,  java,  2011,  content delivery
Version
:   1.0
Source
:   Yes

About the Author
Bart Koopman
Community Development Consultant

As a Community Development Consultant, Bart is the evangelist of all SDL Tridion products. Bart used to be a consultant and trainer at SDL Tridion, supporting both partners and customers with their implementations.

SDL CMT division