Assimilar dados de transmissão

Última atualização em 2023-09-25
  • Criado para:
  • Beginner
    Intermediate
    Developer

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 de borda para onde encaminhar os dados. Vamos configurá-los para enviar os dados para nossa Luma Web Events conjunto de dados na sandbox da Platform.

Engenheiros de dados O precisará 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:

OBSERVAÇÃO

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, Apache Kafka Connecte outros mecanismos.

Permissões necessárias

No 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 o sequência de dados:

  1. Faça logon na Interface do usuário da Coleta de dados do Experience Platform

  2. Selecionar Datastreams na navegação à esquerda

  3. Selecione o Nova sequência de dados no canto superior direito

    Selecionar sequências de dados na navegação à esquerda

  4. Para o Nome amigável, insira Luma Platform Tutorial (adicione seu nome ao final se várias pessoas da sua empresa estiverem fazendo este tutorial)

  5. Selecione o botão Salvar

    Nomear o datastam e salvar

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

  1. Ativar/desativar Adobe Experience Platform para expor campos adicionais
  2. Para Sandbox, selecione Luma Tutorial
  3. Para Conjunto de dados do evento, selecione Luma Web Events Dataset
  4. 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 de borda 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 de borda é usada para especificar os detalhes da conta de cada aplicativo para o qual você deseja enviar os dados.
  5. Selecione Salvar
    Configure o fluxo de dados e salve

Depois que a configuração de borda 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 de borda 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 todos os 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:

  1. Ir para Propriedades na navegação à esquerda
  2. Selecione o botão Nova propriedade
    Adicionar uma nova propriedade
  3. Como a variável Nome, insira Luma Platform Tutorial (adicione seu nome ao final se várias pessoas da sua empresa estiverem fazendo este tutorial)
  4. Como a variável Domínios, insira enablementadobe.com (explicado posteriormente)
  5. Selecione Salvar
    Detalhes da propriedade

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:

  1. Abra a propriedade da tag
  2. Ir para Extensões na navegação à esquerda
  3. Vá para a Catálogo guia
  4. Há muitas extensões disponíveis para tags. Filtrar o catálogo com o termo Web SDK
  5. No Adobe Experience Platform Web SDK , selecione a Instalar botão
    Instalar a extensão SDK da Web do Adobe Experience Platform
  6. 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 de borda 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 na enablementadobe.com domínio à propriedade da tag. O CNAME para o enablementadobe.com o domínio já foi configurado para que data.enablementadobe.com encaminhará 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
  7. No Sequência de dados selecione o Luma Platform Tutorial sequência de dados.
  8. 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:

  1. Ir para Regras na navegação à esquerda
  2. Selecione o Criar nova regra botão
    Criar uma regra
  3. Atribua um nome à regra All Pages - Library Loaded
  4. Em Eventos, selecione o Adicionar botão
    Nomear a regra e adicionar um evento
  5. Use o Núcleo Extensão 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.
  6. Selecionar Manter alterações para retornar à tela principal da regra
    Adicionar o evento Biblioteca carregada
  7. Sair Condições vazio, já que queremos que essa regra seja acionada em todas as páginas, de acordo com o nome que demos a ela
  8. Em Ações, selecione o Adicionar botão
  9. Use o Adobe Experience Platform Web SDK Extensão e selecione Enviar evento como o Tipo de ação
  10. À direita, selecione web.webpagedetails.pageViews do Tipo lista suspensa. Este é um dos campos XDM em nossa Luma Web Events Schema
  11. Selecionar Manter alterações para retornar à tela principal da regra
    Adicionar a ação Enviar evento
  12. Selecionar Salvar para salvar a regra
    Salvar a regra

Publicar a 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:

  1. Ir para Fluxo de publicação na navegação à esquerda
  2. Selecionar Adicionar biblioteca
    Selecione Adicionar biblioteca
  3. Para o Nome, insira Luma Platform Tutorial
  4. Para o Ambiente, selecione Development
  5. Selecione o Adicionar todos os recursos alterados botão. (Para além do Adobe Experience Platform Web SDK e a extensão All Pages - Library Loaded regra, você também verá a variável Núcleo extensão adicionada que contém o JavaScript básico exigido por todas as propriedades da Web do Launch.)
  6. Selecione o Salvar e criar para desenvolvimento botão
    Criar a biblioteca

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 no 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:

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:

  1. Em uma nova guia do navegador, abra Site Luma.
  2. Marque a página para uso no restante do tutorial

