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:
- Develop
- Manage extensions
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 em experience.adobe.com usando suas credenciais da Adobe ID.
- Navegue até Data Collection > Schemas.
- Selecione Create schema.
- Selecione Experience Event e depois Next.
- Dê um nome desejado ao esquema e selecione Finish.
- (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é Data Collection > Datastreams.
- Selecione New datastream.
- Dê ao fluxo de dados um nome desejado e selecione o esquema criado recentemente em Mapping schema.
- Selecione Save.
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é Data Collection > Tags.
- Selecione New property.
- Dê à propriedade da marca um nome e um domínio desejados e selecione Save.
Instalar a extensão de tag
A extensão de tag do Web SDK é instalada em uma determinada propriedade de tag.
- Navegue até Data Collection > Tags > Extensions.
- Selecione a guia Catalog.
- Use a pesquisa para localizar a extensão Adobe Experience Platform Web SDK.
- Selecione o cartão de extensão e, em seguida, selecione Install à 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 quaisquer definições de configuração desejadas e selecione Save.
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é Data Collection > Tags.
-
Selecione a propriedade de tag desejada.
-
Selecione Data elements > Create new data element.
-
Forneça ao elemento de dados as seguintes propriedades à esquerda:
- Name: Qualquer nome desejado
- Extension: Adobe Experience Platform Web SDK
- Data element type: Variable
-
Defina as seguintes propriedades à direita:
Tipo de variável: XDM
Sandbox: a sandbox na qual você criou seu esquema
Schema: o esquema desejado -
Selecione Save.
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é Data Collection > Tags.
-
Selecione a propriedade de tag desejada.
-
Selecione Rules > Add rule.
-
Dê um nome desejado à regra.
-
Selecione o ícone '
+' ao lado de Events. -
Atribua ao evento as seguintes configurações:
- Extension: Core
- Event type: Library loaded (page top)
-
Selecione Keep changes.
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 Actions. -
Atribua à ação as seguintes configurações à esquerda:
- Extension: Adobe Experience Platform Web SDK
- Action type: Send event
-
Defina os seguintes campos à direita:
- XDM: o elemento de dados da variável XDM
-
Selecione Keep changes.
Publicação
A propriedade da tag contém todos os componentes necessários para enviar dados para a Edge Network.
- Navegue até Data Collection > Publishing flow.
- Selecione Add library.
- 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 Development.
- Selecione Add all changed resources.
- Selecione Save & build to Development.
Suas alterações agora são implantadas no ambiente de desenvolvimento.
- Navegue até Data Collection > Environments.
- 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 Publishing flow para publicar a biblioteca no ambiente de preparo e, em seguida, no ambiente de 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.