文件Experience Platform資料流指南

建立和設定資料串流

Last update: Thu Oct 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 開發人員

本文件會介紹在 UI 中設定資料流的步驟。

存取Datastreams工作區

您可以在資料收集UI或Experience Platform UI中建立和管理資料串流，方法是選取左側導覽中的​Datastreams。

資料收集 UI 中的資料流索引標籤

Datastreams​索引標籤會顯示現有資料串流的清單，包括其易記名稱、ID和上次修改日期。 若要檢視其詳細資料並設定服務，請選取資料流的名稱。

若要顯示特定資料串流的更多選項，請選取「更多」圖示(…)。 若要更新資料流的基本設定，請選取​Edit。 若要移除資料流，請選取​Delete。

編輯或刪除現有資料流的選項

建立資料串流 create

若要建立資料串流，請選取​ New Datastream ​以開始。

選取新資料流 。

資料流建立工作流程隨即顯示，首先是設定步驟。在這裡，您必須提供資料流的名稱和說明 (選用)。

如果您設定要在Experience Platform中使用的資料串流，並且也使用網路SDK，您還必須選取事件型體驗資料模型(XDM)結構描述來代表您計畫擷取的資料。

資料流的基本設定

設定地理位置與網路查閱 geolocation-network-lookup

地理位置和網路查詢設定可協助您定義要收集的地理和網路層級資料的詳細程度。

展開​ Geolocation and network lookup ​區段以設定下述設定。

資料流設定畫面中反白顯示地理位置和網路查詢設定。

設定
說明
Geo Lookup

根據訪客的IP位址啟用所選選項的地理位置查閱。 可用的選項包括：

  • 國家：填入xdm.placeContext.geo.countryCode
  • 郵遞區號：填入xdm.placeContext.geo.postalCode
  • 州/省：填入xdm.placeContext.geo.stateProvince
  • DMA：填入xdm.placeContext.geo.dmaID
  • 城市：填入xdm.placeContext.geo.city
  • 緯度：填入xdm.placeContext.geo._schema.latitude
  • 經度：填入xdm.placeContext.geo._schema.longitude

選取​City、Latitude​或​ Longitude ​可提供最多兩個小數點的座標，無論選取的其他選項為何。 這被視為城市層級的詳細程度。

未選取任何選項會停用地理位置查詢。 地理位置發生在IP Obfuscation之前，這表示它不受IP Obfuscation設定影響。

Network Lookup

根據訪客的IP位址啟用所選選項的網路查閱。 可用的選項包括：

  • 行動電信業者：填入xdm.environment.carrier
  • 網域：填入xdm.environment.domain
  • ISP：填入xdm.environment.ISP
  • 連線型別：填入xdm.environment.connectionType

如果您啟用任何上述欄位以進行資料收集，請確定您在設定Web SDK時已正確設定context陣列屬性。

地理位置查閱欄位使用context陣列字串"placeContext"，而網路查閱欄位使用context陣列字串"environment"。

此外，請確定您的結構描述中存在每個所需的XDM欄位。 如果不適用，您可以將Adobe提供的Environment Details欄位群組新增到結構描述。

設定裝置查詢 geolocation-device-lookup

Device Lookup​設定可讓您選取要收集的裝置特定資訊。

展開​ Device Lookup ​區段以設定下述設定。

反白顯示裝置查閱設定的Datastream設定畫面。

IMPORTANT
下表中所示的設定是互斥的。 您無法同時選取使用者代理程式資訊​ 和 ​裝置查閱資料。
設定
說明
Keep user agent and client hints headers
選取此選項可僅收集儲存在使用者代理字串中的資訊。 此設定預設為選取。 填入xdm.environment.browserDetails.userAgent
Use device lookup to collect the following information

如果要收集下列一或多個裝置特定資訊，請選取此選項：

  • Device​資訊：

    • 裝置製造商：填入xdm.device.manufacturer
    • 裝置模型：填入xdm.device.modelNumber
    • 行銷名稱：填入xdm.device.model

  • Hardware​資訊：

    • 硬體型別：填入xdm.device.type
    • 顯示高度：填入xdm.device.screenHeight
    • 顯示寬度：填入xdm.device.screenWidth
    • 顯示色彩深度：填入xdm.device.colorDepth

  • Browser​資訊：

    • 瀏覽器廠商：填入xdm.environment.browserDetails.vendor
    • 瀏覽器名稱：填入xdm.environment.browserDetails.name
    • 瀏覽器版本：填入xdm.environment.browserDetails.version

  • Operating system​資訊：

    • OS廠商：填入xdm.environment.operatingSystemVendor
    • OS名稱：填入xdm.environment.operatingSystem
    • OS版本：填入xdm.environment.operatingSystemVersion

