JavaScript 適用的 AppMeasurement 版本注意事項

JavaScript 適用的 AppMeasurement 累積版本注意事項。

您可以從以下位置下載最新版本的AppMeasurement: GitHub.

2.26.0 版本

發行日期: 2024年3月4日

  • AppMeasurement會自動辨識並利用國家/地區程式碼最上層網域的根網域,而這之前需要特定的Cookie網域設定。 更新可能會因為此自動識別而產生影響。 另請參閱 cookieDomainPeriods 以取得詳細資訊。
  • 此發行版本包含Identity Service Library 5.5.0和Data Integration Library9.6。

2.25.0 版本

發行日期: 2023年9月12日

  • 新增選用方法 bufferRequests() 提升瀏覽器不支援Beacon API或頁面取消載入時取消要求時擷取要求的可靠性。
  • 已新增保護機制,以防止單一追蹤請求出現多個追蹤後回呼。

2.24.0 版本

發行日期: 2023年7月18日

  • 新增可選的設定變數 decodeLinkParameters 將包含雙位元組編碼字元的連結URL解碼。
  • 針對具有錯誤高平均資訊量使用者代理程式使用者端提示API的瀏覽器新增其他錯誤處理。
  • 變更要使用的POST內容型別標頭 x-www-form-urlencoded 依預設。

2.23.0 版本

發行日期:2022 年 9 月 23 日

  • AppMeasurement 現在支援高平均資訊量使用者代理程式用戶端提示的收藏集,Chromium 瀏覽器 (Google Chrome 和 Microsoft Edge) 會使用上述提示來提供裝置資訊。您可以透過「標籤」設定使用者端提示或使用 collectHighEntropyUserAgentHints 設定變數。 高平均資訊量提示的收集預設為停用。 進一步了解使用者代理程式用戶端提示

2.22.4 版本

發行日期:2022 年 1 月 18 日

  • 連結追蹤呼叫 s.tl() 現在會驗證傳遞給它的物件是否包含 string 類型的 href 屬性。如果它不是 string,則會適當地忽略 href 屬性而不是失敗。 當您通過時,可能會發生這種情況 svg 連結追蹤呼叫的物件。

2.22.3 版本

發行日期: 2021 年 10 月 11 日

  • 更新檔案中指向檔案的連結。

2.22.2 版本

發行日期:2021 年 9 月 7 日

  • 此更新會讓 opt.dmpopt.sell 在追蹤連結時一定會被納入。請參閱 隱私權報告 (在管理員使用手冊中)以取得詳細資訊。

2.22.1 版本

發行日期:2021 年 8 月 17 日

  • 使用退出的客戶可能會在追蹤連結時看到伺服器端轉送退出參數不被接受。這個版本中的修正會使得在追蹤連結時如果有退出標幟存在就會傳送這些標幟。

2.22.0 版本

發行日期:2020 年 8 月 4 日

  • 使用者選擇退出偏好設定而造成第一個點擊未傳送,此時要修復缺少的推薦者。

2.21.0 版本

發行日期:2020 年 6 月 24 日

  • 已修正不一定會為 Firefox 套用 Activity Map linkExclusions 篩選器的問題。

2.20.0 版本

發行日期:2020 年 3 月 5 日

  • 已更新 Internet Explorer 偵測以抑制 JSLint 警告,而修正安全性相關問題。

2.19.0 版本

發行日期:2020 年 2 月 21 日

  • Audience Manager 模組已更新至 DIL 9.4。(AN-209341)

2.18.0 版本

發行日期:2020 年 2 月 13 日

  • AppMeasurement 現在可以藉由設定 writeSecureCookies 變數強制 Cookie 包含 Secure 屬性。此變數的需求是,必須安全地提供整個用戶端網站的服務 (HTTPS)。(AN-204604)

2.17.0 版本

發行日期:2019 年 8 月 23 日

  • 新增支援百度查詢字串重新排序。(AN-182483)
  • 修正造成等候選擇加入時排入佇列的點擊中出現過時訪客值的問題。(AN-184391)

2.16.0 版本

發行日期:2019 年 8 月 15 日

  • 為退出連結實施 sendBeacon 支援 (在 AppMeasurement 中)。如果點擊使用 sendBeacon 且頁面取消載入,要求仍會完成。這對於退出連結非常有用,因為點擊更有可能到達資料收集伺服器。(AN-175142)
  • 現在,第一次點擊時會快取 ECID/fid 值,即使 OptIn 設定有所變更。(AN-175142)
  • Audience Manager 模組已更新至 DIL 9.3。(AN-182704)
  • s.ActivityMap.trackScrollReach 中顯示開關,用於開啟或關閉捲動觸及追蹤。(AN-182754)
  • 升級 AppMeasurement 以使用訪客 ID 服務 4.4.0。(AN-182912)

