DocumentaçãoExperience PlatformColeção de dados

context

Last update: Wed Feb 11 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Desenvolvedor

A propriedade context é uma matriz de cadeias de caracteres que determina o que o Web SDK pode coletar automaticamente. Embora esses dados possam fornecer grande valor, a omissão de alguns deles pode ser benéfica para que você possa cumprir a política de privacidade da sua organização.

Palavras-chave de contexto e elementos XDM

Se você incluir determinada palavra-chave de contexto, o Web SDK preencherá automaticamente todos os elementos XDM associados. Se você quiser omitir um elemento XDM específico enquanto permite outros, limpe os valores usando onBeforeEventSend. Se você enviar vários eventos em uma página, o Web SDK incluirá esses campos em cada chamada do SendEvent.

Web

A palavra-chave "web" coleta informações sobre a página atual.

Dimensão
Descrição
Caminho XDM
Exemplo de valor
URL da página
O URL da página atual.
xdm.web.webPageDetails.URL
https://example.com/index.html
URL do referenciador
O URL da página visitada anteriormente.
xdm.web.webReferrer.URL
http://example.org/linkedpage.html

Dispositivo

A palavra-chave "device" coleta informações sobre o dispositivo do usuário.

Dimensão
Descrição
Caminho XDM
Exemplo de valor
Altura da tela
A altura da tela em pixels.
xdm.device.screenHeight
900
Largura da tela
A largura da tela em pixels.
xdm.device.screenWidth
1440
Orientação da tela
A orientação da tela.
xdm.device.screenOrientation
landscape ou portrait

Ambiente

A palavra-chave "environment" coleta informações sobre o navegador do usuário.

Dimensão
Descrição
Caminho XDM
Exemplo de valor
Tipo de ambiente
O tipo de ambiente pelo qual a experiência surgiu. O Web SDK sempre define este campo como browser.
xdm.environment.type
browser
Altura da janela de visualização
A altura da área de conteúdo do navegador em pixels.
xdm.environment.browserDetails.viewportHeight
679
Largura da janela de visualização
A largura da área de conteúdo do navegador em pixels.
xdm.environment.browserDetails.viewportWidth
642

Contexto do local

A palavra-chave "placeContext" coleta informações sobre a localização do usuário.

Dimensão
Descrição
Caminho XDM
Exemplo de valor
Hora local
Carimbo de data/hora local do usuário final no formato simplificado estendido ISO 8601.
xdm.placeContext.localTime
YYYY-08-07T15:47:17.129-07:00
Deslocamento de fuso horário local
O número de minutos em que o usuário está deslocado do GMT.
xdm.placeContext.localTimezoneOffset
360
Código do país
O código do país do usuário final.
xdm.placeContext.geo.countryCode
US
Província do estado
O código de província de estado do usuário final.
xdm.placeContext.geo.stateProvince
CA
Latitude
A latitude da localização do usuário final.
xdm.placeContext.geo._schema.latitude
37.3307447
Longitude
A longitude da localização do usuário final.
xdm.placeContext.geo._schema.longitude
-121.8945965

Carimbo de data e hora

A palavra-chave "timestamp" coleta informações sobre o carimbo de data/hora do evento. Esse contexto é sempre incluído e não pode ser removido.

Dimensão
Descrição
Caminho XDM
Exemplo de valor
Carimbo de data e hora do evento
Carimbo de data/hora UTC do usuário final no formato simplificado estendido ISO 8601.
xdm.timestamp
YYYY-08-07T22:47:17.129Z

Detalhes da implementação

A palavra-chave implementationDetails coleta informações sobre a versão do SDK usada para coletar o evento.

Dimensão
Descrição
Caminho XDM
Exemplo de valor
Nome
O identificador do kit de desenvolvimento de software (SDK). Este campo usa um URI para melhorar a exclusividade entre os identificadores fornecidos por diferentes bibliotecas de software.
xdm.implementationDetails.name
Quando a biblioteca independente é usada, o valor é https://ns.adobe.com/experience/alloy. Quando a biblioteca é usada como parte da extensão de tag, o valor é https://ns.adobe.com/experience/alloy+reactor.
Versão
A versão do kit de desenvolvimento de software (SDK).
xdm.implementationDetails.version
Quando a biblioteca independente é usada, o valor é a versão da biblioteca. Quando a biblioteca é usada como parte da extensão de tag, o valor é a versão da biblioteca e a versão da extensão de tag unida com um +. Por exemplo, se a versão da biblioteca for 2.1.0 e a versão da extensão de tag for 2.1.3, o valor será 2.1.0+2.1.3.
Ambiente
O ambiente onde os dados foram coletados. Este campo é sempre definido como browser ao usar a biblioteca JavaScript.
xdm.implementationDetails.environment
browser

