Migração do AppMeasurement para o SDK da Web

Crie um fluxo de dados na Coleção de dados da Adobe Experience Platform. Ao enviar dados para esse fluxo de dados, ele encaminha dados para a Adobe Analytics. No futuro, esse mesmo fluxo de dados encaminha dados para o Customer Journey Analytics.

1. Navegue até experience.adobe.com e faça logon usando suas credenciais.
2. Use a página inicial ou o seletor de produto no canto superior direito para navegar até Coleção de dados.
3. Na navegação à esquerda, selecione Datastreams.
4. Selecione Novo fluxo de dados.
5. Insira o nome desejado e selecione Salvar.
6. Depois que a sequência de dados for criada, selecione Adicionar Serviço.
7. No menu suspenso do serviço, selecione Adobe Analytics.
8. Insira a mesma ID de conjunto de relatórios do site para o qual você envia dados de análise. Clique em Salvar.

Seu fluxo de dados agora está pronto para receber e transmitir dados para a Adobe Analytics. Observe a ID de sequência de dados, pois essa ID é necessária ao configurar o SDK da Web no código.

Configure sua implementação para apontar para a sequência de dados criada na etapa anterior usando o comando configure do SDK da Web. O comando configure deve ser definido em todas as páginas, para que você possa incluí-lo junto com o código de instalação da biblioteca.

Use as propriedades datastreamId e orgId no comando configure do SDK da Web:

• Defina o datastreamId com a ID de sequência de dados recuperada da etapa anterior.
• Defina o orgId para a organização IMS da sua organização.

alloy("configure", {
    datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
    orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg"
});

Opcionalmente, é possível definir outras propriedades no comando configure, dependendo dos requisitos de implementação da organização.

Altere a implementação do Analytics para que ela não dependa do objeto AppMeasurement.js ou s. Em vez disso, defina as variáveis em um objeto JavaScript formatado corretamente, que é convertido em um objeto JSON quando enviado para o Adobe. Ter uma camada de dados no site ajuda muito na definição de valores, pois você pode continuar fazendo referência a esses mesmos valores.

Para enviar dados para o Adobe Analytics, a carga do SDK da Web deve usar data.__adobe.analytics com todas as variáveis de análise definidas neste objeto. As variáveis nesse objeto compartilham nomes e formatos idênticos aos de suas contrapartes da variável AppMeasurement. Por exemplo, se você definir a variável products, não a divida em objetos individuais, como faria com o XDM. Em vez disso, inclua-o como uma cadeia de caracteres exatamente é se você definir a variável s.products:

{
  "data": {
    "__adobe": {
      "analytics": {
        "products": "Shoes,Men's sneakers,1,49.99"
      }
    }
  }
}

Por fim, esta carga contém todos os valores desejados e todas as referências ao objeto s na sua implementação são removidas. Você pode usar qualquer um dos recursos fornecidos pelo JavaScript para definir esse objeto de carga, incluindo a notação de pontos para definir valores individuais.

// Define the payload and set objects within it
var dataObj = {data: {__adobe: {analytics: {}}}};
dataObj.data.__adobe.analytics.pageName = window.document.title;
dataObj.data.__adobe.analytics.eVar1 = "Example value";

// Alternatively, set values in an object and use a spread operator to achieve identical results
var a = new Object;
a.pageName = window.document.title;
a.eVar1 = "Example value";
var dataObj = {data:{__adobe:{analytics:{...a}}}};

Atualize todas as instâncias nas quais você chama s.t() e s.tl(), substituindo-as pelo comando sendEvent. Há três cenários a serem considerados:

• Rastreamento de exibição de página: substitua a chamada de rastreamento de exibição de página pelo comando sendEvent do SDK da Web:

  code language-js
  // If your current implementation has this line of code: s.t(); // Replace it with this line of code. The dataObj object contains the variables to send. alloy("sendEvent", dataObj);

• Rastreamento automático de links: a propriedade de configuração clickCollectionEnabled está habilitada por padrão. Ela define automaticamente as variáveis de rastreamento de link corretas para enviar dados ao Adobe Analytics. Para desabilitar o rastreamento automático de links, defina esta propriedade como false no comando configure.

• Rastreamento manual de links: o SDK da Web não tem comandos separados entre chamadas pageview e não pageview. Forneça essa distinção no objeto de carga.

  code language-js
  // If your current implementation has this line of code: s.tl(true,"o","Example custom link"); // Replace it with these lines of code. Add the required fields to the dataObj object. dataObj.data.__adobe.analytics.linkName = "Example custom link"; dataObj.data.__adobe.analytics.linkType = "o"; dataObj.data.__adobe.analytics.linkURL = "https://example.com"; alloy("sendEvent", dataObj);

Depois de remover todas as referências ao AppMeasurement e ao objeto s, publique as alterações no ambiente de desenvolvimento para validar se a nova implementação funciona. Depois de validar que tudo funciona corretamente, você poderá publicar suas atualizações para produção.

Se tiver sido migrado corretamente, AppMeasurement.js não será mais necessário no site, e todas as referências a esse script poderão ser removidas.