Show Menu
主題×

實作適用於 Analytics 的 Experience Cloud Identity 服務

這些指示適用於想使用 Experience Cloud Identity 服務但不想使用 Dynamic Tag Management (DTM) 的 Analytics 客戶。不過,我們強烈建議您使用 DTM 來實作 ID 服務。DTM 可簡化工作流程並自動確保程式碼的放置和順序正確無誤。
  • 先閱讀需求 ,再開始使用。
  • 先在開發環境中設定與測試此程式碼,然後才在生產中實作。
請依照以下步驟實作 Adobe Analytics 的 ID 服務:

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

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

步驟 2.將 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 部分: 將函數程式碼新增至 VisitorAPI.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 });

步驟 3: 將您的 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 區分大小寫,需如實使用。

步驟 4: 將追蹤伺服器新增至 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
If you're not sure how to find your tracking server see the FAQ and Correctly Populate the trackingServer and trackingServerSecure variables .

步驟 5: 更新您的 AppMeasurement.js 或 s_code.js 檔案

將此函數新增至
AppMeasurement.js
s_code.js
檔案:
s.visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE");
將程式碼放置在包含設定的相同區段 (例如
trackDownloads
linkInternalFilters
charSet
等)。
**
(可選用,但建議使用)
建立自訂 Prop
AppMeasurement.js
s_code.js
中設定自訂 prop,以測量涵蓋範圍.將此自訂 Prop 新增至
doPlugins
AppMeasurement.js
檔案的
s_code.js
函數:
// prop1 is used as an example only. Choose any available prop. s.prop1 = (typeof(Visitor) != "undefined" ? "VisitorAPI Present" : "VisitorAPI Missing");

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

VisitorAPI.js
檔案放入每個頁面的
<head>
標籤中。將
VisitorAPI.js
檔案放到頁面中時:
  • 放在
    <head>
    區段的開頭處,使其出現在其他解決方案標籤的前面。
  • 必須在 AppMeasurement 及其他 Experience Cloud 解決方案的程式碼之前執行此檔案。
測試並驗證之後,將程式碼移至生產環境。

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

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
欄之後,即可停止寬限期。
點擊流 (Clickstream) 資料擷取

步驟 8: 測試並部署 ID 服務程式碼

您可以依照以下流程進行測試和部署。
測試和驗證
若要測試您的 ID 服務實作,請檢查:
  • 托管網頁之網域中的 AMCV Cookie
  • 透過 AnalyticsAdobe 偵錯工具 檢查 影像請求中的 MID 值。
部署程式碼
當程式碼通過測試後,進行部署。
如果您在 步驟 7 中已啟用寬限期:
  • 請確保 Analytics ID (AID) 與 MID 位於影像請求中。
  • 當您符合中止條件時,請記得停用寬限期。