Enviar dados da Camada de dados de clientes Adobe com o Web SDK

A Camada de dados de clientes Adobe (ACDL) coleta dados e eventos na página, mas não os envia para lugar nenhum. Para enviá-los ao Adobe Experience Platform Edge Network, conecte os eventos ACDL ao Web SDK de uma das seguintes maneiras:

  • Biblioteca JavaScript: seu próprio código escuta eventos ACDL e chama o comando sendEvent do Web SDK.
  • Extensões de marca: as regras de marca usam a extensão ACDL para acionar eventos ACDL e a extensão Web SDK para enviar os dados.

Cada seção desta página mostra ambas as abordagens.

Pré-requisitos prerequisites

O código do site envia os dados e eventos que você deseja enviar. Os exemplos nesta página usam o seguinte push para cada exibição de página:

window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push({
  event: "page view",
  page: { title: "Home", language: "en" }
});

Dependendo da sua abordagem, também é necessário o seguinte:

biblioteca JavaScript

O código base do Web SDK enfileira comandos até que sua biblioteca seja carregada e o ACDL enfileira itens até que sua biblioteca seja carregada. Devido a essas filas, você pode adicionar o código nessa página em qualquer lugar depois do código base do Web SDK, independentemente de qual biblioteca é carregada primeiro.

Extensões de marca

Escolha como mapear seus dados mapping

O Web SDK envia dados em dois objetos. Escolha uma ou ambas:

Objeto
Como funciona o mapeamento
Use-o quando
xdm
Você constrói um objeto que corresponde ao esquema XDM a partir dos valores da camada de dados, no código ou em uma regra de tag.
Você deseja ter controle total sobre a carga, ou a camada de dados já é semelhante ao esquema.
data
Os valores da camada de dados são enviados como estão. Você os mapeia para o XDM na sequência de dados com Preparação de Dados para Coleta de Dados.
Você deseja manter a lógica de mapeamento fora do código da página e das regras de tag, ou vários sites compartilham uma camada de dados bem controlada.

Escolher de onde os valores vêm value-sources

Quando um evento ACDL aciona seu código ou regra, você pode ler valores da camada de dados a partir de dois locais:

Origem
Biblioteca do JavaScript
Extensões de tag
Contains
O objeto enviado
event.page.title, onde event é o argumento do ouvinte
%event.message.page.title%
Somente o objeto que acionou o evento.
O estado calculado
adobeDataLayer.getState("page.title")
Um elemento de dados 🔗 de estado computado ​ da camada de dados com o caminho page.title
Todos os dados foram mesclados de cada push até o momento.

Use o objeto enviado para valores que descrevem o próprio evento, como o produto em uma adição ao carrinho. Use o estado calculado para valores enviados anteriormente, como detalhes do usuário. Quando o código ou a regra é executado, o estado calculado já inclui os dados do push que o acionou. Consulte O que os ouvintes recebem e Usar os dados enviados nas regras.

Enviar dados XDM xdm

Os exemplos a seguir enviam uma visualização de página com o título da página do objeto enviado.

biblioteca JavaScript

Ouça o evento e chame sendEvent:

code language-js
window.adobeDataLayer = window.adobeDataLayer || [];

function sendPageView(event) {
  alloy("sendEvent", {
    xdm: {
      eventType: "web.webpagedetails.pageViews",
      web: {
        webPageDetails: {
          name: event.page.title,
          pageViews: { value: 1 }
        }
      }
    }
  });
}

window.adobeDataLayer.push(function(dl) {
  dl.addEventListener("page view", sendPageView);
});

Para todas as opções de ouvinte, consulte addEventListener().

Extensões de marca
  1. Crie um elemento de dados Variable com a extensão Web SDK. Selecione XDM e, em seguida, selecione sua sandbox e esquema. Este exemplo nomeia o elemento de dados XDM variable.

  2. Criar uma regra e adicionar um evento:

    • Extensão: Camada de Dados de Clientes Adobe
    • Tipo de evento: push de camada de dados
    • Acionadores em: Eventos com nome específico, com o nome de evento page view
    • Escopo de tempo: Todos
  3. Adicione uma ação que preencha o objeto XDM:

    • Extensão: Adobe Experience Platform Web SDK
    • Tipo de ação: Atualizar variável
    • Elemento de dados: XDM variable
    • Defina web.webPageDetails.name como %event.message.page.title% e defina web.webPageDetails.pageViews.value como 1.
  4. Adicionar uma ação que envia o evento:

    • Extensão: Adobe Experience Platform Web SDK
    • Tipo de ação: Enviar evento
    • Tipo: web.webpagedetails.pageViews
    • XDM: %XDM variable%
  5. Salve a regra, adicione-a a uma biblioteca e crie a biblioteca.