Este site hospedado é o motivo pelo qual usamos enablementadobe.com no Domínios campo da configuração inicial da propriedade de tag e por que usamos data.enablementadobe.com como nosso domínio próprio no Adobe Experience Platform Web SDK extensão. 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.

  1. Verifique se o site Luma está aberto e selecione o ícone da extensão do Experience Platform Debugger

  2. 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)

  3. Confirme se o Debugger é "Conectado ao Luma" como mostrado abaixo e selecione o "bloquear" para bloquear o Debugger no site Luma.

  4. Selecione o Conectar no canto superior direito para autenticação.

  5. Agora vá para Launch na navegação à esquerda

  6. Selecione a guia Configuração

  7. À direita de onde ele mostra a Códigos incorporados de página, abra o Ações e selecione Substituir
    Selecione Ações > Substituir

  8. Como você está autenticado, o Debugger extrairá suas propriedades e ambientes disponíveis do Launch. Selecione o Luma Platform Tutorial propriedade

  9. Selecione o Development ambiente

  10. Selecione o Aplicar botão
    Selecionar a propriedade de tag alternativa

  11. O site Luma será recarregado agora com a propriedade da tag. Socorro, fui hackeado! Brincadeira.
    propriedade de tag substituída

  12. Ir para Resumo na navegação à esquerda, para ver os detalhes do Launch propriedade
    Guia Resumo

  13. Agora vá para AEP Web SDK na navegação à esquerda para ver o Solicitações de rede

  14. Abra o events linha

    Solicitação do SDK da Web do Adobe Experience Platform

  15. Observe como podemos ver a web.webpagedetails.pageView tipo de evento que especificamos em Enviar evento e outras variáveis prontas para uso que seguem a AEP Web SDK ExperienceEvent Mixin formato
    Detalhes do evento

  16. Esses tipos de detalhes da solicitação também estão visíveis nas ferramentas do desenvolvedor da Web do navegador Rede guia. Abra-o e recarregue a página. Filtrar chamadas com interact para localizar a chamada, selecione-a e procure no Cabeçalhos guia, Carga da solicitação área.
    Guia Rede

  17. Vá para a Resposta e observe como o valor ECID é incluído na resposta. Copie esse valor como você o usará para validar as informações do perfil no próximo exercício.
    Guia Rede

Validar os dados no Experience Platform

