Geofence 和 Beacon 事件变量

GeofenceBeacon 进入和退出事件是基于位置的事件,可以在 REI 中管理并用于方案。对于每个事件,Oracle Responsys 允许应用程序开发人员使用事件 API 从应用程序最多传递 5 个可选键-值对。这些键-值对帮助营销人员和应用程序开发人员扩展标准现成可用事件的功能。在 SDK 端,每个键-值对都以字符串形式传递,最多 256 个字符。单击此处,可以了解有关在 API 调用中传递此可选数据的更多信息。

在 Responsys 平台端,营销人员必须通过添加其他自定义变量(具有所需属性名称和属性)来扩展 REI 事件。引发 REI 事件时,可在方案中作为方案事件变量使用自定义变量。

Geofence 进入

事件时间戳和源

方案事件变量名称 方案事件变量数据类型 描述 必填字段
RSYS_GEN_TIME 日期/时间 触发此事件时设备上的时间(UTC 时区)

必需

RSYS_GEN_SOURCE 文本(最大长度为 256 个字符) 事件的源。应用程序开发人员可以选择使用此属性来包括详细信息,例如他们已经集成的 Geofence 和 Beacon SDK/解决方案的名称或者 Beacon 硬件的名称。 可选

区域

方案事件变量名称 方案事件变量数据类型 描述 必填字段
RSYS_GEN_ZONE_ID 文本(最大长度为 256 个字符) 地区/区域的 ID。地区或区域表示营销人员要监视的区域的逻辑边界。通常在基于位置的服务产品中,Geofence 和 Beacon 包括在地区或区域中。 可选
RSYS_GEN_ZONE_NAME 文本(最大长度为 256 个字符) 地区/区域的名称。地区或区域表示营销人员要监视的区域的逻辑边界。通常在基于位置的服务产品中,Geofence 和 Beacon 包括在地区或区域中。 可选

Geofence

方案事件变量名称 方案事件变量数据类型 描述 必填字段
RSYS_GEN_FENCE_ID 文本(最大长度为 256 个字符) Geofence 的 ID 必需
RSYS_GEN_FENCE_NAME 文本(最大长度为 256 个字符) Geofence 的名称 必需

设备移动

方案事件变量名称 方案事件变量数据类型 描述 必填字段
RSYS_GEN_DEVICE_SPEED 数字 触发 Geofence 转换时设备的速度。单位取决于应用程序使用的 Geofence SDK/解决方案。 可选
RSYS_GEN_DEVICE_BEARING 数字 触发 Geofence 转换时设备前进的方位/方向。方位通常是前进的水平方向,以度为单位进行计量。 可选

Geofence 退出

事件时间戳和源

方案事件变量名称 方案事件变量数据类型 描述 必填字段
RSYS_GEX_TIME 日期/时间 触发此事件时设备上的时间(UTC 时区) 必需
RSYS_GEX_SOURCE 文本(最大长度为 256 个字符) 什么是事件的源。应用程序开发人员可以选择使用此属性来包括详细信息,例如他们已经集成的 Geofence 和 Beacon SDK/解决方案的名称或者 Beacon 硬件的名称。 可选

区域

方案事件变量名称 方案事件变量数据类型 描述 必填字段
RSYS_GEX_ZONE_ID 文本(最大长度为 256 个字符) 地区/区域的 ID。地区或区域表示营销人员要监视的区域的逻辑边界。通常在基于位置的服务产品中,Geofence 和 Beacon 包括在地区或区域中。 可选
RSYS_GEX_ZONE_NAME 文本(最大长度为 256 个字符) 地区/区域的名称。
地区或区域表示营销人员要监视的区域的逻辑边界。通常在基于位置的服务产品中,Geofence 和 Beacon 包括在地区或区域中。
可选

Geofence

方案事件变量名称 方案事件变量数据类型 描述 必填字段
RSYS_GEX_FENCE_ID 文本(最大长度为 256 个字符) Geofence 的 ID 必需
RSYS_GEX_FENCE_NAME 文本(最大长度为 256 个字符) Geofence 的名称 必需

停留时间

方案事件变量名称 方案事件变量数据类型 描述 必填字段
RSYS_GEX_DWELL_TIME 整数 在 Geofence 内所用的时间(以分钟/秒为单位)。停留时间的单位取决于应用程序使用的解决方案。 可选

Beacon 进入

事件时间戳和源

方案事件变量名称 方案事件变量数据类型 描述 必填字段
RSYS_BEN_TIME 日期/时间 触发此事件时设备上的时间(UTC 时区) 必需
RSYS_BEN_SOURCE 文本(最大长度为 256 个字符) 什么是事件的源。应用程序开发人员可以选择使用此属性来包括详细信息,例如他们已经集成的 Geofence 和 Beacon SDK/解决方案的名称或者 Beacon 硬件的名称。 可选

区域

