Configurar o encaminhamento de eventos com dados do SDK da Web da plataforma
Saiba como usar o encaminhamento de eventos com dados do SDK da Web da Adobe Experience Platform.
O encaminhamento de eventos é um novo tipo de propriedade disponível em Coleção de dados. O encaminhamento de eventos oferece a capacidade de enviar dados para fornecedores de terceiros que não sejam de Adobe diretamente do Edge Network Adobe Experience Platform, em vez do navegador tradicional do lado do cliente. Saiba mais sobre as vantagens do encaminhamento de eventos no Visão geral do encaminhamento de eventos.
Para usar o encaminhamento de eventos na Adobe Experience Platform, os dados devem ser enviados para a Rede de borda da Adobe Experience Platform primeiro usando uma ou mais das três opções a seguir:
Depois de concluir as lições anteriores neste tutorial, você deve enviar dados para o Platform Edge Network usando o SDK da Web. Quando os dados estiverem no Platform Edge Network, você poderá ativar o encaminhamento de eventos e usar uma propriedade de encaminhamento de eventos para enviar dados a soluções que não sejam Adobe.
Objetivos de aprendizagem
Neste final desta lição, você poderá:
- Criar uma propriedade de encaminhamento de eventos
- Vincular uma propriedade de encaminhamento de eventos a uma sequência de dados do SDK da Web da plataforma
- Entender as diferenças entre as regras e os elementos de dados da propriedade de tag e as regras e os elementos de dados da propriedade de encaminhamento de eventos
- Criar um elemento de dados de encaminhamento de eventos
- Configurar uma regra de encaminhamento de eventos
- Validar se uma propriedade de encaminhamento de eventos está enviando dados com êxito
Pré-requisitos
-
Uma licença de software que inclua encaminhamento de eventos. O encaminhamento de eventos é um recurso pago da Coleção de dados. Entre em contato com a equipe de conta do Adobe para obter mais detalhes.
-
O encaminhamento de eventos está habilitado em sua organização Experience Cloud.
-
Permissão de usuário para encaminhamento de eventos. (Em Admin Console, no produto Adobe Experience Platform Launch, itens de permissão paraPlataformas > Edge e todos Direitos de propriedade). Depois de concedido, você deve ver Encaminhamento de evento na navegação à esquerda da interface da Coleção de dados:
-
O SDK da Web ou móvel do Adobe Experience Platform está configurado para enviar dados para o Edge Network. Você deve ter concluído as seguintes lições deste tutorial:
Criar uma propriedade de encaminhamento de eventos
Comece criando uma propriedade de encaminhamento de eventos:
-
Selecionar Encaminhamento de evento na navegação à esquerda
-
Selecione Nova propriedade.
-
Nomeie a propriedade. Nesse caso,
Server-Side - Web SDK Course -
Selecione Salvar.
Configurar o fluxo de dados
Para que o encaminhamento de eventos use os dados enviados para o Edge Network da plataforma, é necessário vincular a propriedade de encaminhamento de eventos recém-criada ao mesmo fluxo de dados usado para enviar dados para as soluções da Adobe.
Para configurar o Target na sequência de dados:
-
Ir para Coleta de dados interface
-
Na navegação à esquerda, selecione Datastreams
-
Selecione o criado anteriormente
Luma Web SDK: Development Environmentsequência de dados
-
Selecionar Adicionar serviço
-
Selecionar Encaminhamento de evento como o Serviço
-
No ID da propriedade selecione o nome que você deu à propriedade de encaminhamento de eventos, nesse caso,
Server-Side - Web SDK Course -
No ID do ambiente selecione o ambiente de tag ao qual você está vinculando o ambiente de encaminhamento de eventos, nesse caso
Developmentnote tip TIP Para enviar dados a um ambiente de encaminhamento de eventos fora da organização do Adobe, selecione Inserir IDs manualmente e cole em uma ID. A ID é fornecida quando você cria uma propriedade de encaminhamento de eventos. -
Selecione Salvar.
Repita essas etapas para fluxos de dados de preparo e produção quando estiver pronto para promover as alterações por meio do fluxo de publicação.
Encaminhar dados do Edge Network da plataforma para uma solução não-Adobe
Neste exercício, você aprenderá a configurar um elemento de dados de encaminhamento de eventos, configurar uma regra de encaminhamento de eventos e validar o usando uma ferramenta de terceiros chamada Webhook.site.
Criar um elemento de dados de encaminhamento de eventos
O objeto XDM configurado anteriormente usando a extensão de tag do SDK da Web da Platform se torna a fonte de dados dos elementos de dados em uma propriedade de encaminhamento de eventos. Você usa os mesmos dados que já configurou na propriedade de tag como uma fonte de dados para o encaminhamento de eventos.
arc.event prefixo:arcsignifica Contexto de resposta da Adobe.- Por exemplo:
arc.event.xdm.web.webPageDetails.URL
Neste exercício, você encaminhará a altura da janela de visualização do navegador e a ID do Experience Cloud do objeto XDM para um webhook. O caminho do campo XDM é determinado pelo esquema XDM criado durante o Configurar um esquema XDM lição.
/ee solicitações, abertura do sinal Carga e detalhando a variável que você está procurando. Em seguida, clique com o botão direito do mouse e selecione "Copiar caminho da propriedade". Veja um exemplo de Altura da janela de visualização do navegador:
-
Vá para a Encaminhamento de evento propriedade que você criou recentemente
-
Na navegação à esquerda, selecione Elementos de dados
-
Selecione para Criar novo elemento de dados
-
Nome o elemento de dados
environment.browserDetails.viewportHeight -
Em Extensão, sair
CORE -
Em Tipo de elemento de dados, selecione
Path -
Digite o caminho do Objeto XDM que contém a Altura da janela de visualização do navegador
arc.event.xdm.environment.browserDetails.viewportHeight -
Selecionar Salvar
-
Criar outro elemento de dados
-
Nome it
ecid -
Em Extensão, sair
CORE -
Em Tipo de elemento de dados, selecione
Path -
Digite o caminho do objeto XDM que contém a ID do Experience Cloud
arc.event.xdm.identityMap.ECID.0.id -
Selecionar Salvar
note caution CAUTION Certifique-se de incluir o arc.event.prefixo no caminho. Além disso, siga o caso exato como o nome do campo Objeto XDM — o namespace da ECID deve estar em maiúsculas.note tip TIP Ao trabalhar com seu próprio site, você pode encontrar o caminho do objeto XDM com as ferramentas de rede do navegador da Web, filtrando por /eesolicitações, abertura do sinal Carga e detalhando a variável que você está procurando. Em seguida, clique com o botão direito do mouse e selecione "Copiar caminho da propriedade". Veja um exemplo de Altura da janela de visualização do navegador:
Instalar a extensão Adobe Cloud Connector
Para enviar dados para locais de terceiros, primeiro instale o Adobe Cloud Connector extensão.
-
Selecionar Extensões na navegação à esquerda
-
Selecione o Catálogo guia
-
Procure por Adobe Cloud Connector, selecione Instalar
Não há configuração de extensão necessária. Com essa extensão, agora é possível encaminhar dados para uma solução não Adobe!
Criar uma regra de encaminhamento de eventos
Há algumas diferenças principais entre a configuração de regras em uma propriedade de tag e uma regra em uma propriedade de encaminhamento de eventos:
-
Eventos & Condições:
- Tags: todas as regras são acionadas por um Evento que deve ser especificado na regra, por exemplo,
Library Loaded - Page Top. As condições são opcionais. - Encaminhamento de eventos: presume-se que cada evento enviado para o Platform Edge Network seja um acionador para encaminhar dados. Por conseguinte, não existem Eventos que devem ser selecionadas nas regras de encaminhamento de eventos. Para gerenciar quais eventos acionam uma regra de encaminhamento de eventos, você deve configurar condições.
- Tags: todas as regras são acionadas por um Evento que deve ser especificado na regra, por exemplo,
-
Tokenização do elemento de dados:
-
Tags: os nomes dos elementos de dados são tokenizados com um
%no início e no fim do nome do elemento de dados quando usado em uma regra. Por exemplo,%viewportHeight%. -
Encaminhamento de eventos: os nomes dos elementos de dados são tokenizados com
{{no início e}}no final do nome do elemento de dados, quando usado em uma regra. Por exemplo,{{viewportHeight}}.
-
-
Sequência de ações de regra:
- A seção Ações de uma regra de encaminhamento de eventos é sempre executada sequencialmente. Verifique se a ordem das ações está correta ao salvar uma regra. Essa sequência de execução não pode ser executada de forma assíncrona como com tags.
Para configurar uma regra para encaminhar dados para o seu webhook, primeiro obtenha o webhook pessoal:
-
Ir para Webhook.site
-
Localizar Seu URL exclusivo, você usa isso como a solicitação de URL em sua regra de encaminhamento de eventos
-
Selecionar Copiar para a área de transferência
-
Deixe essa janela aberta, pois você poderá validar os dados do encaminhamento de eventos em tempo real que estão sendo capturados pelo Webhook
-
Voltar Coleta de dados > Encaminhamento de evento > Regras na navegação à esquerda
-
Selecionar Criar nova regra
-
Nomear como
all events - ad cloud connector - webhook -
Adicionar uma ação
-
Em Extensão, selecione Adobe Cloud Connector
-
Em Tipo de ação, selecione Fazer chamada de busca
-
Cole o URL do Webhook no URL campo
-
Em [Parâmetros de consulta], você adicionará ambos os elementos de dados criados anteriormente.
-
No Chave tipo de coluna em
viewPortHeight. No Valor , insira o{{environment.browserDetails.viewportHeight}}elemento de dados ao digitá-lo ou selecioná-lo no ícone seletor de elemento de dados -
Selecionar + Adicionar outro para adicionar outro parâmetro de consulta
-
No Chave tipo de coluna em
ecid. Na coluna Valor, insira a variável{{ecid}}elemento de dados -
Selecionar Manter alterações
-
Sua regra deve parecer com abaixo
-
Selecionar Salvar
Criar a biblioteca
Crie uma biblioteca e crie todas as alterações no ambiente de desenvolvimento do encaminhamento de eventos, como você faria normalmente em uma propriedade de tag.
Validar regra de encaminhamento de eventos
Agora você pode validar sua propriedade de encaminhamento de eventos usando o Platform Debugger e o Webhook.site:
-
Siga as etapas para alternar a biblioteca de tags no Site de demonstração da Luma à propriedade de tag do SDK da Web para a qual você mapeou sua propriedade de encaminhamento de eventos na sequência de dados.
-
Antes de recarregar a página, no Experience Platform Debugger, abra Logs na navegação à esquerda
-
Selecione o Edge e selecione Conectar para ver as solicitações do Platform Edge Network
-
Recarregar a página
-
Você verá solicitações adicionais que dão visibilidade das solicitações do lado do servidor enviadas pelo Edge Network da plataforma para o WebHook
-
A solicitação para focalizar a validação é aquela que mostra o URL totalmente construído sendo enviado pela rede de borda
-
Observe os parâmetros de cadeia de caracteres de consulta viewPortHeight e ecid
-
Eles correspondem aos dados vistos no objeto XDM
-
Por último, valide as correspondências de dados no Webhook.site e também visualizando a janela aberta do Webhook
Parabéns! Você configurou o encaminhamento de eventos!