地理圍欄和信標事件變數

地理圍欄信標的進入與退出事件是您可以在 REI 中管理並在方案中使用的位置型事件。針對每個事件,Oracle Responsys 可讓應用程式開發人員使用事件 API,從應用程式傳遞高達 5 個選擇性的索引鍵值組。這些索引鍵職組可協助行銷人員和應用程式開發人員擴充標準現有事件的功能。在 SDK 端,會將每個索引鍵職組以字串的形式傳送,此字串最長可達 256 個字元。若要進一步瞭解如何在 API 呼叫中一併傳遞此選擇性資料,請參閱這裡

在 Responsys 平台端,行銷人員必須透過新增額外的自訂變數 (搭配所需的屬性名稱和類型) 來延伸 REI 事件。REI 事件引發後,自訂變數會在方案中作為方案事件變數

地理圍欄進入記錄

事件時間戳記和來源

方案事件變數名稱 方案事件變數資料類型 描述 必要欄位
RSYS_GEN_TIME 日期/時間 觸發此事件時裝置上的時間 (UTC 時區)

必要

RSYS_GEN_SOURCE 文字 (長度上限為 256 個字元) 事件的來源。應用程式開發人員可以選擇此屬性來包含詳細資料,例如他們所互動之地理圍欄和信標 SDK/解決方案的名稱,或是信標硬體的名稱。 選擇性

地區

方案事件變數名稱 方案事件變數資料類型 描述 必要欄位
RSYS_GEN_ZONE_ID 文字 (長度上限為 256 個字元) 區域/地區的 ID。區域或地區代表行銷人員想要監看之區域的邏輯界限。通常在位置型服務產品中,地理圍欄和信標會包含在區域或地區內。 選擇性
RSYS_GEN_ZONE_NAME 文字 (長度上限為 256 個字元) 區域/地區的名稱。區域或地區代表行銷人員想要監看之區域的邏輯界限。通常在位置型服務產品中,地理圍欄和信標會包含在區域或地區內。 選擇性

地理圍欄

方案事件變數名稱 方案事件變數資料類型 描述 必要欄位
RSYS_GEN_FENCE_ID 文字 (長度上限為 256 個字元) 地理圍欄的 ID 必要
RSYS_GEN_FENCE_NAME 文字 (長度上限為 256 個字元) 地理圍欄的名稱 必要

裝置動作

方案事件變數名稱 方案事件變數資料類型 描述 必要欄位
RSYS_GEN_DEVICE_SPEED 數值 觸發地理圍欄轉換時裝置的速度。單位取決於應用程式所使用的地理圍欄 SDK/解決方案。 選擇性
RSYS_GEN_DEVICE_BEARING 數值 觸發地理圍欄轉換時裝置的方位/行進方向。方位通常是水平行進方向,且以度為測量單位。 選擇性

地理圍欄退出記錄

事件時間戳記和來源

方案事件變數名稱 方案事件變數資料類型 描述 必要欄位
RSYS_GEX_TIME 日期/時間 觸發此事件時裝置上的時間 (UTC 時區) 必要
RSYS_GEX_SOURCE 文字 (長度上限為 256 個字元) 事件的來源。應用程式開發人員可以選擇此屬性來包含詳細資料,例如他們所互動之地理圍欄和信標 SDK/解決方案的名稱,或是信標硬體的名稱。 選擇性

地區

方案事件變數名稱 方案事件變數資料類型 描述 必要欄位
RSYS_GEX_ZONE_ID 文字 (長度上限為 256 個字元) 區域/地區的 ID。區域或地區代表行銷人員想要監看之區域的邏輯界限。通常在位置型服務產品中,地理圍欄和信標會包含在區域或地區內。 選擇性
RSYS_GEX_ZONE_NAME 文字 (長度上限為 256 個字元) 區域/地區的名稱
區域或地區代表行銷人員想要監看之區域的邏輯界限。通常在位置型服務產品中,地理圍欄和信標會包含在區域或地區內。
選擇性

地理圍欄

方案事件變數名稱 方案事件變數資料類型 描述 必要欄位
RSYS_GEX_FENCE_ID 文字 (長度上限為 256 個字元) 地理圍欄的 ID 必要
RSYS_GEX_FENCE_NAME 文字 (長度上限為 256 個字元) 地理圍欄的名稱 必要