2.15.0 版本

發行日期:2019 年 7 月 15 日

  • 在 Activity Map 擴充功能中新增 ActivityMap 捲動觸及追蹤功能 (AN-172949)
  • 將 DIL 9.2 新增至 AppMeasurement (AN-182472)

2.14.0 版本

發行日期:2019 年 5 月 21 日

  • 修正有多個點擊擱置時發生的追蹤器參數狀態問題。(AN-176931、AN-176629、DTM-12758)
  • 已更新 AppMeasurement 以納入 Visitor.js 4.3.0 (AN-180049)

2.13.0 版本

發行日期:2019 年 4 月 10 日

  • 修正許多 clearVar 回報的問題。若在追蹤器準備就緒前送出點擊,則會發生問題。當追蹤器準備就緒時,程式庫可設定已經清除或變更的變數。(AN-176931、AN-176629、DTM-12758)。

2.12.0 版本

發行日期:2019 年 2 月 22 日

  • Audience Manager 模組已更新至 DIL 9.1。(AN-175255)
  • GTM 安全性政策不允許 Activity Map 模組。(AN-174679)
  • 改善 AppMeasurement;在 Identity Service 不核准選擇加入時,讓使用者可以選擇退出。(AN-175259)

2.11.0 版本

發行日期:2019 年 2 月 11 日

  • 在 AppMeasurement 中,新增了全新 Adobe 選擇加入服務功能的支援。(AN-163546)
  • 新增了在工作階段儲存體上存儲連結追蹤資料的支援。(AN-162272)
  • 新增了 Audio Analytics 媒體資料流類型的支援。(AN-173265)

2.10.0 版本

發行日期:2018 年 9 月 20 日

此版本確保 AppMeasurement 程式庫正確提交所有連接種類的 Cookie。

  • AppMeasurement 在 POST 期間會封鎖 Cookie 傳輸。(AN-165538)
  • 終止對 XDomainRequest 的支援。(AN-165733)
  • 將 AppMeasurement 的預設 Cookie 期限值從五年縮短為兩年。(AN-158572)
  • 從代碼管理器中移除媒體模組 (AppMeasurement) (AN-166590)

2.9.0 版本

發行日期:2018 年 5 月 24 日

NOTE
使用 Experience Cloud ID 服務的客戶需要具備訪客 API 3.0 或更新版本。Adobe 建議只要更新相關的程式碼程式庫 (at.js 等等),就要升級至最新的 Visitor API 版本。AppMeasurement.js
  • 更新 AppMeasurement 以使用更新後的訪客介面要求 ID。(AN-151483)
  • 修正當連結追蹤關閉時持續寫入連結追蹤 Cookie 的問題。(AN-156332)
  • 修正多次呼叫時 registerPreTrackCallbackregisterPostTrackCallback 會破壞回呼函數簽名的問題。(AN-158566)

2.8.2 版本

發行日期:2018 年 4 月 12 日

  • 更新 AppMeasurement 以使用更新後的訪客介面要求 ID。(AN-151483)
  • 當連結追蹤關閉時持續寫入連結追蹤 cookie。(AN-156332)
  • 將 AppMeasurement 的預設 Cookie 期限值從五年縮短為兩年。(AN-158572)

2.8.1 版本

發行日期:2018 年 3 月 29 日

重新組合訪客 API 3.1.0 (AN-159524),並包含 Hotfix:(CORE-11390、CORE-10634)

2.8.0 版本

發行日期:2018 年 3 月 15 日

重新組合訪客 API 3.1.0 (AN-159524),並包含 Hotfix:(CORE-11390、CORE-10634)

  • 將 VAPI v3.1 與 AppMeasurement v2.8 搭配組合。(AN-158353)
  • 重構資料集合端點以便進行分享。(AN-156647)
  • 將請求的來回時間量度新增至 AppMeasurement。(AN-158343)

2.7.0 版本

發行日期:2018 年 1 月 18 日

  • 終止支援 IE 6 到 IE 9
  • 納入 Visitor API v3.0.0
  • 納入 DIL v7.00

2.6.0 版本

發行日期:2017 年 11 月 9 日

