疑難排解 JavaScript 實施

最後更新： 2024年1月26日

建立對象：

以下是貴組織在將資料正確匯入 Adobe Analytics 時可能遇到問題的幾個原因。

使用引號

傳送至 Adobe 的變數大多為字串。在 JavaScript 中，您可以使用單引號或雙引號。

作為最佳實務，請務必與您使用的引號型別一致。如果以單引號指定字串的開頭，就必須使用單引號來結束該字串。

例如 s.eVar1 = 'Value' 和 s.eVar1 = "Value" 都有效。s.eVar1 = 'Value" 無效.

有時需要在字串中加入單引號或雙引號。例如需要在報表中加入 Alex's sale 或 John the "Hunter" 值時。有兩種方法可包含這些值：

使用其他引號類型：例如 s.eVar1 = "Alex's sale" 和 s.eVar1 = 'John the "Hunter"' 都有效。
逸出引號：使用反斜線來逸出引號。例如 s.eVar1 = 'Alex\'s sale' 和 s.eVar1 = "John the \"Hunter\"" 都有效。

有些程式會自動將中性引號 ("..." 和 '...') 轉換為捲曲引號 ("..." 和 '...')。請避免使用文件編輯器 (例如 Microsoft Word)，或透過電子郵件傳送程式碼片段。JavaScript 中無法使用捲曲引號。

所有傳送至 Adobe 的變數都會使用 Analytics 物件。大部分實施都使用 s 物件。請務必在參考您將 Analytics 物件納入參考的變數時加以確認。

例如 s.eVar1 = 'Value' 有效，而 eVar1 = 'Value' 非有效。

追蹤函數 (s.t()) 執行時，AppMeasurement 會擷取所有已定義的變數，並將它們編譯為影像要求。如果您在實施中定義變數多次，則只會使用最新的值。請確定追蹤函數執行時，所有變數值都包含正確的值。

有些變數使用大寫字母。JavaScript 變數區分大小寫。請務必在定義變數時使用正確的大小寫。例如 s.eVar1 = 'Value' 有效，而 s.evar1 = 'Value' 非有效。

有些組織會使用外掛程式來改善 Adobe Analytics 的實施。升級 AppMeasurement 版本時，請勿忘記重新包含任何已安裝的外掛程式。在代碼管理器中建立的程式碼不含任何外掛程式的程式碼。製作現有程式碼的副本，以備您需要回復至舊版 AppMeasurement 時使用。

HTML 中有數個字元會產生空白字元。這些字元包括空格、定位字元和歸位字元 (或換行字元)。考量下列範例：

<head>
  <title>
    Home Page
  </title>
</head>
<body>
<script language="javascript">
  s.pageName = document.title;
</script>
</body>

在此情況下，document.title 會填入 s.pageName，而其會收到「Home Page」值。不過有些瀏覽器可能以不同方式解譯空格。結果可能是下列兩個範例之一：

s.pageName = "Home Page";

s.pageName = "        Home Page";

在 Adobe Analytics 中，將這兩個變數值視為獨立個體，但是會自動移除空白字元以利顯示。結果報表會顯示兩個看似相同的「Home Page」行項目。請確定變數值中所需值的前後不含空白字元。

將很長的值填入許多變數的實作有時會遇到截斷的影像要求。有些較舊的瀏覽器 (例如 Internet Explorer) 會對影像要求 URL 施加 2083 個字元的限制。如果您的組織遇到很長的影像要求，請嘗試下列步驟：

使用 Experience Cloud ID 服務：AppMeasurement 程式庫 1.4.1和更新版本會在影像要求過長時，使用 HTTP POST 來自動傳送影像要求。不論資料長度為何，使用此方法傳送的資料都不會遭截斷。如需詳細資訊，請參閱 Adobe Experience Cloud ID 服務。
使用處理規則：處理規則可將值從一個變數複製到另一個變數。此方法可讓您省去在多個變數中設定相同值的繁瑣操作。例如：

一律執行：

以 eVar1 覆寫 Prop1 的值

以 eVar1 覆寫 eVar2 的值

以 eVar1 覆寫 prop2 的值

然後在您的實作中設定 eVar1：
s.eVar1 = "The quick brown fox jumps over the lazy dog";
使用動態變數：如果您的實作會將相同的值填入許多變數中，您可以使用動態變數來縮短要求 URL：
s.eVar1 = "The quick brown fox jumps over the lazy dog"; s.eVar2 = "D=v1"; s.prop1 = "D=v1"; s.prop2 = "D=v1";
使用分類：如果產品或頁面名稱異常地長，您可以使用識別值或代碼，然後使用分類來顯示更好記的名稱。

上一頁舊版跨裝置常見問題集

下一頁使用硬式編碼影像要求實作 Analytics