裝置查詢資訊無法與使用者代理程式和使用者端提示一起收集。 選擇收集裝置資訊會停用收集使用者代理程式和使用者端提示，反之亦然。

Do not collect any device information
如果您不想收集任何裝置查詢資訊，請選取此選項。 未收集任何裝置、硬體、瀏覽器、作業系統、使用者代理程式或使用者端提示資料。

如果您啟用任何上述欄位以進行資料收集，請確定您在設定Web SDK時已正確設定context陣列屬性。

裝置和硬體資訊使用context陣列字串"device"，而瀏覽器和作業系統資訊使用context陣列字串"environment"。

此外，請確定您的結構描述中存在每個所需的XDM欄位。 如果不適用，您可以將Adobe提供的Environment Details欄位群組新增到結構描述。

設定進階選項 advanced-options

若要顯示進階設定選項，請選取​Advanced Options。 您可以在此處設定其他資料流設定，例如IP模糊化、第一方ID Cookie等。

進階組態選項

IMPORTANT
您有責任確保已取得適用法律與法規所規定的一切必要許可權、同意、許可與授權，以收集、處理及傳輸個人資料，包括精確的地理位置資訊。
您選擇的IP位址模糊化不會影響到從IP位址衍生並傳送至您設定的Adobe解決方案的地理位置資訊層級。 地理位址查詢必須單獨限制或停用。
設定
說明
IP Obfuscation

說明要套用於資料流的 IP 模糊化的類型。任何根據客戶IP的處理會受到IP模糊化設定的影響。 這包括從資料流接收資料的所有Experience Cloud服務。 IP模糊化會在事件傳送至任何下游服務（例如資料準備）之前發生。

可使用的選項：

  • None：停用IP模糊化功能。 完整的使用者IP位址會透過資料流傳送。

  • Partial：針對IPv4位址，模糊化使用者IP位址的最後八位元。 若為 IPv6 位址，模糊化位址的最後 80 個位元。

    範例：

    • IPv4：1.2.3.4 -> 1.2.3.0
    • IPv6：2001:0db8:1345:fd27:0000:ff00:0042:8329 -> 2001:0db8:1345:0000:0000:0000:0000:0000

  • Full：將整個IP位址模糊化。

    範例：

    • IPv4：1.2.3.4 -> 0.0.0.0
    • IPv6：2001:0db8:1345:fd27:0000:ff00:0042:8329 -> 0:0:0:0:0:0:0:0

IP 模糊化會對其他 Adobe 產品造成影響：

  • Adobe Target：在Adobe Target中執行IP obfuscation之前，將資料流層級IP obfuscation套用至要求上存在的所有IP位址。 例如，如果資料流層級IP obfuscation選項設為​Full，而Adobe Target IP模糊化選項設為​Last octet obfuscation，Adobe Target會收到完全模糊化的IP。 如果資料流層級IP obfuscation選項設為​Partial，而Adobe Target IP模糊化選項設為​Full，Adobe Target會收到部分模糊化的IP，然後套用完整的模糊化選項。 Adobe Target IP模糊化是獨立於資料流管理。 如需更多詳細資料，請至 IP 模糊化和地理位置，參閱 Adobe Target 文件。
  • Audience Manager：在Audience Manager中執行IP obfuscation之前，將資料流層級IP obfuscation設定套用至要求中存在的所有IP位址。 Audience Manager完成的任何地理位置查詢都會受到資料流層級IP obfuscation選項的影響。 Audience Manager中根據完全模糊化的IP進行地理位置查詢會產生未知區域，且不會實現任何根據結果地理位置資料的區段。 如需更多詳細資料，請至 IP 模糊化，參閱 Audience Manager 文件。
  • Adobe Analytics：如果資料流層級IP模糊化設定設為​Full，Adobe Analytics會將IP位址視為空白。 這會影響任何依賴IP位址的Analytics處理，例如地理位置查詢和IP篩選。 若要讓Analytics接收未模糊化或部分模糊化的IP位址，請將IP模糊化設定設為​ Partial ​或​None。 部分模糊化及未模糊化的IP位址在Analytics中可能會進一步模糊化。 如需如何在Analytics中啟用IP模糊化的詳細資訊，請參閱Adobe Analytics 檔案。 如果IP位址已完全模糊化，而且頁面點選既沒有ECID也沒有VisitorID，則Analytics會捨棄點選，而非產生部分以IP位址為基礎的遞補ID。
  • Adobe Advertising：當資料流層級IP模糊化設為Partial或Full時，Advertising DSP中除了連線電視廣告外，已停用地理報告和功能（包括測量和重新鎖定目標）。
First Party ID Cookie
啟用後，在查詢第一方裝置 ID 時，此設定會告知 Edge Network 參照指定的 cookie，而不是在身分識別對應中查詢這個值。

