將網站的Audience Manager實作從使用者端DIL移轉至伺服器端轉送 migrating-your-site-s-aam-implementation-from-client-side-dil-to-server-side-forwarding
如果您同時擁有Adobe Audience Manager (AAM)和Adobe Analytics,而且您目前正在使用DIL(Data Integration Library)程式碼從頁面傳送點選至AAM,以及從頁面傳送點選至Adobe Analytics,則此教學課程適用於您。 由於您擁有這兩個解決方案,而且它們都是Adobe Experience Cloud的一部分,因此您有機會遵循開啟伺服器端轉送的最佳做法,這可讓Analytics資料收集伺服器即時轉送網站分析資料至Audience Manager,而不是讓使用者端程式碼從頁面傳送額外點選至AAM。 本教學課程將逐步帶您瞭解從舊版使用者端DIL實作切換至新版伺服器端轉送方法的步驟。
使用者端(DIL)與伺服器端 client-side-dil-vs-server-side
比較和比較這兩種將Adobe Analytics資料匯入AAM的方法時,先將差異以視覺效果顯示在下列影像中可能有所助益:
使用者端DIL實施 client-side-dil-implementation
如果您使用此方法將Adobe Analytics資料匯入AAM,您會有兩個點選來自您的網頁:一個會前往Analytics,另一個會前往AAM (在網頁上複製Analytics資料後)。 Segments會從AAM傳回至頁面,以便用於個人化等。 這將視為舊版實作,不再建議使用。
除了這並非遵循最佳實務之外,使用此方法的缺點包括:
- 來自頁面的兩個點選,而非只有一個
- 需要伺服器端轉送才能將AAM對象即時分享到Analytics,因此使用者端實作不允許此功能(以及未來可能的其他功能)
建議您改用AAM實作的伺服器端轉送方法。
伺服器端轉送實作 server-side-forwarding-implementation
如上圖所示,點選來自指向Adobe Analytics的網頁。 Analytics然後即時將該資料轉送到AAM,系統會將訪客評估為AAM特徵和segments,就像點選直接來自頁面一樣。
Segments會在相同的即時點選上傳回Analytics,這會將其上的回應轉送至網頁以進行個人化等。
移至伺服器端轉送沒有時間上的問題。 Adobe強烈建議同時擁有Audience Manager和Analytics的任何人使用此實作方法。
您有兩個主要任務 you-have-two-main-tasks
本頁有不少資訊,當然也很重要。 不過,它 可歸結為您需要做的兩項主要工作:
- 將您的程式碼從使用者端DIL程式碼變更為伺服器端轉送程式碼
- 在Analytics Admin Console中反向切換以開始實際轉送資料(根據report suite)
如果您略過其中一項工作,伺服器端轉送將無法正常運作。 已新增步驟和其他資料至本檔案,協助您在設定中正確執行這兩個步驟。
實作選項 implementation-options
當您從使用者端轉送移至伺服器端轉送時,其中一個工作是將程式碼變更為新的伺服器端轉送程式碼。 使用下列其中一個選項來完成:
- Adobe Experience Platform標籤 — Adobe建議的Web屬性實作選項。 您會發現這是一項輕鬆的工作,因為Platform標籤已為您完成所有艱難的工作。
- 在頁面上 — 您也可以將新的SSF程式碼直接放入
appMeasurement.js
檔案內的doPlugins
函式中(如果尚未使用Adobe啟動) - 其他標籤管理員 — 這些處理方式與上一個(在頁面上)選項相同,因為無論其他標籤管理員儲存AppMeasurement程式碼,您仍會將SSF程式碼放入
doPlugins
我們將在 更新程式碼 區段中逐一檢視這些專案。
實作步驟 implementation-steps
下列步驟說明實作。
步驟0:先決條件:Experience CloudID服務(ECID) step-prerequisite-experience-cloud-id-service-ecid
移至伺服器端轉送的主要先決條件為實作Experience CloudID服務。 如果您使用Experience Platform Launch,這可輕鬆完成這項工作,此時您只需安裝ECID擴充功能,其他動作就會執行。
如果您使用非AdobeTMS或完全沒有TMS,請實作ECID以執行 之前 任何其他Adobe解決方案。 如需詳細資訊,請參閱ECID檔案。 唯一的其他先決條件與程式碼版本有關,因此您只需在下列步驟中套用程式碼的最新版本,就不會有問題。
步驟1:從DIL程式碼記錄目前使用的選項 step-record-currently-used-options-from-dil-code
當您準備好從使用者端DIL代碼移至伺服器端轉送時,第一步是識別您使用DIL代碼執行的所有操作,包括自訂設定和傳送至AAM的資料。 需注意及考慮的事項包括:
- 一般Analytics變數,使用
siteCatalyst.init
DIL模組 — 您不需要擔心此變數,因為其工作只是傳送一般Analytics變數,只要啟用伺服器端轉送即可完成。 - 夥伴子網域 — 在
DIL.create
函式中,記下partner
引數。 這稱為您的「合作夥伴子網域」,或有時稱為「合作夥伴ID」,當您放置新的伺服器端轉送程式碼時,將需使用此專案。 - Visitor Service Namespace — 也稱為您的"Org ID"或"IMS Org ID",當您設定新的伺服器端轉送程式碼時,也會需要此專案。 記下它。
- containerNSID、uuidCookie和其他進階選項 — 記下您正在使用的其他進階選項,以便在伺服器端轉送程式碼中設定它們。
- 其他頁面變數 — 如果從頁面將其他變數傳送到AAM (除了siteCatalyst.init處理的一般Analytics變數之外),您將需要記下這些變數,以便透過伺服器端轉送來傳送它們(破壞程式警示:透過contextData變數)。
步驟2:更新程式碼 step-updating-the-code
在實作選項 (以上)中,會針對您實作伺服器端轉送的方式和位置提供多個選項。 為了讓此區段生效,我們需要將其分成這些區段(其中兩個區段合併在一起)。 移至本節最能描述您需求的方法。
Adobe Experience Platform標籤 launch-by-adobe
觀看以下影片,瞭解如何在Experience Platform Launch中將實作選項從使用者端DIL程式碼移至伺服器端轉送。
「在頁面上」或非Adobe標籤管理員 on-the-page-or-non-adobe-tag-manager
觀看以下影片,瞭解如何將實作選項從使用者端DIL程式碼移至伺服器端轉送(使用AppMeasurement程式碼,位於檔案或非Adobe標籤管理系統中)。
步驟3:啟用轉送(根據Report Suite) step-enabling-the-forwarding-per-report-suite
在本教學課程中,我們目前花所有時間將程式碼從使用者端DIL程式碼切換至伺服器端轉送。 沒關係,因為這是比較困難的部分。 雖然您會看到本節非常簡單,但與更新程式碼一樣重要。 在本影片中,您將會瞭解如何切換開關,以實際將資料從Analytics轉送至Audience Manager。
注意: 如影片中所述,最多需要4小時才能在Experience Cloud後端完全實作轉送。
時間 timing
提醒您,從使用者端DIL移至伺服器端轉送有兩個主要工作:
- 更新程式碼
- 在Analytics Admin Console中反向切換
但問題是,您首先要做什麼? 這重要嗎? 好的,很抱歉,有兩個問題。 但答案是……視情況而定,是的,它 可以 很重要。 這表示模糊嗎? 讓我們來加以劃分。 但首先,如果您是擁有許多網站的大型組織,會提出另一個問題:我是否必須一次完成所有工作? 那個比較簡單。 沒有。 您可以逐一執行。
再深入一點 a-little-deeper-dive
時間與順序之所以重要,是因為轉送 實際上 的運作方式,其摘要可歸納為下列幾個技術事實:
- 如果您已實作Experience CloudID服務(ECID),而且Analytics Admin Console中的開關(「開關」)已開啟,即使您尚未更新程式碼,資料仍會從Analytics轉送至AAM。
- 如果您尚未實作ECID,則不會轉送資料,即使您已開啟開關,且伺服器端轉送程式碼亦然。
- 伺服器端轉送程式碼(無論在Platform標籤中或頁面上)會真正處理回應,且是完成移轉的必要專案。
- 請記住,伺服器端轉送交換器是由report suite啟用,但程式碼是由Platform標籤中的屬性處理,或是由AppMeasurement檔案處理(如果您未使用Platform標籤)。
最佳實務 best-practices
根據這些技術細節,以下提供何時該做什麼的建議:
如果您尚未實施ECID if-you-do-not-have-ecid-yet-implemented
-
在Analytics中,針對您為伺服器端轉送啟用的每個report suite翻轉開關。
- 因為您沒有ECID,所以轉送尚未開始。
-
針對每個網站,將您的程式碼從使用者端DIL更新至伺服器端轉送(這可能位於Platform標籤中)或頁面上,如上方另一節所述。
- 轉送現在會流程(因為您已新增ECID),且您也應該會收到對Analytics信標的正確JSON回應(請參閱下方的「驗證和疑難排解」一節,以取得詳細資訊)。
如果您已實施ECID if-you-do-have-ecid-implemented
-
準備並規劃,好讓您可以根據report suite將程式碼從DIL更新至伺服器端轉送,以便啟用伺服器端轉送:
-
在Analytics中翻轉交換器以啟用伺服器端轉送。
- 因為您已啟用ECID,轉送功能將會啟動。
-
請儘快將您的程式碼從使用者端DIL更新為單一端轉送(這可以在Platform標籤中或頁面上,如上方另一節所述)。
- 您應該會收到Analytics信標的正確JSON回應(如需詳細資訊,請參閱下方的驗證和疑難排解區段)。
-
有許多網站和report suites時的移轉時間 migration-timing-when-you-have-many-sites-and-report-suites
本主題在前幾節中會簡單介紹,主要策略可歸納如下:
一次移轉一個網站/report suite (或一組網站/report suites)。
不過,根據幾種可能的情況,這可能會有點棘手:
- 您有一個包含數個不同report suites的網站
- 您有一個包含數個網站的report suite (例如全域report suite)
- 您使用一個Platform標籤屬性來涵蓋多個網站
- 您擁有不同網站的不同開發團隊
因為這些專案,事情可能會變得有點複雜。 最好的建議是:
- 請花點時間,根據先前說明的內容,制定移轉至伺服器端轉送的策略
- 根據Platform標籤中的單一屬性(或單一AppMeasurement檔案)通常對應至1或2個相異report suites的事實,您可能會制定一個計畫,逐個處理這些相異群組,將您的企業更新至伺服器端轉送
- 如果您使用Adobe Consulting,請和他們討論您的移轉計畫,讓他們視需要提供協助
驗證和疑難排解 validation-and-troubleshooting
驗證伺服器端轉送是否正常運作的主要方法是,檢視來自應用程式的任何Adobe Analytics點選回應。
如果您沒有執行從Analytics到Audience Manager的資料伺服器端轉送,則不會有任何對Analytics信標的回應(除2x2畫素以外)。 不過,如果您正在執行伺服器端轉送,Analytics要求與回應中就會有可驗證的專案,讓您知道Analytics正在與Audience Manager正確通訊、轉送點選及取得回應。
stuff
物件在回應中。 如果沒有該訊息,您可能會看到顯示"status":"SUCCESS"
的訊息。 雖然聽起來不合理,但這實際上是運作「不」正常的證明。
如需伺服器端轉送的詳細資訊,請參閱檔案。