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
sendEventdo 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:
- O ACDL está instalado em suas páginas.
- O código base e a biblioteca do Web SDK estão instalados, e o Web SDK está configurado com uma sequência de dados.
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.
- A extensão ACDL está instalada e configurada na propriedade da marca.
- A extensão Web SDK está instalada e configurada com uma sequência de dados.
Escolha como mapear seus dados mapping
O Web SDK envia dados em dois objetos. Escolha uma ou ambas:
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:
event.page.title, onde event é o argumento do ouvinte%event.message.page.title%adobeDataLayer.getState("page.title")page.titleUse 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.
Ouça o evento e chame sendEvent:
| code language-js |
|---|
|
Para todas as opções de ouvinte, consulte addEventListener().
-
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. -
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
-
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.namecomo%event.message.page.title%e definaweb.webPageDetails.pageViews.valuecomo1.
-
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%
-
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.
| code language-js |
|---|
|
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").
-
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. -
Crie uma regra com o mesmo evento de push de camada de dados que em Enviar dados XDM.
-
Adicionar uma ação Enviar evento da extensão do Web SDK:
- Tipo:
web.webpagedetails.pageViews - Dados:
%ACDL state%
- Tipo:
-
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.
Limpe o histórico no final do ouvinte de exibição de página:
| code language-js |
|---|
|
Consulte Limpar o histórico.
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çãoscopeno 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. Usefuturesomente 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.
Páginas relacionadas related
- Comando
sendEvente ação Enviar evento: todas as opções do Web SDK para enviar eventos. addEventListener()e Push da camada de dados: todas as opções para escuta de eventos ACDL.