Documentação Experience Platform Assimilar dados de transmissão

Assimilar dados de transmissão

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:
Assimilação de dados

Criado para:

Iniciante
Intermediário
Desenvolvedor

Nesta lição, você transmitirá dados usando o SDK da Web da Adobe Experience Platform.

Há duas tarefas principais que devem ser concluídas na interface da Coleção de dados:

Precisamos implementar o SDK da Web no site Luma para enviar dados sobre a atividade do visitante do site para a rede da Adobe Edge. Faremos uma implementação simples usando tags (antigo Launch)
Precisamos configurar um fluxo de dados, que informa à rede da Edge para onde encaminhar os dados. Vamos configurá-los para enviar os dados para nosso conjunto de dados Luma Web Events na sandbox da Platform.

Os engenheiros de dados precisarão assimilar dados de transmissão fora deste tutorial. Ao implementar os SDKs da Web ou móvel da Adobe Experience Platform, normalmente um desenvolvedor da Web ou móvel está envolvido na criação da camada de dados e na configuração da propriedade de tag.

Antes de começar os exercícios, assista a estes dois pequenos vídeos para saber mais sobre a assimilação de dados por transmissão e o SDK da Web:

https://video.tv.adobe.com/v/31683?learn=on&captions=por_br

https://video.tv.adobe.com/v/37265?learn=on&captions=por_br

NOTE

Embora este tutorial se concentre na assimilação por transmissão de sites com o SDK da Web, você também pode transmitir dados usando o SDK móvel do Adobe, o Apache Kafka Connect e outros mecanismos.

Permissões necessárias

Na lição Configurar Permissões, você configura todos os controles de acesso necessários para concluir esta lição.

Configurar o fluxo de dados

Primeiro, configuraremos o fluxo de dados. Um fluxo de dados informa à rede Adobe Edge para onde enviar os dados depois de recebê-los da chamada do SDK da Web. Por exemplo, deseja enviar os dados para o Experience Platform, Adobe Analytics ou Adobe Target? Os fluxos de dados são gerenciados na interface da Coleção de dados (antigo Launch) e são essenciais para a coleta de dados com o SDK da Web.

Para criar sua sequência de dados:

Faça logon na interface de usuário da Coleção de dados do Experience Platform
Selecione Datastreams na navegação à esquerda
Selecione o botão Nova sequência de dados no canto superior direito
Para o Nome Amigável, digite Luma Platform Tutorial (adicione seu nome ao final, se várias pessoas da sua empresa estiverem fazendo este tutorial)
Selecione o botão Salvar

Na próxima tela, especifique para onde deseja enviar dados. Para enviar dados para o Experience Platform:

Alternar no Adobe Experience Platform para expor campos adicionais
Para Sandbox, selecione Luma Tutorial
Para Conjunto de Dados do Evento, selecione Luma Web Events Dataset
Se você usa outros aplicativos Adobe, sinta-se à vontade para explorar as outras seções para ver quais informações são necessárias na Configuração Edge dessas outras soluções. Lembre-se de que o SDK da Web foi desenvolvido não apenas para transmitir dados para o Experience Platform, mas também para substituir todas as bibliotecas JavaScript anteriores usadas por outros aplicativos Adobe. A Configuração do Edge é usada para especificar os detalhes da conta de cada aplicativo para o qual você deseja enviar os dados.
Selecione Salvar

Depois que a configuração do Edge for salva, a tela resultante mostrará três ambientes que foram criados para desenvolvimento, armazenamento temporário e produção. Ambientes de desenvolvimento adicionais podem ser adicionados:
Cada configuração do Edge pode ter vários ambientes
Todos os três ambientes contêm os detalhes da plataforma que você acabou de inserir. No entanto, esses detalhes podem ser configurados de formas diferentes por ambiente. Por exemplo, cada ambiente pode enviar dados para uma sandbox da Platform diferente. Neste tutorial, não faremos nenhuma personalização adicional no nosso fluxo de dados.

Instalar a extensão SDK da Web

Adicionar uma propriedade do

Primeiro, devemos criar uma propriedade de tag (anteriormente uma propriedade de tag ). Uma propriedade é um container para todas as JavaScript, regras e outros recursos necessários para coletar detalhes de uma página da Web e enviá-los para vários locais.

Para criar uma propriedade:

Vá para Propriedades na navegação à esquerda
Selecione o botão Nova propriedade
Como o Nome, digite Luma Platform Tutorial (adicione seu nome ao final, se várias pessoas da sua empresa estiverem fazendo este tutorial)
Como os Domínios, digite enablementadobe.com (explicado mais tarde)
Selecione Salvar

Adicionar a extensão SDK da Web

Agora que você tem uma propriedade, é possível adicionar o SDK da Web usando uma extensão. Uma extensão é um pacote de códigos que estende a interface e a funcionalidade da Coleção de dados. Para adicionar a extensão:

Abra a propriedade da tag
Vá para Extensões na navegação à esquerda
Vá para a guia Catálogo
Há muitas extensões disponíveis para tags. Filtrar o catálogo com o termo Web SDK
Na extensão Adobe Experience Platform Web SDK, selecione o botão Instalar
Há várias configurações disponíveis para a extensão SDK da Web, mas há apenas duas que vamos configurar para este tutorial. Atualize o Domínio do Edge para data.enablementadobe.com. Essa configuração permite definir cookies primários com a implementação do SDK da Web, que é incentivada. Posteriormente nesta lição, você mapeará um site no domínio enablementadobe.com para a propriedade de tag. O CNAME do domínio enablementadobe.com já foi configurado para que data.enablementadobe.com encaminhe para servidores Adobe. Ao implementar o SDK da Web no seu próprio site, será necessário criar um CNAME para fins de coleta de dados, por exemplo, data.YOUR_DOMAIN.com
Na lista suspensa Sequência de dados, selecione a sequência de dados Luma Platform Tutorial.
Fique à vontade para ver as outras opções de configuração (mas não as altere!) e selecione Salvar

Criar uma regra para enviar dados

Agora criaremos uma regra para enviar dados para a Platform. Uma regra é uma combinação de eventos, condições e ações que instruem as tags a fazer algo. Para criar uma regra:

