Panoramica degli hint client e domande frequenti
Gli hint client sono singole informazioni relative al dispositivo di un utente. Sono forniti dai browser basati su Chromium, come ad esempio Google Chrome e Microsoft Edge. Per questi browser, gli hint client sostituiranno gradualmente l’agente utente come origine delle informazioni sul dispositivo. Adobe Analytics aggiornerà il processo di ricerca di informazioni sui dispositivi in modo da utilizzare, oltre all’agente utente, anche gli hint client per determinare le informazioni sul dispositivo.
Hint client a bassa entropia e ad alta entropia
Google divide gli hint client dall’agente utente in due categorie: hint a bassa entropia e ad alta entropia.
-
Gli hint a bassa entropia contengono informazioni più generiche sui dispositivi. Vengono forniti automaticamente dai browser basati su Chromium.
-
Gli hint ad alta entropia contengono informazioni più dettagliate. Questi sono disponibili solo su richiesta. Le librerie AppMeasurement e Web SDK possono essere configurate per richiedere hint ad alta entropia. Per impostazione predefinita, entrambe le librerie non richiedono hint ad alta entropia.
A partire da ottobre 2022, le nuove versioni dei browser basati su Chromium hanno iniziato a "congelare" la versione del sistema operativo rappresentata nella stringa dell’agente utente. La versione del sistema operativo è un hint ad alta entropia; per essere certi di includere nei rapporti informazioni accurate sulla versione del sistema operativo è quindi necessario configurare la libreria di raccolta per raccogliere tali hint. Nel corso del tempo, le altre informazioni relative al dispositivo dell’agente utente verranno congelate, e sarà quindi necessario ricorrere agli hint client affinché sia possibile raccogliere nei rapporti informazioni accurate sui dispositivi.
Gli hint client verranno incorporati nel processo di ricerca del dispositivo di Analytics a partire dal 27 febbraio 2023 e fino al 2 marzo 2023. AppMeasurement e Web SDK supportano attualmente la raccolta di dati hint, ma non verranno utilizzati nella ricerca del dispositivo fino a metà febbraio. Come indicato di seguito, la versione del sistema operativo è stata congelata a partire da ottobre, ma a causa di un rollout graduale e del fatto che molti agenti utente forniscono già una versione del sistema operativo congelata (vedi altro qui), prevediamo che questo interesserà <3% dei visitatori di Chrome.
Adobe Audience Manager richiede la raccolta di hint ad alta entropia per preservare la piena funzionalità. Se sta usando inoltro lato server a Adobe Audience Manager allora potrebbe essere utile abilitare la raccolta di hint ad alta entropia.
Domande frequenti
Gli hint a bassa entropia vengono forniti automaticamente dal browser e inclusi per derivare le informazioni sul dispositivo e sul browser. Le versioni più recenti di Web SDK (a partire dalla versione 2.12.0) e AppMeasurement (a partire dalla versione 2.23.0) possono essere configurate per raccogliere hint ad alta entropia tramite le rispettive estensioni di tag oppure direttamente tramite un’opzione di configurazione. Consultare le istruzioni per SDK per web e AppMeasurement.
Per entrambe le librerie, la raccolta di hint ad alta entropia è disattivata per impostazione predefinita.
Per i dati inviati tramite API, ad esempio tramite API di inserimento dati o API di inserimento dati in blocco, gli hint devono essere inclusi esplicitamente nel payload. Per informazioni dettagliate, consulta la relativa documentazione.
Al momento non è possibile. È possibile scegliere di raccogliere tutti gli hint ad alta entropia oppure nessuno.
FullVersionList non viene attualmente raccolto perché la versione principale del browser viene acquisita come hint a bassa entropia.
La tabella seguente descrive gli hint client da ottobre 2022.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 | |||
|---|---|---|---|
| Hint | Descrizione | Alta o bassa entropia | Esempio |
| Sec-CH-UA | Browser e versione rilevante | Bassa | "Google Chrome 84" |
| Sec-CH-UA-Mobile | Dispositivo mobile (true o false) | Bassa | true |
| Sec-CH-UA-Platform | Sistema operativo/piattaforma | Bassa | "Android" |
| architettura | Architettura del sito | Alta | "arm" |
| amarezza | Abilità dell'architettura | Alta | "64" |
| fullVersionList | Elenco dei marchi e versione | Alta | "Not A;Brand";v="99", "Chromium";v="98", "Google Chrome";v="98" |
| modello | Modello dispositivo | Alta | "Pixel 3" |
| platformVersion | Versione del sistema operativo/piattaforma | Alta | "10" |
- Gli hint a bassa entropia vengono raccolti tramite l’intestazione della richiesta.
- Gli hint ad alta entropia vengono raccolti tramite JavaScript e trasmessi attraverso i valori dei parametri delle stringhe di query. I parametri della stringa di query utilizzano
h.come prefisso nella richiesta di immagine. FullVersionList non viene attualmente raccolto perché la versione principale del browser viene acquisita come hint a bassa entropia.
Gli hint ad alta entropia vengono raccolti tramite chiamata JavaScript e trasmessi tramite il parametro di query
Questi campi sono derivati direttamente dall’agente utente, ma l’agente utente può essere utilizzato per aiutare a derivare i valori per altri campi relativi al dispositivo, a seconda dei relativi dettagli.
Le informazioni sul dispositivo nel reporting sono derivate dall’agente utente. Abbiamo aggiornato i nostri processi per utilizzare sia l’agente utente che gli hint client, se disponibili.
ID di fallback (s_fid) deriva dall'agente utente e dall'indirizzo IP. Questo ID viene utilizzato solo se non è possibile impostare un cookie in modo che non sia ampiamente utilizzato
Tali campi subiranno modifiche nel tempo, man mano che Google “congelerà” più parti dell'agente utente. Il primo campo che verrà interessato direttamente è “Sistema operativo” che include la versione del sistema operativo in base alla timeline pubblicata di Google per il “congelamento” degli hint dell’agente utente e la versione del sistema operativo verrà congelata a partire dalla fine di ottobre 2022 con la versione 107 di Chromium. A quel punto la versione del sistema operativo nell'agente utente in alcuni casi sarà imprecisa.
Consulta la timeline pubblicata da Google per informazioni sulla tempistica del congelamento di altre parti dell’agente utente.