RSiteCatalyst (version 1.1)

QueueRanked: Run a QueueRanked Report

Description

A QueueRanked report is a report that shows the ranking of values for one or more elements relative to a metric, aggregated over the time period selected. The QueueRanked report is analogous to pulling a "ranked" report within SiteCatalyst. The QueueRanked function returns a data frame equivalent to pulling a Ranked report in SiteCatalyst. Correlations & Sub-Relations are supported.

Usage

QueueRanked(reportSuiteID, dateFrom, dateTo, metrics, elements, top, 
    startingWith, segment_id, selected, currentData)

Arguments

reportSuiteID

Report Suite ID

dateFrom

Report Start Date in "YYYY-MM-DD" format

dateTo

Report End Date in "YYYY-MM-DD" format

metrics

The metric(s) you want in the report

elements

The element(s) (page, browser, eVar, prop) for the report to be broken down by.

top

How many results you want trended. Used in combination with "startingWith". Not used if "selected" argument used.

startingWith

The first ranked number you want in the report. Used in combination with "top". Not used if "selected" argument used.

selected

List of selected values, such as specific pages or eVar values. Not used if "top" and "startingWith" arguments are used

segment_id

Optional. If no segment_id is specified, metrics will be reported for all visitors.

currentData

Optional. Use value of "1" to get current data results. Only needed when dateTo is greater than or equal to the current day.

Value

• Data Frame

Details

Because of the Reporting API structure, this function first requests the report, then checks the reporting queue to see if the report is completed, and when the report returns as "done" pulls the report from the API. This checking process can occur up to 120 times, with a 5 second delay between status checks. If the report does not return as "done" after 10 minutes, the function returns an error.

Note: Because of the multiple argument types ("top" and "startingWith" OR "selected"), keyword arguments are generally needed towards the end of the function call instead of just positional arguments.

See Also

GetAvailableMetrics GetSegments GetAvailableElements

Examples

#Top 100 pages viewed/visits for Loyal_Visitors segment, broken down by browser 
(correlation/subrelation)
top100_pages <- 
QueueRanked("keystonerandy", "2013-02-13","2013-02-28", c("pageviews"), c('page', 'browser'),
top= "100", startingWith= "1", segment_id= "Loyal_Visitors")


#Get just the elements you want from the ranked list, instead of "Top"
single_pages <- 
QueueRanked("keystonerandy", "2013-02-13","2013-02-19", c("pageviews", "visits"),'page',
selected = c("http://randyzwitch.com", "http://randyzwitch.com/about"))