Statistics

The statistics resource delivers information about the shop's operations. It contains information about traffic, sales flow and order data overview.

The statistics data is split into the following 4 areas, which can be fetched independently:

Traffic data for the shop
Orders from the shop
Abandonded shopping carts
Devices accessing the shop
Sold products

What can you do with Statistics?

The FlickRocket API lets you do the following with the statistics resources. More detailed versions of these general actions may be available:

GET /api/statistics/traffic/1202.json?StartDate=2016-01-01&EndDate=2016-05-30

Get a shop's traffic data such as views, visits, etc. in a certain time frame.

GET /api/statistics/order/1202.json?StartDate=2016-01-01&EndDate=2016-05-30

Get a shop's order overview in terms of quantity and revenue in a certain time frame.

GET /api/statistics/cart/1202.json?StartDate=2016-01-01&EndDate=2016-05-30

Get an overview about a shop's abandoned shopping carts in a certain time frame.

GET /api/statistics/order_devices/1202.json?StartDate=2016-01-01&EndDate=2016-07-30

Get informatin about the devices which have accessed a shop in a certain time frame.

GET /api/statistics/order_products/1202.json?StartDate=2016-01-01&EndDate=2016-07-30

Get information about a shop's sold products in a certain time frame.

Statistics Properties - "traffic_statistics"

traffic_statistics:[]

List of daily traffic data. All fields are read-only.

date	"date": "2016-01-01T00:00:00" The date of this record's data.
visits	"visits": 20235 Visits per day (excluding bots)
page_views	"page_views": 8953 Page views per day (excl. bots)
visitors	"visitors": 6235 Visitors per day (excl. bots)
repeating_visitors	"repeating_visitors": 3546 Repeating visitors per day (excl. bots)
bots	"bots": 1209 Bot visits per day
bounce	"bounce": 1460 Bounces per day

Statistics Properties - "order_statistics"

order_statistics:[]

List of daily order data. All fields are read-only.

currency	"currency": "usd" The currency used for this record. This matches the home currency of the shop owner. All foreign currencies values are transformed into this currency using current day-to-day exchange rates.
date	"date": "2016-07-01T00:00:00" The date of this record. All other values are sums of their respective data for tis day.
digital_count	"digital_count": 0 The number of digital items sold this day.
digital_amount	"digital_amount": 0 The amount for which digital items were sold this day in the currency specified.
international_count	"international_count": 0 The number of items sold to international customers this day.
international_amount	"international_amount": 0 The amount for which items were sold this day to international customers in the currency specified.
item_count	"item_count": 0 The number of items sold this day.
national_count	"national_count": 0 The number of items sold to domestic customers this day.
national_amount	"national_amount": 0 The amount for which items were sold this day to domestic customers in the currency specified.
order_count	"order_count": 0 The number of orders processed this day.
order_amount	"order_amount": 0 The amount for which orders were processed this day in the currency specified.
permanent_license	"permanent_license_count": 0 The number of permanent licenses sold this day.
permanent_license_amount	"permanent_license_amount": 0 The amount for which permanent digital licenses were sold this day in the currency specified.
physical_count	"physical_count": 0 The number of physical items sold this day.
physical_amount	"physical_amount": 0 The amount for which physical items were sold this day in the currency specified.
rental_license_count	"rental_license_count": 0 The number of rental licenses sold this day.
rental_license_amount	"rental_license_amount": 0 The amount for which digital rental licenses were sold this day in the currency specified.

Statistics Properties - "abandoned_shopping_cart"

abandoned_shopping_cart:[]

List of daily abandoned shopping carts. All fields are read-only.

