將您的Audience Manager資料收集程式庫從AppMeasurement更新為Web SDK
目標對象 intended-audience
此頁面適用於使用AppMeasurement JavaScript資料庫將Web資料傳送至Audience Manager的Audience Manager和Adobe Analytics客戶。
請參閱下表，瞭解移轉至Web SDK的步驟指南（視您目前的資料收集方法而定）。
移轉概述 overview
從AppMeasurement移轉至Web SDK主要是Adobe Analytics移轉。 針對Audience Manager客戶，此移轉作業也包含Audience Manager。 兩者必須一起移轉。 如果您主要使用Audience Manager，請務必讓Analytics團隊參與此移轉。
如果您使用AppMeasurement進行Audience Manager資料收集，目前您正使用Server-side Forwarding (SSF)方法將分析資料傳送至Audience Manager。 在此設定中，Analytics資料收集請求會轉送至Audience Manager，後者也會處理頁面的Audience Manager回應。
這是多年的標準方法，很可能是您目前的設定。 如果您的AppMeasurement程式庫包含AudienceManagement模組，而您的資料收集呼叫在要求(/10/)中包含/b/ss/examplereportsuite/10/路徑，則本指南適用於您。
伺服器端轉送(SSF)與Web SDK資料流程 data-flows
瞭解Analytics與Audience Manager在移至Web SDK (和Edge Network)時的資料流程差異，對於下列指示至關重要。
透過伺服器端轉送，Analytics區域資料收集節點會收集資料，將其轉換為Audience Manager接受的訊號，傳送至Audience Manager，並將Audience Manager回應傳回至頁面。 AudienceManagement程式庫中的AppMeasurement模組接著會處理回應（例如，卸除Cookie、傳送URL目的地）。 此程式稱為伺服器端轉送，因為Analytics會使用Adobe伺服器將資料轉送至Audience Manager。
透過Web SDK，Edge Network會以不同動作將資料傳送至Analytics和Audience Manager。 Web SDK是單一資料庫，可將資料傳送至所有解決方案，而Edge Network會將與解決方案無關的資料點轉換為解決方案專用格式。
在這個新的資料流程中，所有資料都會傳送到Edge Network 資料串流，您可以設定，視需要傳送資料到Adobe解決方案。 若為Audience Manager，在資料流上啟用Audience Manager服務會將XDM和Analytics資料轉換為Audience Manager接受的訊號。 Edge Network也會將Audience Manager回應傳回至頁面，其中Web SDK會處理回應，類似於AppMeasurement和AudienceManagement模組的處理方式。
標籤與非標籤移轉 tags-vs-non-tags
無論您是使用具有AppMeasurement擴充功能的標籤、其他標籤管理系統中的AppMeasurement資料庫，或直接在頁面上放置AppMeasurement，將Audience Manager移轉至Web SDK的步驟均相同。 由於Audience Manager移轉取決於Analytics移轉，因此從AppMeasurement移轉至Web SDK的步驟會在Analytics移轉期間決定。
該資訊包含在標籤或JavaScript型實作的Analytics檔案中。
XDM和data.__adobe.節點 xdm-data-nodes
網頁SDK的主要功能之一，是將資料傳送至Real-Time Customer Data Platform (RTCDP)。 為達成此目的，同時仍收集其他Experience Cloud解決方案的資料，而不需要完全重新實作，解決方案特定資料會在資料收集伺服器呼叫中加以區隔。 此呼叫使用名為體驗資料模型(XDM)的標準化JSON結構描述
與解決方案無關的元素（例如關於瀏覽器和裝置的資訊），會以預先確定的XDM結構傳送至Edge Network。 Edge Network會將此資料轉換為解決方案專用格式。 不過，Target、Analytics和Audience Manager專屬的資料會儲存在XDM裝載內的專用data.__adobe節點中。
例如：
- Analytics變數
s.eVar1在XDM承載中呈現為data.__adobe.analytics.evar1。 - 與客戶忠誠度狀態相關的Target引數會儲存為
data.__adobe.target.loyaltyStatus。
__adobe節點中的資料會傳送至個別解決方案(例如Analytics和Audience Manager)，而不會傳送至Experience Platform，即使資料流中已啟用Experience Platform服務亦然。 這表示您可以保留Analytics和Audience Manager的目前設定，同時還能彈性地將任何必要的資料元素對應到XDM結構描述元素，以在Experience Platform中使用資料收集的資料準備的即時使用案例。
例如，在結帳期間用於報告購物車內容的Analytics s.products字串仍可以原始格式傳送給Analytics和Audience Manager。 同時，您可以使用此字串的元素，針對Experience Platform使用案例建立更直覺式的XDM購物車結構描述。
由於大多數Audience Manager實作都仰賴轉送至Audience Manager的Analytics資料，因此您的許多Audience Manager特徵運算式可能會以Analytics變數（c_evar#、c_prop#和c_events）為基礎。 為避免在移轉期間使用XDM格式重建特徵運算式，Edge Network預設會設定為將data.__adobe.analytics節點中找到的任何Analytics變數轉換為Audience Manager訊號。 類似的轉換程式會在伺服器端轉送工作流程中進行。
Edge Network可以執行此轉換，因為來自頁面的單一資料收集呼叫會傳送到單一資料流，以饋送多個Adobe解決方案。 因此，大部分從AppMeasurement移轉至Analytics和Audience Manager的Web SDK時，都會主要使用data.__adobe.analytics節點。
Edge Network會將XDM裝載和封包標題中的裝置和瀏覽器資料轉換為Audience Manager訊號。 這可讓您繼續在Audience Manager特徵運算式中使用h_和d_平台金鑰。
data.__adobe.audiencemanager節點 data-note
data.__adobe.audiencemanager節點用於不依賴Analytics的Audience Manager實作。 它儲存先前透過Audience Manager資料庫傳送的自訂DIL金鑰/值組，如標籤延伸功能移轉指南所述。
雖然本指南概述的移轉不需要data.__adobe.audiencemanager節點，但此處說明的新資料流程可讓資料傳送至Audience Manager，而不需在Analytics中記錄。
如果您需要傳送自訂索引鍵/值組至Audience Manager，而不將其納入Analytics，則可使用data.__adobe.audiencemanager節點。 此節點中的任何資料集都會附加至資料收集伺服器呼叫中Audience Manager轉換的Analytics資料。
此實作路徑的優缺點
使用此移轉方法的優缺點。 請仔細權衡每個選項，決定哪種方式最適合您的組織。
- 使用您現有的實作：雖然此方法需要一些實作變更，但它不需要從頭開始的全新實作。 您可以使用現有的資料層和程式碼，只需對實作邏輯進行最低限度的變更。
- 不需要結構描述：對於移轉至Web SDK的這個階段，您不需要XDM結構描述。 相反地，您可以填入
data物件，這會直接將資料傳送到Audience Manager。 一旦移轉至Web SDK完成，您就可以為貴組織建立結構描述，並使用資料流對應來填入適用的XDM欄位。 如果移轉流程的這個階段需要結構描述，貴組織將被強制使用Audience Manager XDM結構描述。 使用此結構描述會使您的組織未來更難以使用您自己的結構描述。
- 實作技術債：由於此方法使用您現有實作的修改形式，因此可能更難追蹤實作邏輯，並在日後需要時執行變更。
- 需要對應才能將資料傳送至Platform：當您的組織準備好使用Real-Time CDP時，您必須將資料傳送至Adobe Experience Platform中的資料集。 此動作要求
data物件中的每個欄位必須是資料流對應工具中的專案，以將其指派給XDM結構描述欄位。 此工作流程只需對應一次，不需要變更實作。 不過，這是在XDM物件中傳送資料時不需要的額外步驟。
Adobe建議在下列情況下使用此實施路徑：
- 您已有使用Adobe Analytics AppMeasurement JavaScript資料庫的實作。 如果您有使用Audience Manager標籤擴充功能的實作，請改為遵循從Audience Manager標籤擴充功能移轉至Web SDK標籤擴充功能。
- 您打算在未來使用Real-Time CDP，但不想從頭開始使用Web SDK實作來取代Audience Manager實作。 使用Web SDK從頭開始取代實作的替代方案需要您盡最大努力，因為您需要重新建置所有Audience Manager特徵，以尋找XDM格式資料。 不過，這也是最可行的長期實作架構。 如果您的組織願意徹底實施網頁SDK，請參閱網頁SDK檔案，而非使用本指南，以取得詳細資訊。
移轉至Web SDK所需的步驟
請依照下列步驟，將您的資料收集整合移轉至Web SDK。
將Audience Manager服務新增至您在步驟1提及的Analytics移轉中使用的資料流。
-
導覽至experience.adobe.com並使用您的認證登入。
-
使用右上方的首頁或產品選擇器來導覽至 Data Collection。
-
在左側導覽中，選取 Datastreams。
-
選取您在步驟1的Analytics移轉過程中建立的資料串流。
-
選取 Add Service。
-
在服務下拉式功能表中，選取 Audience Manager。
-
檢查 Cookie Destinations Enabled 和 URL Destinations Enabled 選項。 這些選項可讓Edge Network將這些Audience Manager目的地型別傳回頁面。
-
確定 Enable XDM Flattened Fields 已停用。 此選項會停用Analytics變數自動轉換為Audience Manager訊號的功能。 此選項旨在為在Edge Network自動將Analytics資料轉換為Audience Manager訊號之前移轉至Web SDK的使用者維持回溯相容性。
note note NOTE 若要在啟用 Enabled XDM Flattened Fields 選項的情況下移轉至Web SDK，需要更新Audience Manager中格式化為XDM的任何資料，以及使用prop、eVar或事件的所有Audience Manager特徵，以尋找XDM格式的資料。 Adobe建議停用此選項。 
-
選取 Save 以儲存資料流組態。
您的資料流現在已準備好接收資料並傳遞給Audience Manager。 請記下資料串流ID，因為在程式碼中設定網頁SDK時需要此ID。
-
導覽至experience.adobe.com並使用您的認證登入。
-
使用右上方的首頁或產品選擇器來導覽至 Data Collection。
-
在左側導覽中，選取 Datastreams。
-
選取您在步驟1的Analytics移轉過程中建立的資料串流。
-
選取資料流設定頁面右上角的 Edit。
-
展開 Advanced Options 下拉式功能表，並啟用 Third Party ID Sync 功能（如果尚未啟用）。 此選項會通知Edge Network傳回Audience Manager與Experience Platform資料合作夥伴的合作夥伴ID同步。
-
在大多數情況下，您可以將 Third Party ID Sync Container ID 欄位保留空白。 它將預設為
0。 不過，如果您偏好確保使用正確的容器ID，請遵循下列步驟：- 以無痕模式或私密模式開啟瀏覽器視窗，並導覽至屬於移轉一部分的頁面。
- 使用瀏覽器的開發人員工具來篩選
dpm.demdex.net/id的網路呼叫。 此呼叫只會在首次造訪的第一個頁面上觸發，因此需要無痕瀏覽器或私人瀏覽器。 - 檢視請求的裝載。 如果
d_nsid引數不是零，請將其複製到 Third Party ID Sync Container ID 欄位。
-
選取 Save。
您的資料流現在已準備好將資料傳送至Audience Manager，並將Audience Manager回應傳遞至Web SDK。
大多數Audience Manager實作會在跨裝置個人化案例中使用設定檔合併規則，並協助根據訪客的驗證狀態（登入或登出）控制訪客可以符合的區段。 設定檔合併規則要求客戶擁有的識別碼（CRM ID、帳號等）在驗證後每次資料收集呼叫時傳送至Audience Manager。 先前，訪客ID服務(setCustomerIDs)的visitor.js函式是用來將客戶ID附加至每個Analytics資料收集呼叫，然後再轉送至Audience Manager。
透過Web SDK，這些身分現在需要使用名為IdentityMap的特殊XDM建構傳送至Edge Network。
若要在身分對應中正確傳遞身分，必須瞭解身分名稱空間，並仔細考慮要傳遞哪些身分，尤其是在將資料傳送至Experience Platform沙箱時。 本文章概述這些考量事項和指示。
決定要傳遞的身分以及傳遞時間後，請遵循標籤內使用Identity map Identity map 資料元素的指南，或如身分資料概觀中所述手動設定，以符合您的Web SDK部署策略。
aam_uuid Cookie許多年的標準作法是將Audience Manager UUID （第三方Demdex Cookie中的值）放在通常名為aam_uuid的第一方Cookie中。
若要設定Cookie，您必須在設定 Name 時，於Analytics標籤擴充功能之 Unique User ID Cookie 區段的uuidCookie欄位或audienceManagementModule欄位中輸入Cookie名稱。 雖然程式碼中通常會設定，但Cookie很少使用，因為Audience Manager UUID值是廣告平台使用的裝置專屬跨網域識別碼，且很少提供做為第一方識別碼的值。
如果您發現實作需要此aam_uuid Cookie才能在移轉至Web SDK後繼續設定，您可以使用兩種方式擷取Audience Manager UUID。
-
來自Edge Network互動端點的每個回應都包含具有
id個節點的承載。id名稱空間承載的CORE節點包含Audience Manager UUID。 -
使用Web SDK的getIdentity命令來擷取它。 使用檔案中列出的
CORE名稱空間，並從回應中的identity.CORE欄位擷取值。
不論使用何種方法擷取Audience Manager UUID，開發團隊都必須剖析回應、擷取UUID並設定Cookie。 無法透過網頁SDK自動設定此Cookie。
在Analytics報表套裝管理器UI中設定伺服器端轉送和Audience Analytics configure-ssf-analytics
如果您熟悉Analytics 伺服器端轉送功能，可能會想知道：「是否應在Analytics報表套裝管理員UI中停用伺服器端轉送設定，以防止將Analytics資料傳送至Audience Manager兩次？」。
答案是否定的，您不可以停用此設定，原因如下：
-
在資料流上啟用Audience Manager服務時，Edge Network會將
cm.ssf變數附加至傳送給Analytics的所有資料收集請求。 這麼做也會防止Analytics資料傳送至Audience Manager。 當資料流上啟用Assurance服務時，用於驗證Analytics移轉的任何Audience Manager記錄都會顯示cm.ssf=1變數。 如需詳細資訊，請參閱伺服器端轉送的Analytics和GDPR法規遵循頁面。 -
此設定也會啟用Audience Analytics整合的資料流。 如Audience Analytics概觀中所述，此整合需要伺服器端轉送，因為對Analytics資料收集伺服器的Audience Manager回應會在處理前新增至Analytics點選。 Edge Network中也會發生類似的程式。 啟用伺服器端轉送時，Edge Network會將必要區段從Audience Manager回應新增至傳送至Analytics的資料。
總而言之，此設定必須保持啟用，以便Audience Analytics可繼續在Web SDK實作中運作，而且沒有任何資料會在Audience Manager中重複計算。
驗證移轉 validation
現在，所有Adobe解決方案都透過單一Web SDK呼叫提供服務，驗證步驟會因Web SDK提供的解決方案而異。
如果Adobe Target或Adobe Journey Optimizer （包括Decisioning）屬於實作所服務的解決方案棧疊的一部分，則您將在頁面上擁有對Edge Network的多個網路呼叫。 其中有些是用來擷取個人化和選件，有些是用來收集資料和製作報表。
無論您的實作為何，以下一般原則適用於驗證資料是否透過Web SDK正確流進或流出Audience Manager。
-
第一頁首次訪客的第一個網路呼叫將前往
adobedc.demdex.net網域和/interact端點。 您可以開啟網頁瀏覽器上的[開發人員]索引標籤，按一下[網路]索引標籤，然後篩選/interact，以檢視Web SDK所發出的網路呼叫。
還有其他型別的Web SDK呼叫，但只有interact個呼叫會將資料傳送至Edge Network，並從取得回應裝載。
-
第一個網路呼叫的回應有多個負載。 其中一個裝載節點包含數個型別
url的子節點。 這url個節點是過去由Visitor ID服務引發的第三方ID同步。 在您的容器中設定的每個協力廠商ID同步應該有一個url節點（請參閱上述步驟3）。
此外，您可以依
demdex篩選，並發現裝載中參照的每個URL都引發其自己的ID同步網路要求，就像Visitor ID服務一樣。 這些ID同步只應在首次訪客的第一個頁面上引發，而且之後每14天才引發一次。 -
用於Analytics和Audience Manager資料收集的任何後續
/interact請求都應在承載中包含data.__adobe.analytics節點。
依賴這些Analytics變數的Audience Manager特徵，以及使用
h_或d_平台金鑰的特徵應繼續填入。note tip TIP 您可能想要使用規則運算式建立測試特徵，該特徵只有在收集Web SDK資料時才能表達。 由於沒有開發Audience Manager環境，並且多個網站可能會將資料傳送至相同的Audience Manager執行個體，因此只檢視整體母體計數可能無法提供您所需的驗證。 -
在傳遞Analytics變數的相同
/interact呼叫中，可以在回應的裝載節點中找到任何Cookie或URL目的地。 URL目的地會位於型別為url的裝載（就像在第三方ID同步中一樣），而Cookie目的地會位於型別為cookie的裝載。
您也應確定Cookie已放入瀏覽器的Cookie儲存空間中。
note tip TIP 與先前的驗證步驟類似，為應傳回Cookie目的地的區段授予資格是確保資料進出於Audience Manager的一種特定方式。 -
如果您需要透過「身分對應」傳遞其他客戶ID，請在網站中驗證，並確保在要求裝載的「身分對應」節點中傳遞身分及其相關引數。
note tip TIP 如果Adobe Target是其中一個接收解決方案，且有Target活動依賴Audience Manager區段，而需要傳遞正確的身分，請確定身分對應是在用於擷取個人化的 /interact呼叫中傳遞，而不只是資料收集呼叫中傳遞。 擷取區段資訊時，Adobe Target將在對Audience Manager的伺服器端呼叫中使用這些身分識別。