本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
使用行銷活動收集 AWS IoT FleetWise 資料
重要
某些 AWS IoT FleetWise 功能的存取目前受到鎖定。如需詳細資訊，請參閱AWSAWS IoT FleetWise 中的區域和功能可用性。
行銷活動是資料收集規則的協調。行銷活動會提供 Edge Agent for AWS IoT FleetWise 軟體指示，說明如何選取、收集資料並將資料傳輸至雲端。
您可以在雲端中建立活動。在您或您的團隊核准行銷活動後， AWS IoT FleetWise 會將行銷活動設定為準備好部署，並在下次車輛進廠時部署。您可以選擇將行銷活動部署到車輛或機群。在將執行中的行銷活動部署到車輛之前，Edge Agent 軟體不會開始收集資料。
重要
除非您有以下項目，否則行銷活動將無法運作。
-
Edge Agent 軟體正在您的 車輛中執行。如需如何開發、安裝和使用 Edge Agent 軟體的詳細資訊，請執行下列動作。
-
在服務首頁的開始使用 AWS IoT FleetWise 區段中，選擇探索邊緣代理程式。
-
您已設定 AWS IoT Core 來佈建您的 車輛。如需詳細資訊，請參閱Provision AWS IoT FleetWise 車輛。
注意
您也可以 監控您車輛的最後已知狀態（而非機群） 近乎即時地使用狀態範本，可讓您使用「變更中」或「定期」更新策略串流遙測資料。此功能也提供「隨需」功能，以啟用或停用先前部署的範本，或一次性請求目前的車輛狀態 （擷取）。
目前已封鎖對最後一個已知狀態的存取。如需詳細資訊，請參閱AWSAWS IoT FleetWise 中的區域和功能可用性。
每個行銷活動都包含下列資訊。
signalCatalogArn-
與行銷活動相關聯之訊號目錄的 Amazon Resource Name (ARN)。
- (選用)
tags -
標籤是可用於管理行銷活動的中繼資料。您可以將相同的標籤指派給來自不同 服務的資源，以指出資源是相關的。
TargetArn-
部署活動之車輛或機群的 ARN。
name-
有助於識別行銷活動的唯一名稱。
collectionScheme-
資料收集方案為 Edge Agent 軟體提供有關要收集哪些資料或何時收集資料的說明。 AWS IoT FleetWise 目前支援以條件為基礎的收集方案和以時間為基礎的收集方案。
-
conditionBasedCollectionScheme– 條件型收集機制使用邏輯表達式來識別要收集的資料。Edge Agent 軟體會在滿足條件時收集資料。-
expression– 用來辨識要收集哪些資料的邏輯表達式。例如，如果指定$variable.`myVehicle.InVehicleTemperature` > 50.0表達式，Edge Agent 軟體會收集大於 50.0 的溫度值。如需如何撰寫表達式的說明，請參閱 AWS IoT FleetWise 行銷活動的邏輯表達式。 -
（選用）
conditionLanguageVersion– 條件式表達式語言的版本。 -
（選用）
minimumTriggerIntervalMs– 兩個資料收集事件之間的最短持續時間，以毫秒為單位。如果訊號經常變更，您可能會以較慢的速度收集資料。 -
（選用）
triggerMode– 可以是下列其中一個值：-
RISING_EDGE– Edge Agent 軟體只會在第一次符合條件時收集資料。例如$variable.`myVehicle.AirBagDeployed` == true。 -
ALWAYS– Edge Agent 軟體會在符合條件時收集資料。
-
-
-
timeBasedCollectionScheme– 當您定義以時間為基礎的收集方案時，請以毫秒為單位指定時段。Edge Agent 軟體會使用期間來決定收集資料的頻率。例如，如果時段為 120，000 毫秒，Edge Agent 軟體會每兩分鐘收集資料一次。-
periodMs– 決定收集資料頻率的期間 （以毫秒為單位）。
-
-
- (選用)
compression -
若要節省無線頻寬並減少網路流量，您可以指定 SNAPPY
來壓縮車輛中的資料。 根據預設 (
OFF)，Edge Agent 軟體不會壓縮資料。 dataDestinationConfigs-
選擇行銷活動將傳輸車輛資料的單一目的地。您可以將資料傳送至 MQTT 主題，或將其存放在 Amazon S3 或 Amazon Timestream 中。
MQTT （訊息佇列遙測傳輸） 是一種輕量且廣泛採用的訊息通訊協定。您可以將資料發佈至 MQTT 主題，以使用 AWS IoT rule. AWS IoT support for MQTT 以 MQTT v3.1.1 規格
和 MQTT v5.0 規格 為基礎，但有一些差異。如需詳細資訊，請參閱 MQTT 差異。 S3 可以是經濟實惠的資料儲存機制，可提供持久的資料管理功能和下游資料服務。您可以使用 S3 處理與駕駛行為或分析長期維護相關的資料。
Timestream 是一種資料持久性機制，可協助您近乎即時地識別趨勢和模式。您可以使用 Timestream 處理時間序列資料，例如分析車輛速度或煞車的歷史趨勢。
注意
Amazon Timestream 不適用於亞太區域 （孟買） 區域。
- (選用)
dataExtraDimensions -
您可以新增一或多個屬性，以提供訊號的其他資訊。
- (選用)
dataPartitions -
建立資料分割區以暫時將訊號資料存放在車輛上。您可以設定將資料轉送至雲端的時間和方式。
-
透過定義最大儲存大小、最短存留時間和儲存位置，指定 AWS IoT FleetWise 如何在車輛或機群上儲存資料。
-
行銷活動
spoolingMode必須為TO_DISK。 -
上傳組態包括定義條件語言的版本和邏輯表達式。
-
- (選用)
description -
新增描述以協助識別行銷活動的目的。
- (選用)
diagnosticsMode -
當診斷模式設定為 時
SEND_ACTIVE_DTCS，行銷活動會傳送已儲存的標準診斷故障碼 (DTCs)，以協助識別您車輛的問題。例如，P0097 表示引擎控制模組 (ECM) 已判斷吸入空氣溫度感應器 2 (IAT2) 輸入低於正常感應器範圍。根據預設 (
OFF)，Edge Agent 軟體不會傳送診斷代碼。 - (選用)
expiryTime -
定義行銷活動的過期日期。當行銷活動到期時，Edge Agent 軟體會停止收集此行銷活動中指定的資料。如果車輛部署了多個行銷活動，Edge Agent 軟體會使用其他行銷活動來收集資料。
預設值：
253402243200(12 月 31 日，9999，00：00：00 UTC) - (選用)
postTriggerCollectionDuration -
您可以定義觸發後收集持續時間，以便 Edge Agent 軟體在調用方案後繼續收集資料一段指定的期間。例如，如果叫用具有下列表達式的條件型集合結構描述：
$variable.`myVehicle.Engine.RPM` > 7000.0，則 Edge Agent 軟體會繼續收集引擎的每分鐘轉數 (RPM) 值。即使 RPM 只高於 7000 次，也可能表示發生機械問題。在這種情況下，您可能希望 Edge Agent 軟體繼續收集資料，以協助監控條件。預設值：
0 - (選用)
priority -
指定整數以指示行銷活動的優先順序層級。數量較小的行銷活動具有較高的優先順序。如果您將多個行銷活動部署到車輛，則會先啟動優先順序較高的行銷活動。
預設值：
0 - (選用)
signalsToCollect -
叫用資料收集方案時從中收集資料的訊號清單。
-
name– 叫用資料收集結構描述時從中收集資料的訊號名稱。 -
dataPartitionId– 要在訊號中使用的資料分割區 ID。ID 必須符合 中提供的其中一個 IDsdataPartitions。如果您上傳訊號做為資料分割區中的條件，則這些相同的訊號必須包含在 中signalsToCollect。 -
（選用）
maxSampleCount– Edge Agent 軟體在叫用資料收集方案時收集並傳輸到雲端的資料樣本數量上限。 -
（選用）
minimumSamplingIntervalMs– 兩個資料範例收集事件之間的最短持續時間，以毫秒為單位。如果訊號經常變更，您可以使用此參數以較慢的速度收集資料。有效範圍：0‐4294967295
-
- (選用)
spoolingMode -
如果
spoolingMode設定為TO_DISK，則 Edge Agent 軟體會在車輛未連線至雲端時暫時將資料存放在本機。重新建立連線後，本機儲存的資料會自動傳輸至雲端。預設值：
OFF - (選用)
startTime -
核准的行銷活動會在開始時間啟動。
預設值：
0
行銷活動的狀態可以是下列其中一個值。
-
CREATING– AWS IoT FleetWise 正在處理您的請求以建立行銷活動。 -
WAITING_FOR_APPROVAL– 建立行銷活動後，它會進入WAITING_FOR_APPROVAL狀態。若要核准行銷活動，請使用UpdateCampaignAPI 操作。行銷活動獲得核准後， AWS IoT FleetWise 會自動將行銷活動部署到目標車輛或機群。如需詳細資訊，請參閱更新 an AWS IoT FleetWise 行銷活動。 -
RUNNING– 行銷活動為作用中。 -
SUSPENDED– 行銷活動已暫停。若要繼續行銷活動，請使用UpdateCampaignAPI 操作。
AWS IoT FleetWise 提供下列 API 操作，您可以用來建立和管理行銷活動。
-
CreateCampaign – 建立新的行銷活動。
-
UpdateCampaign – 更新現有的行銷活動。建立行銷活動後，您必須使用此 API 操作來核准行銷活動。
-
DeleteCampaign – 刪除現有的行銷活動。
-
ListCampaigns – 擷取所有行銷活動的分頁摘要清單。
-
GetCampaign – 擷取行銷活動的相關資訊。
教學