currency	"currency": "usd" The currency used for this record. This matches the home currency of the shop owner. All foreign currencies values are transformed into this currency using current day-to-day exchange rates.
date	"date": "2016-07-01T00:00:00" The date of this record. All other values are sums of their respective data for tis day.
digital_count	"digital_count": 0 The number of digital items in abandoned shopping carts this day.
digital_amount	"digital_amount": 0 The amount for which digital content was placed in abandoned shopping carts this day in the currency specified.
international_count	"international_count": 0 The number of items in abandoned shopping carts from international customers this day.
international_amount	"international_amount": 0 The amount for which items were placed in abandoned shopping cart sthis day to international customers in the currency specified.
item_count	"item_count": 0 The number of items placed in abandoned shopping carts this day.
national_count	"national_count": 0 The number of items placed in abandoned shopping cart from domestic customers this day.
national_amount	"national_amount": 0 The amount for which items were as placed in abandoned shopping carts this day to domestic customers in the currency specified.
order_count	"order_count": 0 The number of abandoned shopping carts this day.
order_amount	"order_amount": 0 The amount for which orders were as placed in abandoned shopping carts this day in the currency specified.
permanent_license	"permanent_license_count": 0 The number of permanent licenses placed in abandoned shopping carts this day.
permanent_license_amount	"permanent_license_amount": 0 The amount for which permanent digital licenses were as placed in abandoned shopping carts this day in the currency specified.
physical_count	"physical_count": 0 The number of physical items placed in abandoned shopping carts this day.
physical_amount	"physical_amount": 0 The amount for which physical items were placed in abandoned shopping carts this day in the currency specified.
rental_license_count	"rental_license_count": 0 The number of rental licenses placed in abandoned shopping carts this day.
rental_license_amount	"rental_license_amount": 0 The amount for which digital rental licenses were placed in abandoned shopping carts this day in the currency specified.

Statistics Properties - "order_devices"

order_devices:[]

List of daily devices/operating systems which accessed the shop. All fields are read-only.

date	"date": "2016-01-01T00:00:00" The date of this record's data.
fire_os	"fire_os": 143 Number of Fire OS devices accessing the shop.
chrome_os	"chrome_os": 213 Number of Chrome OS devices accessing the shop.
ios	"ios": 6538 Number of iOS devices accessing the shop.
android	"android": 16453 Number of Android devices accessing the shop.
windows	"windows": 21056 Number of Windows devices accessing the shop.
os_x	"os_x": 876 Number of MacOS devices accessing the shop.
linux	"linux": 22 Number of Linux devices accessing the shop.
unknown	"unknown": 666 Number of unknown devices accessing the shop.

Statistics Properties - "order_products"

order_products:[]

List of products with related data sorted by revenue. All fields are read-only.

count	"count": 1299 The number of times this product has been sold in the specified time frame.
id	"id": 42147 Unique ID of the product.
name	"name": "Sita Sings the Blues" Title of the product as defined in product data.
product_id	"product_id": "0000-A4A3-7DB2-8BFA" Unique Product ID of the product.
amount	amount": 58288 Total revenue generated with this product in the specified time frame. The value is in 1/100 of the base currency, e.g. cent for USD.
currency	"currency": "usd" Currency for the revenue data. Revenue in other currencies are converted at daily conversion rates.

Samples

Get a shop's traffic data such as views, visits, etc. in a certain time frame.

GET /api/statistics/traffic/1202.json?StartDate=2016-01-01&EndDate=2016-05-30

View Response

/api/statistics/traffic/1202.json?StartDate=2016-02-01&EndDate=2016-02-02
{
  "traffic_statistics": [
      {
          "date": "2016-02-01T00:00:00",
          "visits": 4856,
          "page_views": 6854,
          "visitors": 3899,
          "repeating_visitors": 2256,
          "bots": 1599,
          "bounce": 1276
      },
      {
          "date": "2016-02-02T00:00:00",
          "visits": 5268,
          "page_views": 7451,
          "visitors": 4029,
          "repeating_visitors": 2681,
          "bots": 1199,
          "bounce": 988
      }
  ]
}

Get a shop's order overview in terms of quantity and revenue in a certain time frame.

GET /api/statistics/order/1202.json?StartDate=2016-01-01&EndDate=2016-05-30

View Response

