Assimilar dados de fluxo

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

Há duas tarefas principais que devem ser concluídas na interface da Coleta de dados:

  • Precisamos implementar o SDK da Web no site Luma para enviar dados sobre a atividade do visitante do site para a rede do Adobe Edge. Faremos uma implementação simples usando tags (antigo Launch)

  • Precisamos configurar um armazenamento de dados, que informa à rede do Edge onde encaminhar os dados. Configuraremos para enviar os dados para nosso Luma Web Events conjunto de dados na sandbox da Platform.

Engenheiros de dados precisará assimilar dados de transmissão fora deste tutorial. Ao implementar SDKs da Web ou móveis 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 de streaming e o SDK da Web:

OBSERVAÇÃO

Embora este tutorial se centre na assimilação de streaming de sites com SDK da Web, você também pode fazer stream de dados usando a variável Adobe Mobile SDK, Conexão Apache Kafkae outros mecanismos.

Permissões necessárias

No Configurar permissões lição, configure todos os controles de acesso necessários para concluir esta lição.

Configurar o fluxo de dados

Primeiro, vamos configurar o armazenamento de dados. Um armazenamento de dados informa à rede da Adobe Edge para onde enviar os dados depois de recebê-los da chamada do SDK da Web. Por exemplo, você deseja enviar os dados para o Experience Platform, Adobe Analytics ou Adobe Target? Os conjuntos de dados são gerenciados na interface do usuário da Coleta de dados (antigo Launch) e são essenciais para a coleta de dados com o SDK da Web.

Para criar datastream:

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

  2. Selecionar Datastreams na navegação à esquerda

  3. Selecione o Novo fluxo de dados no canto superior direito

    Selecionar datastreams na navegação à esquerda

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

  5. Selecione o Salvar botão

    Nomeie o datastram e salve

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

  1. Ativar 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ê usar outros aplicativos Adobe, fique à vontade para explorar as outras seções e ver quais informações são necessárias na Edge Configuration dessas outras soluções. Lembre-se, o SDK da Web foi desenvolvido não apenas para transmitir dados no Experience Platform, mas também para substituir todas as bibliotecas JavaScript anteriores usadas por outros aplicativos do Adobe. A Edge Configuration é usada para especificar os detalhes da conta de cada aplicativo para o qual você deseja enviar os dados.

  5. Selecione Salvar

    Configure o armazenamento de dados e salve

Depois que a Configuração de borda for salva, a tela resultante mostrará três ambientes foram criados para Desenvolvimento, Armazenamento temporário e Produção. Outros ambientes de desenvolvimento 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 forma diferente por ambiente. Por exemplo, cada ambiente pode enviar dados para uma sandbox de plataforma diferente. Neste tutorial, não faremos nenhuma personalização adicional em nosso armazenamento de dados.

Instalar a extensão Web SDK

Adicionar uma propriedade

Primeiro, devemos criar uma propriedade de tag (anteriormente uma propriedade de tag). Uma propriedade é um contêiner de todos os recursos 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 Nova propriedade botão
    Adicionar uma nova propriedade

  3. Como Nome, insira Luma Platform Tutorial (adicione seu nome ao final, se várias pessoas de sua empresa estiverem recebendo este tutorial)

  4. Como Domínios, insira enablementadobe.com (explicado mais tarde)

  5. Selecione Salvar

    Detalhes da propriedade

Adicionar a extensão Web SDK

Agora que você tem uma propriedade, pode adicionar o SDK da Web usando uma extensão . Uma extensão é um pacote de código que estende a interface e a funcionalidade da Coleta de dados. Para adicionar a extensão:

  1. Abra sua propriedade de tag
  2. Ir para Extensões na navegação à esquerda
  3. Vá para o 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 Adobe Experience Platform Web SDK
  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 próprios com a implementação do SDK da Web, o que é recomendável. Posteriormente nesta lição, você mapeará um site na enablementadobe.com à propriedade da tag. O CNAME do enablementadobe.com domínio já foi configurado para que data.enablementadobe.com O encaminhará para os servidores do Adobe. Ao implementar o SDK da Web em seu próprio site, será necessário criar um CNAME para suas próprias finalidades de coleta de dados, por exemplo, data.YOUR_DOMAIN.com
  7. No Datastream selecione sua Luma Platform Tutorial datastream.
  8. Fique à vontade para ver as outras opções de configuração (mas não as altere!) e depois 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 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 de regra principal
    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 a demos
  8. Em Ações, selecione o Adicionar botão
  9. Use o Adobe Experience Platform Web SDK Extensão e selecione Enviar evento como 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 de regra principal
    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 no ambiente de desenvolvimento para que possamos verificar se 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. (Além do Adobe Experience Platform Web SDK e a All Pages - Library Loaded , você também verá a variável Núcleo adição da extensão , que contém o JavaScript base exigido por todas as propriedades da Web do Launch.)
  6. Selecione o Salvar e criar para desenvolvimento botão
    Criar e criar a biblioteca

