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 na visão geral do encaminhamento de eventos.
Para usar o encaminhamento de eventos no Adobe Experience Platform, os dados devem ser enviados para o Edge Network 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, sob o produto Adobe Experience Platform Launch, itens de permissão para Plataformas > Edge e todos os Direitos de Propriedade). Depois de concedido, você deve ver Encaminhamento de Eventos 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:
-
Selecione Encaminhamento de eventos na navegação à esquerda
-
Selecione Nova propriedade.
-
Nomeie a propriedade. Neste 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 a interface Coleção de Dados
-
Na navegação à esquerda, selecione Datastreams
-
Selecionar a sequência de dados
Luma Web SDK: Development Environmentcriada anteriormente
-
Selecione Adicionar Serviço
-
Selecione Encaminhamento de Eventos como o Serviço
-
Na lista suspensa ID de Propriedade, selecione o nome atribuído à propriedade de encaminhamento de eventos, neste caso
Server-Side - Web SDK Course -
Na lista suspensa ID de Ambiente, selecione o ambiente de marcas ao qual você está vinculando o ambiente de encaminhamento de eventos, neste 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 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: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 a lição Configurar um esquema XDM.
/ee, abrindo o sinal Carga e aprofundando na 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 propriedade Encaminhamento de Eventos criada recentemente
-
Na navegação à esquerda, selecione Elementos de Dados
-
Selecione para Criar novo elemento de dados
-
Nomeie o elemento de dados
environment.browserDetails.viewportHeight -
Em Extensão, saia de
CORE -
Em Tipo de Elemento de Dados, selecione
Path -
Digite o caminho do Objeto XDM que contém a Altura da Porta de Visualização de Navegador
arc.event.xdm.environment.browserDetails.viewportHeight -
Selecione Salvar
-
Criar outro elemento de dados
-
Nomeie
ecid -
Em Extensão, saia de
CORE -
Em Tipo de Elemento de Dados, selecione
Path -
Digite o caminho do objeto XDM que contém a ID de Experience Cloud
arc.event.xdm.identityMap.ECID.0.id -
Selecione Salvar
note caution CAUTION Certifique-se de incluir o prefixo arc.event.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, abrindo o sinal Carga e aprofundando na 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 a locais de terceiros, instale primeiro a extensão Adobe Cloud Connector.
-
Selecione Extensões na navegação à esquerda
-
Selecione a guia Catálogo
-
Procure o Conector de nuvem do Adobe, 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 e Condições:
- Marcas: 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 ao Platform Edge Network seja um acionador para encaminhar dados. Portanto, não há Eventos que devam ser selecionados nas regras de encaminhamento de eventos. Para gerenciar quais eventos acionam uma regra de encaminhamento de eventos, você deve configurar condições.
- Marcas: todas as regras são acionadas por um Evento que deve ser especificado na regra, por exemplo,
-
Tokenização de elemento de dados:
-
Marcas: os nomes de elementos de dados são tokenizados com um
%no início e no fim do nome do elemento de dados quando usados em uma regra. Por exemplo,%viewportHeight%. -
Encaminhamento de eventos: os nomes dos elementos de dados são tokenizados com
{{no início e}}no fim do nome do elemento de dados quando usados 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. Use-o como 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
-
Retorne Coleção de dados > Encaminhamento de eventos > Regras da navegação à esquerda
-
Selecione Criar nova regra
-
Nomeie como
all events - ad cloud connector - webhook -
Adicionar uma ação
-
Em Extension, selecione Adobe Cloud Connector
-
Em Tipo de ação, selecione Fazer chamada de busca
-
Cole a URL do seu Webhook no campo URL
-
Em [Parâmetros de consulta], você adicionará ambos os elementos de dados criados anteriormente.
-
No tipo de coluna Chave em
viewPortHeight. Na coluna Value, insira o elemento de dados{{environment.browserDetails.viewportHeight}}, digitando-o ou selecionando-o no ícone seletor de elemento de dados -
Selecione + Adicionar Outro para adicionar outro parâmetro de consulta
-
No tipo de coluna Chave em
ecid. Na coluna Value, insira o elemento de dados{{ecid}} -
Selecione Manter alterações
-
Sua regra deve parecer com abaixo
-
Selecione 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 marcas no site de demonstração da Luma para a propriedade de marca 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 a guia Edge e Connect para exibir as solicitações de Edge Network da plataforma
-
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 que está sendo enviado pela rede Edge
-
Observe os parâmetros de cadeia de caracteres de consulta viewPortHeight e ecid
-
Eles correspondem aos dados vistos no objeto XDM
-
Por fim, valide as correspondências de dados no Webhook.site e exiba a janela do Webhook aberta
Parabéns! Você configurou o encaminhamento de eventos!