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. Vamos configurá-lo para enviar os dados para nosso conjunto de dados Luma Web Events em nossa sandbox da Platform.

Os engenheiros de dados precisarão 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 tenha como foco a assimilação de streaming de sites com SDK da Web, você também pode fazer stream de dados usando o Adobe Mobile SDK, 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, 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 seu datastream:

  1. Faça logon na interface do usuário Experience Platform Data Collection

  2. Selecione Datastreams no painel de navegação esquerdo

  3. Selecione o botão New Datastream no canto superior direito

    Selecionar datastreams na navegação à esquerda

  4. Para o Friendly Name, digite Luma Platform Tutorial (adicione seu nome ao final, se várias pessoas de sua empresa estiverem recebendo este tutorial)

  5. Selecione o botão Save

    Nomeie o datastram e salve

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

  1. Ative Adobe Experience Platform para expor campos adicionais

  2. Para Sandbox, selecione Luma Tutorial

  3. Para Conjunto de Dados de Eventos, 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. Vá para Properties no painel de navegação esquerdo

  2. Selecione o botão Nova propriedade
    Adicionar uma nova propriedade

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

  4. Como Domínios, digite 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. Vá para Extensões no painel de navegação esquerdo
  3. Vá para a guia Catalog
  4. Há muitas extensões disponíveis para tags. Filtre o catálogo com o termo Web SDK
  5. Na extensão Adobe Experience Platform Web SDK, selecione o botão Instalar
    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 no domínio enablementadobe.com para sua propriedade de tag. O CNAME para o domínio enablementadobe.com já foi configurado para que data.enablementadobe.com seja encaminhado para servidores 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. Na lista suspensa Datastream , selecione o conjunto de dados Luma Platform Tutorial.
  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. Vá para Rules no painel de navegação esquerdo
  2. Selecione o botão Criar nova regra
    Criar uma regra
  3. Atribua um nome à regra All Pages - Library Loaded
  4. Em Eventos, selecione o botão Adicionar
    Nomear a regra e adicionar um evento
  5. Use o Core Extension e selecione Library Loaded (Page Top) como o Event Type. Essa configuração significa que nossa regra é acionada sempre que a biblioteca do Launch é carregada em uma página.
  6. Selecione Manter alterações para retornar à tela de regra principal
    Adicionar o evento Biblioteca carregada
  7. Deixe Conditions vazia, já que queremos que esta regra seja acionada em todas as páginas, de acordo com o nome que a demos
  8. Em Actions, selecione o botão Add
  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 na lista suspensa Type. Este é um dos campos XDM em Luma Web Events Schema
  11. Selecione Manter alterações para retornar à tela de regra principal
    Adicionar a ação Enviar evento
  12. Selecione 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. Vá para Fluxo de publicação no painel de navegação esquerdo
  2. Selecione Adicionar biblioteca
    Selecione Adicionar biblioteca
  3. Para o Nome, digite Luma Platform Tutorial
  4. Para o Ambiente, selecione Development
  5. 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 o JavaScript base exigido por todas as propriedades da Web do Launch.)
  6. Selecione o botão Salvar e criar para desenvolvimento
    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 na tela Fluxo de publicação, há muito mais no processo de publicaçã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

Esse site hospedado é o motivo pelo qual usamos enablementadobe.com no campo Domínios da configuração inicial da propriedade de tag e o motivo pelo qual usamos data.enablementadobe.com como nosso domínio próprio na extensão Adobe Experience Platform Web SDK. 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 é "Connected to Luma", conforme mostrado abaixo, e selecione o ícone "lock" para bloquear o Debugger no site Luma.

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

  5. Agora vá para Launch no painel de navegação esquerdo

  6. Selecione a guia Configuração

  7. À direita de onde ele mostra os Códigos de inserção de página, abra a lista suspensa 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 sua propriedade Luma Platform Tutorial

  9. Selecione seu ambiente Development

  10. Selecione o botão Aplicar
    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. Vá para Summary no painel de navegação esquerdo para ver os detalhes da propriedade Launch
    Guia Resumo

  13. Agora vá para AEP Web SDK no painel de navegação esquerdo para ver as Solicitações de rede

  14. Abra a linha events

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

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

  16. Esses tipos de detalhes da solicitação também são visíveis na guia Ferramentas do desenvolvedor da Web do navegador Rede. Abra-o e recarregue a página. Filtre as chamadas com interact para localizar a chamada, selecione-a e, em seguida, procure na guia Headers, na área Solicitar carga.
    Guia Rede

  17. Vá para a guia Response 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 na 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 Plataforma, vá para Datasets no painel de navegação esquerdo
  2. Abra o Luma Web Events Dataset e confirme se 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 botão Visualizar conjunto de dados
    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 Plataforma, vá para Profiles no painel de navegação esquerdo
  2. Selecione o namespace ECID e pesquise seu valor 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 a guia Events para ver as páginas visualizadas
    Eventos de perfil

Adicionar dados personalizados ao evento

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

  1. Na interface de tags da Coleta 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 biblioteca.

  2. Agora vá para Elementos de dados no painel de navegação esquerdo

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

    Criar um novo elemento de dados

  4. Como Nome, digite Page Name

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

  6. Como o nome da variável JavaScript, digite digitalData.page.pageInfo.pageName

  7. Para ajudar a padronizar o formato dos valores, marque as caixas Forçar valor em minúsculas e Limpar texto

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

  9. Selecione 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 perfil Luma Tutorial Platform e adicione 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

Na página Elementos de dados:

  1. Criar um novo elemento de dados

  2. Como Nome, digite XDM Object

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

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

  5. Como o Sandbox, selecione sua sandbox Luma Tutorial

  6. Como Schema, selecione Luma Web Events Schema

  7. Selecione o campo web.webPageDetails.name

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

  9. Selecione 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 a tela Rules
  2. Abra sua regra All Pages - Library Loaded
  3. Abra a ação Adobe Experience Platform Web SDK - Send Event
  4. Como o XDM data, selecione o ícone para abrir a modal de seleção do elemento de dados e escolha seu elemento de dados XDM Object
  5. Selecione o botão Manter alterações
    Adicionar os dados XDM à ação Enviar evento
  6. Agora, como você selecionou Luma Platform Tutorial como biblioteca de trabalho para os últimos vários 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 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 lição Mapear identidades. 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 o nome da variável JavaScript, digite digitalData.user.0.profile.0.attributes.username
  4. Selecione o botão Salvar na biblioteca (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 elemento de dados Mapa de identidade :

  1. Adicione um elemento de dados chamado Identities

  2. Como Extension, selecione Adobe Experience Platform Web SDK

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

  4. Como o Namespace, digite Luma CRM Id, que é o namespace que 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 é "compatível com sandbox" e, portanto, o valor 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 o ID, selecione o ícone para abrir a modal de seleção do elemento de dados e escolha seu elemento de dados CRM Id

  6. Como o Estado autenticado, selecione Autenticado

  7. 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 raro usar qualquer coisa diferente da ECID como o identificador principal. Normalmente, 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 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

OBSERVAÇÃO

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 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 o Elemento de dados, selecione o ícone para abrir a modal de seleção do elemento de dados e escolha seu elemento de dados Identities
  4. Agora, como você selecionou Luma Platform Tutorial como biblioteca de trabalho para os últimos vários 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 link Login na parte superior direita 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 Depurador (Adobe Experience Platform Web SDK > Solicitações de Rede > eventos da solicitação mais recente) e você deverá ver o 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 terminou a lição de Assimilação de fluxo, você pode remover a sandbox Prod do perfil de produto Luma Tutorial Platform

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

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

Nesta página