啟用此設定時，您必須提供應儲存ID的Cookie名稱。
Third Party ID Sync
將 ID 同步分組至不同的容器中，即可讓不同的 ID 同步在不同時間執行。啟用後，此設定會讓您指定為此資料流執行哪個 ID 同步的容器。
Third Party ID Sync Container ID
用於協力廠商 ID 同步之容器的數值 ID。
Container ID Overrides
在此區段中，您可以定義其他第三方ID同步容器ID，以用來覆寫預設的ID。
Access Type

定義 Edge Network 接受資料流的驗證類型。

  • Mixed Authentication：選取此選項時，Edge Network會接受已驗證和未驗證的請求。 當您打算使用Web SDK或Mobile SDK以及Edge Network API時，請選取此選項。
  • Authenticated Only：選取此選項時，Edge Network僅接受已驗證的請求。 當您計畫只使用Edge Network API，並想要防止Edge Network處理任何未驗證的請求時，請選取此選項。
Media Analytics
啟用透過Experience Platform SDK或Media Edge API處理Edge Network整合的串流追蹤資料。 從檔案瞭解Media Analytics。

如果您正在設定Experience Platform的資料串流，請先按照資料收集的資料準備上的教學課程將資料對應到Experience Platform事件結構描述，然後再返回本指南。 否則，請選取​ Save ​並繼續下一節。

檢視資料流詳細資料 view-details

設定新資料流或選取要檢視的現有資料流後，該資料流的詳細資料頁面會隨即顯示。您可以在此處找到有關資料流的進一步資訊，包括其 ID。

資料流詳細資料頁面。

在資料流詳細資料畫面中，您可以新增服務，以啟用您有權存取的 Adobe Experience Cloud 產品的功能。您還可以編輯資料流的基本設定、更新其對應規則、複製資料流，或將其完全刪除。

將服務新增至資料流 add-services

在資料流的詳細資訊頁面上，選取​ Add Service ​以開始為該資料流新增可用服務。

選取[新增服務]以繼續。

在下一個畫面上，使用下拉選單選取要為此資料流設定的服務。此清單中只會顯示您有權存取的服務。

從清單中選取服務。

選取所需的服務，填寫顯示的組態選項，然後選取​ Save ​將服務新增至資料流。 所有已新增的服務都會顯示在資料流的詳細資料檢視中。

已新增至資料流的服務

以下子區段會說明每項服務的設定選項。

NOTE
每個服務組態都包含一個​ Enabled ​切換，在選取服務時自動啟動。 若要停用此資料流選取的服務，請再次選取​ Enabled ​切換按鈕。

Adobe Advertising設定 advertising

Adobe Advertising與Customer Journey Analytics整合需要此服務。

Adobe Analytics 設定 analytics

此服務會控制是否將資料傳送到 Adobe Analytics 以及傳送方式。請參閱傳送資料至Adobe Analytics。

Adobe Analytics資料流設定。

設定
說明
Report Suite ID
(必要) 您要將資料傳送到的 Analytics 報告套裝的 ID。您可以在Adobe Analytics UI的Admin > ReportSuites下找到此ID。 如果指定多個報告套裝，則資料會複製到每個報告套裝。
Visitor ID namespace
（選用）您要用於Adobe Analytics visitorID的名稱空間。 當您傳送具有為此名稱空間指定值的事件時，系統會自動將其用作Analytics中的visitorID。
Report Suite Overrides
在本區段中，您可以新增其他報告套裝 ID，以用於覆寫預設的報告套裝 ID。

Adobe Audience Manager 設定 audience-manager

此服務會控制是否將資料傳送到 Adobe Audience Manager 以及傳送方式。若要將資料傳送到 Audience Manager，需要做的就是啟用本區段。其他設定為選用，但建議使用。

Adobe對象管理資料流設定。

設定
說明
Cookie Destinations Enabled
允許 SDK 透過 cookie 目的地從 Audience Manager 共用區段資訊。
URL Destinations Enabled
允許 SDK 透過 URL 目的地從 Audience Manager 共用區段資訊。

Adobe Experience Platform 設定 aep

IMPORTANT
為Experience Platform啟用資料串流時，請記下您目前使用的Experience Platform沙箱，如UI的頂端功能區中所示。
選取的沙箱
沙箱是 Adobe Experience Platform 中的虛擬分區，可讓您將資料和實作與貴組織中的其他項目隔離。資料流建立後，其沙箱即無法變更。如需在 Experience Platform 中的沙箱角色的更多詳細資料，請參閱沙箱文件。

此服務會控制是否將資料傳送到 Adobe Experience Platform 以及傳送方式。

Adobe Experience Platform資料流設定。

