Introdução à extensão de tag do Web SDK
Use as tags da Adobe Experience Platform (antigo Launch) para enviar dados de eventos do seu site para a Edge Network e soluções downstream da Adobe.
Antes de seguir essas etapas, verifique se você pode acessar os direitos de propriedade a seguir:
- Desenvolver
- Gerenciar extensões
Além disso, verifique se você tem todas as permissões nas seguintes categorias:
- Modelagem de dados
- Identidades
Criar um esquema do XDM schema
O Experience Data Model (XDM) é uma especificação de código aberto que fornece estruturas e definições comuns para dados na forma de esquemas. É altamente recomendável configurar um esquema ao enviar dados para a Edge Network.
- Faça logon no CX Enterprise usando suas credenciais da Adobe ID.
- Navegue até Coleção de dados > Esquemas.
- Selecione Criar esquema.
- Selecione Evento de experiência e Próximo.
- Dê um nome desejado ao esquema e selecione Concluir.
- (Opcional) É possível adicionar mais campos ou grupos de campos para quaisquer dados adicionais que você queira coletar.
Criar um fluxo de dados datastream
Uma Sequência de dados é uma configuração que informa à Edge Network como lidar com os dados enviados. Ao configurar um fluxo de dados para enviar dados a um determinado produto, o fluxo de dados transmite automaticamente dados relevantes para cada produto de uma forma que o produto específico entenda.
- Navegue até Coleção de dados > Sequências de dados.
- Selecione Nova sequência de dados.
- Dê um nome desejado à sequência de dados e selecione o esquema criado recentemente em Esquema de mapeamento.
- Selecione Salvar.
Criar uma propriedade de tag
Depois de criar um esquema e um fluxo de dados, você pode criar e configurar uma propriedade de tag.
- Navegue até Coleção de dados > Marcas.
- Selecione Nova propriedade.
- Dê à propriedade da marca um nome e um domínio desejados e selecione Salvar.
Instalar a extensão de tag
A extensão de tag do Web SDK é instalada em uma determinada propriedade de tag.
- Navegue até Coleção de dados > Marcas > Extensões.
- Selecione a guia Catálogo.
- Use a pesquisa para localizar a extensão Adobe Experience Platform Web SDK.
- Selecione o cartão de extensão e selecione Instalar à direita.
Configurar a extensão de tag
Ao instalar a extensão de tag do Web SDK, você é levado automaticamente para a página Configuração.
- Na seção Datastreams, selecione a sequência de dados desejada para cada ambiente.
Todas as outras configurações são preenchidas para você ou opcionais. Defina as configurações desejadas e selecione Salvar.
Criar um elemento de dados variável
A Adobe recomenda usar elementos de dados Variável para armazenar a carga que você deseja enviar para o Adobe. Os objetos XDM também são elementos de dados disponíveis, mas são mais antigos e limitados nos casos de uso aplicáveis.
-
Navegue até Coleção de dados > Marcas.
-
Selecione a propriedade de tag desejada.
-
Selecione Elementos de dados > Criar novo elemento de dados.
-
Forneça ao elemento de dados as seguintes propriedades à esquerda:
- Nome: qualquer nome que desejar
- Extensão: Adobe Experience Platform Web SDK
- Tipo de elemento de dados: Variável
-
Defina as seguintes propriedades à direita:
Tipo de variável: XDM
Sandbox: a sandbox na qual você criou seu esquema
Esquema: o esquema desejado -
Selecione Salvar.
Criar uma regra
As regras determinam quando você deseja acionar algo ou definir variáveis. A criação de uma regra que é executada sempre que a biblioteca é carregada permite preencher facilmente variáveis que você deseja que contenham um valor em cada página.
-
Navegue até Coleção de dados > Marcas.
-
Selecione a propriedade de tag desejada.
-
Selecione Regras > Adicionar regra.
-
Dê um nome desejado à regra.
-
Selecione o ícone ‘
+’ ao lado de Eventos. -
Atribua ao evento as seguintes configurações:
- Extensão: Núcleo
- Tipo de evento: Biblioteca carregada (início da página)
-
Selecione Manter alterações.
As etapas acima estabelecem a parte de critérios da regra, que é acionada quando a biblioteca é carregada. As etapas a seguir estabelecem as medidas a serem tomadas quando esses critérios forem atendidos.
-
Selecione o ícone ‘
+’ ao lado de Ações. -
Atribua à ação as seguintes configurações à esquerda:
- Extensão: Adobe Experience Platform Web SDK
- Tipo de ação: Enviar evento
-
Defina os seguintes campos à direita:
- XDM: o elemento de dados da variável XDM
-
Selecione Manter alterações.
Publicação
A propriedade da tag contém todos os componentes necessários para enviar dados para a Edge Network.
- Navegue até Coleção de Dados > Fluxo de publicação.
- Selecione Adicionar biblioteca.
- Dê um nome desejado à biblioteca. Considere esse nome semelhante a um nome de confirmação ao trabalhar no software de controle de versão.
- Defina o menu suspenso de ambiente como Desenvolvimento.
- Selecione Adicionar todos os recursos alterados.
- Selecione Salvar e criar no desenvolvimento.
Suas alterações agora são implantadas no ambiente de desenvolvimento.
- Navegue até Coleção de dados > Ambientes.
- Selecione o ícone de instalação ao lado do ambiente de desenvolvimento
- Instale o código incorporado em uma página da Web de teste no site.
Depois de validar que a tag funciona no ambiente de desenvolvimento, você poderá usar a interface do Fluxo de publicação para publicar a biblioteca para preparo e, em seguida, para produção.
- Adicione a extensão e a regra a uma Biblioteca, crie-a em um Ambiente e instale o código de inserção no site.
- Validar com Adobe Experience Platform Debugger.
Agora você tem uma configuração de lean que captura eventos e os envia para a Edge Network. Agora, você pode aumentar ainda mais a implementação adicionando campos ao esquema, produtos a um fluxo de dados ou elementos de dados à propriedade de tag.