Show Menu
TÓPICOS×

Implementação com AMP

O AMP é uma estrutura HTML de código aberto que fornece uma maneira simples de criar páginas da Web rápidas e com carregamento leve.
Como o Adobe Analytics usa uma biblioteca JavaScript para compilar e enviar uma solicitação de imagem, são necessários ajustes na implementação para enviar dados à Adobe nas páginas que usam o AMP.

Determine que método deve ser implementado no Adobe Analytics em páginas que usam o AMP

A Adobe criou dois métodos para implementar o Adobe Analytics em páginas que usam o AMP. Ambos usam a tag HTML <amp-analytics> . Consulte a tag amp-analytics no GitHub do projeto ampproject para obter mais informações.
  • Usar o "adobeanalytics" modelo de rastreamento : construa a solicitação do Analytics diretamente na página
  • Usar o "analytics_nativeConfig" modelo de rastreamento : use um iframe que contenha o mesmo código do AppMeasurement implantado no site normal
A tabela a seguir compara estes dois métodos:
modelo "adobeanalytics"
modelo "adobeanalytics_nativeConfig"
Contagem de visitante/visitas no conjunto de relatórios existente
Inflação alta
Inflação mínima
Usar um conjunto de relatórios separado
Recomendado
Não é necessário
Visitantes novos vs. retornos
Não suportado
Suportado
Serviço de ID de visitante
Não suportado
Suportado
Rastreamento de vídeo e link
Suporte parcial
Ainda não é suportado
Dificuldade da implementação
Um pouco difícil
Relativamente fácil
Integrações da Adobe Experience Cloud
Não suportado
Suporte parcial
Considere os prós e os contras na organização para determinar qual método deseja usar. Consulte exemplos de AMP no repositório GitHub da Adobe para obter o código de amostra.
Não use os modelos "adobeanalytics" e "adobeanalytics_nativeConfig" na mesma página que usa o AMP. Se tentar fazer isso, poderá gerar erros no console do navegador, além de contar os visitantes duas vezes.

Método 1: usar a tag amp-analytics com o modelo "adobeanalytics"

O modelo de rastreamento "adobeanalytics" usa a tag HTML <amp-analytics> para criar uma solicitação de rastreamento diretamente. Especifique as solicitações de ocorrência que são acionadas em eventos de página específicos, como a página se tornando visível ou em um clique. Eventos de clique podem ser personalizados para se aplicarem a certas IDs de elemento ou classes ao especificar um seletor. É possível carregar o modelo ao adicionar type="adobeanalytics" à tag amp-analytics.
No código de exemplo a seguir, há dois disparadores definidos: pageLoad e click . O acionador pageLoad é executado quando o documento se torna visível e inclui a variável pageName , conforme definido na seção vars . O segundo acionador click é acionado ao clicar em um botão. Para este evento, eVar1 é definido com o valor button clicked .
<amp-analytics type="adobeanalytics">
  <script type="application/json">
    {
      "requests": {
        "myClick": "${click}&v1=${eVar1}",
      },
      "vars": {
        "host": "example.sc.omtrdc.net",
        "reportSuites": "reportSuiteID",
        "pageName": "Adobe Analytics Using amp-analytics tag"
      },
      "triggers": {
        "pageLoad": {
          "on": "visible",
          "request": "pageview"
        },
        "click": {
          "on": "click",
          "selector": "button",
          "request": "myClick",
          "vars": {
            "eVar1": "button clicked"
          }
        }
      }
    }
  </script>
</amp-analytics>

No acionador click , você pode especificar um seletor para garantir que, ao clicar no elemento DOM (nesse caso, qualquer botão), a solicitação buttonClick será acionada e definida automaticamente para denotar essa ocorrência como uma chamada de rastreamento de link.
Além disso, o amp-analytics suporta uma quantidade de substituições para as variáveis, para que o AMP possa fornecer valores de dados conhecidos. Consulte variáveis compatíveis com amp-analytics no GitHub para obter mais informações.
As solicitações de imagem enviadas à Adobe usando esse método não incluem dados para muitos relatórios padrão (por exemplo, navegador, tamanho de tela ou referenciador). Se desejar incluir essas informações nas ocorrências, verifique se elas foram incluídas como parte da cadeia de caracteres de consulta da solicitação de imagem. Consulte Parâmetros de consulta de coleta de dados para obter mais informações.
A Adobe identifica visitantes usando uma função AMP integrada e define o cookie adobe_amp_id . Essa ID de visitante é exclusiva de qualquer outra ID definida pelo Adobe Analytics (por exemplo, o cookie s_vi ). O serviço da Adobe Experience Cloud ID não é compatível com esse método de implementação.
O AMP usa CDNs para fornecer conteúdo. Ele é estruturado para contar um visitante único diferente para cada CDN do qual um visitante recupera o conteúdo, o que pode aumentar a contagem de visitantes únicos.
Recomendamos o uso de um conjunto de relatórios separado para páginas AMP é por causa da forma de como o AMP identifica visitantes únicos.
Essa solução exige que o servidor de rastreamento seja especificado na propriedade host corresponda ao servidor de rastreamento no site principal, para que os controles da política de privacidade sejam respeitados. Caso contrário, crie uma política de privacidade separada para as páginas que usam AMP.

