本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
透過行銷活動收集和傳輸資料
促銷活動是資料收集規則的協調流程。行銷活動提供 AWS IoT Edge Agent FleetWise 軟體指示,說明如何選取、收集資料並將資料傳輸到雲端。
您可以在雲端中建立活動。在您或您的團隊核准行銷活動之後,AWSIoT FleetWise 會自動將其部署到車輛上。您可以選擇將戰役部署到車輛或車隊。在將執行中的行銷活動部署到車輛之前,Edge Agent 軟體不會開始收集資料。
注意
在您擁有以下情況之前,廣告系列將無法運作。
-
邊緣代理程式軟體正在您的車輛中執行。如需有關如何開發、安裝和使用 Edge Agent 軟體的詳細資訊,請執行下列動作。
-
導覽至 AWSIoT FleetWise 主控台
。 -
在服務首頁的 [開始使用 AWS IoT] FleetWise 區段中,選擇 [探索 Edge 代理程式]。
-
-
您已設定AWS IoT Core為配置您的車輛。如需詳細資訊,請參閱提供車輛。
每個廣告系列都包含以下信息。
signalCatalogArn
-
與活動相關聯的信號目錄的 Amazon 資源名稱 (ARN)。
- (選用)
tags
-
標記是可用來管理促銷活動的中繼資料。您可以將相同標籤指派給來自不同服務的資源,以指出資源是相關的。
TargetArn
-
部署活動之車輛或機群的 ARN。
name
-
有助於識別促銷活動的唯一名稱。
collectionScheme
-
資料收集配置會針對要收集的資料或何時收集資料提供 Edge Agent 軟體指示。 AWSIoT FleetWise 目前支持基於條件的收集方案和基於時間的收集方案。
conditionBasedCollectionScheme
-
以條件為基礎的收集配置使用邏輯運算式來識別要收集的資料。Edge 代理程式軟體會在符合條件時收集資料。
expression
-
用來識別要收集哪些資料的邏輯運算式。例如,如果指定了
$variable.`myVehicle.InVehicleTemperature` > 50.0
運算式,Edge Agent 軟體會收集大於 50.0 的溫度值。如需如何撰寫表示式的指示,請參閱促銷活動的邏輯運算。 - (選擇性)
triggerMode
可以是下列其中一個值。 -
-
RISING_EDGE
— 只有在第一次符合條件時,Edge Agent 軟體才會收集資料。例如$variable.`myVehicle.AirBagDeployed` == true
。 -
ALWAYS
— Edge 代理程式軟體會在符合條件時收集資料。
-
- (選用)
minimumTriggerIntervalMs
-
兩個資料收集事件之間的最短持續時間,以毫秒為單位。如果訊號經常變更,您可能會以較慢的速率收集資料。
- (選用)
conditionLanguageVersion
-
條件運算式語言的版本。
timeBasedCollectionScheme
-
當您定義以時間為基礎的收集配置時,請指定以毫秒為單位的時間週期。Edge 代理程式軟體會使用期間來決定收集資料的頻率。例如,如果時間週期為 120,000 毫秒,Edge Agent 軟體會每兩分鐘收集一次資料。
- (選用)
compression
-
若要節省無線頻寬並減少網路流量,您可以指定 SNAPPY
來壓縮車輛中的資料。 依預設 (
OFF
),Edge 代理程式軟體不會壓縮資料。 dataDestinationConfigs
-
選擇廣告活動要傳送車輛資料的目的地。您可以選擇將資料存放在 Amazon S3 或 Amazon Timestream 中。
S3 是符合成本效益的資料儲存機制,可提供持久的資料管理功能和下游資料服務。您可以將 S3 用於與駕駛行為或分析長期維護相關的資料。
Timestream 是一種數據持久性機制,可以幫助您以近乎實時的方式識別趨勢和模式。您可以使用 Timestream 處理時間序列資料,例如分析車速或煞車的歷史趨勢。
- (選用)
dataExtraDimensions
-
您可以加入一個或多個屬性,以提供信號的其他資訊。
- (選用)
description
-
您可以新增說明以協助識別廣告活動的用途。
- (選用)
diagnosticsMode
-
將診斷模式設定為時
SEND_ACTIVE_DTCS
,促銷活動會傳送儲存的標準診斷故障代碼 (DTC),以協助識別您的車輛出現問題。例如,P0097 表示引擎控制模組 (ECM) 已判定進氣溫度感測器 2 (IAT2) 輸入低於正常感測器範圍。依預設 (
OFF
),Edge 代理程式軟體不會傳送診斷代碼。 - (選用)
expiryTime
-
您可以定義廣告活動的到期日。促銷活動到期時,Edge Agent 軟體會停止收集此促銷活動中指定的資料。如果將多個行銷活動部署至車輛,Edge Agent 軟體會使用其他行銷活動來收集資料。
預設值:
253402243200
(一九九九九年十二月三十一日,世界標準時間 00:00:00) - (選用)
postTriggerCollectionDuration
-
您可以定義觸發後收集持續時間,以便 Edge Agent 軟體在呼叫配置之後,持續收集指定期間的資料。例如,如果呼叫具有下列運算式的條件式收集配置:
$variable.`myVehicle.Engine.RPM` > 7000.0
,Edge Agent 軟體會繼續收集引擎的每分鐘轉數 (RPM) 值。即使 RPM 只高於 7000 一次,也可能表明存在機械問題。在此情況下,您可能希望 Edge Agent 軟體繼續收集資料,以協助監視狀況。預設值:
0
- (選用)
priority
-
您可以指定整數來表示促銷活動的優先順序層級。數量較小的促銷活動是較高的優先順序。如果您在車輛上部署多個行銷活動,則會先啟動優先順序較高的廣告活動。
預設值:
0
- (選用)
signalsToCollect
-
呼叫資料收集方案時,從中收集資料的訊號清單。
重要
必須在此欄位中指定以條件為基礎的收集配置的運算式中使用的信號。
name
-
呼叫資料收集方案時,從中收集資料的訊號名稱。
- (選用)
maxSampleCount
-
呼叫資料收集配置時,Edge Agent 軟體收集並傳輸至雲端的資料範例數目上限。
- (選用)
minimumSamplingIntervalMs
-
兩個資料樣本收集事件之間的最短持續時間,以毫秒為單位。如果訊號經常變更,您可以使用此參數以較慢的速率收集資料。
有效範圍:
- (選用)
spoolingMode
-
如果設定
spoolingMode
為TO_DISK
,則當車輛未連線至雲端時,Edge Agent 軟體會暫時在本機儲存資料。重新建立連線後,儲存在本機的資料會自動傳輸到雲端。預設值:
OFF
- (選用)
startTime
-
核准的行銷活動會在開始時間啟用。
預設值:
0
廣告活動的狀態可以是下列其中一個值。
-
CREATING
— AWS IoT FleetWise 正在處理您的請求以創建廣告系列。 -
WAITING_FOR_APPROVAL
— 建立行銷活動後,它會進入WAITING_FOR_APPROVAL
狀態。若要核准行銷活動,請使用UpdateCampaign
API 作業。行銷活動核准後,AWSIoT FleetWise 會自動將行銷活動部署到目標車輛或車隊。如需詳細資訊,請參閱更新行銷活動 (AWS CLI)。 -
RUNNING
— 該活動是活動. -
SUSPENDED
— 活動已暫停。若要繼續宣傳活動,請使用UpdateCampaign
API 作業。
AWSIoT FleetWise 提供下列 API 作業,您可以用來建立和管理行銷活動。
-
CreateCampaign-創建一個新的廣告系列。
-
UpdateCampaign— 更新現有的行銷活動。建立宣傳活動後,您必須使用此 API 作業來核准行銷活動。
-
DeleteCampaign— 刪除現有的行銷活動。
-
ListCampaigns— 擷取所有行銷活動摘要的分頁清單。
-
GetCampaign— 擷取有關行銷活動的資訊。