修正呼叫 s_gl 時,AppMeasurement 程式庫無法每次都設為正確帳戶組合的問題。(AN-152153)

2.5.0 版本

發行日期:2017 年 9 月 21 日

  • 納入 dil.js 6.12 (Audience Manager 模組)
  • 納入訪客 API 2.5.0。

2.4.0 版本

發行日期:2017 年 8 月 17 日

  • 納入 dil.js v6.11
  • 納入訪客 API 2.4.0

2.3.0 版本

發行日期:2017 年 7 月 20 日

  • 修正 s.Util.getQueryParam 擷取 # 的錯誤
  • 新增 dil.js v6.10 (AN-145701)

2.2.0 版本

發行日期:2017 年 6 月 8 日

  • 新增對多重 AppMeasurement 具現化階層的支援。(AN-138237)
  • 納入訪客 API 2.2.0 版本。(AN-144042)

2.1.0 版本

發行日期:2017 年 4 月 20 日

  • 納入最新版本 dil.js (AN-140396)
  • 新增對 adobe_mc_ref 參數的支援,可覆蓋頁面反向連結。(AN-131920)
  • 重新納入 Visitor API 2.1.0。(AN-140873)
  • 新增 mcorgid 參數。(AN-139586)
  • 新增 cp (customerPerspective) 參數。(AN-140897)

2.0.0 版本

發行日期:2017 年 3 月 9 日

  • 移到需要到更新版本 2.0.0 新的建立程序。(AN-137878)
  • 將「mboxMCSDID」的處理移到追蹤呼叫發出的正確截面位置。(AN-138483)

1.8.0 版本

發行日期:2017 年 1 月 19 日

  • 納入 Visitor API 2.0.0
  • 重新排序函數呼叫和檢查,以便在中止檢查完成後使用 SDID。(AN-134364)
  • 新增 s.registerPreTrackCallbacks.registerPostTrackCallback 鉤點。(AN-134567)

1.7.0 版本

更新日期:2016 年 11 月 11 日

  • 納入 Visitor API 1.10.1。
  • 使用 Demdex Integration Library (DIL) 6.6 更新 Audience Manager 模組。(AN-132065)
  • 納入 Visitor API 1.9.0。(AN-132072)
  • 使用 DIL 6.5 和其他設定更新 AppMeasurement Audience Manager 模組 (AN-129411)
  • 包括 Visitor API 1.8.0 (AN-129887)

1.6.4 版本

更新日期: 2016 年 8 月 18 日

  • 更新 AppMeasurement,可讀取和寫入 AMCV Cookie。(AN-127098)
  • 納入 Visitor API 1.7.0。
NOTE
另請參閱下列 JavaScript 1.6.3 版本的版本注意事項中,對 Experience Cloud ID 服務的更新要求。

1.6.3 版本

更新日期: 2016 年 8 月 4 日

  • 修正 AppMeasurement 提前終止請求連線的問題。(AN-126448)
IMPORTANT
1.6.0 版本 Experience Cloud ID 服務「需使用」**AppMeasurement 供 JavaScript 1.6.3 版本或更新版本使用。如果您想要升級為 1.6.0 版的 Experience Cloud ID Service,請務必使用 AppMeasurement 1.6.3 版或更新版本。

1.6.2 版本

發行日期:2016 年 7 月 21 日

  • 已納入 Visitor API 1.6.0。
  • 修正導致 AppMeasurement 在訪客 API 中呼叫了錯誤隱藏方法的問題。(AN-126006)
  • 修正引發此 JavaScript 錯誤的問題:「屬性僅在 v:image 上有效」。(AN-124009)

1.6.1 版本

發行日期:2016 年 6 月 16 日

  • 納入 Visitor API 1.5.7。
  • 已修正處理 Firefox 中無法引發完成事件的連結點擊追蹤功能。

1.6 版本

發行日期:2016 年 4 月 21 日

  • AppMeasurement Activity Map 模組已整合至 AppMeasurement 標準模組,因此您僅需參考一個 .js 檔案。此外,預設已啟用「Activity Map」追蹤。(AN-112689)
  • 修正 AppMeasurement 中查詢字串變數順序的截斷問題,因此 pageURLRest 會顯示於最後。(AN-114647)

1.5.4 版本

發行日期:2016 年 3 月 17 日

  • 納入 Visitor API 1.5.4
  • 支援 Visitor API 1.5.4+ 選擇退出功能

1.5.3 版本