Vá para Regras na navegação à esquerda
Selecione o botão Criar nova regra
Atribua um nome à regra All Pages - Library Loaded
Em Eventos, selecione o botão Adicionar
Use a Extensão de do {Core e selecione Biblioteca Carregada (Início da Página) como o Tipo de Evento. Essa configuração significa que nossa regra é acionada sempre que a biblioteca do Launch é carregada em uma página.
Selecione Manter alterações para retornar à tela de regra principal
Deixe Condições em branco, pois queremos que esta regra seja acionada em todas as páginas, de acordo com o nome que demos a ela
Em Ações, selecione o botão Adicionar
Use a Extensão do do SDK da Web da Adobe Experience Platform e selecione Enviar Evento como o Tipo de Ação
À direita, selecione web.webpagedetails.pageViews na lista suspensa Tipo. Este é um dos campos XDM em nosso Luma Web Events Schema
Selecione Manter alterações para retornar à tela de regra principal
Selecione Salvar para salvar a regra

Publish da regra em uma biblioteca

Em seguida, publicaremos a regra em nosso ambiente de desenvolvimento para que possamos verificar se ela funciona.

Para criar uma biblioteca:

Vá para Fluxo de Publicação na navegação à esquerda
Selecione Adicionar biblioteca
Para o Nome, digite Luma Platform Tutorial
Para o Ambiente, selecione Development
Selecione o botão Adicionar todos os recursos alterados. (Além da extensão Adobe Experience Platform Web SDK e da regra All Pages - Library Loaded, você também verá a extensão Core adicionada, que contém a base do JavaScript exigida por todas as propriedades da Web do Launch.)
Selecione o botão Salvar e criar para desenvolvimento

A biblioteca pode levar alguns minutos para ser criada e, quando estiver concluída, exibirá um ponto verde à esquerda do nome da biblioteca:
Compilação concluída

Como você pode ver na tela Fluxo de publicação, há muito mais no processo de publicação, que está além do escopo deste tutorial. Vamos usar uma única biblioteca em nosso ambiente de desenvolvimento.

Validar os dados na solicitação

Adicione o Adobe Experience Platform Debugger

O Experience Platform Debugger é uma extensão disponível para os navegadores Chrome e Firefox que ajuda a visualizar a tecnologia de Adobe implementada nas páginas da Web. Baixe a versão do seu navegador de preferência:

Se você nunca usou o Debugger antes (e este é diferente do Adobe Experience Cloud Debugger mais antigo), assista a este vídeo de visão geral de cinco minutos:

https://video.tv.adobe.com/v/36163?learn=on&captions=por_br

Abra o site Luma

Para este tutorial, usamos uma versão hospedada publicamente do site de demonstração do Luma. Vamos abri-lo e marcá-lo:

Em uma nova guia do navegador, abra o site da Luma.
Marque a página para uso no restante do tutorial

Este site hospedado explica por que usamos enablementadobe.com no campo Domínios de nossa configuração inicial de propriedade de tag e por que usamos data.enablementadobe.com como nosso domínio próprio na extensão do Adobe Experience Platform Web SDK. Veja, eu tinha um plano!

Página inicial do Luma

Use o depurador de Experience Platform para mapear para a propriedade de tag

O depurador de Experience Platform tem um recurso interessante que permite substituir uma propriedade de tag existente por outra. Isso é útil para validação e permite ignorar muitas etapas de implementação neste tutorial.

Verifique se o site Luma está aberto e selecione o ícone da extensão do Experience Platform Debugger
O Debugger abrirá e mostrará alguns detalhes da implementação codificada, que não está relacionada a este tutorial (talvez seja necessário recarregar o site Luma depois de abrir o Debugger)
Confirme se o Depurador está "Conectado ao Luma", como mostrado abaixo, e selecione o ícone "bloquear" para bloquear o Depurador no site Luma.
Selecione o botão Entrar na parte superior direita para autenticar.
Agora vá para Launch na navegação à esquerda
Selecione a guia Configuração
À direita do local onde ele mostra os Códigos incorporados de página, abra a lista suspensa Ações e selecione Substituir
Como você está autenticado, o Debugger extrairá suas propriedades e ambientes disponíveis do Launch. Selecione sua propriedade Luma Platform Tutorial
Selecione seu ambiente Development
Selecione o botão Aplicar
O site Luma recarregará agora com sua propriedade de marca. Socorro, fui hackeado! Brincadeira.
Vá para Resumo na navegação à esquerda para ver os detalhes da sua propriedade Inicialização
Agora vá para AEP Web SDK na navegação à esquerda para ver as Solicitações de rede
Abrir a linha eventos
Observe como podemos ver o tipo de evento web.webpagedetails.pageView que especificamos na ação Enviar Evento e outras variáveis prontas para uso que seguem o formato AEP Web SDK ExperienceEvent Mixin
Esses tipos de detalhes de solicitação também estão visíveis na guia Rede das ferramentas de desenvolvedor da Web do navegador. Abra-o e recarregue a página. Filtre chamadas com interact para localizar a chamada, selecioná-la e procurar na guia Cabeçalhos, área Carga da solicitação.
Vá para a guia Resposta e observe como o valor da ECID é incluído na resposta. Copie esse valor como você o usará para validar as informações do perfil no próximo exercício.

Validar os dados no Experience Platform

Você pode validar se os dados estão chegando na Platform observando os lotes de dados que chegam no Luma Web Events Dataset. (Eu sei, é chamada de assimilação de dados por transmissão, mas agora estou dizendo que chega em lotes!) Ele flui em tempo real para o Perfil, para que possa ser usado para segmentação e ativação em tempo real, mas é enviado em lotes a cada 15 minutos para o data lake.)

Para validar os dados:

Na interface do usuário da Platform, acesse Conjuntos de dados na navegação à esquerda
Abra o Luma Web Events Dataset e confirme se um lote chegou. Lembre-se de que elas são enviadas a cada 15 minutos, portanto, talvez seja necessário aguardar até que o lote seja exibido.
Selecione o botão Visualizar conjunto de dados
Na modal de visualização, observe como é possível selecionar diferentes campos do esquema à esquerda para visualizar esses pontos de dados específicos:

Você também pode confirmar que o novo perfil está aparecendo:

