Show Menu
主題×

實作適用於 Analytics、Audience Manager 和 Target 的 Experience Cloud Identity Service

這些指示適用於想使用 Experience Cloud Identity Service 但不想使用 Dynamic Tag Management (DTM) 的 Analytics、Audience Manager 和 Target 客戶。不過,我們強烈建議您使用 DTM 來實作 ID 服務。DTM 可簡化實作工作流程,並自動確保程式碼放置和順序的正確性。
開始前請先參閱 ID 服務 需求 ,並注意本實作專屬的下列需求:>
  • 使用 s_code 的客戶無法完成此程序。請升級至 mbox 程式碼 v61 以完成此程序。
  • 請​
    ​在開發環境中設定與測試此程式碼,然後才在生產環境中實作。

步驟1:規劃伺服器端轉送

除了此處所述步驟以外,使用 Analytics 和 Audience Manager 的客戶也應移轉至伺服器端轉送。伺服器端轉送功能可讓您移除 DIL (Audience Manager 的資料收集程式碼),並將其取代為 對象管理模組 。如需詳細資訊,請參閱 伺服器端轉送文件
要移轉至伺服器端轉送,必須進行規劃和協調。此程序牽涉到對您的網站程式碼進行的外部變更,以及 Adobe 為了佈建您的帳戶而須執行的內部步驟。事實上,其中許多移轉程序都需要並行執行,並且一起發行。您的實作路徑應依照以下事件順序進行:
  1. 與您的 Analytics 和 Audience Manager 聯絡人合作,一同規劃 ID 服務與伺服器端轉送移轉。選擇追蹤伺服器是此規劃的重要一部分。
  2. 完成 整合與佈建網站 上的表單即可開始使用。
  3. 同時實作 ID 服務與 Audience Management Module。為了正常運作,Audience Management Module (伺服器端轉送) 和 ID 服務必須針對相同的頁面集同時發行。

步驟 2:下載 ID 服務程式碼

ID 服務需要
VisitorAPI.js
程式碼程式庫。若要下載此程式碼程式庫:
  1. 前往​
    管理 > 代碼管理器
  2. 在「代碼管理器」中,按一下
    JavaScript (新)
    JavaScript (舊)
    。即會下載壓縮的程式碼程式庫。
  3. 解壓縮程式碼檔案,並開啟
    VisitorAPI.js
    檔案。

步驟 3:將 Visitor.getInstance 函數新增至 ID 服務程式碼

  • 舊版 ID 服務 API 將此函數放置在不同的位置,且需要不同的語法。如果您要從 1.4 版 之前的版本移轉,請留意此處說明的新位置和語法。
  • ALL CAPS 中的程式碼是實際值的預留位置。請將此文字取代為您的組織 ID、追蹤伺服器 URL 或其他指定值。
第 1 部分:複製下方的 Visitor.getInstance 函數
var visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE", { trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure // To enable CNAME support, add the following configuration variables // If you are not using CNAME, DO NOT include these variables marketingCloudServer: "INSERT-TRACKING-SERVER-HERE", marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure });
第 2 部分:將函數程式碼新增至 Visitor API.js 檔案
Visitor.getInstance
函數放置在程式碼區塊之後的檔案結尾。您編輯的檔案應該看起來如下所示:
/* ========== DO NOT ALTER ANYTHING BELOW THIS LINE ========== Version and copyright section */ // Visitor API code library section // Put Visitor.getInstance at the end of the file, after the code library var visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE", { trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure // To enable CNAME support, add the following configuration variables // If you are not using CNAME, DO NOT include these variables marketingCloudServer: "INSERT-TRACKING-SERVER-HERE", marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure });

步驟 4:將您的 Experience Cloud 組織 ID 新增至 Visitor.getInstance