方案事件变量名称 方案事件变量数据类型 描述 必填字段
RSYS_BEN_ZONE_ID 文本(最大长度为 256 个字符) 地区/区域的 ID。地区或区域表示营销人员要监视的区域的逻辑边界。通常在基于位置的服务产品中,Geofence 和 Beacon 包括在地区或区域中。 可选
RSYS_BEN_ZONE_NAME 文本(最大长度为 256 个字符) 地区/区域的名称。
地区或区域表示营销人员要监视的区域的逻辑边界。通常在基于位置的服务产品中,Geofence 和 Beacon 包括在地区或区域中。
可选

Beacon

方案事件变量名称 方案事件变量数据类型 描述 必填字段
RSYS_BEN_BEACON_ID 文本(最大长度为 256 个字符) Beacon 的 ID 必需
RSYS_BEN_BEACON_NAME 文本(最大长度为 256 个字符) Beacon 的名称 必需
RSYS_BEN_BEACON_TAG 文本(最大长度为 256 个字符) 对此 Beacon 进行进一步分类的任何标记 可选

iBeaconIdentifier

方案事件变量名称 方案事件变量数据类型 描述 必填字段
RSYS_BEN_IBEACON_UUID 文本(最大长度为 256 个字符) iBeacon UUID 可选
RSYS_BEN_IBEACON_MAJOR 整数 iBeacon(主要) 可选
RSYS_BEN_IBEACON_MINOR 整数 iBeacon(次要) 可选

EddystoneIdentifier

方案事件变量名称 方案事件变量数据类型 描述 必填字段
RSYS_BEN_EDDY_ID1 文本(最大长度为 256 个字符) Eddystone 或其他协议 ID1 可选
RSYS_BEN_EDDY_ID2 文本(最大长度为 256 个字符) Eddystone 或其他协议 ID2 可选

邻近

方案事件变量名称 方案事件变量数据类型 描述 必填字段
RSYS_BEN_PROXIMITY 文本(最大长度为 256 个字符) 用户/设备与 Beacon 的邻近距离。可能值为:邻近 (I)、附近 (N)、遥远 (F)、未知 (U) 可选

Beacon 退出

事件时间戳和源

方案事件变量名称 方案事件变量数据类型 描述 必填字段
RSYS_BEX_TIME 日期/时间 触发此事件时设备上的时间(UTC 时区) 必需
RSYS_BEX_SOURCE 文本 什么是事件的源。应用程序开发人员可以选择使用此属性来包括详细信息,例如他们已经集成的 Geofence 和 Beacon SDK/解决方案的名称或者 Beacon 硬件的名称。 可选

区域

方案事件变量名称 方案事件变量数据类型 描述 必填字段
RSYS_BEX_ZONE_ID 文本(最大长度为 256 个字符) 地区/区域的 ID。地区或区域表示营销人员要监视的区域的逻辑边界。通常在基于位置的服务产品中,Geofence 和 Beacon 包括在地区或区域中。 可选
RSYS_BEX_ZONE_NAME 文本(最大长度为 256 个字符) 地区/区域的名称。
地区或区域表示营销人员要监视的区域的逻辑边界。通常在基于位置的服务产品中,Geofence 和 Beacon 包括在地区或区域中。
可选

Beacon

方案事件变量名称 方案事件变量数据类型 描述 必填字段
RSYS_BEX_BEACON_ID 文本(最大长度为 256 个字符) Beacon 的 ID 必需
RSYS_BEX_BEACON_NAME 文本(最大长度为 256 个字符) Beacon 的名称 必需
RSYS_BEX_BEACON_TAG 文本(最大长度为 256 个字符) 对此 Beacon 进行进一步分类的任何标记 可选

iBeaconIdentifier

方案事件变量名称 方案事件变量数据类型 描述 必填字段
RSYS_BEX_IBEACON_UUID 文本(最大长度为 256 个字符) iBeacon UUID 可选
RSYS_BEX_IBEACON_MAJOR 整数 iBeacon(主要) 可选
RSYS_BEX_IBEACON_MINOR 整数 iBeacon(次要) 可选

EddystoneIdentifier

方案事件变量名称 方案事件变量数据类型 描述 必填字段
RSYS_BEX_EDDY_ID1 文本(最大长度为 256 个字符) Eddystone 或其他协议 ID1 可选
RSYS_BEX_EDDY_ID2 文本(最大长度为 256 个字符) Eddystone 或其他协议 ID2 可选

停留时间

方案事件变量名称 方案事件变量数据类型 描述 必填字段
RSYS_BEX_DWELL_TIME 整数 在 Beacon 邻近范围内所用的时间(以分钟/秒为单位)。停留时间的单位取决于应用程序使用的解决方案。 可选

相关主题

方案, geofence, beacon, REI, responsys 事件界面, 事件界面, geofence_entry, geofence_exit, beacon_entry, beacon_exit, 事件变量, 数据类型, 进入点, 退出