Método 2: usar a tag amp-analytics com o modelo "adobeanalytics_nativeConfig"

A tag "adobeanalytics_nativeConfig" é mais fácil de implementar, pois usa a mesma metodologia de marcação usada nas páginas normais da Web. Adicione o seguinte à tag amp-analytics :
<amp-analytics type="adobeanalytics_nativeConfig">
  <script type="application/json">
    {
      "requests": {
        "base": "https://${host}",
        "iframeMessage": "${base}/stats.html?campaign=${queryParam(campaign)}&pageURL=${ampdocUrl}&ref=${documentReferrer}"
      },
      "vars": {
        "host": "example.sc.omtrdc.net"
      },
      "extraUrlParams": {
      "pageName": "Example AMP page",
      "v1": "eVar1 example value"
      }
    }
 </script>
</amp-analytics>

Uma página HTML hospedada nos servidores da Web também é necessária:
<html>
  <head>
    <title>Stats Example</title>
    <script language="JavaScript" type="text/javascript" src="VisitorAPI.js"></script>
    <script language="JavaScript" type="text/javascript" src="AppMeasurement.js"></script>
  </head>
  <body>
    <script>
      var v_orgId = "INSERT-ORG-ID-HERE";
      var s_account = "examplersid";
      var s_trackingServer = "example.sc.omtrdc.net";
      var visitor = Visitor.getInstance(v_orgId);
      visitor.trackingServer = s_trackingServer;
      var s = s_gi(s_account);
      s.account = s_account;
      s.trackingServer = s_trackingServer;
      s.visitorNamespace = s_visitorNamespace;
      s.visitor = visitor;
      s.pageName = s.Util.getQueryParam("pageName");
      s.eVar1 = s.Util.getQueryParam("v1");
      s.campaign = s.Util.getQueryParam("campaign");
      s.pageURL = s.Util.getQueryParam("pageURL");
      s.referrer = s.Util.getQueryParam("ref");
      s.t();
    </script>
  </body>
</html>

Essa abordagem envia dados a uma página da Web de utilitário por meio de parâmetros de cadeias de caracteres de consulta especiais adicionados ao parâmetro de solicitação iframeMessage . Esses parâmetros de cadeias de caracteres de consulta podem ser nomeados quando desejar, contanto que a página stats.html esteja configurada para coletar os dados apropriados.
O modelo "adobeanalytics_nativeConfig" também adiciona parâmetros da cadeia de caracteres de consulta com base nas variáveis listadas na seção extraUrlParams da tag amp-analytics. No exemplo acima, os parâmetros pageName e v1 são incluídos.
Sua página stats.html deve ser hospedada em um subdomínio separado do domínio em que o AMP está hospedado. A estrutura da AMP não permite iframes do mesmo subdomínio no qual a AMP está. Por exemplo, se o AMP estiver hospedado no amp.example.com , hospede a página stats.html em um subdomínio separado, como o ampmetrics.example.com .
Usando esse método, se um usuário final optar por não ser rastreado no site primário, ele também deixará de ser rastreado em todos os AMPs sem etapas adicionais. Usar essa página de utilitários também significa que o AMP pode ser compatível com o serviço da Adobe Experience Cloud ID. Não é necessário um conjunto de relatórios separado.
O rastreamento de link e de vídeo não pode ser usado com este método. A tag iframeMessage no AMP só pode ser carregada uma vez por página, portanto, não é possível enviar outras solicitações de imagem depois que o quadro é carregado. Esse método também requer mais recursos de processamento para execução, o que pode afetar o desempenho da rolagem. Ele não afeta o tempo de carregamento da página, pois todos os recursos são carregados de forma assíncrona.

Perguntas frequentes

O rastreamento de vídeo está disponível para qualquer método?
Não. O padrão AMP é compatível apenas com acionadores para "visível", "clique" e "timer". Ele ainda não oferece suporte a acionadores explícitos para rastreamento de vídeo que a tag amp-analytics pode registrar. Além disso, o modelo "adobeanalytics_nativeConfig" só pode ser carregado uma vez, de modo que as solicitações de imagem subsequentes após o carregamento de uma página não são possíveis.
Como posso diferenciar visitantes AMP de outros em meus dados?
Para todas as páginas AMP, a dimensão Versão do JavaScript coleta um valor semelhante ao AMP vX.X . Também é possível definir uma dimensão personalizada como "AMP" para segmentar esses visitantes.
Como esse método de implementação se compara aos Artigos Instantâneos do Facebook?
Os Artigos Instantâneos do Facebook são compatíveis com uma solução semelhante ao método "adobeanalytics_nativeConfig" . A página stats.html desse método pode atender às necessidades de análise tanto para AMP quanto para FIA, simultaneamente. Para obter mais informações sobre como implementar o rastreamento no FIA, consulte Artigos Instantâneos do Facebook .