設定
說明
Event Dataset
（必要）​選取將串流至客戶事件資料的Experience Platform資料集。 此結構描述必須使用 XDM 體驗事件類別。若要新增其他資料集，請選取​Add Event Dataset。
Profile Dataset
選取將用於傳送​同意、推播權杖​和​ 使用者活動區域 ​客戶屬性的Experience Platform資料集。 此結構描述必須使用 XDM 個人輪廓類別。
Offer Decisioning
為Web SDK實作啟用Offer Decisioning。 如需更多實作詳細資訊，請參閱搭配使用Offer Decisioning與Web SDK指南。

如需有關 Offer Decisioning 功能的詳細資訊，請參閱 Adobe Journey Optimizer 文件。
Edge Segmentation
啟用此資料流的邊緣分段。 當網頁SDK或Edge Network API透過已啟用邊緣細分的資料流傳送資料時，有關設定檔的任何更新對象會籍都會在回應中傳回。

您可以透過​邊緣目的地、Personalization、Offer Decisioning或Adobe Journey Optimizer，針對相同頁面和下一頁個人化使用案例，將此選項與Adobe Target目的地搭配使用
Personalization Destinations
啟用此資料流的自訂Personalization。 當網頁SDK或Edge Network API透過已啟用個人化目的地的資料流傳送資料時，在回應中會傳回相關設定檔的對象成員資格和對應的設定檔屬性(僅適用於已驗證的Edge Network API請求)。
Adobe Journey Optimizer
啟用此資料流的Adobe Journey Optimizer。

啟用此選項可讓資料流從Adobe Journey Optimizer中的網頁和應用程式傳入行銷活動傳回個人化內容。

此選項需要選取的資料集使用包含​Experience Event - Proposition Interactions 欄位群組的結構描述。 此欄位群組用於記錄所有使用者與Adobe Journey Optimizer行銷活動和體驗的互動。

Adobe Target 設定 target

此服務會控制是否將資料傳送到 Adobe Target 以及傳送方式。

Adobe Target資料流設定。

設定
說明
Property Token
Target允許客戶使用屬性控制許可權。 如需有關屬性的詳細資訊，請至設定企業權限 (在 Target 文件中)，詳閱指南。

可在Adobe Target UI的Setup > Properties下找到屬性代號。
Target Environment ID
Adobe Target 中的環境可協助您管理全部開發階段的實作。此設定會指定您將使用此資料流的環境。

最佳做法是針對您的每個 dev、stage 和 prod 資料流環境對此做不同的設定，以保持事情簡單。但是，如果您已經定義了 Adobe Target 環境，則可以使用已定義的環境。
Target Third Party ID namespace
您要用於此資料流之 mbox3rdPartyId 的身分識別命名空間。如果您使用Adobe Target的Customer Attributes整合，或透過thirdPartyIdAdobe Target設定檔API使用來更新或建立設定檔，您必須提供您選擇的名稱空間值。 您必須在XDM結構描述的IdentityMap區段中使用此名稱空間，以傳送用於客戶屬性檔案上傳或設定檔更新API呼叫的customerID或thirdPartyId。 如需詳細資訊，請至實作 mbox3rdPartyId 和 Web SDK，詳閱指南。
Property Token Overrides
在此區段中，您可以定義其他可用來覆寫預設屬性代號的屬性。

Event Forwarding設定

此服務會控制是否將資料傳送到事件轉送以及傳送方式。

資料流設定畫面的 事件轉送區段。

設定
說明
Launch Property
(必要) 您要將資料傳送到的事件轉送屬性。
Launch Environment
(必要) 您要將資料傳送到的選取屬性內的環境。
NOTE
您可以選取​ Manually enter IDs ​來輸入屬性和環境名稱，而不使用下拉式選單。

複製資料流 copy

您可以建立現有資料流的副本並根據需要變更其詳細資料。

NOTE
資料流只能在相同的沙箱內複製。換句話說，您無法將資料流從一個沙箱複製到另一個沙箱。

從Datastreams工作區中的首頁面，選取省略符號(…)，然後選取​Copy。

顯示從資料流清單檢視中選取之複製選項的影像。

或者，您可以從指定資料流的詳細資料檢視中選取​Copy Datastream。

從資料流詳細資料檢視中選取的複製選項。

確認對話框隨即顯示，提示您為要將建立的新資料流提供唯一名稱，以及有關將複製的設定選項的詳細資料。準備就緒後，選取​Copy。

複製資料串流的確認對話方塊。

Datastreams工作區的首頁面會重新出現，並列出新的資料流。

後續步驟

本指南會介紹如何在資料收集 UI 中管理資料流。如需有關如何在設定資料流後安裝並設定 Web SDK 的詳細資訊，請參閱資料收集 E2E 指南。

recommendation-more-help
c4bd45d4-a044-4e32-94ad-5e2f71800fac