Show Menu
主題×

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

這些指示適用於想使用 Experience Cloud Identity 服務但不想使用 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 版 之前的版本移轉,請注意此處說明的新位置和語法。
  • 全部大寫的程式碼是實際值的預留位置。請以您的組織 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: (選用) 設定寬限期

If any of these use cases apply to your situation, ask Customer Care to set up a temporary grace period . 寬限期可執行最多 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 服務。
You can use the Adobe Debugger or the Charles HTTP proxy to check for these solution-specific IDs. 不過,您當然可以使用最適合您的任何工具或偵錯工具。
所有解決方案
檢查下列項目:
  • AMCV Cookie ,在托管頁面的網域中。
  • Experience Cloud ID (MID) 搭配 Adobe 偵錯工具或您慣用的偵錯工具。
如需可協助您判斷 ID 服務是否正常運作的其他檢查,請參閱 測試及驗證 Experience Cloud Identity 服務
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 位於影像請求中。
  • 當您符合 中止條件 時,請記得停用寬限期。