發行日期:2016 年 1 月 21 日

  • 修正使用 POST 來追蹤呼叫時,Audience Manager 模組的處理方式。(AN-115381)
  • 已將剩餘的頁面 URL (「-g」) 移至追蹤請求查詢字串的尾端。(AN-114647)

1.5.2 版本

發行日期:2015 年 11 月 5 日

  • 納入 Visitor API 1.5.3。
  • 修正 IE 11 對 URL 截斷 2047 的偵測功能 (AN-114914)

1.5.1 版本

發行日期:2015 年 9 月 17 日

  • 納入 Visitor API 1.5.2
  • 已更新 Audience Manager 使用Adobe Audience ManagerDIL6.2的模組 — 從VisitorAPI.js取得客戶ID並在呼叫給Adobe Audience Manager時將其傳入。 (AN-104978)

1.5 版本

發行日期:2015 年 6 月 18 日

  • Visitor API 1.5 的支援 (使用 getCustomerIDs 方法收集客戶 ID 及已驗證狀態,並針對資料彙集要求傳送 ID)。
  • 修正 AudienceManagement 模組 (DIL 6.1) 中重複目的地 iframe 的建立
  • 已修正 1.4.5 版本中說明的已知問題。

1.4.5 版本

發行日期:2015 年 5 月 21 日

  • 從iOS SDK 4.5版開始,新的iOS擴充功能可讓您從Apple Watch應用程式、「今天」小工具、「照片編輯」小工具和所有其他iOS擴充應用程式中收集使用資料。
  • 從Android SDK 4.5版開始,新的Android擴充功能可讓您透過Android穿戴式裝置應用程式中收集資料。
  • 納入 Visitor API 1.4.
  • 已更新 AudienceManagement 模組以使用 DIL 6.0 版本。
NOTE
已知問題:在訪客 API / AppMeasurement Audience Manager 模組整合中,有可發佈在 IE6-9 中提出之 iFrame 要求的兩個目的地://fast.<subdomain>.demdex.net/dest5.html//fast.<subdomain>.demdex.net/dest4.html。如同其他瀏覽器的情況,正確的行為是只載入 //fast.<subdomain>.demdex.net/dest5.html

1.4.4 版本

發行日期:2015 年 4 月 16 日

  • 您現在可使用生命週期量度來納入自訂內容資料的變數。
  • 您現在可在 PhoneGap 中使用 trackBeaconclearCurrentBeacon 呼叫。
  • 進行微幅修正,以在 trackLight 呼叫後清除小型伺服器呼叫設定檔 ID。

1.4.3 版本

發行日期:2015 年 2 月 19 日

  • 將所有延遲追蹤呼叫的處理改為一致,以修正延遲期間的備份變數問題,例如已點按物件。
  • 第一個追蹤呼叫後不再進行自動反向連結追蹤,以在第一個追蹤呼叫前手動設定 s.referrer 時,以免第二個、第三個……追蹤呼叫(通常是連結追蹤)重複計算反向連結。
  • 已更新分送 Zip 檔,現在包含 Visitor API 1.3.5。

1.4.2 版本

發行日期:2015 年 1 月 15 日

  • 修正 WebKit 轉譯前處理,防止追蹤未檢視的轉譯前頁面。
  • 更新分送 Zip 檔,以包含 Visitor API 1.3.4 以及 AudienceManagement 模組 (包含 DIL 5.5 版本)。

1.4.1 版本

發行日期:2014 年 9 月 18 日

  • 新增 tagContainerMarker 變數,讓實作可指定最多 4 個字元附加至版本字串與其他破折號分隔字元。此功能可用於動態標籤管理。

    code language-js
    // JavaScript
    s.tagContainerMarker = "D1.0";
    
    // Data Collection request
    //.../b/ss/myrsid/1/JS-1.4.1-D1.0/s43317392037311?...
    

    這 4 個字元僅限使用 URL 檔案路徑允許的字元,例如英數字元和句號。

  • 在利用 H 程式碼加上雙標籤的頁面中,啟用強制連結追蹤 (Webkit 瀏覽器的預設) 時,在自動連結追蹤 (下載和退出) 期間可能會發生重複循環,這個問題已經修正。此外,在自動連結追蹤周圍新增一般防護以避免類似的重複循環。此防護可限制自動連結追蹤每 10 秒重複點擊​ 相同 ​物件一次。此防護僅適用於自動連結追蹤,因此,手動連結追蹤 (s.tl) 呼叫不在此限。此外,點擊不同物件也不受此防護影響,並且將進行追蹤。

  • 已修正需要延遲時點擊物件的處理。

  • 如果訪客 API 尚未取得需要的值,從連結 onclick 功能呼叫 s.t 時,會導致頁面檢視計數倍增,這個問題已經修正。

  • HTTP POST 支援。

    note important
    IMPORTANT
    若要讓 Analytics 呼叫使用 POST 方法,而不是 AppMeasurement 中的 GET 方法 (解決 IE 中的截斷 URL 的方法),您至少必須將訪客 ID 服務的實作用於 Experience Cloud。

