nomniture
nomniture copied to clipboard
A Node.js module that allows access to Omniture's REST API libraries (developer.omniture.com)
nomniture
This is a Node.js port of ROmniture by msukmanowsky.
what is it
nomniture is a minimal Node.js module wrapper for Omniture's REST API.
There are two objects to use, Client
and Report
. Client
is the generic interface to the Omniture API. Report
adds a few helper methods to handle requesting a report and polling the Omniture API until the report is ready. It then requests the report and returns the data.
Omniture's API is closed, you have to be a paying customer in order to access the data.
installation
[sudo] npm install nomniture
initialization and authentication
nomniture requires you supply the username
, sharedSecret
and environment
which you can access within the Company > Web Services section of the Admin Console. The environment you'll use to connect to Omniture's API depends on which data center they're using to store your traffic data and will be one of:
- San Jose (https://api.omniture.com/admin/1.2/rest/)
- Dallas (https://api2.omniture.com/admin/1.2/rest/)
- London (https://api3.omniture.com/admin/1.2/rest/)
- San Jose Beta (https://beta-api.omniture.com/admin/1.2/rest/)
- Dallas (beta) (https://beta-api2.omniture.com/admin/1.2/rest/)
- Sandbox (https://api-sbx1.omniture.com/admin/1.2/rest/)
Here's an example of initializing with a few configuration options.
// generic Client
var Client = require('nomniture').Client;
var c = new Client(username, sharedSecret, 'sanJose');
// Report
var Report = require('nomniture').Report;
var r = new Report(username, sharedSecret, 'sanJose', {waitTime : 10}); // waitTime is optional, default is set to 5 seconds
usage
There is only one core method for the user:
- request - handles all requests to the API.
For reference, I'd recommend keeping Omniture's Developer Portal open as you code . It's not the easiest to navigate but most of what you need is there.
The method takes three arguments:
- Report type - 'Report.QueueRanked', 'ReportSuite.GetAvailableMetrics'
- Parameters - These vary depending on the type of request. This should be in an object. If no data is needed, pass an empty object
- Callback function - This function will be called when the request has finished. This callback function has two arguments passessed: an error object (null, if no errors) and the response object.
If the response is a string or a number as it is for "Company.GetTokenCount", the response will be returned a such. All other responses will be a parsed JSON object.
examples
// Get all available metrics using the Client object
var Client = require('nomniture').Client,
c = new Client(username, sharedSecret, 'sanJose'),
reportData = { "rsid_list": ["reportSuiteId"] }
c.request('ReportSuite.GetAvailableMetrics', reportData, function(err, response){
if(err){ throw new Error(err.message); }
console.log(response);
});
// Use the Report object to get a pageView Overtime report
var Report = require('nomniture').Report,
option = {
waitTime: 10, // optionally set the wait time between polling API
log: true // default is false
},
reportData = {
reportDescription: {
reportSuiteID: "reportSuiteId",
dateFrom: "2012-01-01",
dateTo: "2012-01-31",
metrics: [{ id: "pageviews" }],
validate: "true"
}
};
var r = new Report(username, sharedSecret, 'sanJose', options) // lets set our poll time to 10 seconds
r.request("Report.QueueOvertime", reportData, function(err, response){
if(err){ throw new Error(err.message); }
console.log(response);
});