DocumentaçãoAnalyticsGuia de Implementação

Identificação do visitante usando o AppMeasurement

Última atualização: 10 de julho de 2026

Criado para:

  • {"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"},{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"}

O AppMeasurement é a biblioteca JavaScript herdada do Adobe Analytics para coleta de dados. Embora o AppMeasurement por si só ofereça uma maneira nativa de identificar visitantes, muitos navegadores modernos rejeitam os cookies de terceiros que ele tenta definir. A Adobe recomenda usar o Serviço de ID de visitante da Adobe em todas as implementações para estar em conformidade com os padrões modernos de privacidade do navegador. Todas as versões do AppMeasurement vêm com o VisitorAPI.js, a biblioteca de JavaScript usada para implementar o Serviço de ID de visitante.

Identificação de visitantes usando o Serviço de ID de visitante (recomendado)

Esteja preparado com o seguinte:

  • Baixe a versão mais recente do AppMeasurement. A biblioteca baixada inclui AppMeasurement.js e VisitorAPI.js.

  • Uma ID do conjunto de relatórios de desenvolvimento.

  • O domínio de borda desejado para trackingServerSecure.

  • Sua ID organizacional IMS:

    1. Faça logon no Adobe CX Enterprise usando suas credenciais da Adobe ID.
    2. Em qualquer lugar na interface do CX Enterprise, pressione [Cmd] + [I] (iOS) ou [Ctrl] + [I] (Windows).
    3. Um Depurador de dados do usuário é exibido. Selecione a guia Organizações atribuídas.
    4. Expanda a organização IMS desejada.
    5. Localize o campo ID.

Depois de usar os recursos acima, a página de exemplo básica a seguir conterá o mínimo de chamadas necessárias para enviar dados ao Adobe Analytics:

<html>
  <head>
    <title>Example AppMeasurement implementation page</title>
    <script src="AppMeasurement.js"></script>
    <script src="VisitorAPI.js"></script>
  </head>
  <body>
    <h1>Hello world!</h1>
    <script>
      var s = s_gi("examplersid"); // Include development report suite ID here
      s.trackingServerSecure = "example.data.adobedc.net"; // Include edge domain here
      s.visitor = Visitor.getInstance("ADB3LETTERSANDNUMBERS@AdobeOrg"); // Include IMS org ID here
      s.pageName = document.title;
      s.t();
    </script>
  </body>
</html>
TIP
Você pode acompanhar se uma ocorrência usa o serviço de ID de visitante atribuindo a presença de Visitor a uma variável personalizada em doPlugins:
code language-js 
s.doPlugins = function() {
      s.prop1 = typeof(Visitor) != "undefined" ? "VisitorAPI present" : "VisitorAPI missing";
    };
IMPORTANT
A Adobe recomenda não usar esse método para identificar visitantes.

Se sua organização não usar o Serviço de ID de visitante (VisitorAPI.js), a AppMeasurement usará sua própria forma herdada de identificação de visitantes. Quando um visitante chega ao seu site pela primeira vez, a biblioteca verifica se há um cookie s_vi. Este cookie é definido no domínio correspondente a trackingServerSecure (para HTTPS) ou trackingServer (para HTTP).

  • Se você participar do Programa de certificado gerenciado, o servidor de rastreamento normalmente será um domínio próprio, tornando os cookies do s_vi originais.
  • Se você não participar do programa de certificado gerenciado, o servidor de rastreamento normalmente é um subdomínio de adobedc.net, omtrdc.net ou 2o7.net, tornando o cookie s_vi um cookie de terceiros. Devido aos padrões modernos de privacidade do navegador, os cookies de terceiros são rejeitados pela maioria dos navegadores. Depois de rejeitado, o AppMeasurement tenta definir um cookie de fallback primário (fid).

Se você definir corretamente trackingServerSecure, nenhuma outra medida de identificação de visitante será necessária.

Identificando visitantes usando visitorID (Não recomendado)

IMPORTANT
A Adobe recomenda não usar esse método para identificar visitantes.

Usar a variável visitorID permite que sua organização controle independente completo identificando visitantes. Se você usar visitorID, observe as seguintes limitações:

  • Cada ocorrência deve conter o mesmo valor visitorID para ser contado como um único visitante.

    • Qualquer ocorrência que omita visitorID tenta automaticamente usar outro método de identificação de visitante, tratando-os como um visitante separado.
    • Todas as ocorrências que contêm um valor visitorID diferente de uma ocorrência anterior são tratadas como um visitante separado.
    • A Adobe não oferece uma maneira de compilar ocorrências usando diferentes IDs de visitante no Adobe Analytics.

  • Públicos-alvo compartilhados, Analytics para Target e Atributos do cliente não são suportados com visitantes identificados usando visitorID.

Consulte visitorID para obter instruções de implementação usando essa variável.

recommendation-more-help
analytics-help-implement