將Audience Manager的資料收集程式庫從Audience Manager標籤擴充功能更新為網頁SDK標籤擴充功能
目標對象
此頁面適用於使用Audience Manager標籤擴充功能將網頁集合資料匯入Audience Manager的Audience Manager客戶。 若客戶使用AppMeasurement JavaScript資料庫,請參閱如何將Audience Manager 的資料收集資料庫從AppMeasurement JavaScript資料庫更新至Web SDK JavaScript資料庫的指南。
此實作路徑的優缺點
使用此移轉方法的優缺點。 請仔細權衡每個選項,決定哪種方式最適合您的組織。
- 您的網站上沒有程式碼變更:因為您的實作已安裝標籤,所以可以在標籤介面中進行所有移轉更新。
- 使用您現有的實作:此方法不需要全新實作。 雖然這確實需要新的規則動作,但您可以以最小的變更重複使用現有的資料元素和規則條件。
- 不需要結構描述:對於移轉至Web SDK的這個階段,您不需要XDM結構描述。 相反地,您可以填入
data
物件,這會直接將資料傳送到Adobe Audience Manager。 一旦移轉至Web SDK完成,您就可以為貴組織建立結構描述,並使用資料流對應來填入適用的XDM欄位。 如果移轉流程的這個階段需要結構描述,貴組織將被強制使用Adobe Audience Manager XDM結構描述。 使用此結構描述會使您的組織未來更難以使用您自己的結構描述。
- 實作技術債:由於此方法使用您現有實作的修改形式,因此可能更難追蹤實作邏輯並在需要時執行變更。 自訂程式碼可能特別難以偵錯。
- 需要對應才能將資料傳送至Platform:當您的組織準備好使用Real-Time CDP時,您必須將資料傳送至Adobe Experience Platform中的資料集。 此動作要求
data
物件中的每個欄位必須是資料流對應工具中的專案,以將其指派給XDM結構描述欄位。 此工作流程只需對應一次,不需要變更實作。 不過,這是在XDM物件中傳送資料時不需要的額外步驟。
Adobe建議您在有使用Adobe Audience Manager標籤擴充功能的現有實作時遵循此實作路徑。
移轉至Web SDK所需的步驟
下列步驟包含需努力達成的具體目標。 選取每個步驟,以取得如何完成的詳細說明。
請依照下列指示,在Adobe Experience Platform Data Collection中建立資料流。 當您傳送資料至此資料流時,它會轉送資料至Audience Manager。 未來,相同的資料流會將資料轉送至Real-Time CDP。
-
導覽至experience.adobe.com並使用您的認證登入。
-
使用右上方的首頁或產品選擇器來導覽至 Data Collection。
-
在左側導覽中,選取 Datastreams。
-
選取 New Datastream。
-
輸入所要的名稱,然後選取 Save。
-
建立資料流後,請選取 Add Service。
-
在服務下拉式功能表中,選取 Adobe Audience Manager。
-
請確定未核取 Enable XDM Flattened Fields 選項。
您的資料流現在已準備好接收資料並傳遞給Audience Manager。
本節將準備您的標籤,以利後續步驟中進行的大量移轉作業。
-
選取Adobe Experience Platform介面左上角的漢堡圖示,然後選取 Tags。
-
選取所需的標籤屬性。
-
在標籤屬性的左側導覽中,選取 Extensions。
-
選取頂端附近的 Catalog,檢視所有可用副檔名的清單。
-
搜尋並選取 Adobe Experience Platform Web SDK 副檔名,然後在右側選取 Install。
-
擴充功能組態設定隨即顯示。 找到 Datastreams 區段,然後選取您使用的沙箱以及您在上一步中建立的資料流。
-
選取 Save。
您的標籤屬性現在已安裝Web SDK。
資料物件資料元素提供直覺式架構,可設定Web SDK用來傳送至資料流的裝載。 您在下列步驟中更新的大部分規則都會與此資料元素互動。
-
在標籤介面的左側導覽中,選取 Data Elements。
-
選取 Add Data Element
-
為資料元素執行下列設定:
- Name:您想要的任何專案,例如「資料層」或「資料物件」
- Extension: Adobe Experience Platform Web SDK
- Data Element Type: Variable
- 核取方塊可以維持原狀。
-
在右側,選取下列設定:
- 屬性選項按鈕: Data
- Solution: Adobe Audience Manager
-
選取 Save。
您的標籤屬性現在擁有更新每個規則所需的一切。
此步驟包含移轉至Web SDK所需的大部分工作,且需要瞭解您實作的運作方式。 以下提供如何編輯典型標籤規則的範例。 更新實施中的所有標籤規則,以Web SDK擴充功能取代Audience Manager擴充功能的所有參考。
-
在標籤介面的左側導覽中,選取 Rules。
-
選取要編輯的規則。
-
選取動作 Audience Manager - Set Variables
-
請注意在此規則內設定的所有Audience Manager變數。 納入在下拉式功能表中設定的變數,以及在自訂程式碼中設定的變數。
-
將Action Configuration變更為下列設定:
- Extension: Adobe Experience Platform Web SDK
- Action type:更新變數
-
確定已在右側 Data element 欄位的下拉式清單中選取您在步驟3建立的資料物件。
-
將Audience Manager機碼值組設為其各自在Audience Manager擴充功能中設定的相同值。
-
使用Web SDK擴充功能復寫所有規則邏輯後,請選取 Keep Changes。
-
對使用Audience Manager標籤擴充功能設定值的每個動作設定重複這些步驟。
上述步驟僅適用於設定值的規則。 下列步驟會取代所有使用Action Configuration Send Event的動作。
-
選取傳送網頁SDK事件的規則。
-
選取動作型別 Send Event。
-
將Action Configuration變更為下列設定:
- Extension: Adobe Experience Platform Web SDK
- Action type: Send event
-
在右側,將動作設定變更為下列專案:
- Type:使用 Web Webpagedetails Page Views。
- Data:選取您在步驟3建立的資料物件。
-
選取 Keep Changes。
-
對使用Audience Manager傳送事件的每個動作設定重複這些步驟。
發佈更新規則的工作流程,與標籤設定的任何其他變更相同。
-
在標籤介面的左側導覽中,選取 Publishing Flow。
-
選取 Add Library。
-
為此標籤認可命名,例如「升級至Web SDK」。
-
選取 Add All Changed Resources。
-
選取 Save。
-
發佈工作流程會顯示橘色點,表示正在建置。 圓點變成綠色後,您的變更即可在開發環境中使用。
-
在開發環境中測試您的變更,以確保所有規則皆正確引發,且資料物件會填入預期值。
-
準備就緒後,請提交程式庫進行核准、建置到測試環境,最後核准並發佈到生產環境。
將標籤實作完全移轉至Web SDK後,您就可以停用Audience Manager擴充功能。
- 在標籤介面的左側導覽中,選取 Extensions。
- 找到並選取Audience Manager副檔名。 在右側選取 Disable。
- 依照上述相同的發佈工作流程,發佈移除Audience Manager延伸模組。
- 擴充功能在生產環境中停用後,您就可以完全解除安裝。 選取副檔名,選取右側的三個點功能表,然後選取 Uninstall。
- 按照上面的相同發佈工作流程,將這些變更發佈到生產環境。
此時,您的Audience Manager實作已完全移轉至Web SDK,並準備好在未來移轉至Real-Time CDP。