Analytics para implementação Target

Várias etapas são necessárias ao implementar Adobe Analytics como a fonte de relatórios para Adobe Target (A4T). O processo varia dependendo da implementação do A4T com o Adobe Experience Platform Web SDK ou com o at.js.

Etapas de implementação do SDK da Web da Adobe Experience Platform para uma implementação do SDK da Web da Adobe Experience Platform

As seções a seguir descrevem as etapas necessárias para implantar essa integração no seu site se você estiver planejando usar o SDK da Web da plataforma:

Etapa 1: Solicitar provisionamento para Analytics e Target

Antes de implementar o A4T, você deve ser provisionado para Analytics e Target. Use este formulário para solicitar o aprovisionamento.

Etapa 2: Configurar permissões do usuário

Os requisitos da conta do usuário devem ser atendidos antes que você possa criar uma atividade baseada em Analytics em Target. Consulte Requisitos de permissão do usuário.

Etapa 3: Criar uma configuração de Edge

Crie uma configuração de borda usando Adobe Experience Platform Launch usando a ferramenta de configuração de borda. Defina as configurações de Analytics and Target borda.

Etapa 4: Instalar e configurar o SDK da Web da plataforma

Para começar a fornecer Target experiências e aplicar Analytics para fins de rastreamento e análise, Instale e configure o SDK da Web da plataforma nas páginas do site.

Etapa 5: Ativar as opções para uso do A4T

Na interface Target, clique em Administração > Visual Experience Composer e escolha Selecionar por atividade ou Adobe Analytics.

  • **Selecionar por atividade permite escolher entre o e o para criar cada atividade.**TargetAnalytics
  • **O Adobe configura o Analytics como fonte de relatórios para todas as atividades que você criar.**Analytics

Etapas de at.js badgeImplementation para uma implementação da at.js

As seções a seguir descrevem as etapas necessárias para implantar essa integração no seu site se você planeja usar a at.js:

Etapa 1: Solicitar provisionamento para o Analytics e Target

Após implementar Analytics como a fonte de relatórios para Target, você deve ser provisionado para Analytics e Target. Use este formulário para solicitar o aprovisionamento.

Etapa 2: Configurar permissões do usuário

Os requisitos da conta do usuário devem ser atendidos antes que você possa criar uma atividade baseada em Analytics em Target. Consulte Requisitos de permissão do usuário.

Etapa 3: Implementar o serviço de ID de visitante da Experience Cloud

O serviço de ID do visitante permite identificar os usuários através das soluções da Adobe Experience Cloud. Implemente ou migre para a versão exigida da ID de visitante do Experience Cloud. Para obter mais informações, consulte "Requisitos de implementação" em antes de implementar.

Consulte Implementar o Serviço de ID do Experience Cloud para Target na documentação Serviço de ID do visitante do Experience Cloud.

Etapa 4: Atualizar o AppMeasurement para JavaScript ou s_code

Implemente ou migre para a versão exigida do appMeasurement.js. Para obter mais informações, consulte "Requisitos de implementação" em antes de implementar.

Para novas implementações, consulte Visão geral da implementação do JavaScript no Guia de Implementação do Analytics.

Para migração, consulte Migrating to AppMeasurement for JavaScript no Analytics Implementation Guide.

Etapa 5: Baixe e atualize a at.js

Implemente ou migre para a versão exigida da at.js usando sua conta de produção. Não são necessárias modificações no código.

Para obter mais informações, consulte "Requisitos de implementação" em antes de implementar.

Etapa 6: Host da at.js

Se você já implantou a at.js, é possível substituir o arquivo existente pela versão atualizada. Para obter mais informações, consulte "Requisitos de implementação" em antes de implementar.

Caso contrário, este arquivo pode ser hospedado com o serviço de ID de visitante e os arquivos do AppMeasurement para JavaScript. Esses arquivos devem ser hospedados em um servidor da Web que seja acessível a todas as páginas no seu site. Você precisa do caminho até esses arquivos na próxima etapa.

Etapa 7: Referencie a at.js em todas as páginas do site

Inclua at.js abaixo de VisitorAPI.js adicionando a seguinte linha de código na tag de cada página:

Para at.js:

<script language="JavaScript" type="text/javascript"
src="http://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/at.js"></script>

