{"_id":"57ab9dfcdb6b2e0e003e7dd8","user":"56157c37c41bfc0d00292b38","category":{"_id":"55e76b8196131b2f00bf4b72","pages":["55e8b2c13fef5017000dbd9a","55e8b365f0f1850d00d24a5b","55f88ebd5840d119004346bf","55f8ab55c449610d002daf87","5603759a8d58900d0051e9ee","560375cd90ee490d004403da","5633b5ebc49a7c19001fd091","567353ae47f7010d005bfdc9"],"project":"5429beef1163360800ed31fa","__v":8,"version":"5429beef1163360800ed31fd","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-09-02T21:34:57.232Z","from_sync":false,"order":2,"slug":"apis","title":"Integrating with APIs"},"project":"5429beef1163360800ed31fa","githubsync":"","version":{"_id":"5429beef1163360800ed31fd","__v":22,"project":"5429beef1163360800ed31fa","createdAt":"2014-09-29T20:19:59.904Z","releaseDate":"2014-09-29T20:19:59.904Z","categories":["5429beef1163360800ed31fe","55e74e1f5d36b32b002563fa","55e7500a73169617001f2e86","55e76b8196131b2f00bf4b72","55e89569cdbb8a350096df9c","55f8935eb089b71700a8364e","55f8a67d3bb4bb0d0022d093","55f9dbefc7ef770d00d9bf6d","5601c21a22ecf60d002b27b3","5601c21ff12aee0d001bb06e","5601c2256c7b610d00280db5","5601c22c22ecf60d002b27b4","5603738d0c78b00d0039af47","5626f70bfcbbc621004ebf52","566f7a1ae144ab0d00e9732f","566f85ca7820960d00c3b93d","56708ce43a32d20d00c45cbf","56708d436995210d003aad8e","5736471abe10a9200030732c","57a82c7aff9bd30e00a6f1c1","591b8500e3992319007190f4","5a3718305c66a60012d960ba"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"parentDoc":null,"__v":7,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-08-10T21:34:52.169Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"code":"curl -H \"Authorization: Bearer aBcdeFgHiJK\" \\\nhttps://console.getpolymorph.com/api/v2/report/provider/?start_date=2016-01-01&end_date=2016-01-02","language":"curl"}]},"method":"get","results":{"codes":[{"name":"","code":"{  \n   \"status\":{  \n      \"message\":\"Success\",\n      \"time_elapse\":154\n   },\n   \"data\":[  \n      {  \n      \t\"total\":{  \n           \"revenue\":0.13,\n           \"impression\":123\n        },\n        \"meta\":{  \n           \"status\":\"Paused\",\n           \"provider\":72,\n           \"name\":\"Provider Name 1\"         ...\n        }\n   \t\t}\n    ],\n    \"summary\":{  \n             \"series\":{  \n                \"revenue\":[...],\n                \"impression\":[...],\n                \"labels\":[string labels for each time unit],\n                \"ts\":[unix timestamps for each time unit]\n             },\n            \"total\":{  \n               \"revenue\":0.13,\n               \"impression\":123\n            },\n            \"meta\":{  \n               \"request\":{  \n                  \"render_format\":\"json\",\n                  \"data_type\":\"full\",\n                  \"end_date\":\"2016-01-02T00:00:00\",\n                  \"object_type\":\"provider\",\n                  \"object_id\":\"123\",\n                  \"group_by\":null,\n                  \"granularity\":\"days\",\n                  \"start_date\":\"2016-01-01T00:00:00\"\n               },\n               \"id\":\"summary\"\n            }\n    }\n}","language":"json","status":200},{"name":"","code":"{\n\t\"status\": {\n\t\"message\": \"Invalid request.\",\n\t\"detail\": {\n      \"start_date\": [\n        \"This field is required.\"\n      ],\n      \"end_date\": [\n        \"This field is required.\"\n      ]\n    },\n\t\"time_elapse\": 0\n\t}\n}","language":"json","status":400}]},"settings":"57aba40454fa780e006c5437","auth":"required","params":[{"_id":"57aba7b8b5e8742000e17ecb","ref":"","in":"path","required":true,"desc":"Options: campaign, advertiser, placement, site, or provider","default":"","type":"string","name":"OBJECT_TYPE"},{"_id":"57aba7b8b5e8742000e17eca","ref":"","in":"path","required":false,"desc":"If blank, top-level report data for the object_type will be returned. Multiple IDs can be concatenated using '-'.  e.g. 1-2-3","default":"","type":"string","name":"OBJECT_ID"},{"_id":"57aba7b8b5e8742000e17ec9","ref":"","in":"query","required":true,"desc":"","default":"","type":"yyyy-mm-dd","name":"start_date"},{"_id":"57aba7b8b5e8742000e17ec8","ref":"","in":"query","required":true,"desc":"","default":"","type":"yyyy-mm-dd","name":"end_date"},{"_id":"57aba7b8b5e8742000e17ec6","ref":"","in":"query","required":false,"desc":"Time-series granularity: days, months, hours","default":"days","type":"string","name":"granularity"},{"_id":"57aba7b8b5e8742000e17ec5","ref":"","in":"query","required":false,"desc":"Response format.  'json' or 'csv'.  'csv' is used for exporting as file.","default":"json","type":"string","name":"render_format"},{"_id":"57aba7b8b5e8742000e17ec4","ref":"","in":"query","required":false,"desc":"Response data fields to include.  Options are: 'total', 'series', 'full'.  'full' returns both 'total' and 'series' data","default":"full","type":"string","name":"data_type"},{"_id":"57aba7b8b5e8742000e17ec7","ref":"","in":"query","required":false,"desc":"Group by object.  Only supported for Unit report where a single object_id is defined.","default":"","type":"string","name":"group_by"},{"_id":"57abb4d0b5c9591700b879c3","ref":"","in":"header","required":true,"desc":"OAuth2 Bearer token. Follow **[authentication instructions](http://dev.getpolymorph.com/v1.0/docs/console-api-authentication)** to authenticate.","default":"","type":"string","name":"Authorization: Bearer"},{"_id":"58213ba5ac662027004dba1d","ref":"","in":"query","required":false,"desc":"Response includes itemized \"data\" field.","default":"True","type":"boolean","name":"itemize"}],"url":"/v2/report/OBJECT_TYPE/OBJECT_ID"},"isReference":true,"order":12,"body":"## Response Fields\n\n* **status**: status of API response\n* **data**: array of data objects based on group_by request parameter\n    - ***total***: aggregate metrics for each group_by object\n    - ***meta***: Metadata about the object\n* **summary**: summary of all data in total and time-series format\n    - ***total***:  total aggregate metrics\n    - ***series***:  total time-series metrics\n    - ***meta***: echo API request parameters\n\n\n## Available Metrics\n* **visits** - For placement and site reports only\n* **fill_rate** - For placement and site reports only\n* **impressions**\n* **viewable_impressions**\n* **viewability**  -  100 * viewable_impressions / impressions \n* **views** - Video Views\n* **clicks**\n* **ctr** - 100 * clicks / impressions\n* **revenue** - For placement and site reports \n* **expense** - For campaign and advertiser reports\n* **ecpm** - effective CPM\n* **ecpc** - effective CPC\n* **vcpm** - viewable CPM\n\n** Advanced Metrics **\n* **vv25** - 1st Quartile Video Views\n* **vv50** - 2nd Quartile Video Views\n* **vv75** - 3rd Quartile Video Views\n* **vv100** - 4th Quartile Video Views\n* **network_request** - For placement and site reports only\n* **network_timeout** - For placement and site reports only\n* **network_fallback** - For placement and site reports only\n\n##  Available Options for group_by\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"OBJECT_TYPE\",\n    \"h-1\": \"campaign\",\n    \"h-2\": \"advertiser\",\n    \"h-3\": \"placement\",\n    \"h-4\": \"site\",\n    \"h-5\": \"provider\",\n    \"0-0\": \"**group_by**\",\n    \"0-1\": \"creative (default)\",\n    \"1-1\": \"placement\",\n    \"2-1\": \"site\",\n    \"3-1\": \"\",\n    \"0-2\": \"campaign (default)\",\n    \"1-2\": \"placement\",\n    \"2-2\": \"site\",\n    \"3-2\": \"\",\n    \"1-3\": \"advertiser\",\n    \"0-3\": \"campaign (default)\",\n    \"2-3\": \"\",\n    \"3-3\": \"\",\n    \"0-4\": \"placement (default)\",\n    \"1-4\": \"campaign\",\n    \"2-4\": \"advertiser\",\n    \"3-4\": \"\",\n    \"0-5\": \"placement  (default)\",\n    \"1-5\": \"site\"\n  },\n  \"cols\": 6,\n  \"rows\": 4\n}\n[/block]","excerpt":"","slug":"reporting-api-v2","type":"endpoint","title":"Reporting API v2"}