使用行銷活動收集 AWS IoT FleetWise 資料 - AWS IoT FleetWise

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用行銷活動收集 AWS IoT FleetWise 資料

行銷活動是資料收集規則的協調。行銷活動會提供 Edge Agent for AWS IoT FleetWise 軟體指示，說明如何選取、收集資料，以及將資料傳輸至雲端。

您可以在雲端中建立活動。您或您的團隊核准行銷活動後， AWS IoT FleetWise 會自動將其部署到車輛。您可以選擇將行銷活動部署至車輛或機群。在執行中的行銷活動部署至車輛之前，Edge Agent 軟體不會開始收集資料。

注意

直到您有下列內容，行銷活動才會運作。

  • Edge Agent 軟體正在您的車輛中執行。如需如何開發、安裝和使用 Edge Agent 軟體的詳細資訊，請執行下列動作。

    1. 導覽至 AWS IoT FleetWise 主控台 。

    2. 在服務首頁的 AWS IoT FleetWise入門區段中，選擇探索邊緣代理程式 。

  • 您已設定 AWS IoT Core 來佈建車輛。如需詳細資訊，請參閱Provision AWS 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 行銷活動的邏輯表達式。

（選用） triggerMode 可以是下列其中一個值。

  • RISING_EDGE – Edge Agent 軟體只會在第一次符合條件時收集資料。例如：$variable.`myVehicle.AirBagDeployed` == true。

  • ALWAYS – Edge Agent 軟體會在符合條件時收集資料。

(選用) minimumTriggerIntervalMs

兩個資料收集事件之間的最短持續時間，以毫秒為單位。如果訊號經常變更，您可能會以較慢的速度收集資料。

(選用) conditionLanguageVersion

條件表達式語言的版本。

timeBasedCollectionScheme

當您定義以時間為基礎的收集方案時，請指定以毫秒為單位的時段。Edge Agent 軟體會使用時間段來決定收集資料的頻率。例如，如果時段為 120，000 毫秒，Edge Agent 軟體會每兩分鐘收集一次資料。

(選用) compression

若要節省無線頻寬並減少網路流量，您可以指定 SNAPPY 來壓縮車輛中的資料。

根據預設 （OFF），Edge Agent 軟體不會壓縮資料。

dataDestinationConfigs

選擇行銷活動將傳輸車輛資料的目的地。您可以選擇將資料儲存在 Amazon S3 或 Amazon Timestream 中。

S3 是一種經濟實惠的資料儲存機制，可提供持久的資料管理功能和下游資料服務。您可以使用 S3 處理與駕駛行為或分析長期維護相關的資料。

Timestream 是一種資料持久性機制，可協助您近乎即時地識別趨勢和模式。您可以使用 Timestream 來分析時間序列資料，例如分析車輛速度或煞車的歷史趨勢。

(選用) dataExtraDimensions

您可以新增一或多個屬性，以提供訊號的其他資訊。

(選用) description

您可以新增描述以協助識別行銷活動的目的。

(選用) diagnosticsMode

當診斷模式設定為 時SEND_ACTIVE_DTCS，行銷活動會傳送已儲存的標準診斷問題碼 （DTCs），以協助識別車輛的問題。例如，P0097 表示引擎控制模組 （ECM） 已判斷進氣溫度感應器 2 （IAT2） 輸入低於正常感應器範圍。

根據預設 （OFF），Edge Agent 軟體不會傳送診斷碼。

(選用) expiryTime

您可以定義行銷活動的到期日。當行銷活動到期時，Edge Agent 軟體會停止收集此行銷活動中指定的資料。如果車輛部署了多個行銷活動，Edge Agent 軟體會使用其他行銷活動來收集資料。

預設值：253402243200（12 月 31 日、9999、00：00：00UTC）

(選用) 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

兩個資料範例收集事件之間的最短持續時間，以毫秒為單位。如果訊號經常變更，您可以使用此參數以較慢的速度收集資料。

有效範圍：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 會自動將行銷活動部署到目標車輛或機群。如需詳細資訊，請參閱更新 AWS IoT FleetWise 行銷活動。

  • RUNNING – 行銷活動為作用中。

  • SUSPENDED – 行銷活動已暫停。若要繼續行銷活動，請使用 UpdateCampaignAPI操作。

AWS IoT FleetWise 提供下列API操作，您可以用來建立和管理行銷活動。

  • CreateCampaign – 建立新的行銷活動。

  • UpdateCampaign – 更新現有的行銷活動。建立行銷活動後，您必須使用API此操作來核准行銷活動。

  • DeleteCampaign – 刪除現有的行銷活動。

  • ListCampaigns – 擷取所有行銷活動的分頁摘要清單。

  • GetCampaign – 擷取行銷活動的相關資訊。

教學課程