Visitor.getInstance
函數中,將
INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE
取代為 Experience Cloud 組織 ID。如果您不知道組織 ID,可以在 Experience Cloud 管理頁面中找到。您編輯的函數看起來可能類似於下列範例。
var visitor = Visitor.getInstance("1234567ABC@AdobeOrg", { ...
請勿
​變更組織 ID 中的字元大小寫。ID 區分大小寫,需如實使用。

步驟 5:將追蹤伺服器新增至 Visitor.getInstance

Analytics 會使用追蹤伺服器進行資料收集。
第 1 部分:尋找您的追蹤伺服器 URL
檢查
s_code.js
AppMeasurement.js
檔案,以尋找追蹤伺服器 URL。您想根據下列變數指定 URL:
  • s.trackingServer
  • s.trackingServerSecure
第 2 部分:設定追蹤伺服器變數
若要確認所應使用的追蹤伺服器變數:
  1. 回答下列決策對照表中的問題。請使用與您的答案相對應的變數。
  2. 將追蹤伺服器預留位置取代為您的追蹤伺服器 URL。
  3. 將未使用的追蹤伺服器與 Experience Cloud 伺服器變數從程式碼中移除。
使用時,請將 Experience Cloud 伺服器 URL 與其對應的追蹤伺服器 URL 配對,如下所示:
  • Experience Cloud 伺服器 URL = 追蹤伺服器 URL
  • Experience Cloud 伺服器安全 URL = 追蹤伺服器安全 URL
若不清楚如何尋找您的追蹤伺服器,請參閱 常見問題集 正確填入 trackingServer 及 trackingServerSecure 變數

步驟 6:更新您的 AppMeasurement.js 檔案

此步驟需要用到 AppMeasurement。如果您仍在使用 s_code,將無法繼續。
將下方所示的
Visitor.getInstance
函數新增至您的
AppMeasurement.js
檔案。將此函數放置在包含設定的相同區段 (例如
trackDownloads
linkInternalFilters
charSet
等)。
s.visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE");
此時您應移除 Audience Manager DIL 程式碼,改為使用「對象管理模組」。如需相關指示,請參閱 實作伺服器端轉送
***(可選用,但建議使用)*建立自訂 Prop **
AppMeasurement.js
中設定自訂 prop 以測量涵蓋範圍.將此自訂 Prop 新增至
doPlugins
檔案的
AppMeasurement.js
函數:
// prop1 is used as an example only. Choose any available prop. s.prop1 = (typeof(Visitor) != "undefined" ? "VisitorAPI Present" : "VisitorAPI Missing");

步驟 7:將訪客 API 程式碼新增至頁面

[VisitorAPI.js]
檔案放入每個頁面的
<head>
標籤中。將
VisitorAPI.js
檔案放到頁面中時:
  • 放在
    <head>
    區段的開頭處,使其出現在其他解決方案標籤的前面。
  • 必須在 AppMeasurement 及其他 Experience Cloud 解決方案的程式碼之前執行此檔案。

步驟 8:(選用) 設定寬限期

若其中有任何使用案例適用於您的情況,請要求 客戶服務 設定暫時的 寬限期 。寬限期最多可達 180 天。如有必要,您可以更新寬限期。
部分實作
如果部分頁面使用 ID 服務,部分頁面未使用,且這些頁面全部都向相同的 Analytics 報告套裝報告,則您需要寬限期。如果您有跨網域報告的全域報告套裝,就常會有此需要。
在所有向相同報告套裝報告的網頁上部署 ID 服務後,請停止寬限期。
s_vi Cookie 需求
如果您要求新訪客在移轉至 ID 服務後必須要有 s_vi Cookie,則需要寬限期。如果實作讀取 s_vi Cookie 並將其儲存在變數中,這個情況是很常見的。
當您的實作可擷取 MID,而非讀取 s_vi Cookie 之後,則可停止寬限期。
點擊流資料整合
如果您將資料從點擊流資料資料源傳送至內部系統,而且該程序使用
visid_high
visid_low
欄位,則需要寬限期。
您的資料擷取程序可使用
post_visid_high
post_visid_low
欄之後,即可停止寬限期。
另請參閱 點按流資料欄參考

步驟 9:測試並驗證

本實作中的 Experience Cloud 解決方案會以機碼值組的形式傳回 ID。每個解決方案使用不同的機碼 (例如 Analytics SDID、Target mboxMCSDID) 來保存相同的 ID。若要測試實作,請在開發環境中載入您的頁面。使用監控 HTTP 要求和回應的瀏覽器主控台或軟體,來檢查下表中列出的 ID。如果下列機碼值組傳回相同的 ID 值,代表已正確實作 ID 服務。
您可以使用 Adobe 偵錯工具 Charles HTTP Proxy 來檢查這些解決方案特有的 ID。不過,您當然可以使用最適合您的任何工具或偵錯工具。
所有解決方案
檢查:
  • AMCV Cookie ,在托管頁面的網域中。
  • Experience Cloud ID (MID) 搭配 Adobe 偵錯工具或您慣用的偵錯工具。
如需可協助您判斷 ID 服務是否正常運作的其他檢查,請參閱 測試及驗證 Experience Cloud Identity Service
Analytics
檢查 JavaScript 請求中的 SDID 識別碼。Analytics SDID 應符合 Target mboxMCSDID。
如果測試傳回 AID,則表示有下列其中一種情況:
  • 您在移轉舊版 Analytics ID 的程序中傳回訪客。
  • 您已啟用 寬限期
如果看到 AID,請根據 Target mboxMCAVID 檢查其值。如果有正確實作 ID 服務,這些值會相同。
Audience Manager
若要測試伺服器端轉送,請參閱 如何驗證您的伺服器端轉送實作
Target
檢查:
  • mboxMCGVID
  • mboxMCSDID (mboxMCSDID 應符合 Analytics SDID)。
如果測試傳回 mboxMCAVID,則表示有下列其中一種情況:
  • 您在移轉舊版 Analytics ID 的程序中傳回訪客。
  • 您已啟用寬限期。
如果看到 mboxMCAVID,請根據 Analytics AID 檢查其值。如果有正確實作 ID 服務,這些值會相同。
部署

步驟 10:部署

在程式碼通過測試後加以部署。
如果您已啟用寬限期:
  • 確定 Analytics ID (AID) 與 MID 位於影像請求中。
  • 當您符合 中止條件 時,請記得停用寬限期。