Atualize sua biblioteca de coleção de dados para o Audience Manager da biblioteca JavaScript do AppMeasurement para a biblioteca JavaScript do 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 os dados para o Audience Manager. No futuro, esse mesmo fluxo de dados encaminha dados para o Real-Time CDP.

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é Data Collection.

3. Na navegação à esquerda, selecione Datastreams.

4. Selecionar New Datastream.

5. Insira o nome desejado e selecione Save.

6. Depois que o fluxo de dados for criado, selecione Add Service.

7. No menu suspenso do serviço, selecione Audience Manager.

   

Seu fluxo de dados agora está pronto para receber e transmitir dados para o Audience Manager. 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 o fluxo de dados criado na etapa 1 usando o SDK da Web configure comando. A variável configure O comando deve ser definido em cada página para que você possa incluí-lo junto com o código de instalação da biblioteca.

Use o edgeConfigId e orgId propriedades no SDK da Web configure comando:

• Defina o edgeConfigId para a ID de fluxo de dados recuperada da etapa anterior.
• Defina o orgId para a ID da organização IMS.

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

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

Altere a implementação do Audience Manager para que ele não dependa de AppMeasurement.js ou o s objeto. 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 um camada de dados no seu site ajuda muito ao definir valores, pois você pode continuar fazendo referência a esses mesmos valores.

Para enviar dados para o Audience Manager, a carga do SDK da Web deve usar data.__adobe.audiencemanager com todas as variáveis do analytics 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 string. Exatamente é se você definir a variável s.products Variável:

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

Em última análise, essa carga contém todos os valores desejados e todas as referências à s objetos na implementação do são removidos. Você pode usar qualquer um dos recursos fornecidos pelo JavaScript para definir esse objeto de carga útil, incluindo a notação de pontos para definir valores individuais.

// Define the payload and set objects within it
var dataObj = {data: {__adobe: {audiencemanager: {}}}};
dataObj.data.__adobe.audiencemanager.pageName = window.document.title;
dataObj.data.__adobe.audiencemanager.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:{audiencemanager:{...a}}}};

Atualizar todas as instâncias para as quais você chamar s.t() e s.tl(), substituindo-os pelo sendEvent comando. 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 SDK da Web sendEvent comando:

  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 variável clickCollectionEnabled a propriedade de configuração é ativada por padrão. Ela define automaticamente as variáveis de rastreamento de link corretas para enviar dados ao Audience Manager. Se quiser desativar o rastreamento automático de links, defina essa propriedade como false no prazo de configure comando.

• Rastreamento manual de links: o SDK da Web não tem comandos separados entre chamadas de exibição de página e de não exibição de página. 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.audiencemanager.linkName = "Example custom link"; dataObj.data.__adobe.audiencemanager.linkType = "o"; dataObj.data.__adobe.audiencemanager.linkURL = "https://example.com"; alloy("sendEvent", dataObj);

Depois de remover todas as referências ao AppMeasurement e à s objeto, 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 migrado corretamente, AppMeasurement.js O não é mais necessário no site e todas as referências a esse script podem ser removidas.