A biblioteca pode levar alguns minutos para ser criada e, quando estiver concluída, exibe um ponto verde à esquerda do nome da biblioteca:
Build concluída

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

Validar os dados na solicitação

Adicionar o Adobe Experience Platform Debugger

O Experience Platform Debugger é uma extensão disponível para navegadores Chrome e Firefox, que ajuda a visualizar a tecnologia Adobe implementada em suas páginas da Web. Baixe a versão do seu navegador preferido:

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

Abra o site do Luma

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

  1. Em uma nova guia do navegador, abra o Site Luma.
  2. Marque a página como favorito para uso no resto 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 Experience Platform Debugger para mapear para a propriedade da tag

O Experience Platform Debugger 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. Certifique-se de ter o site Luma aberto e selecione o ícone de 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 após abrir o Debugger)

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

  4. Selecione o Fazer logon na parte superior direita para autenticar.

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

  6. Selecione a guia Configuração

  7. À direita de onde ele mostra o Códigos de inserção da página, abra o Ações e selecione Substituir

    Selecione Ações > Substituir

  8. Como você é autenticado, o Debugger obterá as propriedades e os ambientes disponíveis do Launch. Selecione seu Luma Platform Tutorial propriedade

  9. Selecione seu Development ambiente

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

  11. O site Luma agora será recarregado com sua propriedade de tag. Ajuda, fui hackeado! Só brincando.
    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 row

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

  15. Observe como podemos ver a variável web.webpagedetails.pageView tipo de evento que especificamos em Enviar evento e outras variáveis prontas para uso que seguem o AEP Web SDK ExperienceEvent Mixin format
    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, em seguida, procure no Cabeçalhos guia , Solicitar carga área.
    Guia Rede

  17. Vá para o 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 no Platform, observando os lotes de dados que chegam no Luma Web Events Dataset. (Eu sei, é chamado de assimilação de dados de transmissão, mas agora estou dizendo que chega em lotes! Ele é transmitido em tempo real para o Perfil, para que possa ser usado para a segmentação e ativação em tempo real, mas é enviado em lotes a cada 15 minutos para o lago de dados.)

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 confirmar que um lote chegou. Lembre-se de que eles são enviados a cada 15 minutos; portanto, talvez seja necessário aguardar a exibição do lote.
  3. Selecione o Visualizar conjunto de dados botão
    Abra o conjunto de dados
  4. No 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á sendo exibido:

  1. Na interface do usuário da Platform, acesse Perfis na navegação à esquerda
  2. Selecione o ECID namespace e pesquise pelo valor da ECID (copie-o da resposta. O perfil terá sua própria ID, separada da ECID.
  3. Selecione o ID do perfil para abrir o perfil
    Encontrar e abrir o perfil
  4. Selecione o Eventos para ver as páginas que você visualizou
    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 Coleta de dados , no canto superior direito da Luma Platform Tutorial , abra o Selecionar uma biblioteca de trabalho e selecione seu Luma Platform Tutorial biblioteca. Essa configuração facilita a publicação de atualizações adicionais na biblioteca.

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

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

    Criar um novo elemento de dados

  4. Como Nome, insira Page Name

  5. Como Tipo de elemento de dados, selecione JavaScript Variable

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

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

  8. Certifique-se de que Luma Platform Tutorial é selecionado como a biblioteca de trabalho

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

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

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

IMPORTANTE

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

No Elementos de dados página:

  1. Criar um novo elemento de dados

  2. Como Nome, insira XDM Object

  3. Como Extensão, selecione Adobe Experience Platform Web SDK

  4. Como Tipo de elemento de dados, selecione XDM object

  5. Como Sandbox, selecione o Luma Tutorial sandbox

  6. Como Esquema, selecione o Luma Web Events Schema

  7. Selecione o web.webPageDetails.name campo

  8. Como Valor, selecione o ícone para abrir o modal de seleção do elemento de dados e escolha Page Name elemento de dados

  9. Selecionar Salvar na biblioteca

    Mapeie 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 à ação Enviar evento

Agora que possui dados mapeados para campos XDM, você pode incluí-los na ação Enviar evento:

  1. Vá para o Regras tela
  2. Abra seu All Pages - Library Loaded regra
  3. Abra o Adobe Experience Platform Web SDK - Send Event ação
  4. Como Dados XDM, selecione o ícone para abrir o modal de seleção do elemento de dados e escolha XDM Object elemento de dados
  5. Selecione o Manter alterações botão
    Adicionar os dados XDM à ação Enviar evento
  6. Agora, desde que você teve Luma Platform Tutorial selecionadas como a biblioteca de trabalho dos ú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 , você pode abrir a lista suspensa no botão azul e selecionar 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 XDM

Agora é possível recarregar a página inicial do Luma, enquanto está mapeada para a propriedade de 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 Experience Cloud ID (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 estiver usando. Então, como podemos obter uma visã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 deterministicamente seu perfil por meio da identificação.

Se você se lembrar, eu mencionei que estaríamos usando a ECID e a CRM Id como identidades de nossos dados da Web na Mapear identidades lição. Então 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 Tipo de elemento de dados, selecione Variável JavaScript
  3. Como 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á-la a um tipo de elemento de dados especial chamado Mapa de identidade elemento de dados:

  1. Adicionar um elemento de dados chamado Identities

  2. Como Extensão, selecione Adobe Experience Platform Web SDK

  3. Como Tipo de elemento de dados, selecione Mapa de identidade

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

    AVISO

    A extensão Adobe Experience Platform Web SDK versão 2.2 permite selecionar Namespace a partir de uma lista suspensa pré-preenchida usando os valores reais na sua conta da plataforma. Infelizmente, esse recurso ainda não é "sensível a sandbox" e, portanto, a variável Luma CRM Id pode não aparecer na lista suspensa. Isto pode impedir que conclua este exercício. Depois de confirmado, publicaremos uma solução alternativa.

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

  6. Como Estado autenticado, selecione Autenticado

  7. Sair 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 raro usar qualquer coisa diferente da ECID como o identificador principal. Geralmente, não menciono as configurações padrão nessas instruções, mas chamo essa para ajudar você a evitar dores de cabeça mais tarde em sua própria implementação.

  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

Você pode passar vários identificadores usando a variável 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 devemos atualizar: o elemento de dados Objeto XDM. Pode parecer estranho ter que atualizar três elementos de dados separados para transmitir essa única identidade, mas esse processo foi projetado para dimensionar para várias identidades. Não se preocupe, estamos quase terminando com esta lição!

  1. Abra o elemento de dados do Objeto XDM
  2. Abra o campo XDM do IdentityMap
  3. Como Elemento de dados, selecione o ícone para abrir o modal de seleção do elemento de dados e escolha Identities elemento de dados
  4. Agora, desde que você teve Luma Platform Tutorial selecionadas como a biblioteca de trabalho dos ú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 , você pode abrir a lista suspensa no botão azul e selecionar 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 para a propriedade da tag usando o Debugger, de acordo com as instruções anteriores
  3. Selecione o Logon link no canto superior direito do site Luma
  4. Faça 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ê deve ver a variável lumaCrmId:
    Validar a identidade no Debugger
  6. Procure o perfil do 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, bem como os detalhes do perfil, como o nome e o número de telefone. Todas as identidades e dados foram unidos em um único perfil de cliente em tempo real!
    Validar a identidade na Platform

Recursos adicionais

Excelente trabalho! Essas eram muitas informações sobre o SDK da Web e o Launch. Há muito mais envolvido em uma implementação completa, mas esses são os conceitos básicos para ajudá-lo a começar e ver os resultados na Platform.

OBSERVAÇÃO

Agora que você terminou a lição de Assimilação de fluxo, é possível remover a variável Prod sandbox da sua Luma Tutorial Platform perfil de produto

Engenheiros de dados, se você quiser, pule para a lição executar consultas.

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

Nesta página