Различия

Показаны различия между двумя версиями страницы.

Ссылка на это сравнение

Следующая версия
Предыдущая версия
external:integration:api:time [2017/05/18 10:52]
admin created
— (текущий)
Строка 1: Строка 1:
-# Распределение аналитических метрик во времени 
- 
-Возвращает распределение метрик по времени. 
- 
-* obj_id - уникальный идентификатор объекта на сервере Shopster, 
-* time - интервал времени, для которых приводятся данные статистики. В случае выбора "hourly" в качестве параметра "interval" в запросе time выражается в минутах. При выборе "interval" равным "daily" данные "time" выражаются в виде номера дня недели (1 - понедельник и т.д.), 
-* avg_count_session - среднее количество сессий, усредненное по интервалам time в периоде от "from" до "to", указанных в параметрах запроса, 
-* avg_count_client - среднее количество уникальных MAC-адресов, усредненное по интервалам time в периоде от "from" до "to", указанных в параметрах запроса, 
-* avg_session_duration - средняя продолжительность сессии в минутах, усредненная по интервалам time в периоде от "from" до "to", указанных в параметрах запроса, 
-* avg_count_comeback_client - среднее количество уникальных MAC-адресов, зарегистрированных более одного раза в течение окна возвратов (параметр "comeback" в запросе), усредненное по интервалам time в периоде от "from" до "to", указанных в параметрах запроса, 
-* user_type - категория зарегистрированных устройств (all - все, passer - прохожие, visitor - посетители, bounced - невовлеченные посетители, half engaged - полувовлеченные посетители, engaged - вовлеченные посетители, employee - сотрудники). Тип вовлеченности определяется на основании переданных параметров bounce_threshold и engagement_threshold. Проведшие менее bounce_threshold - невовлеченные, проведшие более bounce_threshold, но менее engagement_threshold - полувовлеченные, проведшие более engagement_threshold - вовлеченные. 
- 
-## URL 
-`/reports/time` 
- 
-## Method 
-`GET` 
- 
-## GET Params 
-`from=[date]`<br /> 
-`to=[date]`<br /> 
-`objects=[[]int]`<br /> 
-`interval=[daily|hourly]`<br /> 
-`comeback=[2 week|1 month|2 month|3 month|6 month|1 year|10 year]`<br /> 
-`bounce_threshold=[2 minute|5 minute|10 minute|15 minute|20 minute|30 minute|45 minute]`<br /> 
-`engagement_threshold=[2 minute|5 minute|10 minute|15 minute|20 minute|30 minute|45 minute]`, должен быть больше или равен bounce_threshold 
-   
-## Headers 
-`x-token=[string]` 
- 
-## Response 
-```javascript 
- 
-  "1290": { 
-    "visitor": [ 
-      { 
-        "obj_id": 1290, 
-        "time": 1020, 
-        "avg_count_session": 48, 
-        "avg_count_client": 48, 
-        "avg_session_duration": 13, 
-        "avg_count_comeback_client": 11, 
-        "user_type": "visitor", 
-        "datetime": "0001-01-01T00:00:00Z" 
-      }, 
-      { 
-        "obj_id": 1290, 
-        "time": 540, 
-        "avg_count_session": 2, 
-        "avg_count_client": 2, 
-        "avg_session_duration": 5, 
-        "avg_count_comeback_client": 1, 
-        "user_type": "visitor", 
-        "datetime": "0001-01-01T00:00:00Z" 
-      }, 
-      { 
-        "obj_id": 1290, 
-        "time": 1080, 
-        "avg_count_session": 46, 
-        "avg_count_client": 46, 
-        "avg_session_duration": 13, 
-        "avg_count_comeback_client": 8, 
-        "user_type": "visitor", 
-        "datetime": "0001-01-01T00:00:00Z" 
-      }, 
-      { 
-        "obj_id": 1290, 
-        "time": 1320, 
-        "avg_count_session": 2, 
-        "avg_count_client": 2, 
-        "avg_session_duration": 3, 
-        "avg_count_comeback_client": 1, 
-        "user_type": "visitor", 
-        "datetime": "0001-01-01T00:00:00Z" 
-      }, 
-      { 
-        "obj_id": 1290, 
-        "time": 900, 
-        "avg_count_session": 49, 
-        "avg_count_client": 49, 
-        "avg_session_duration": 13, 
-        "avg_count_comeback_client": 10, 
-        "user_type": "visitor", 
-        "datetime": "0001-01-01T00:00:00Z" 
-      }, 
-      { 
-        "obj_id": 1290, 
-        "time": 840, 
-        "avg_count_session": 49, 
-        "avg_count_client": 49, 
-        "avg_session_duration": 13, 
-        "avg_count_comeback_client": 9, 
-        "user_type": "visitor", 
-        "datetime": "0001-01-01T00:00:00Z" 
-      }, 
-      { 
-        "obj_id": 1290, 
-        "time": 1200, 
-        "avg_count_session": 34, 
-        "avg_count_client": 34, 
-        "avg_session_duration": 13, 
-        "avg_count_comeback_client": 7, 
-        "user_type": "visitor", 
-        "datetime": "0001-01-01T00:00:00Z" 
-      }, 
-      { 
-        "obj_id": 1290, 
-        "time": 720, 
-        "avg_count_session": 31, 
-        "avg_count_client": 31, 
-        "avg_session_duration": 11, 
-        "avg_count_comeback_client": 6, 
-        "user_type": "visitor", 
-        "datetime": "0001-01-01T00:00:00Z" 
-      }, 
-      { 
-        "obj_id": 1290, 
-        "time": 1260, 
-        "avg_count_session": 17, 
-        "avg_count_client": 17, 
-        "avg_session_duration": 12, 
-        "avg_count_comeback_client": 5, 
-        "user_type": "visitor", 
-        "datetime": "0001-01-01T00:00:00Z" 
-      }, 
-      { 
-        "obj_id": 1290, 
-        "time": 780, 
-        "avg_count_session": 41, 
-        "avg_count_client": 41, 
-        "avg_session_duration": 13, 
-        "avg_count_comeback_client": 8, 
-        "user_type": "visitor", 
-        "datetime": "0001-01-01T00:00:00Z" 
-      }, 
-      { 
-        "obj_id": 1290, 
-        "time": 660, 
-        "avg_count_session": 23, 
-        "avg_count_client": 23, 
-        "avg_session_duration": 12, 
-        "avg_count_comeback_client": 4, 
-        "user_type": "visitor", 
-        "datetime": "0001-01-01T00:00:00Z" 
-      }, 
-      { 
-        "obj_id": 1290, 
-        "time": 600, 
-        "avg_count_session": 10, 
-        "avg_count_client": 10, 
-        "avg_session_duration": 12, 
-        "avg_count_comeback_client": 3, 
-        "user_type": "visitor", 
-        "datetime": "0001-01-01T00:00:00Z" 
-      }, 
-      { 
-        "obj_id": 1290, 
-        "time": 960, 
-        "avg_count_session": 51, 
-        "avg_count_client": 51, 
-        "avg_session_duration": 12, 
-        "avg_count_comeback_client": 11, 
-        "user_type": "visitor", 
-        "datetime": "0001-01-01T00:00:00Z" 
-      }, 
-      { 
-        "obj_id": 1290, 
-        "time": 1140, 
-        "avg_count_session": 43, 
-        "avg_count_client": 43, 
-        "avg_session_duration": 13, 
-        "avg_count_comeback_client": 8, 
-        "user_type": "visitor", 
-        "datetime": "0001-01-01T00:00:00Z" 
-      } 
-    ] 
-  } 
-} 
-``` 
- 
-## Request 
-``` 
-curl 'https://api-public.getshopster.com/reports/time?objects=1290&from=2016-02-01&to=2016-02-14&bounce_threshold=5+minute&engagement_threshold=20+minute&comeback=2+week&interval=daily' -H 'x-token: xxxx' 
-``` 
  

external/integration/api/time.1495104744.txt.gz · Последнее изменение: 2017/05/19 09:30 (внешнее изменение)