Você pode validar se os dados estão chegando à Platform, observando os lotes de dados que chegam na 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:

  1. Na interface do usuário da Platform, acesse Conjuntos de dados na navegação à esquerda
  2. 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.
  3. Selecione o Visualizar conjunto de dados botão
    Abra o conjunto de dados
  4. Na modal de visualização, observe como é possível selecionar diferentes campos do esquema à esquerda para visualizar esses pontos de dados específicos:
    Visualizar os campos

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

  1. Na interface do usuário da Platform, acesse Perfis na navegação à esquerda
  2. Selecione o ECID e procure seu valor ECID (copie-o da resposta de. O perfil terá sua própria ID, separada da ECID.
  3. Selecione o ID do perfil para abrir o perfil
    Localizar e abrir o perfil
  4. Selecione o Eventos para ver as páginas exibidas
    Eventos de perfil\

Adicionar dados personalizados ao evento

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

  1. Na interface das tags da Coleção de dados, no canto superior direito do Luma Platform Tutorial propriedade, abra a variável Selecionar uma biblioteca de trabalho e selecione seu Luma Platform Tutorial biblioteca. Essa configuração facilita a publicação de atualizações adicionais na nossa biblioteca.

  2. Agora vá para Elementos de dados na navegação à esquerda

  3. Selecione o Criar novo elemento de dados botão

    Crie um novo elemento de dados

  4. Como a variável Nome, insira Page Name

  5. Como a variável Tipo de elemento de dados, selecione JavaScript Variable

  6. Como a variável Nome da variável JavaScript, insira digitalData.page.pageInfo.pageName

  7. Para ajudar a padronizar o formato dos valores, marque as caixas de seleção Forçar valor de minúsculas e Texto limpo

  8. Verifique se Luma Platform Tutorial está selecionada como a biblioteca de trabalho

  9. Selecionar Salvar na biblioteca
    Criar um elemento de dados para o nome da página

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.

IMPORTANTE

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 o Luma Tutorial Platform perfil e adicionar 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
Adicionar a sandbox de produção

No Elementos de dados página:

  1. Crie um novo elemento de dados
  2. Como a variável Nome, insira XDM Object
  3. Como a variável Extensão, selecione Adobe Experience Platform Web SDK
  4. Como a variável Tipo de elemento de dados, selecione XDM object
  5. Como a variável Sandbox, selecione o Luma Tutorial sandbox
  6. Como a variável Esquema, selecione o Luma Web Events Schema
  7. Selecione o web.webPageDetails.name campo
  8. Como a variável Valor, selecione o ícone para abrir a modal de seleção de elemento de dados e escolha o Page Name elemento de dados
  9. Selecionar Salvar na biblioteca
    Mapear o nome da página para o elemento de dados Objeto XDM

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:

  1. Vá para a Regras tela
  2. Abra o All Pages - Library Loaded regra
  3. Abra o Adobe Experience Platform Web SDK - Send Event ação
  4. Como a variável Dados XDM, selecione o ícone para abrir a modal de seleção de elemento de dados e escolha o XDM Object elemento de dados
  5. Selecione o Manter alterações botão
    Adicionar os dados XDM à sua ação Enviar evento
  6. Agora, já que você teve Luma Platform Tutorial selecionado como sua biblioteca de trabalho para os últimos exercícios, as alterações recentes foram salvas diretamente na biblioteca. Em vez de precisar publicar as alterações por meio da tela Fluxo de publicação, abra a lista suspensa no botão azul e selecione Salvar na biblioteca e criar
    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 do 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-se, mencionei que usaríamos a ECID e a CRM Id como identidades para nossos dados da Web na Mapear identidades lição. 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:

  1. Na interface das tags, adicione um elemento de dados chamado CRM Id
  2. Como a variável Tipo de elemento de dados, selecione Variável JavaScript
  3. Como a variável Nome da variável JavaScript, insira digitalData.user.0.profile.0.attributes.username
  4. Selecione o Salvar na biblioteca botão (Luma Platform Tutorial ainda deve ser sua biblioteca de trabalho)
    Adicionar elemento de dados para a ID do CRM

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 elemento de dados especial chamado de Mapa de identidade elemento de dados:

  1. Adicione um elemento de dados chamado Identities

  2. Como a variável Extensão, selecione Adobe Experience Platform Web SDK

  3. Como a variável Tipo de elemento de dados, selecione Mapa de identidade

  4. Como a variável Namespace, insira Luma CRM Id, que é a namespace criamos em uma lição anterior

    AVISO

    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, a 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.

  5. Como a variável ID, selecione o ícone para abrir a modal de seleção de elemento de dados e escolha o CRM Id elemento de dados

  6. Como a variável Estado autenticado, selecione Autenticado

  7. Sair Principal 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.

  8. Selecione o Salvar na biblioteca botão (Luma Platform Tutorial ainda deve ser sua biblioteca de trabalho)
    Adicionar a ID do CRM ao elemento de dados do Mapa de identidade

OBSERVAÇÃO

É possível transmitir vários identificadores usando o Mapa de identidade tipo de dados.

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!

  1. Abra o elemento de dados Objeto XDM
  2. Abrir o campo XDM do IdentityMap
  3. Como a variável Elemento de dados, selecione o ícone para abrir a modal de seleção de elemento de dados e escolha o Identities elemento de dados
  4. Agora, já que você teve Luma Platform Tutorial selecionado como sua biblioteca de trabalho para os últimos exercícios, as alterações recentes foram salvas diretamente na biblioteca. Em vez de precisar publicar as alterações por meio da tela Fluxo de publicação, abra a lista suspensa no botão azul e selecione Salvar na biblioteca e criar
    Adicionar o elemento de dados IdentityMap ao objeto XDM

Validar a identidade

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

  1. Abra o Site Luma
  2. Mapeie-o para a propriedade de tag usando o Depurador, de acordo com as instruções anteriores
  3. Selecione o Logon link na parte superior direita do site Luma
  4. Fazer logon usando as credenciais test@adobe.com/test
  5. Depois de autenticado, inspecione a chamada do SDK da Web do Experience Platform no Debugger (Adobe Experience Platform Web SDK > Solicitações de rede > events da solicitação mais recente) e você deverá ver a lumaCrmId:
    Validar a identidade no Debugger
  6. 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!
    Validar a identidade na Platform

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.

OBSERVAÇÃO

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

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

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

Nesta página