O VisitorAPI.js deve ser carregado antes da at.js. Se estiver atualizando um arquivo at.js ou mbox.js existente, verifique a ordem do carregamento.

A configuração padrão para a integração Target e Analytics, de uma perspectiva de implementação, é usar a SDID transmitida da página para unir a solicitação Target e Analytics ao back-end automaticamente.

Você pode controlar como e quando enviar dados de análise relacionados a Target a Analytics para fins de relatório. Se não quiser aceitar as configurações padrão de ter Target e Analytics automaticamente unir os dados de análise pela SDID, defina analyticsLogging = client_side via window.targetGlobalSettings. Observação: qualquer versão inferior a 2.1 não dá suporte a essa abordagem.

Por exemplo:

window.targetGlobalSettings = {
  analyticsLogging: "client_side"
};

Essa configuração tem um efeito global, o que significa que cada chamada feita por at.js tem analyticsLogging: "client_side" enviado nas solicitações Target e uma carga de análise é retornada para cada solicitação. Quando essa opção é configurada, o formato da carga retornada é semelhante ao seguinte:

"analytics": {
   "payload": {
      "pe": "tnt",
      "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
   }
}

A carga pode ser encaminhada para o Analytics por meio da Data Insertion API. Para atividades de Alocação automática e Direcionamento automático, você também deve encaminhar a sessionId. Para obter mais informações, consulte Relatórios do Analytics for Target (A4T) no guia SDKs do Adobe Target .

Se uma configuração global não for desejada e uma abordagem mais sob demanda for preferível, use a função at.js getOffers() passando em analyticsLogging: "client_side". A carga de análise é retornada somente para esta chamada e o Target backend não encaminha a carga para Analytics. Ao seguir essa abordagem, cada solicitação de at.js Target retorna a carga por padrão, mas somente quando desejado e especificado.

Por exemplo:

adobe.target.getOffers({
      request: {
        experienceCloud: {
          analytics: {
            logging: "client_side"
          }
        },
        prefetch: {
          mboxes: [{
            index: 0,
            name: "a1-serverside-xt"
          }]
        }
      }
    })
    .then(console.log)

Essa chamada chama uma resposta da qual você pode extrair a carga de análise.

A resposta é semelhante à seguinte:

{
  "prefetch": {
    "mboxes": [{
      "index": 0,
      "name": "a1-serverside-xt",
      "options": [{
        "content": "<img src=\"http://s7d2.scene7.com/is/image/TargetAdobeTargetMobile/L4242-xt-usa?tm=1490025518668&fit=constrain&hei=491&wid=980&fmt=png-alpha\"/>",
        "type": "html",
        "eventToken": "n/K05qdH0MxsiyH4gX05/2qipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
        "responseTokens": {
          "profile.memberlevel": "0",
          "geo.city": "bucharest",
          "activity.id": "167169",
          "experience.name": "USA Experience",
          "geo.country": "romania"
        }
      }],
      "analytics": {
        "payload": {
          "pe": "tnt",
          "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
        }
      }
    }]
  }
}

A carga pode ser encaminhada para Analytics por meio da API de inserção de dados.

Etapa 8: Validar a implementação

Carregue suas páginas depois de atualizar as bibliotecas JavaScript para confirmar que os valores dos parâmetros mboxMCSDIDTarget nas chamadas do são compatíveis com o valor do parâmetro sdidAnalytics na chamada de exibição de página do

É especialmente importante confirmar que esses valores correspondem em Aplicativos de página única (SPA), onde a ordem das chamadas nem sempre é previsível.

OBSERVAÇÃO

A correspondência desses valores é necessária para que o A4T funcione corretamente.

Etapa 9: (Opcional) Remover o código de integração anterior

O Adobe recomenda remover a integração anterior para simplificar sua implementação e eliminar a necessidade de classificar as discrepâncias entre os sistemas. Você pode remover qualquer código implantado por um SC anterior à integração T&T, incluindo mboxLoadSCPlugin.

Etapa 10: Ativar as opções de uso do Analytics como a fonte de relatórios do Target

Em Target, clique em Administração > Visual Experience Composer e escolha Selecionar por atividade ou Adobe Analytics para ativar as opções.

  • **Selecionar por atividade permite escolher entre o e o para criar cada atividade.**TargetAnalytics
  • **O Adobe configura o Analytics como fonte de relatórios para todas as atividades que você criar.**Analytics

Nesta página