使用者代理使用者端提示

概觀 overview

每次網頁瀏覽器向網頁伺服器發出請求時,請求的標題都會包含有關瀏覽器和執行瀏覽器環境的資訊。 所有這些資料都會彙總為字串,稱為使用者代理字串。

以下是使用者代理字串在來自在Mac OS裝置上執行的Chrome瀏覽器的請求中看起來的範例。

NOTE
這些年來,使用者代理字串中包含的瀏覽器和裝置資訊量已經增長和修改多次。 以下範例顯示一系列最常見的使用者代理資訊。
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/105.0.0.0 Safari/537.36`
欄位
軟體名稱
Chrome
軟體版本
105
完整軟體版本
105.0.0.0
版面引擎名稱
AppleWebKit
版面引擎版本
537.36
作業系統
MAC OS X
作業系統版本
10.15.7
裝置
Intel Mac OS X 10_15_7

使用案例 use-cases

長期以來,使用者代理字串一直被用來為行銷和開發團隊提供有關瀏覽器、作業系統和裝置如何顯示網站內容,以及使用者如何與網站互動的重要深入分析。

使用者代理字串也可用來封鎖垃圾郵件並篩選機器人,這些機器人會為各種其他目的而編目網站。

Adobe Experience Cloud中的使用者代理字串 user-agent-in-adobe

Adobe Experience Cloud解決方案以各種方式利用使用者代理字串。

  • Adobe Analytics利用使用者代理字串來增加和衍生與用於造訪網站的作業系統、瀏覽器和裝置相關的其他資訊。
  • Adobe Audience Manager和Adobe Target會根據使用者代理字串提供的資訊,讓使用者符合細分和個人化行銷活動的資格。

介紹使用者代理程式使用者端提示 ua-ch

近年來,網站所有者和行銷供應商使用使用者代理字串以及請求標題中包含的其他資訊來建立數位指紋。 這些指紋可以在使用者不知情的情況下用作識別使用者的手段。

儘管使用者代理字串對網站擁有者具有重要用途,瀏覽器開發人員已決定變更使用者代理字串的運作方式,以限制一般使用者的潛在隱私問題。

他們開發的解決方案稱為使用者代理程式使用者端提示。 使用者端提示仍可讓網站收集必要的瀏覽器、作業系統和裝置資訊,同時提供更強防護以防止變相的追蹤方法,例如指紋。

使用者端提示可讓網站擁有者存取使用者代理字串中提供的大部分相同資訊,但採用更能保護隱私的方式來存取這些資訊。

當現代瀏覽器將使用者傳送至網頁伺服器時,無論是否需要,系統都會針對每個請求傳送完整的使用者代理字串。 另一方面,使用者端提示會強制執行模型,其中伺服器必須要求瀏覽器提供它想要瞭解的使用者端的其他資訊。 在收到此請求後,瀏覽器可以套用本身原則或使用者設定來決定要傳回哪些資料。 現在,所有請求的存取管理都可以明確且可稽核的方式進行,而不需依預設來公開整個使用者代理字串。

瀏覽器支援 browser-support

使用者代理程式使用者端提示已隨Google Chrome版本89引入。

其他基於Chromium的瀏覽器支援使用者端提示API,例如:

  • Microsoft Edge
  • Opera
  • Brave
  • Chrome for Android
  • Opera for Android
  • Samsung Internet

類別 categories

有兩種類別的使用者代理程式使用者端提示:

低平均資訊量使用者端提示 low-entropy

低平均資訊量使用者端提示包含無法用於指紋識別使用者的基本資訊。 瀏覽器品牌、平台和請求是否來自行動裝置等資訊。

Web SDK預設會啟用低平均資訊量使用者端提示,並在每個請求時傳遞。

HTTP標頭
JavaScript
預設包含在使用者代理中
預設包含在使用者端提示中
Sec-CH-UA
brands
Sec-CH-UA-Platform
platform
Sec-CH-UA-Mobile
mobile

高平均資訊量使用者端提示 high-entropy

高平均資訊量使用者端提示是有關使用者端裝置的更詳細資訊,例如平台版本、架構、型號、位元(64位元或32位元平台)或完整作業系統版本。 此資訊可能用於指紋識別。

HTTP標頭
JavaScript
預設包含在使用者代理中
預設包含在使用者端提示中
Sec-CH-UA-Platform-Version
platformVersion
Sec-CH-UA-Arc
architecture
Sec-CH-UA-Model
model
Sec-CH-UA-Bitness
Bitness
Sec-CH-UA-Full-Version-List
fullVersionList

Web SDK預設會停用高平均資訊量使用者端提示。 若要啟用它們,您必須手動設定Web SDK以請求高平均資訊量使用者端提示。

高平均資訊量使用者端提示對Experience Cloud解決方案的影響 impact-in-experience-cloud-solutions

有些Adobe Experience Cloud解決方案在產生報表時會依賴高平均資訊量使用者端提示中包含的資訊。

如果您未在環境中啟用高平均資訊量使用者端提示,下面說明的Adobe Analytics和Audience Manager報表與特徵將無法運作。

依賴高平均資訊量使用者端提示的Adobe Analytics報告 analytics

作業系統維度包含儲存為高平均資訊量使用者端提示的作業系統版本。 如果未啟用高平均資訊量使用者端提示,從Chromium瀏覽器收集點選的作業系統版本可能會不準確。

依賴高平均資訊量使用者端提示的Audience Manager特徵 aam

Google已更新Chrome瀏覽器功能,以將透過User-Agent標題收集的資訊減至最少。 因此,使用DIL的Audience Manager客戶將不再收到以平台層級金鑰為基礎之特徵的可靠資訊。

使用平台層級金鑰進行目標定位的Audience Manager客戶必須切換至Experience PlatformWeb SDK (而非DIL),並啟用高平均資訊量使用者端提示以繼續接收可靠的特徵資料。

啟用高平均資訊量使用者端提示 enabling-high-entropy-client-hints

若要在您的Web SDK部署上啟用高平均資訊量使用者端提示,您必須在「context」欄位中包含額外的「highEntropyUserAgentHints」內容選項。

例如,若要從Web屬性擷取高平均資訊量使用者端提示,您的設定將如下所示:

context: ["highEntropyUserAgentHints", "web"]

範例 example

瀏覽器向網頁伺服器傳送的第一個請求標題所包含的使用者端提示將包含瀏覽器品牌、瀏覽器的主要版本,以及使用者端是否為行動裝置的指標。 每一段資料都有自己的標題值,而非分組為單一的使用者代理字串,如下所示:

Sec-CH-UA: "Chromium";v="101", "Google Chrome";v="101", " Not;A Brand";v="99"

Sec-CH-UA-Mobile: ?0

Sec-CH-UA-Platform: "macOS

相同瀏覽器的對等User-Agent標頭看起來像這樣:

Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/101.0.4951.54 Safari/537.36

雖然資訊類似,但對伺服器的第一個請求包含使用者端提示。 這些僅包括使用者代理字串中可用內容的子集。 請求中沒有作業系統架構、完整作業系統版本、版面引擎名稱、版面引擎版本和完整瀏覽器版本。

但是,在後續的請求中,Client Hints API會允許網頁伺服器要求有關裝置的其他詳細資料。 當請求這些值時,根據瀏覽器原則或使用者設定,瀏覽器回應可能包含該資訊。

以下是在要求高平圴資訊量值時,Client Hints API傳回的JSON物件範例:

{
   "architecture":"x86",
   "bitness":"64",
   "brands":[
      {
         "brand":" Not A;Brand",
         "version":"99"
      },
      {
         "brand":"Chromium",
         "version":"100"
      },
      {
         "brand":"Google Chrome",
         "version":"100"
      }
   ],
   "fullVersionList":[
      {
         "brand":" Not A;Brand",
         "version":"99.0.0.0"
      },
      {
         "brand":"Chromium",
         "version":"100.0.4896.127"
      },
      {
         "brand":"Google Chrome",
         "version":"100.0.4896.127"
      }
   ],
   "mobile":false,
   "model":"",
   "platformVersion":"12.2.1"
}
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636