Show Menu
TÓPICOS×

Implementação do Analytics for Target

Several steps are required when implementing Adobe Analytics as the reporting source for Target (A4T).

Implementation steps

As seções a seguir descrevem as etapas necessárias para implantar essa integração no site.

Etapa 1: Solicitar provisionamento para o Analytics e Públicos alvos

After you implement Analytics as the reporting source for Target, you must be provisioned for Analytics and Target. Use este formulário para solicitar o aprovisionamento .

Etapa 2: Configurar permissões do usuário

User account requirements must be met before you can create an Analytics-based activity in Target. See User permission requirements .

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. Você deve implementar ou migrar para a versão exigida da ID de visitante da Experience Cloud. Para obter mais informações, consulte "Requisitos de implementação" em antes de implementar .
See Implement the Experience Cloud ID Service for Target in the Experience Cloud Visitor ID Service documentation.

Etapa 4: Atualizar o AppMeasurement para JavaScript ou s_code

Você deve implementar ou migrar para a versão exigida da 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 obter uma migração, consulte Migração para o AppMeasurement para JavaScript no Guia de implementação do Analytics.

Etapa 5: Baixe e atualize o at.js ou mbox.js

Você deve implementar ou migrar para a versão exigida da at.js ou da mbox.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 ou mbox.js

Se você implantou anteriormente o at.js ou o mbox.js, você pode 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 ou mbox.js em todas as páginas do site

Inclua at.js ou mbox.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>

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

É essencial que o VisitorAPI.js seja carregado antes da at.js ou da mbox.js. Se estiver atualizando um arquivo at.js ou mbox.js existente, verifique a ordem do carregamento.
The way the out-of-the-box settings are configured for Target and Analytics integration from an implementation perspective is to use the SDID that is passed from the page to stitch the Target and Analytics request together on the backend automatically for you.
However, if you want more control on how and when to send analytics data related to Target to Analytics for reporting purposes, and you do not want to opt-in to the default settings of having Target and Analytics automatically stitch the analytics data via the SDID, then you can set 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 analyticsLogging: "client_side" será enviado para todas as chamadas feitas pela at.js nas solicitações do e uma carga de análise será retornada para cada solicitação. Target Quando configurado, 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 ao Analytics por meio da API de inserção de dados.
Se uma configuração global não for desejada e uma abordagem mais sob demanda for preferível, você poderá usar a função getOffers() para fazer isso, passando em analyticsLogging: "client_side" . The analytics payload will be returned for only this call and the Target backend will not forward the payload to Analytics. By pursuing this approach, every at.js Target request will not return the payload by default, but instead only when desired and specified.
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 a 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 mboxMCSDID Target nas chamadas do são compatíveis com o valor do parâmetro sdid Analytics na chamada de exibição de página do
Isso é especialmente importante para confirmar em Aplicativos de página única (SPAs), onde a ordem das chamadas nem sempre é previsível.
Observação: a compatibilidade desses valores é necessária para que o A4T funcione corretamente.

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

Recomendamos 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

In Target, click Administation > Visual Experience Composer and choose either Select per activity or Adobe Analytics to enable the options.
  • Selecionar por atividade permite escolher entre o e o para criar cada atividade. Target​Analytics
  • O Adobe configura o Analytics como fonte de relatórios para todas as atividades que você criar. Analytics