停留時間

方案事件變數名稱 方案事件變數資料類型 描述 必要欄位
RSYS_GEX_DWELL_TIME 整數 在地理圍欄內花費的時間 (以分鐘/秒為單位)。停留時間的單位取決於應用程式所使用的解決方案。 選擇性

信標進入記錄

事件時間戳記和來源

方案事件變數名稱 方案事件變數資料類型 描述 必要欄位
RSYS_BEN_TIME 日期/時間 觸發此事件時裝置上的時間 (UTC 時區) 必要
RSYS_BEN_SOURCE 文字 (長度上限為 256 個字元) 事件的來源。應用程式開發人員可以選擇此屬性來包含詳細資料,例如他們所互動之地理圍欄和信標 SDK/解決方案的名稱,或是信標硬體的名稱。 選擇性

地區

方案事件變數名稱 方案事件變數資料類型 描述 必要欄位
RSYS_BEN_ZONE_ID 文字 (長度上限為 256 個字元) 區域/地區的 ID。區域或地區代表行銷人員想要監看之區域的邏輯界限。通常在位置型服務產品中,地理圍欄和信標會包含在區域或地區內。 選擇性
RSYS_BEN_ZONE_NAME 文字 (長度上限為 256 個字元) 區域/地區的名稱
區域或地區代表行銷人員想要監看之區域的邏輯界限。通常在位置型服務產品中,地理圍欄和信標會包含在區域或地區內。
選擇性

信標

方案事件變數名稱 方案事件變數資料類型 描述 必要欄位
RSYS_BEN_BEACON_ID 文字 (長度上限為 256 個字元) 信標的 ID 必要
RSYS_BEN_BEACON_NAME 文字 (長度上限為 256 個字元) 信標的名稱 必要
RSYS_BEN_BEACON_TAG 文字 (長度上限為 256 個字元) 任何將此信標進一步分類的標記 選擇性

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 個字元) 使用者/裝置與信標的鄰近性。可能的值為:緊鄰 (I)、靠近 (N)、遠距 (F)、未知 (U) 選擇性

信標退出記錄

事件時間戳記和來源

方案事件變數名稱 方案事件變數資料類型 描述 必要欄位
RSYS_BEX_TIME 日期/時間 觸發此事件時裝置上的時間 (UTC 時區) 必要
RSYS_BEX_SOURCE 文字 事件的來源。應用程式開發人員可以選擇此屬性來包含詳細資料,例如他們所互動之地理圍欄和信標 SDK/解決方案的名稱,或是信標硬體的名稱。 選擇性

地區

方案事件變數名稱 方案事件變數資料類型 描述 必要欄位
RSYS_BEX_ZONE_ID 文字 (長度上限為 256 個字元) 區域/地區的 ID。區域或地區代表行銷人員想要監看之區域的邏輯界限。通常在位置型服務產品中,地理圍欄和信標會包含在區域或地區內。 選擇性
RSYS_BEX_ZONE_NAME 文字 (長度上限為 256 個字元) 區域/地區的名稱
區域或地區代表行銷人員想要監看之區域的邏輯界限。通常在位置型服務產品中,地理圍欄和信標會包含在區域或地區內。
選擇性

信標

方案事件變數名稱 方案事件變數資料類型 描述 必要欄位
RSYS_BEX_BEACON_ID 文字 (長度上限為 256 個字元) 信標的 ID 必要
RSYS_BEX_BEACON_NAME 文字 (長度上限為 256 個字元) 信標的名稱 必要
RSYS_BEX_BEACON_TAG 文字 (長度上限為 256 個字元) 任何將此信標進一步分類的標記 選擇性

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 整數 在信標鄰近性中花費的時間 (以分鐘/秒為單位)。停留時間的單位取決於應用程式所使用的解決方案。 選擇性

相關內容

Program, geofence, beacon, REI, responsys event interface, event interface, geofence_entry, geofence_exit, beacon_entry, beacon_exit, event variable, data type, entry, exit, 方案, 地理圍欄, 信標, Responsys 事件介面, 事件介面, geofence_entry, geofence_exit, beacon_entry, beacon_exit, 事件變數, 資料類型, 進入記錄, 退出