GET /api/statistics/order/1202.json?StartDate=2016-01-01&EndDate=2016-05-30
{
  "order_statistics": [
      {
          "date": "2016-02-01T00:00:00",
          "physical_count": 18,
          "physical_amount": 17982,
          "digital_count": 79,
          "digital_amount": 78921,
          "permanent_license_count": 50,
          "permanent_license_amount": 58644,
          "rental_license_count": 29,
          "rental_license_amount": 20277,
          "national_count": 67,
          "national_amount": 64602,
          "international_count": 30,
          "international_amount": 32301,
          "order_count": 58,
          "order_amount": 96903,
          "item_count": 97,
          "currency": "usd"
      },
      {
          "date": "2016-02-02T00:00:00",
          "physical_count": 14,
          "physical_amount": 22541,
          "digital_count": 81,
          "digital_amount": 132542,
          "permanent_license_count": 49,
          "permanent_license_amount": 86477,
          "rental_license_count": 32,
          "rental_license_amount": 46065,
          "national_count": 51,
          "national_amount": 90886,
          "international_count": 30,
          "international_amount": 64197,
          "order_count": 64,
          "order_amount": 155083,
          "item_count": 95,
          "currency": "usd"
      }
  ]
}

Get an overview about a shop's abandoned shopping carts in a certain time frame.

GET /api/statistics/cart/1202.json?StartDate=2016-01-01&EndDate=2016-05-30

View Response

GET /api/statistics/cart/1202.json?StartDate=2016-01-01&EndDate=2016-05-30
  "order_statistics": [
      {
          "date": "2016-02-01T00:00:00",
          "physical_count": 18,
          "physical_amount": 17982,
          "digital_count": 79,
          "digital_amount": 78921,
          "permanent_license_count": 50,
          "permanent_license_amount": 58644,
          "rental_license_count": 29,
          "rental_license_amount": 20277,
          "national_count": 67,
          "national_amount": 64602,
          "international_count": 30,
          "international_amount": 32301,
          "order_count": 58,
          "order_amount": 96903,
          "item_count": 97,
          "currency": "usd"
      },
      {
          "date": "2016-02-02T00:00:00",
          "physical_count": 14,
          "physical_amount": 22541,
          "digital_count": 81,
          "digital_amount": 132542,
          "permanent_license_count": 49,
          "permanent_license_amount": 86477,
          "rental_license_count": 32,
          "rental_license_amount": 46065,
          "national_count": 51,
          "national_amount": 90886,
          "international_count": 30,
          "international_amount": 64197,
          "order_count": 64,
          "order_amount": 155083,
          "item_count": 95,
          "currency": "usd"
      }
  ]
}

Get informatin about the devices which have accessed a shop in a certain time frame.

GET /api/statistics/order_devices/1202.json?StartDate=2016-01-01&EndDate=2016-07-30

View Response

GET /api/statistics/order_devices/1202.json?StartDate=2016-01-01&EndDate=2016-07-30
{
  "order_devices": [
      {
          "date": "2016-02-01T00:00:00",
          "fire_os": 20,
          "chrome_os": 34,
          "ios": 3240,
          "android": 2899,
          "windows": 14567,
          "os_x": 976,
          "linux": 132,
          "unknown": 423
      },
      {
          "date": "2016-02-02T00:00:00",
          "fire_os": 13,
          "chrome_os": 42,
          "ios": 4256,
          "android": 3345,
          "windows": 16342,
          "os_x": 1002,
          "linux": 98,
          "unknown": 239
      }
  ]
}

Get information about a shop's sold products in a certain time frame.

GET /api/statistics/order_products/1202.json?StartDate=2016-01-01&EndDate=2016-07-30

View Response

GET /api/statistics/order_products/1202.json?StartDate=2016-01-01&EndDate=2016-07-30
{
  "order_products": [
      {
          "count": 404,
          "id": 2874,
          "name": "Big Buck Bunny",
          "product_id": "0000-0B3A-5DA6-3EB3",
          "amount": 403596,
          "currency": "usd"
      },
      {
          "count": 46,
          "id": 42147,
          "name": "Sita Sings the Blues",
          "product_id": "0000-A4A3-7DB2-8BFA",
          "amount": 45954,
          "currency": "usd"
      },
      {
          "count": 32,
          "id": 42069,
          "name": "Biker's soul",
          "product_id": "0000-A455-9607-D7A7",
          "amount": 31968,
          "currency": "usd"
      },
      {
          "count": 1,
          "id": 13235,
          "name": "Sintel",
          "product_id": "0000-33B3-B888-DFED",
          "amount": 999,
          "currency": "usd"
      },
      {
          "count": 101,
          "id": 14136,
          "name": "Tears of Steel",
          "product_id": "0000-3738-6CA2-99EA",
          "amount": 100899,
          "currency": "usd"
      }
  ]
}