Dicas do cliente de alta entropia high-entropy-client-hints

A palavra-chave "highEntropyUserAgentHints" coleta informações detalhadas sobre o dispositivo do usuário. Esses dados são incluídos no cabeçalho HTTP da solicitação enviada para o Adobe. Depois que os dados chegam à rede do Edge, o objeto XDM preenche seu respectivo caminho XDM. Se você definir o respectivo caminho XDM na chamada do sendEvent, ele terá prioridade sobre o valor do cabeçalho HTTP.

Se você usar pesquisas de dispositivo ao configurar sua sequência de dados, os dados poderão ser apagados em favor dos valores de pesquisa do dispositivo. Alguns campos de dica do cliente e de pesquisa de dispositivo não podem existir na mesma ocorrência.

Propriedade
Descrição
Cabeçalho HTTP
Caminho XDM
Exemplo
Versão do sistema operacional
A versão do sistema operacional.
Sec-CH-UA-Platform-Version
xdm.environment.browserDetails.
userAgentClientHints.platformVersion
10.15.7
Arquitetura
A arquitetura subjacente do CPU.
Sec-CH-UA-Arch
xdm.environment.browserDetails.
userAgentClientHints.architecture
x86
Modelo do dispositivo
O nome do dispositivo usado.
Sec-CH-UA-Model
xdm.environment.browserDetails.
userAgentClientHints.model
Intel Mac OS X 10_15_7
Bitness
O número de bits que a arquitetura subjacente do CPU suporta.
Sec-CH-UA-Bitness
xdm.environment.browserDetails.
userAgentClientHints.bitness
64
Fornecedor do navegador
A empresa que criou o navegador. A dica de baixa entropia Sec-CH-UA também coleta esse elemento.
Sec-CH-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.vendor
Google
Nome do navegador
O navegador usado. A dica de baixa entropia Sec-CH-UA também coleta esse elemento.
Sec-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.brand
Chrome
Versão do navegador
A versão significativa do navegador. A dica de baixa entropia Sec-CH-UA também coleta esse elemento. A versão exata do navegador não é coletada automaticamente.
Sec-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.version
105

Consulte User agent client hints para obter mais informações.

Referenciador único do Analytics one-time-analytics-referrer

A palavra-chave "oneTimeAnalyticsReferrer" envia um valor de referenciador para a Adobe Analytics somente na primeira chamada sendEvent sem decisão de uma página. O principal caso de uso para esta palavra-chave de contexto é impedir que a dimensão Referenciador no Adobe Analytics seja inflada por ocorrências usadas principalmente em integrações do Analytics e do Target.

Se determinado comando sendEvent usar um tipo de evento de decisão (decisioning.propositionFetch, decisioning.propositionDisplay, decisioning.propositionInteract), ele será ignorado ao calcular o primeiro sendEvent em uma página. Se o valor do referenciador for alterado na página e outro sendEvent for acionado, o novo valor do referenciador será incluído na carga. Essa condição permite que o recurso seja usado com aplicativos de página única.

Quando um valor de referenciador duplicado é detectado, a biblioteca define data.__adobe.analytics.referrer como uma cadeia de caracteres vazia ("").
Definir esse campo de objeto de dados como uma string vazia efetivamente limpa o valor quando uma ocorrência chega ao Adobe Analytics, já que o objeto de dados substitui qualquer campo equivalente do objeto XDM. Isso não afeta o objeto XDM, permitindo que os dados continuem a ser enviados para um conjunto de dados da Experience Platform se você incluir vários serviços em um fluxo de dados.

Implementação

Defina a matriz de cadeias de caracteres context ao executar o comando configure. Se você omitir essa propriedade ao configurar o SDK, todas as informações de contexto, exceto "highEntropyUserAgentHints" e "oneTimeAnalyticsReferrer", serão coletadas por padrão. Defina essa propriedade se quiser coletar dicas de cliente de alta entropia ou se quiser omitir outras informações de contexto da coleta de dados. As cadeias de caracteres podem ser incluídas em qualquer ordem.

TIP
Para coletar todas as informações de contexto, incluindo dicas de cliente de alta entropia, você deve incluir cada valor na cadeia de caracteres da matriz context. O valor padrão context omite "highEntropyUserAgentHints" e "oneTimeAnalyticsReferrer"; se você definir a propriedade context, quaisquer valores omitidos não coletarão dados.
alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  context: ["web", "device", "environment", "placeContext", "highEntropyUserAgentHints", "oneTimeAnalyticsReferrer"]
});

Coletar informações de contexto usando a extensão de tag do Web SDK

Consulte Configurações de contexto em configurações da coleção de dados, na documentação da extensão de marca do Web SDK.

recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1