Na interface do usuário da Platform, vá para Perfis na navegação à esquerda
Selecione o namespace ECID e procure seu valor de ECID (copie-o da resposta. O perfil terá sua própria ID, separada da ECID.
Selecione a ID do Perfil para abrir o perfil
Selecione a guia Eventos para ver as páginas que você visualizou
\

Adicionar dados personalizados ao evento

Criar um elemento de dados para o nome da página

Na interface das marcas da Coleção de Dados, no canto superior direito da propriedade Luma Platform Tutorial, abra a lista suspensa Selecionar uma Biblioteca de Trabalho e selecione sua biblioteca Luma Platform Tutorial. Essa configuração facilita a publicação de atualizações adicionais na nossa biblioteca.
Agora vá para Elementos de dados na navegação à esquerda
Selecione o botão Criar novo elemento de dados
Como o Nome, digite Page Name
Como o Tipo de Elemento de Dados, selecione JavaScript Variable
Como o nome da variável do JavaScript, digite digitalData.page.pageInfo.pageName
Para ajudar a padronizar o formato dos valores, marque as caixas para Forçar valor de minúsculas e Limpar texto
Verifique se Luma Platform Tutorial está selecionado como a biblioteca de trabalho
Selecione Salvar na biblioteca

Mapear o nome da página para o elemento de dados Objeto XDM

Agora mapearemos nosso nome de página para o SDK da Web.

IMPORTANT

Para concluir essa tarefa, precisamos garantir que seu usuário primeiro tenha acesso à sandbox de produção. Se você ainda não tiver acesso à sandbox de Produção de um perfil de produto diferente, abra rapidamente seu perfil do Luma Tutorial Platform e adicione o item de permissão Sandboxes > Prod. Depois de fazer isso, faça um SHIFT-Reload na página Elementos de dados para limpar seu cache

Na página Elementos de Dados:

Criar um novo elemento de dados
Como o Nome, digite XDM Object
Como a Extensão, selecione Adobe Experience Platform Web SDK
Como o Tipo de Elemento de Dados, selecione XDM object
Como a Sandbox, selecione sua Luma Tutorial sandbox
Como o Esquema, selecione seu Luma Web Events Schema
Selecionar o campo web.webPageDetails.name
Como o Valor, selecione o ícone para abrir a modal de seleção de elemento de dados e escolha seu Page Name elemento de dados
Selecione Salvar na biblioteca

Esse mesmo processo é usado para mapear dados personalizados adicionais em seu site para campos XDM.

Adicionar os dados XDM à sua ação Enviar evento

Agora que você tem dados mapeados para campos XDM, é possível incluí-los na ação Enviar evento:

Vá para a tela Regras
Abra sua regra do All Pages - Library Loaded
Abrir a ação Adobe Experience Platform Web SDK - Send Event
Como os dados XDM, selecione o ícone para abrir a modal de seleção de elemento de dados e escolha seu XDM Object elemento de dados
Selecione o botão Manter alterações
Agora, como você selecionou o Luma Platform Tutorial como sua biblioteca de trabalho para os últimos exercícios, as alterações recentes foram salvas diretamente na biblioteca. Em vez de ter que publicar nossas alterações por meio da tela Fluxo de publicação, você pode abrir a lista suspensa no botão azul e selecionar Salvar na biblioteca e criar

Isso inicia a criação de uma nova biblioteca de tags com as três alterações que você acabou de fazer.

Validar os dados do XDM

Agora é possível recarregar a página inicial do Luma, enquanto mapeada para a propriedade da tag usando o Debugger, como você aprendeu anteriormente, e ver que o campo de nome da página é preenchido na solicitação.
Validar os dados XDM

Também é possível validar se os dados do nome da página foram recebidos na Platform, visualizando o conjunto de dados e o perfil.

Enviar identidades adicionais

Sua implementação do SDK da Web agora está enviando eventos com a ID de Experience Cloud (ECID) como o identificador principal. A ECID é gerada automaticamente pelo SDK da Web e é exclusiva por dispositivo e navegador. Um único cliente pode ter várias ECIDs, dependendo do dispositivo e do navegador que está usando. Então, como podemos obter uma visualização unificada desse cliente e vincular sua atividade online aos nossos dados de CRM, Fidelidade e Compra offline? Fazemos isso coletando identidades adicionais durante a sessão e vinculando determinicamente seu perfil por meio da compilação de identidade.

Lembrando que mencionei que usaríamos a ECID e a CRM Id como identidades para os dados da Web na lição Mapear identidades. Portanto, vamos coletar a ID do CRM com o SDK da Web.

Adicionar elemento de dados para a ID do CRM

Primeiro, armazenamos a ID do CRM em um elemento de dados:

Na interface das tags, adicione um elemento de dados chamado CRM Id
Como o Tipo de Elemento de Dados, selecione Variável JavaScript
Como o nome da variável do JavaScript, digite digitalData.user.0.profile.0.attributes.username
Selecione o botão Salvar na Biblioteca (Luma Platform Tutorial ainda deve ser sua biblioteca de trabalho)

Adicionar a ID do CRM ao elemento de dados do Mapa de identidade

Agora que capturamos o valor da ID do CRM, devemos associá-lo a um tipo de elemento de dados especial chamado de elemento de dados do Mapa de identidade:

Adicionar um elemento de dados chamado Identities
Como a Extensão, selecione o Adobe Experience Platform Web SDK
Como o Tipo de Elemento de Dados, selecione Mapa de identidade

Como o Namespace, digite Luma CRM Id, que é o namespace que criamos em uma lição anterior

note warning

note warning
WARNING
A extensão SDK da Web do Adobe Experience Platform versão 2.2 permite selecionar o Namespace em uma lista suspensa pré-preenchida usando os valores reais na conta da Platform. Infelizmente, esse recurso ainda não é "sensível à sandbox" e, portanto, o valor `Luma CRM Id` pode não aparecer na lista suspensa. Isso pode impedir que você conclua este exercício. Publicaremos uma solução alternativa depois de confirmada.

WARNING

A extensão SDK da Web do Adobe Experience Platform versão 2.2 permite selecionar o Namespace em uma lista suspensa pré-preenchida usando os valores reais na conta da Platform. Infelizmente, esse recurso ainda não é "sensível à sandbox" e, portanto, o valor Luma CRM Id pode não aparecer na lista suspensa. Isso pode impedir que você conclua este exercício. Publicaremos uma solução alternativa depois de confirmada.

Como a ID, selecione o ícone para abrir a modal de seleção de elemento de dados e escolha seu elemento de dados CRM Id
Como o Estado autenticado, selecione Autenticado
Deixe Primário desmarcado. Como a ID do CRM não está presente para a maioria dos visitantes do site Luma, você definitivamente não deseja substituir a ECID como o identificador principal. Seria um caso de uso raro usar qualquer coisa diferente da ECID como o identificador principal. Geralmente, não menciono as configurações padrão nessas instruções, mas estou chamando esta para ajudar você a evitar dores de cabeça posteriormente em sua própria implementação do.
Selecione o botão Salvar na Biblioteca (Luma Platform Tutorial ainda deve ser sua biblioteca de trabalho)

NOTE

Você pode passar vários identificadores usando o tipo de dados Mapa de identidade.

Adicionar o elemento de dados do Mapa de identidade ao Objeto XDM

Há mais um elemento de dados que deve ser atualizado: o elemento de dados Objeto XDM. Pode parecer estranho ter que atualizar três elementos de dados separados para transmitir essa identidade, mas esse processo foi projetado para ser dimensionado para várias identidades. Não se preocupe, estamos quase terminando esta lição!

Abra o elemento de dados Objeto XDM
Abrir o campo XDM do IdentityMap
Como o Elemento de dados, selecione o ícone para abrir a modal de seleção de elemento de dados e escolha seu Identities elemento de dados
Agora, como você selecionou o Luma Platform Tutorial como sua biblioteca de trabalho para os últimos exercícios, as alterações recentes foram salvas diretamente na biblioteca. Em vez de precisar publicar suas alterações por meio da tela Fluxo de publicação, você pode abrir a lista suspensa no botão azul e selecionar Salvar na biblioteca e criar

Validar a identidade

Para validar se a ID do CRM agora está sendo enviada pelo SDK da Web:

Abra o site da Luma
Mapeie-o para a propriedade de tag usando o Depurador, de acordo com as instruções anteriores
Selecione o link Logon na parte superior direita do site Luma
Fazer logon usando as credenciais test@adobe.com/test
Depois de autenticado, inspecione a chamada do SDK da Web do Experience Platform no Depurador (SDK da Web da Adobe Experience Platform > Solicitações de Rede > eventos da solicitação mais recente) e você deverá ver o lumaCrmId:
Procure o perfil de usuário usando o namespace e o valor da ECID novamente. No perfil, você verá a ID do CRM e também a ID de fidelidade, além dos detalhes do perfil, como o nome e o número de telefone. Todas as identidades e dados foram compilados em um único perfil do cliente em tempo real!

Recursos adicionais

Excelente trabalho! Havia muitas informações sobre o SDK da Web e o Launch. Há muito mais envolvido em uma implementação completa, mas essas são as noções básicas para ajudar você a começar e ver os resultados na Platform.

NOTE

Agora que você concluiu a lição Assimilação de streaming, pode remover a sandbox Prod do seu perfil de produto Luma Tutorial Platform

Engenheiros de dados, se desejar, podem pular para a lição executar consultas.

Arquitetos de dados, você pode seguir para políticas de mesclagem!

recommendation-more-help

513160b6-bf42-4c58-abdd-4f817b1cccad