Tips för användaragentklient

Översikt overview

Varje gång en webbläsare skickar en begäran till en webbserver innehåller begärans huvud information om webbläsaren och miljön som webbläsaren körs i. Alla dessa data sammanställs i en sträng, som kallas användaragentsträng.

Här är ett exempel på hur en användaragentsträng ser ut på en begäran som kommer från en Chrome-webbläsare som körs på en Mac OS-enhet.

NOTE
Under årens lopp har mängden webbläsarinformation och enhetsinformation som ingår i användaragentsträngen ökat och ändrats flera gånger. I exemplet nedan visas ett urval av den vanligaste användaragentinformationen.
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`
Fält
Värde
Programvarunamn
Chrome
Programversion
105
Fullversion
105.0.0.0
Namn på layoutmotor
AppleWebKit
Layoutmotorversion
537,36
Operativsystem
MAC OS X
Operativsystemversion
10.15.7
Enhet
Intel Mac OS X 10_15_7

Användningsfall use-cases

Användaragentsträngar har länge använts för att ge marknadsförings- och utvecklingsteam viktiga insikter i hur webbläsare, operativsystem och enheter visar webbplatsinnehåll samt hur användarna interagerar med webbplatser.

Användaragentsträngar används också för att blockera skräppost och filterbottar som crawlar webbplatser för en mängd andra syften.

Användaragentsträngar i Adobe Experience Cloud user-agent-in-adobe

Adobe Experience Cloud lösningar använder användaragentsträngarna på olika sätt.

  • Adobe Analytics använder användaragentsträngen för att utöka och hämta ytterligare information om operativsystem, webbläsare och enheter som används för att besöka en webbplats.
  • Adobe Audience Manager och Adobe Target kvalificerar slutanvändare för segmenterings- och personaliseringskampanjer baserat på informationen i användaragentsträngen.

Introduktion till klienttips för användaragent ua-ch

Under de senaste åren har webbplatsägare och marknadsföringsleverantörer använt användaragentsträngar tillsammans med annan information i begäranderubriker för att skapa digitala fingeravtryck. Dessa fingeravtryck kan användas som ett sätt att identifiera användare utan deras kännedom.

Trots det viktiga syftet med användaragentsträngar för webbplatsägare har webbläsarutvecklare beslutat att ändra hur användaragentsträngar fungerar, för att begränsa eventuella sekretessproblem för slutanvändare.

Den lösning de utvecklade kallas klienttips för användaragent. Klienttips gör det fortfarande möjligt för webbplatser att samla in nödvändig information om webbläsare, operativsystem och enheter, samtidigt som det ger ett bättre skydd mot dolda spårningsmetoder, som fingeravtryck.

Klienttips gör att webbplatsägare kan komma åt mycket av den information som finns i användaragentsträngen, men på ett mer sekretessbeständigt sätt.

När moderna webbläsare skickar en användare till en webbserver, skickas hela användaragentsträngen vid varje begäran, oavsett om den krävs eller inte. Klienttips tvingar å andra sidan en modell där servern måste fråga webbläsaren om ytterligare information om klienten. När webbläsaren tar emot den här begäran kan den tillämpa egna profiler eller användarkonfiguration för att avgöra vilka data som returneras. I stället för att visa hela användaragentsträngen som standard för alla begäranden, hanteras nu åtkomsten på ett explicit och spårbart sätt.

Stöd för webbläsare browser-support

Klienttips för användaragent introducerades med Google Chromeversion 89.

Ytterligare Chromium-baserade webbläsare stöder API:t för klienttips, som:

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

Kategorier categories

Det finns två typer av klienttips för användaragenten:

Tips för låg entropi-klient low-entropy

Klienttips för låg entropi innehåller grundläggande information som inte kan användas för fingeravtrycksanvändare. Information som webbläsarens varumärke, plattform och om begäran kommer från en mobil enhet.

Klienttips med låg entropi är aktiverade som standard i Web SDK och skickas för varje begäran.

HTTP-huvud
JavaScript
Ingår i användaragent som standard
Ingår i klienttips som standard
Sec-CH-UA
brands
Ja
Ja
Sec-CH-UA-Platform
platform
Ja
Ja
Sec-CH-UA-Mobile
mobile
Ja
Ja

Tips för hög entropi-klient high-entropy

High-entropy-klienttips är mer detaljerad information om klientenheten, som plattformsversion, arkitektur, modell, bitness (64- eller 32-bitars plattformar) eller fullständig operativsystemsversion. Den här informationen kan eventuellt användas vid fingeravtryck.

Egenskap
Beskrivning
HTTP-huvud
XDM-sökväg
Exempel
Ingår i användaragent som standard
Ingår i klienttips som standard
Operativsystemversion
Operativsystemets version.
Sec-CH-UA-Platform-Version
xdm.environment.browserDetails.
userAgentClientHints.platformVersion
10.15.7
Ja
Nej
Arkitektur
Den underliggande processorarkitekturen.
Sec-CH-UA-Arch
xdm.environment.browserDetails.
userAgentClientHints.architecture
x86
Ja
Nej
Enhetsmodell
Namnet på den enhet som används.
Sec-CH-UA-Model
xdm.environment.browserDetails.
userAgentClientHints.model
Intel Mac OS X 10_15_7
Ja
Nej
Bitness
Antalet bitar som den underliggande processorarkitekturen stöder.
Sec-CH-UA-Bitness
xdm.environment.browserDetails.
userAgentClientHints.bitness
64
Ja
Nej
Webbläsarleverantör
Företaget som skapade webbläsaren. Det låga entropytipset Sec-CH-UA samlar också in det här elementet.
Sec-CH-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.vendor
Google
Ja
Nej
Webbläsarnamn
Webbläsaren används. Det låga entropytipset Sec-CH-UA samlar också in det här elementet.
Sec-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.brand
Chrome
Ja
Nej
Webbläsarversion
Den viktiga versionen av webbläsaren. Det låga entropytipset Sec-CH-UA samlar också in det här elementet. Exakt webbläsarversion samlas inte in automatiskt.
Sec-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.version
105
Ja
Nej

Klienttips för hög entropi är inaktiverade som standard i Web SDK. Om du vill aktivera dem måste du konfigurera Web SDK manuellt för att begära tips för hög entropi-klient.

Högupplösta klienttips påverkar Experience Cloud-lösningar impact-in-experience-cloud-solutions

Vissa Adobe Experience Cloud-lösningar förlitar sig på information som ingår i kundtips med hög entropi när rapporter genereras.

Om du inte aktiverar klienttips för hög entropi i din miljö fungerar inte rapporterna och egenskaperna som beskrivs nedan i Adobe Analytics och Audience Manager.

Adobe Analytics rapporterar beroende av klienttips för hög entropi analytics

Dimensionen Operativsystem innehåller en operativsystemversion som lagras som ett högt entropi-klienttips. Om tips för klienter med hög entropi inte är aktiverat kan det bero på att operativsystemets version inte stämmer för träffar som samlats in från Chromium-webbläsare.

Audience Manager förlitar sig på klienttips med hög entropi aam

Google har uppdaterat webbläsarfunktionen Chrome för att minimera den information som samlas in via rubriken User-Agent. Detta innebär att Audience Manager-kunder som använder DIL inte längre får tillförlitlig information om egenskaper baserat på plattformsnivånycklar.

Audience Manager-kunder som använder plattformsnivånycklar för målinriktning måste växla till Experience Platform Web SDK i stället för DIL och aktivera High Entropy Client-tips för att fortsätta få pålitliga trait-data.

Aktivera tips för hög entropi-klient enabling-high-entropy-client-hints

Om du vill aktivera tips för hög entropi-klient i Web SDK-distributionen måste du inkludera det extra alternativet highEntropyUserAgentHints i fältet context.

Om du till exempel vill hämta klienttips för hög entropi från webbegenskaper ser konfigurationen ut så här:

context: ["highEntropyUserAgentHints", "web"]

Exempel example

Klienttips som finns i rubrikerna för den första begäran som webbläsaren gör till en webbserver innehåller webbläsarvarumärket, huvudversionen av webbläsaren och en indikator på om klienten är en mobil enhet. Varje datadel har ett eget rubrikvärde i stället för att grupperas i en enda användaragentsträng, vilket visas nedan:

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

Motsvarande User-Agent-huvud för samma webbläsare skulle se ut så här:

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

Även om informationen är liknande innehåller den första begäran till servern klienttips. Dessa innehåller bara en delmängd av det som är tillgängligt i användaragentsträngen. Saknas i begäran är operativsystemets arkitektur, operativsystemets fullständiga version, namnet på layoutmotorn, versionen av layoutmotorn och webbläsarversionen.

Vid efterföljande begäranden tillåter dock Client Hints API webbservrar att fråga efter ytterligare information om enheten. När dessa värden begärs, beroende på webbläsarprincipen eller användarinställningarna, kan webbläsarsvaret inkludera den informationen.

Nedan visas ett exempel på JSON-objektet som returneras av Client Hints API när höga entropisvärden begärs:

{
   "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