Visão geral e perguntas frequentes sobre dicas do cliente
As dicas do cliente são informações individuais sobre o dispositivo de um usuário. Elas são fornecidas por navegadores Chromium, como o Google Chrome e Microsoft Edge. Nesses navegadores, as dicas do cliente substituirão gradualmente o usuário-agente como a fonte de informações do dispositivo. O Adobe Analytics atualizará seu processo de pesquisa de dispositivo para usar dicas do cliente além do usuário-agente para determinar as informações do dispositivo.
Dicas de cliente de baixa entropia e alta entropia
O Google divide as dicas do cliente de usuário-agente em duas categorias: dicas de baixa entropia e alta entropia.
-
Dicas de baixa entropia contém informações mais genéricas sobre dispositivos. Essas dicas são fornecidas automaticamente pelos navegadores Chromium.
-
As dicas de alta entropia contêm informações mais detalhadas. Essas dicas estão disponíveis somente mediante solicitação. O AppMeasurement e o SDK da Web podem ser configurados para solicitar dicas de alta entropia. Por padrão, ambas as bibliotecas não solicitam dicas de alta entropia.
A partir de outubro de 2022, novas versões dos navegadores Chromium iniciaram o “congelamento” da versão do sistema operacional representada na string do usuário-agente. A versão do sistema operacional é uma dica de alta entropia, portanto, para manter a precisão da versão do sistema operacional em seus relatórios, é necessário configurar a biblioteca de coleção para coletar essas dicas de alta entropia. Com o tempo, outras informações do dispositivo do usuário-agente serão congeladas, o que exigirá que as dicas do cliente mantenham a precisão do relatório do dispositivo.
As dicas do cliente serão incorporadas ao processo de pesquisa de dispositivo do Analytics a partir de 27 de fevereiro de 2023 e concluídas em 2 de março de 2023. Atualmente, o AppMeasurement e o SDK da Web são compatíveis com a coleção de dados de dicas, mas esta não será usada na pesquisa de dispositivo até meados de fevereiro. Conforme observado abaixo, a versão do sistema operacional foi congelada a partir de outubro, mas devido a um lançamento gradual e ao fato de muitos agentes de usuário já fornecerem uma versão do sistema operacional congelada (veja mais aqui), estimamos que isso afetará <3% dos visitantes do Chrome.
O Adobe Audience Manager requer que dicas de alta entropia sejam coletadas para preservar a funcionalidade completa. Se estiver usando o encaminhamento pelo lado do servidor para o Adobe Audience Manager, talvez você queira habilitar a coleção de dicas de alta entropia.
Perguntas frequentes
As dicas de baixa entropia são fornecidas automaticamente pelo navegador e assimiladas para a obtenção de informações do dispositivo e do navegador. As versões mais recentes do SDK da Web (começando com a 2.12.0) e do AppMeasurement (começando com a 2.23.0) podem ser configuradas para coletar dicas de alta entropia por meio de suas respectivas extensões de Tags ou diretamente por meio de uma opção de configuração. Consulte as instruções para o SDK da Web e o AppMeasurement.
Para ambas as bibliotecas, a coleção de dicas de alta entropia é desativada por padrão.
Para dados enviados por API, como a API de inserção de dados ou a API de inserção de dados em massa, as dicas devem ser incluídas explicitamente na carga. Consulte a documentação respectiva para obter mais detalhes.
Não neste momento. Você pode optar por coletar todas as dicas de alta entropia ou nenhuma.
Observe que fullVersionList não está coletado no momento porque a versão principal do navegador é capturada como uma dica de baixa entropia.
A tabela abaixo descreve as dicas do cliente a partir de outubro de 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 | |||
---|---|---|---|
Dica | Descrição | Alta ou baixa entropia | Exemplo |
Sec-CH-UA | Navegador e versão significativa | Baixa | "Google Chrome 84" |
Sec-CH-UA-Mobile | Dispositivo móvel (verdadeiro ou falso) | Baixa | true |
Sec-CH-UA-Platform | Sistema operacional/plataforma | Baixa | "Android" |
Arquitetura do | Arquitetura do site | Alta | "arm" |
bitness | Bitness da arquitetura | Alto | "64" |
fullVersionList | Lista de marcas com suas versões | Alta | "Not A;Brand";v="99", "Chromium";v="98", "Google Chrome";v="98" |
model | Modelo do dispositivo | Alta | "Pixel 3" |
platformVersion | Versão do sistema operacional/plataforma | Alta | "10" |
- As dicas de baixa entropia são coletadas por meio do cabeçalho da solicitação.
- As dicas de alta entropia são coletadas por meio de JavaScript e transmitidas pelos valores de parâmetro da string de consulta. Os parâmetros da cadeia de caracteres de consulta usam
h.
como prefixo na solicitação de imagem. Observe que fullVersionList não está coletado no momento porque a versão principal do navegador é capturada como uma dica de baixa entropia.
Dicas de alta entropia são coletadas por meio da chamada do JavaScript e transmitidas pelo parâmetro de consulta
Esses campos são obtidos diretamente do usuário-agente, mas o usuário-agente pode ser usado para ajudar a obter valores para outros campos relacionados ao dispositivo, dependendo dos detalhes do dispositivo.
As informações do dispositivo no relatório são derivadas do Agente do usuário. Atualizamos nossos processos para usar o Agente do usuário e as dicas do cliente, quando disponíveis.
A ID de fallback (s_fid) é derivada do Agente do usuário e do Endereço IP. Essa ID é usada somente se não for possível definir um cookie, portanto, não é amplamente usada
Isso será alterado com o tempo, à medida que o Google “congela” mais partes do usuário-agente. O primeiro campo a ser diretamente afetado é o “Sistema operacional”, que inclui a versão do sistema operacional. De acordo com a linha do tempo de “congelamento” de dicas do usuário-agente publicada pelo Google, a versão do sistema operacional será congelada a partir do final de outubro de 2022 com a versão 107 do Chromium. Nesse momento, a versão do sistema operacional no usuário-agente será imprecisa em alguns casos.
Consulte a linha do tempo publicada pelo Google para ver o tempo de congelamento de outras partes do usuário-agente.