1.4 版本

發行日期:2014 年 8 月 21 日

  • 15 版本中不再針對移除追蹤瀏覽器外掛程式 (p 查詢參數) 做為外掛程式進行報告。
  • 在下載 Zip 中新增 AudienceManagement 模組。
  • 已新增對其他 eVar (76 - 250) 和事件 (101-1000) 的支援。
NOTE
H-Code 不支援其他 eVar 和事件。

1.3.2 版本

發行日期:2014 年 6 月 19 日

  • 修正處理訪客 API 欄位 (如舊版 Analytics 訪客 ID) 的完成和等待標幟時會發生錯誤的問題。
  • 支援訪客 ID 服務 1.3 的新功能。

1.3.1 版本

發行日期:2014 年 5 月 22 日

  • JavaScript s_gi 適用的 AppMeasurement 功能無法正確地找到使用 H-Code s_gi 所建立的例項。請注意,此問題只有影響到某些雙重標籤實作,意即 JavaScript 適用的 AppMeasurement 和 H-Code 出現在具備個別例項的相同頁面,而報表套裝也使用 s_gi 尋找例項。

1.3 版本

發行日期:2014 年 4 月 17 日

1.2.4 版本

發行日期:2014 年 3 月 13 日

  • 已修正心率視訊的錯誤。

1.2.3 版本

發行日期:2014 年 2 月 20 日

  • 已修正心率視訊的錯誤。

1.2.2 版本

發行日期:2014 年 2 月 6 日

  • 修正 Audience Manager DIL 模組的相容性問題。Audience Manager 客戶也必須更新至 DIL 模組的 4.8 版本。

1.2.1 版本

發行日期:2013 年 11 月 15 日

  • 修正用於心率視訊測量的頁面事件。

1.2 版本

發行日期:2013 年 11 月 14 日

1.1.1 版本

  • 防止 Opera 瀏覽器針對開頭為 "opera:" 的連結 ("opera:" 類似於其他瀏覽器中的 "about:" 和 "chrome:"),傳送連結追蹤呼叫。
  • 新增 alt="" 至所有影像物件,以遵循「視訊與通訊無障礙法」(Accessible Video and Communications Act)。

1.1 版本

發行日期:2013 年 9 月 18 日

  • 修正在 head 標籤中放置庫和頁面程式碼的支援。
  • 已新增遺漏模組 onLoad 支援。

1.0.3 版本

發行日期:2013 年 8 月 15 日

  • 新增支援透過 Adobe 標籤管理進行部署。
  • 修正 AppMeasurement 物件上無法設定階層變數的問題。

1.0.2 版本

發行日期:2013 年 7 月 18 日

  • 自動連結追蹤現在會忽略雜湊/片段。以前由於下列 URL 的整個 .pdf 結尾為 href,所以會自動加以追蹤:

    code language-js
    <a href="index.htm#anchor.pdf">Test Link</a>
    

    現在會忽略雜湊/片段,所以只在檔案名稱結尾為符合的副檔名時才會追蹤連結。

1.0.1 版本

發行日期:2013 年 5 月 23 日

代碼管理器現在提供新版 JavaScript AppMeasurement 程式庫。本程式庫提供與 s_code.js 相同的核心功能,但可更加輕鬆快速地在行動版與桌面版網頁上使用。

  • 執行速度較 H.25 程式碼快 3 到 7 倍。
  • 未壓縮大小僅為 21k,而採用 gzipped 壓縮的大小為 8k (H.25 程式碼的未壓縮大小為 33k,而採用 gzipped 的大小為 13 k)。
  • 原生支援,以便取得查詢參數、讀取和寫入 Cookie,以及執行進階連結追蹤。
  • 輕便快速且功能強大,無論在行動版網頁或桌面完整版網頁皆可輕鬆使用,可讓您在所有的網站環境中使用單一程式庫。
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690