Implementação do Analytics para Target

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

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

As seções a seguir descrevem as etapas necessárias para implantar essa integração no site se você planeja 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 provisionamento.

Etapa 2: Configurar permissões do usuário

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

Etapa 3: criar uma configuração do Edge

Crie uma configuração do Edge usando o Adobe Experience Platform com a ferramenta de configuração de borda. Configure o Criar e configurar sequências de dados.

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

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

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

Na interface do usuário do Target, clique em Administration > Visual Experience Composer e escolha Select per activity ou Adobe Analytics.

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

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

Etapa 1: solicitar provisionamento para o Analytics e o Target

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

Etapa 2: Configurar permissões do usuário

Os requisitos da conta de usuário devem ser atendidos antes que você possa criar uma atividade baseada em Analytics no 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 de visitante permite identificar os usuários nas soluções do 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 de Experience Cloud para o Target na documentação do Serviço de ID de visitante de 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 Migração para o AppMeasurement para o JavaScript no Guia de Implementação do Analytics.

Etapa 5: baixar e atualizar 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: Hospedagem de at.js

Se você implantou anteriormente a at.js, é possível substituir seu 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: Referência a at.js em todas as páginas do site step7

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 existente, verifique a ordem do carregamento.

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

Você pode controlar como e quando enviar dados de análise relacionados a Target para Analytics para fins de relatório. Se você não quiser aceitar as configurações padrão de ter o Target e o Analytics compilando automaticamente os dados de análise por meio da 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 pela 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 API de inserção de dados. 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 dos 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 da at.js getOffers() passando em analyticsLogging: "client_side". A carga de análise é retornada somente para esta chamada e o back-end do Target 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 step8

Carregue suas páginas depois de atualizar as bibliotecas JavaScript para confirmar que os valores de parâmetro mboxMCSDID nas chamadas do Target correspondem ao valor do parâmetro sdid na chamada de exibição de página Analytics.

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

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

A 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 Administration > Reporting e escolha Select per activity ou Adobe Analytics para habilitar as opções.