Para todas as opções de evento, consulte Push da camada de dados.

Cada vez que o site envia um evento page view, o código ou a regra envia uma exibição de página para a Edge Network.

Enviar interações da mesma maneira. Por exemplo, para um push como { event: "cart add", eventInfo: { sku: "HT105" } }, escute ou acione cart add e leia o produto em eventInfo. Para os campos XDM que descrevem interações comerciais, consulte Coletar informações de comércio, produto e pedido.

Enviar a camada de dados para mapeamento na sequência de dados data

Para mapear na sequência de dados, em vez de em códigos ou regras, envie valores de camada de dados no objeto data e inclua um XDM eventType para que o evento seja classificado corretamente.

biblioteca JavaScript
code language-js
function sendWithDataPrep(event) {
  alloy("sendEvent", {
    xdm: { eventType: "web.webpagedetails.pageViews" },
    data: this.getState()
  });
}

window.adobeDataLayer.push(function(dl) {
  dl.addEventListener("page view", sendWithDataPrep);
});

Dentro de um ouvinte ACDL, this refere-se à camada de dados, portanto, this.getState() retorna o estado calculado. Para enviar apenas parte dele, passe um caminho, como this.getState("page").

Extensões de marca
  1. Crie um elemento de dados de estado computado camada de dados com a extensão ACDL. Selecione Todo o estado computado, ou selecione Caminho específico e insira o caminho dos dados que deseja enviar. Este exemplo nomeia o elemento de dados ACDL state.

  2. Crie uma regra com o mesmo evento de push de camada de dados que em Enviar dados XDM.

  3. Adicionar uma ação Enviar evento da extensão do Web SDK:

    • Tipo: web.webpagedetails.pageViews
    • Dados: %ACDL state%
  4. Salve a regra, adicione-a a uma biblioteca e crie a biblioteca.

Em seguida, no fluxo de dados, mapeie os campos enviados para o esquema XDM. Consulte Preparação de Dados para a Coleção de Dados. Dados que você não mapeia e que nenhum serviço configurado lê não são armazenados. Enviar todo o estado calculado também aumenta o tamanho de cada solicitação, de modo que, nas páginas com uma grande camada de dados, envie apenas as partes mapeadas.

Aplicativos de página única spa

Em um aplicativo de página única, a página permanece aberta enquanto o visitante visualiza muitas páginas virtuais e o histórico da camada de dados continua crescendo. Envie por push um evento page view para cada exibição de página virtual e limpe o histórico depois de enviá-lo. A limpeza do histórico não altera o estado calculado nem remove ouvintes e regras.

biblioteca JavaScript

Limpe o histórico no final do ouvinte de exibição de página:

code language-js
function sendPageView(event) {
  alloy("sendEvent", { /* ... */ });
  this.length = 0;
}

Consulte Limpar o histórico.

Extensões de marca
Adicione a ação Limpar histórico da camada de dados da extensão ACDL como a última ação da regra de exibição de página.

Tempo e duplicatas timing

Siga estas práticas para que cada evento seja enviado exatamente uma vez:

  • Usar o escopo all. É o padrão em ambas as abordagens: a opção scope no JavaScript e a configuração Escopo de tempo nas tags. Envia eventos que foram enviados antes do listener ou da regra começar a escutar, como uma exibição de página enviada antes do carregamento do script ou da biblioteca de tags. Use future somente se outra parte da sua implementação já tiver enviado os eventos anteriores. Consulte Escopo.
  • Enviar cada evento de um local. Se seu próprio código e uma regra de tag enviarem o mesmo evento de camada de dados, o Adobe o receberá duas vezes.
  • Biblioteca do JavaScript: use funções nomeadas e adicione cada ouvinte uma vez. A ACDL ignora um segundo registro da mesma função para o mesmo evento. No entanto, se o código executado repetidamente passar uma nova função anônima a cada vez, a ACDL adicionará um novo ouvinte a cada vez e cada evento será enviado mais de uma vez.
  • Extensões de marca: acionador em nomes de evento específicos. Uma regra que aciona em Todas as alterações de dados é executada para cada push de dados, o que pode enviar muito mais eventos do que o esperado.
recommendation-more-help
experience-platform-help-collection