概述
常规 FTP 数据检索
付款方式 | 则fTP |
每分钟/每小时 | 原始数据/每分钟数据 |
已发送文件数 |
根据安装的计数器数量,每天每个计数器一个文件 |
数据检索时间 |
2.30am 根据客户的时区 |
使用传统方法的缺点:
- 比较难维护
- 对客户端服务器的 FTP 成功率不可见
- 未汇总原始数据。 需要自我聚合和比较。 如果其中一个计数器处于脱机状态,原始文件不会合并到分支级别,这将导致分支级别流量降低
- 不知道是否会在第二天重新包含迟到的数据
- 数据完整性:不准确的数据,特别是当一个离线计数器影响计数的整体准确性时,在销售转化、访客计数等方面。如果检索到的数据部分完成或完全完成,则不可见,如果它是没有离线的干净数据
计数器和没有未经验证的数据
建议的解决方案:
- 确保收集的数据得到充分验证
- 确保收集的分行级数据没有因计数器之一离线而丢失数据
- 确保数据完全上传到服务器并获得完整的数据集与销售额进行比较
转变
与现任整合 人流量统计器
用户可以选择将历史数据从现有设备迁移到FootfallCam Analytic Manager中。该过程最多需要一周时间才能基于历史数据生成报告。
但是,此功能当前不公开发布。 如果您想从现有数据中迁移数据 人流量统计器,请发送电子邮件至 FootfallCam销售团队.
数据检索
FootfallCam是一个完全嵌入式的软件模块,适用于需要计算商店人流量的任何环境。 商业智能(BI)系统提取和分析人流量数据(来自FootfallCam中央服务器)以及ePOS数据或员工劳动时间(来自零售商的ePOS系统或员工管理系统),以生成用于公司战略规划的管理报告。 默认情况下,用户可以通过以下几种类型的方法直接从计数器或服务器获取人流数据:
通过API从设备检索数据
步骤1 -产生网址: HTTP://[插入内部IP]/cgi-bin/access_token.cgi?用户名=[插入用户名] &password =[插入密码]
有关如何生成访问令牌的视频链接: https://youtu.be/emDf1yAZhPk
Item | 产品描述 |
内部IP | 检索内部IP。
(信息: 有关内部IP的更多信息,请参阅 第6.2.) |
用户名 | 管理员
(信息: 区分大小写。) |
密码 | (信息: 用于登录的相同密码 计数器安装向导,因此它是反依赖的。 不是 用于登录以对抗 Wi-Fi 的密码) |
步骤2 -运行URL,接收到的访问令牌将显示如下。
网址 | 输出 |
http://192.168.2.123/cgi-bin/access_token.cgi?username=admin&password=[password] |
步骤3 -使用接收到的访问令牌检索数据。 使用以下列出的所选参数生成URL: http://[插入内部IP]/ cgi-bin / apiCount_cgi?data_type =[插入数据类型]&data_format =[插入数据格式]&resolution_min =[插入解决方案分钟]&date_start =[插入日期开始]&date_end =[插入日期结束]&time_start =[插入时间开始]&time_end = [插入时间结束]&access_token =[插入令牌]
产品型号 | 产品描述 | 值 | 样本 |
数据类型 | 数据类型。 | json,xml | data_type = xml |
数据格式 | 数据格式。 | 时,分,秒 | data_format =秒 |
解析分钟 | 分钟数据的分辨率。 | 1,5,10,15,30,60 | resolution_min = 15 |
分辨率第二 | 第二个数据的分辨率。 | 1,5,10,15,30,60 | resolution_sec = 1 |
开始日期 | 数据的开始日期。 | YYYYMMDD | date_start = 20181231 |
日期结束 | 数据的结束日期。 | YYYYMMDD | date_end = 20190131 |
时间开始 | 设置API的开始时间范围 | 嗯嗯 | time_start = 103000 |
时间结束 | 设置API的结束时间范围 | 嗯嗯 | time_end = 223300 |
通过Analytic Manager中的API检索数据
步骤1 -登录分析管理器并从左侧导航栏导航到导出页面 设置 > 出口
步骤2 - 选择 API 标签
步骤3 -为每个字段选择所需的导出选项,然后单击 使用
Item | 产品描述 |
资料汇总 | 选择要导出的数据类型(计数器级别或站点级别)。 然后,它将通过计数器或站点进一步填充下拉列表。 |
时间汇总 | 选择要导出的每小时或每日汇总数据 |
日期范围 | 导出数据的开始和结束日期。 可以在生成的URL中手动调整“ fromdate”和“ todate”,以便于集成。 |
日期格式 | CSV / Excel / TXT导出文件中使用的日期格式 |
步骤4 -点击 复制 按钮以复制URL,以根据所选字段导出数据。 某些参数可以在URL中手动调整(例如:“ fromdate”和“ todate”)。
通过WebSocket检索实时数据
网络套接字客户端
使用此模块,计数数据可以在发生时发送到您的websocket服务器。 如果可以设置一个websocket服务器来接收我们的实时计数数据,请咨询您的IT技术人员。
为此,需要满足以下几个要求:
设置 Websocket 模块
需求 |
|
Websocket服务器地址 |
时间 必须 被承认 OK 收到它们后,FootfallCam计数器将假定发送失败,并继续重新发送相同的数据。 |
基本身份验证(可选) |
用户名和密码 |
在计数器的控制面板中,导航到“设置”选项卡,然后向下滚动以查找“ Websocket模块”。
启用后,您可以填写 Websocket地址 在提供的字段中。 如果 基本认证 如果您的服务器已启用“启用”,则可以切换该选项并填写详细信息。 否则,此选项是可选的。
每次更改设置时, 检查连接 在保存之前必须先单击它,以允许计数器测试连接。
- Websocket服务器应接收带有主题“ generic-test-topic”的JSON测试数据。
- Websocket服务器必须返回“OK".
Websocket模块:数据说明
产品型号 |
产品描述 |
值 |
话题 |
IN / OUT数据将发送到服务器的有效负载名称。 |
ffc-事件原始数据 |
相机系列 |
唯一身份。 (信息: 您可以通过从主页获取芯片组代码来获取CameraSerial。) |
00000000xxxxxxxxx |
事件开始UTC时间 |
UTC时区中的事件开始。 |
YYYY-MM-DD HH:MM:SS |
事件结束UTC时间 |
UTC时区中的事件结束。 |
YYYY-MM-DD HH:MM:SS |
事件开始时间 |
Linux时间戳记中的事件开始时间 |
YYYY-MM-DD HH:MM:SS |
事件结束时间 |
Linux时间戳记中的事件结束时间 |
YYYY-MM-DD HH:MM:SS |
事件开始本地时间 |
活动在当地时间开始。 |
YYYY-MM-DD HH:MM:SS |
事件结束本地时间 |
活动在当地时间结束。 |
YYYY-MM-DD HH:MM:SS |
上传的UTCDateTime |
UTC发布数据要发送的时间。 |
YYYY-MM-DD HH:MM:SS |
上传本地日期时间 |
发布数据要发送的本地时间。 |
YYYY-MM-DD HH:MM:SS |
指标 ID |
To表示触发的事件类型,例如Value IN或Value Out。 |
1 = 值输入 2 = 值输出 |
人员类型 ID |
指示检测到哪种人。 |
1 =访客 2 =员工 |
烂了 |
暂时仅供内部使用。 |
N / A |
人员编号 |
表示正在跟踪人员。 例如,将用不同的ID指示多个人。 |
数字 |
示例1-值输入数据 |
{'Topic':'ffc-eventrawdata','Data':{'EventStartUTCTime':'2020-06-17 03:16:41','EventEndLocalTime':'2020-06-17 11:16:41', 'EventStartTime':1592363801,'MetricId':1,'RoiId':1,'CameraSerial':'000000006afce315','PeopleId':1,'EventEndUTCTime':'2020-06-17 03:16:41',' UploadedLocalDateTime':'2020-06-17 11:16:45','EventEndTime':1592363801,'EventStartLocalTime':'2020-06-17 11:16:41','UploadedUTCDateTime':'2020-06-17 03 :16:45','PeopleTypeId':1}} |
示例2-值OUT数据 |
{'Topic':'ffc-eventrawdata','Data':{'EventStartUTCTime':'2020-06-17 03:20:18','EventEndLocalTime':'2020-06-17 11:20:18', 'EventStartTime':1592364018,'MetricId':2,'RoiId':1,'CameraSerial':'000000006afce315','PeopleId':1,'EventEndUTCTime':'2020-06-17 03:20:18',' UploadedLocalDateTime':'2020-06-17 11:20:21','EventEndTime':1592364018,'EventStartLocalTime':'2020-06-17 11:20:18','UploadedUTCDateTime':'2020-06-17 03 :20:21','PeopleTypeId':1}} |
通过数据集成工具检索数据
下载链接(仅支持 Windows 64 位设备)
构建/发送查询
步骤1 -选择 API类型 (身份验证/小时数据/分钟数据/秒数据/最近60秒数据)。
步骤2 - 填写 必须 字段。
步骤3 - 点击 复制 要复制的图标 询问,或 发送查询 发送按钮 请求.
复制代码片段
步骤1 -选择 API类型 (身份验证/小时数据/分钟数据/秒数据/最近60秒数据)。
步骤2 - 填写 必须 字段。
步骤3 - 选择 语言.
步骤4 - 点击 复制 要复制的图标 代码段.
将计数器链接到本地 WebSocket 服务器
步骤1 - 点击 复制 要复制的图标 本地WebSocket地址.
步骤2 - 导航 计数器安装向导 您希望在Web浏览器中测试WebSocket连接的计数器的数量。
步骤3 - 导航 IT设置 页,然后转到 WebSocket模块 下 进阶IT设定 部分。
步骤4 -切换 WebSocket的 至 “上”.
步骤5 -粘贴到 WebSocket服务器地址 文字输入。
步骤6 -点击 测试连接 按钮。
步骤7 -点击 保存 按钮。
步骤8 -你应该看到 输入/输出数据 (包括测试连接)显示在 响应 in 数据整合工具 应用程序。
通过 FTP 检索数据
FTP直接从柜台
输出时间 | 每天一次 |
最低分辨率 | 每1分钟一次 |
数据展示 | 按计数器级别 |
- 访问 门户 -> 左侧导航栏 -> 设置 -> 公司 左侧菜单栏上的页面
- 滚动到新登录页面中的“从计数器直接导出”部分
- 点击选项 启用 则fTP.
- 填写所需的详细信息:
Item | 产品描述 |
1. FTP配置 | FTP帐户详细信息 |
2。 时间表 | 数据应多久导出一次 |
3.日期格式 | 数据上显示的日期格式 |
4.文件名 | 导出文件的名称 |
5.文件格式 | 导出文件的格式 |
直接从柜台获取FTP的整体流程
来自服务器的 FTP 推送
输出时间 | 每周的每日 |
最低分辨率 | 1小时 |
数据展示 | 按分行级别 |
资料类型 | 输入和输出值,外部流量,上交率,验证和聚合状态 |
输出格式 | .xlsx或.csv格式 |
- 选择 出口中心 在左侧的菜单栏上
- 点击标签 自动导出
- 点击 配置 创建一个新的FTP时间表
- 根据需要填写详细信息
Item |
产品描述 |
1.数据汇总 |
要导出的数据级别以及应该导出的站点 |
2.时间汇总 |
导出数据的时间范围 |
3.日期格式 |
将在导出文件中显示的数据格式 |
4.出口频率 |
出口时间表的频率 |
5.出口类型 |
选择要导出的文件格式 |
6. FTP详细信息 |
输入您的FTP帐户详细信息 |
通过 MQTT 检索数据
通过计数器设置向导设置 MQTT
步骤1 - 登录设备后,在主页上单击设置以前往设置页面。
步骤2 - 在设置页面上。 打开高级 IT 设置下拉菜单。
步骤3 - 前往 MQTT 模块并单击启用 MQTT。
步骤4 - 填写必要的字段并单击下面的“保存更改”上的“保存”。
示例配置
MQTT 代理地址 |
mqtt://broker.hivemq.com:1883 或 mqtt://your.broker.server.com:1883 |
MQTT 客户端 ID |
client_123 #default是设备的ChipSerial |
MQTT主题 | 你的/topic#default设置是/status/{ChipSerial} |
MQTT 最后的意愿 QoS |
0 #send andforget(目前仅支持此QoS) |
MQTT 用户名 | #需要基本身份验证才能建立连接 |
MQTT密码 | #需要基本身份验证才能建立连接 |
示例 1 - 占用数据 |
{
“RoiId”:1,
“CombineObjectTypeId”:1,
“ObjectCount”:0,#1 表示已占用,0 表示无
“时间戳”:1672889540,#UTCtime
"LocalTime": "2023-01-05 11:32:20",
"UTCTime": "2023-01-05 03:32:20",
“OccupancyTypeId”:1,
“对象计数单元”:1,
“相机序列号”:“100000008c76409d”
}
|
示例 2 - 计数数据 |
{
“CombineObjectTypeId”:11,
"EventEndLocalTime": "2022-11-25 04:47:49",
“事件结束时间”:1669351669,
"EventEndUTCTime": "2022-11-25 04:47:49",
"EventStartLocalTime": "2022-11-25 04:47:49",
“事件开始时间”:1669351669,
"EventStartUTCTime": "2022-11-25 04:47:49",
“指标 ID”:2,
“人物编号”:1,
“人物类型”:1,
“RoiId”:1,
“相机序列号”:“000000007b77a260”
}
|
通过 Bacnet 检索数据
步骤1 - 将 FFC 设备连接到 Bacnet 路由器。
步骤2 - 将计算机连接到与 FFC 设备相同的网络。
步骤3 - 通过计数器设置向导配置 FFC 设备的 IP 地址。
步骤4 - 将计算机/主设备连接到 Bacnet 网络 巴克0 协议和端口 47808.
使用 YABE 软件连接的示例设置
步骤5 - 使用设备名称从设备属性中获取数据 FFC 和设备的ID 公司序列号的最后六位数字。
使用 Bacnet 的连接设备示例显示
设备连接到 Bacnet 网络后,计数数据在属性中。 并且有两种类型的数据是 客户体验 和 外客户体验. In-CX 和 Out-CX 分别代表 In count 和 Out count,X 代表 当前时间 - X 小时。 共有96个数据代表 最后 48 小时进出计数 对于设备。
通过 SQL 检索数据
步骤1 - 点击 设置>公司 访问“控制面板设置”页面。
步骤2 -导航到部分 从SQL表中获取数据.
步骤3 -通过输入所有必填字段来完成该过程,然后单击 创建 按钮。
Item | 产品描述 |
1.用户名 | 用于访问FootfallCam Analytic Manager V9™的用户名。 |
2。 密码 | 用于访问FootfallCam数据库服务器的密码。 |
示例于2021-02-25更新:
分析经理用户名 | 分析管理员密码 | SQL Server用户名 | SQL Server密码 |
ABC | 123 | XYZ | 789 |
旧方法: 从functionName('abc','123')中选择*; 执行函数名称('abc','123'); |
|||
新的方法 : 从functionName('abc','789')中选择*; 执行函数名称('abc','789'); |
注意:密码“ 789”仅是示例密码。 出于安全考虑,鼓励用户设置复杂的模式集。
示例1-如何获得计数器列表 | |
产品描述 | 要检索计数器列表和站点信息,包括ID,CameraName,IP,端口,串行。 |
功能名称 | 按分支获取计数器 |
数据参数 | 用户名[nvarchar]; 密码[nvarchar]; Branchid [bigint] |
示例SQL | 选择* FROM GetCounterByBranch('username','password',37); |
样品结果 |
示例2-如何获取站点列表 | |
产品描述 | 要检索站点列表和站点信息,包括BranchCode,BranchName,Region,City,Country,StoreType,Latitude,Longitude和Floorsize。 |
功能名称 | 获取分支列表 |
数据参数 | 用户名[nvarchar]; 密码[nvarchar] |
示例SQL | SELECT * FROM GetBranchList('用户名','密码'); |
样品结果 |
示例3-如何按站点获取每小时计数数据 | |
产品描述 | 要检索站点每小时的计数数据,包括Branchid,ValueIn,ValueOut,OutsideTraffic,TurnInRate。 |
功能名称 | 每小时获取分支 |
数据参数 | 用户名[nvarchar]; 密码[nvarchar]; BranchCode [bigint]; StartDate [datetime]; EndDate [datetime] |
示例SQL | SELECT * FROM GetBranchHourly('用户名','密码',-1,'20150320','20150321'); |
备注 | -1表示所有站点的公司。 |
样品结果 |
示例4-如何按站点获取每日计数数据 | |
产品描述 | 要检索站点每日计数数据,包括Branchid,ValueIn,ValueOut,OutsideTraffic,TurnInRate。 |
功能名称 | 每小时获取分支 |
数据参数 | 用户名[nvarchar]; 密码[nvarchar]; BranchCode [bigint]; StartDate [datetime]; EndDate [datetime] |
示例SQL | SELECT * FROM GetBranchDailySummary('用户名','密码',410,'20140120','20140121'); |
备注 | -1表示所有站点的公司。 |
样品结果 |
架构
通过 PostgreSQL 检索数据
示例 1 - 如何按站点组获取站点组每日数据 | |
产品描述 | 检索 站点组每日数据 按站点组。 |
功能名称 | sitegroup_footfallcounting_day |
示例SQL | 选择时间、FC01_1_SUM、FC02_1_SUM、SiteGroupName FROM sitegroup_footfallcounting_day WHERE SiteGroupId = 'xxx' AND 时间 BETWEEN '2023-09-21' 和 '2023-09-26'; |
样品结果 |
示例 2 - 如何按站点组获取站点组每小时数据 | |
产品描述 | 检索 站点组每小时数据 按站点组。 |
功能名称 | sitegroup_footfallcounting_hour |
示例SQL | 选择时间、FC01_1_SUM、FC02_1_SUM、SiteGroupName FROM sitegroup_footfallcounting_hour WHERE SiteGroupId = 'xxx' AND 时间 BETWEEN '2023-09-21 00:00:00' 和 '2023-09-26 16:00:00'; |
样品结果 |
示例 3 - 如何按站点组获取站点每日数据 | |
产品描述 | 检索 站点每日数据 按站点组。 |
功能名称 | sitegroup_footfallcounting_day |
示例SQL | 选择时间、FC01_1_SUM、FC02_1_SUM、BranchName FROM sitegroup_footfallcounting_day WHERE SiteGroupId = 'xxx' AND 时间 BETWEEN '2023-09-21' 和 '2023-09-26'; |
样品结果 |
示例 4 - 如何按站点组获取站点每小时数据 | |
产品描述 | 检索 站点每小时数据 按站点组。 |
功能名称 | sitegroup_footfallcounting_hour |
示例SQL | 选择时间、FC01_1_SUM、FC02_1_SUM、BranchName FROM sitegroup_footfallcounting_hour WHERE SiteGroupId = 'xxx' AND 时间 BETWEEN '2023-09-21 00:00:00' 和 '2023-09-26 16:00:00'; |
样品结果 |
通过手动导出功能检索数据
步骤1 - 点击 设置>导出 访问“导出”页面。
步骤2 - 点击 手动导出 标签以访问“手动导出”标签。
步骤3 -通过输入所有必填字段来完成该过程,然后单击 CSV/Excel/TXT 按钮。
Item | 产品描述 |
1。 资料汇总 | 选择站点/计数器。 |
2.时间汇总 | 选择数据长度。 |
3.日期范围 | 选择开始日期和结束日期。 |
4.日期格式 | 选择日期格式。 |
5.时间格式 | 选择时间格式。 |
6.文件列 | 下载文件中的列的排列。 (信息: 用户能够重新组织数据列(如果已选择) 习俗 模式。) |
不同的指标可用于数据聚合和时间聚合的不同组合。
通过 Web Portal 上的自动计划检索数据
可以计划数据以根据频率设置自动生成并导出到您的电子邮件。 以下是配置自动导出设置的步骤。
步骤1 - 点击 设置>导出 访问“导出”页面。
步骤2 - 点击 自动导出 标签以访问“手动导出”标签。
步骤3 - 点击 配置 按钮访问“配置自动导出设置”页面。
步骤4 -通过输入所有必填字段来完成该过程,然后单击 保存 按钮。
Item | 产品描述 |
1。 资料汇总 | 选择站点/计数器。 |
2.时间汇总 | 选择数据长度。 |
3.日期格式 | 选择日期格式。 |
4.时间格式 | 选择时间格式。 |
5.出口频率 | 选择导出频率。 |
6.出口类型 | 选择导出格式类型。 (信息:共有3种导出类型:Excel,CSV,TXT) |
7。 电子邮件 | 邮箱 (信息:如果自动导出失败,则通知将发送到此电子邮件。) |
8.导出(电子邮件计划程序) | 导出数据电子邮件的活动时间表。 |
9.您的FTP详细信息 | FTP详细信息以接收导出的文件。 |
10.预先设定 | 包括加密模式和连接类型[e。 |
Power BI 集成
- 然后您将被重定向到 PostgreSQL 登录页面。 填写以下详细信息:-
- 服务器:beta-cube.footfallcam.com:6543
- 数据库:postgres
- 数据连接方式:DirectQuery
- 然后点击确定,您将被引导至用户登录页面
- 请通过支持门户联系 FootfallCam 支持以请求用户凭据。
销售数据整合
准备进口销售文件
必须遵守导入文件的要求如下:
Item |
产品描述 |
文件格式 |
逗号分隔值(.csv) |
1.商店代码 |
StoreCode必须与FootfallCam Analytic Manager V9™中的站点代码匹配。 (信息: 有关站点代码的更多信息,请参阅 4.5管理站点详细信息.) |
2. 日期时间 |
DateTime的格式必须为 DD-MM-YYYY hh:mm. |
3. 总交易量 |
TotalTransactionQty是客户进行的交易次数,其格式必须为 完整的号码 并且没有任何特殊字符。 |
4. 总交易价值 |
TotalTransactionValue是已收到的付款金额,格式必须为 数字 最多2个小数位,没有任何特殊字符。 |
TotalTransactionQty和TotalTransactionValue可以根据以下示例按小时汇总:
汇总之前 | 聚合后[可选] |
导入销售文件选项
选项2-自动导入 |
||||||||||||||||||
步骤1 - 点击 设置>导入 访问“导入”页面。 步骤2 - 点击 自动上传 标签以访问“自动上传”标签。 步骤3 - 点击 配置 进入“配置自动导入设置”页面。 步骤4 -通过输入所有必填字段来完成该过程,然后单击 测试 按钮以确保过程成功运行。 步骤5 - 点击 保存 按钮完成该过程。
|
导入销售文件历史
步骤1 - 点击 设置>导入 访问“导入”页面。
步骤2 - 点击 自动上传 标签以访问“自动上传”标签。
步骤3 -选择要管理的导入数据类型,然后单击 编辑.
步骤4 -导航至页面底部的导入历史记录日志。
步骤5 - 点击 下载日志 查看导入状态的详细信息。
汇入成功 |
导入失败 |
自定义销售数据导入
请填写 这种形式 并发送回使用足够的信息。我们的技术人员将就集成的下一步与您联系。
常见问题
问题 1:您如何确保 API 是安全的?
- 需要通过用户名和密码访问 SQL Server API
- 密码被存储为加密字符串,只能使用 SQL Server 内部的密钥解密,并且该密钥对用户隐藏
- 用于检索数据的 REST API 调用也需要使用加密的访问令牌进行调用
- 服务器的所有者可以为 SQL Server 选择防火墙阻止和 IP 白名单,以进一步增强服务器的安全性
- 不会使用默认端口来防止黑客劫持
问题 2:FootfallCam 如何处理 API 请求和响应的巨大流量?
流量处理由 Microsoft SQL Server 执行,FootfallCam 没有其他处理。 但是 FootfallCam 为数据拉取 (API) 提供的数据库脚本已经进行了微调,以防止出现瓶颈。