awe.sm Stats Overview

When performance data (i.e. clicks, conversion counts, and conversion values) is combined with the intent data captured when a share action is created, awe.sm provides a deep understanding of the factors that contribute to the most optimal sharing behaviors.

Please review the key concepts before continuing.

Finding Meaningful Data

The awe.sm stats API provides powerful filtering and grouping functionalities of input parameters. By providing information about the sharer, how the link was created, and where the link was shared, successful attributes can be identified through performance stats.

Performance stats can be retrieved on an individual awe.sm link or in aggregate. All values are available as totals within a time period, as well as broken down into hourly, daily, or weekly intervals for graphs.

Stat	Individual Link	Aggregate
Clicks
Page Views
5 Conversion Counts
5 Conversion Values
Shares
Clicks per Share

Filters

Filters allow retrieval of stats for a subset of awe.sm links based on input parameter values. List of filter parameters

For example, if you wanted stats for URLs shared to Twitter, specify service=twitter . The data could output:

Grouping

Grouping allows retrieval of stats with common values within a input parameter. Grouping can be performed on any filterable parameter, though you cannot group and filter on the same parameter simultaneously.

For example, if you wanted stats across all social networks, specify group_by=service . The data could output:

Pivots

Pivots allow sub-grouping of link input parameters. Pivots can be performed on any filterable parameter, as long as the parameter is not already filtered or grouped.

For example, if you wanted to know how well various social networks performed within multiple campaigns, specify group_by=campaign&pivot=service .

Note: Interval totals are unavailable when using pivot grouping.

Sorting & Pagination

Groups and pivot results can be paginated and sorted by any performance column, ascending or descending.

Last updated 2011-10-26