Coleta de dados do Content Analytics

Este artigo explica em detalhes como o Content Analytics coleta dados

Definições

As seguintes definições são usadas no contexto deste artigo:

  • Experiência:

    • Para o canal web, uma experiência é definida como o conteúdo de texto em uma página da Web inteira. Para a coleta de dados, o Content Analytics registra a Experience ID, que se baseia no URL da página. Mais tarde, o texto na página é capturado por meio do serviço de recuperação.
    • Para o canal mobile, uma experiência é definida e rastreada no aplicativo móvel usando a extensão Content Analytics para o Adobe Experience Platform Mobile SDK.
  • Experience ID:

    • Para o canal Web, a ID da experiência é uma combinação exclusiva de URL relevante (URL base mais quaisquer parâmetros que direcionam o conteúdo na página) e versão da experiência.

      • Você especifica, como parte da configuração, quais parâmetros são relevantes para qualquer URL completo.
      • Você define um identificador de versão que será usado para coletar adequadamente as alterações em suas experiências.
    • Para o canal mobile, a ID da experiência é o valor de retorno do uso da chamada de API registerExperience.

  • Ativo: uma imagem. O Content Analytics registra o URL do ativo.

  • ID do ativo: o URL do ativo.

  • URL relevante: o URL de base e quaisquer parâmetros que direcionem o conteúdo na página.

Funcionalidade

O Content Analytics exige o Experience Platform Edge Network Web SDK (para o canal da Web) e o Experience Platform Edge Network Mobile SDK (para o canal móvel) para coletar dados do evento de conteúdo. Esses dados de evento são combinados com dados comportamentais existentes usando o Experience Platform Edge Network (Web SDK, Mobile SDK ou Server API) ou um conector de origem do Analytics, como o Adobe AppMeasurement.

A biblioteca do Content Analytics coleta dados quando:

  • O Content Analytics está incluído na biblioteca de tags carregada na página ou usada no aplicativo móvel.
  • A URL da página e a URL do ativo estão configuradas na extensão da Web do Content Analytics, parte da biblioteca de marcas incluída.
  • A URL do ativo, a localização do ativo ou a localização da experiência não são excluídas na extensão móvel do Content Analytics.

Evento do Content Analytics

Esta seção detalha as especificidades dos eventos do Content Analytics na Web. Consulte Rastreamento de experiência para obter detalhes sobre eventos do Content Analytics para dispositivos móveis.
Um evento do Content Analytics consiste em:

  • Campos padrão

    • Carimbo de data e hora
    • Identidade
  • Visualizações de experiência (se houver e se configuradas)

  • Cliques de experiência (se houver e se configurados)

  • Visualizações de ativos (se houver e se configuradas)

  • Cliques no ativo (se houver e se configurados)

Os eventos do Content Analytics são coletados como uma sequência de:

A análise de conteúdo coleta dados dessa maneira para refletir essa sequência, em vez de coletar uma visualização ou cliques separadamente da coleta do evento imediatamente após essa visualização ou clique. Essa forma de coletar dados de Análise de Conteúdo também reduz a quantidade de dados coletados.

Visualização gravada ou clique

Uma visualização de ativo é registrada quando:

  • O ativo não foi excluído pela configuração da extensão do Content Analytics.
  • O ativo está 75% visível.
  • Esse ativo ainda não foi registrado para esta página.

Um clique de ativo é registrado quando:

  • O ativo foi visualizado.
  • O ativo não foi excluído pela configuração da extensão do Content Analytics.
  • Um clique diretamente no ativo, que é um link, abre outra página.

Uma visualização de experiência é registrada quando:

  • As experiências são habilitadas na configuração do Content Analytics.

Um clique de experiência é registrado quando:

  • Qualquer clique em um link ativado aciona uma experiência.

Acionar para enviar um evento do Content Analytics

Para reduzir o número de solicitações de rede enviadas da página, a Content Analytics coleta informações, mas não as envia imediatamente. As informações de interação de conteúdo são coletadas e um evento contendo essas informações só é enviado quando ocorre um dos seguintes acionadores:

  • O Web SDK ou o Adobe AppMeasurement enviam um evento.

  • A visibilidade muda para oculta, por exemplo, ao:

    • Descarregar a página
    • Alternar a guia
    • Minimizar o navegador
    • Fechar o navegador
    • Bloquear a tela
  • O URL muda, o que resulta em um URL relevante modificado.

  • As exibições de ativos registradas e prontas para serem enviadas excedem 32.

NOTE
Os eventos adicionais do Content Analytics provavelmente afetarão qualquer definição de taxa de rejeição baseada no número de eventos em uma sessão ou página.

Identidades

Esta seção explica como o Content Analytics lida com identidades.

Web

O Content Analytics trata as identidades do canal da Web da seguinte maneira:

  • A ECID é preenchida automaticamente na parte identityMap do esquema do Content Analytics.
  • Se precisar de outros valores de identidade no identityMap, será necessário definir esses valores no retorno de chamada onBeforeEventSend da extensão do SDK da web.
  • A compilação baseada em campo não é compatível porque o esquema é de propriedade do sistema. Portanto, não é possível adicionar outro campo ao esquema para oferecer suporte à compilação baseada em campo

Para garantir que os dados de identidade da Content Analytics e os dados de identidade da Web SDK sejam compilados corretamente no nível do campo, modifique o Web SDK em antes de enviar o retorno de chamada do evento.

  1. Navegue até a propriedade Tags, que contém as extensões do SDK da web da Adobe Experience Platform e do Adobe Content Analytics.

  2. Selecione Extensões de Plug .

  3. Selecione a extensão SDK da web da Adobe Experience Platform.

  4. Selecione Configurar.

  5. Na seção Instâncias do SDK, role para baixo até Coleta de dadosRetorno de chamada “Antes do evento de envio”.

    Retorno de chamada “antes do evento de envio”

  6. Selecione </> Fornecer o código do retorno de chamada “antes do evento de envio”.

  7. Adicione o seguinte código:

    code language-javascript
    window.adobeContentAnalytics?.forwardEvent(content);
    
    content.xdm.identityMap = _satellite.getVar('identityMap');
    if ((content.xdm.eventType === "content.contentEngagement") && (_satellite.getVar('identityMap') != null)) {
       return true;
    }
    

    Retorno de chamada antes do evento de envio

  8. Selecione Salvar para salvar o código.

  9. Selecione Salvar para salvar a extensão.

  10. Publique as atualizações para a propriedade de tags.

Dispositivo móvel

Consulte a Identidade da extensão do Serviço da Experience Cloud ID e a Identidade da extensão móvel do Edge Network para obter mais informações sobre como trabalhar com identidades no aplicativo móvel.

Assim que a identidade for alterada no aplicativo móvel, o lote atual de dados do Content Analytics será redefinido para iniciar uma nova coleção de dados do Content Analytics para a nova identidade.

Esquemas

A Experience Platform coleta dados do Content Analytics em conjuntos de dados com base em esquemas específicos do Content Analytics. Os esquemas de referência estão disponíveis publicamente:

recommendation-more-help
analytics-platform-help-main