AWS IoT FleetWise 自 2026 年 4 月 30 日起將不再向新客戶開放。現有的 AWS IoT FleetWise 客戶可以繼續使用 服務。[上的連線行動性指南 AWS](https://aws.amazon.com/solutions/guidance/connected-mobility-on-aws/)提供如何為連線行動解決方案開發和部署模組化服務的指引，這些解決方案可用於實現與 AWS IoT FleetWise 同等的功能。 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 使用行銷活動收集 AWS IoT FleetWise 資料 **重要** 對特定 AWS IoT FleetWise 功能的存取目前受到鎖定。如需詳細資訊，請參閱[AWS AWS IoT FleetWise 中的區域和功能可用性](fleetwise-regions.md)。 行銷活動是資料收集規則的協調。行銷活動會提供 Edge Agent for AWS IoT FleetWise 軟體指示，說明如何選取、收集資料並將資料傳輸至雲端。 您可以在雲端中建立活動。在您或您的團隊核准行銷活動後， AWS IoT FleetWise 會將行銷活動設定為準備好部署，並在下次車輛進廠時部署。您可以選擇將行銷活動部署至車輛或機群。Edge Agent 軟體不會開始收集資料，直到正在執行的行銷活動部署到車輛為止。 **重要** 除非您有以下項目，否則行銷活動將無法運作。 Edge Agent 軟體正在您的 車輛中執行。如需如何開發、安裝和使用 Edge Agent 軟體的詳細資訊，請執行下列動作。 開啟 [AWS IoT FleetWise 主控台](https://console.aws.amazon.com/iotfleetwise)。 在服務首頁的**開始使用 AWS IoT FleetWise** 區段中，選擇**探索邊緣代理**程式。 您已設定 AWS IoT Core 來佈建您的 車輛。如需詳細資訊，請參閱[Provision AWS IoT FleetWise 車輛](provision-vehicles.md)。 **注意** 您也可以 [監控車輛的最後已知狀態](last-known-state.md)（而非機群） 近乎即時地使用狀態範本，可讓您使用「變更中」或「定期」更新策略串流遙測資料。此功能也提供「隨需」功能，以啟用或停用先前部署的範本，或一次性請求目前的車輛狀態 （擷取）。 目前已封鎖對上次已知狀態的存取。如需詳細資訊，請參閱[AWS AWS IoT FleetWise 中的區域和功能可用性](fleetwise-regions.md)。 每個行銷活動都包含下列資訊。 `signalCatalogArn` 與行銷活動相關聯之訊號目錄的 Amazon Resource Name (ARN)。 (選用) `tags` 標籤是可用於管理行銷活動的中繼資料。您可以對來自不同服務的資源指派相同的標籤，表示這些是相關的資源。 `TargetArn` 部署活動之車輛或機群的 ARN。 `name` 有助於識別行銷活動的唯一名稱。 `collectionScheme` 資料收集方案為 Edge Agent 軟體提供有關要收集哪些資料或何時收集資料的說明。 AWS IoT FleetWise 目前支援以條件為基礎的收集方案和以時間為基礎的收集方案。 + `conditionBasedCollectionScheme` – 條件型收集機制使用邏輯表達式來識別要收集的資料。邊緣代理程式軟體會在符合條件時收集資料。 + `expression` – 用來辨識要收集哪些資料的邏輯表達式。例如，如果指定`$variable.`myVehicle.InVehicleTemperature` > 50.0`表達式，Edge Agent 軟體會收集大於 50.0 的溫度值。如需如何撰寫表達式的說明，請參閱 [AWS IoT FleetWise 行銷活動的邏輯表達式](logical-expression.md)。 + （選用） `conditionLanguageVersion` – 條件式表達式語言的版本。 + （選用） `minimumTriggerIntervalMs` – 兩個資料收集事件之間的最短持續時間，以毫秒為單位。如果訊號經常變更，您可能會以較慢的速度收集資料。 + （選用） `triggerMode` – 可以是下列其中一個值： + `RISING_EDGE` – Edge Agent 軟體只會在第一次符合條件時收集資料。例如 `$variable.`myVehicle.AirBagDeployed` == true`。 + `ALWAYS` – Edge Agent 軟體會在符合條件時收集資料。 + `timeBasedCollectionScheme` – 當您定義以時間為基礎的收集方案時，請以毫秒為單位指定時段。邊緣代理程式軟體會使用時段來決定收集資料的頻率。例如，如果時段為 120，000 毫秒，Edge Agent 軟體會每兩分鐘收集資料一次。 + `periodMs` – 決定收集資料頻率的期間 （以毫秒為單位）。 (選用) `compression` 若要節省無線頻寬並減少網路流量，您可以指定 [SNAPPY](https://opensource.google/projects/snappy) 來壓縮車輛中的資料。 根據預設 (`OFF`)，Edge Agent 軟體不會壓縮資料。 `dataDestinationConfigs` 選擇行銷活動將傳輸車輛資料的單一目的地。您可以將資料傳送至 [MQTT 主題](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html)，或將其存放在 Amazon S3 或 Amazon Timestream 中。 MQTT （訊息佇列遙測傳輸） 是一種輕量且廣泛採用的訊息通訊協定。您可以將資料發佈至 MQTT 主題，以使用 AWS IoT rule. AWS IoT support for MQTT 以 [ MQTT v3.1.1 規格](http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html)和 [MQTT v5.0 規格](http://docs.oasis-open.org/mqtt/mqtt/v5.0/mqtt-v5.0.html)為基礎，但有一些差異。如需詳細資訊，請參閱 [MQTT 差異](https://docs.aws.amazon.com/iot/latest/developerguide/mqtt.html#mqtt-differences.html)。 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 必須符合 中提供的其中一個 IDs`dataPartitions`。如果您上傳訊號做為資料分割區中的條件，則這些相同的訊號必須包含在 中`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` 狀態。若要核准行銷活動，請使用 `UpdateCampaign` API 操作。行銷活動獲得核准後， AWS IoT FleetWise 會自動將行銷活動部署到目標車輛或機群。如需詳細資訊，請參閱[更新 an AWS IoT FleetWise 行銷活動](update-campaign-cli.md)。 + `RUNNING ` – 行銷活動為作用中。 + `SUSPENDED` – 行銷活動已暫停。若要繼續行銷活動，請使用 `UpdateCampaign` API 操作。 AWS IoT FleetWise 提供下列 API 操作，您可以用來建立和管理行銷活動。 + [CreateCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateCampaign.html) – 建立新的行銷活動。 + [UpdateCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateCampaign.html) – 更新現有的行銷活動。建立行銷活動後，您必須使用此 API 操作來核准行銷活動。 + [DeleteCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteCampaign.html) – 刪除現有的行銷活動。 + [ListCampaigns](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListCampaigns.html) – 擷取所有行銷活動的分頁摘要清單。 + [GetCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetCampaign.html) – 擷取行銷活動的相關資訊。 **Topics** + [建立 an AWS IoT FleetWise 行銷活動](create-campaign.md) + [更新 an AWS IoT FleetWise 行銷活動](update-campaign-cli.md) + [刪除 an AWS IoT FleetWise 行銷活動](delete-campaign.md) + [Get AWS IoT FleetWise 行銷活動資訊](get-campaign-information-cli.md) + [儲存和轉送行銷活動資料](store-and-forward.md) + [使用 AWS IoT FleetWise 收集診斷問題碼資料](diagnostic-trouble-codes.md) + [Visualize AWS IoT FleetWise 車輛資料](process-visualize-data.md)