Transmitir dados para o Experience Platform com o Web SDK

Saiba como transmitir dados da web para a Adobe Experience Platform com o SDK da web da Platform.

O Experience Platform é a espinha dorsal de todos os novos aplicativos da Experience Cloud, como o Adobe Real-Time Customer Data Platform, o Adobe Customer Journey Analytics e o Adobe Journey Optimizer. Esses aplicativos foram projetados para usar o Platform Web SDK como o método ideal de coleta de dados da Web.

Diagrama do Web SDK e Adobe Experience Platform

O Experience Platform usa o mesmo esquema XDM criado anteriormente para capturar dados do evento do site da Luma. Quando esses dados são enviados para a Platform Edge Network, a configuração da sequência de dados pode encaminhá-los para a Experience Platform.

Objetivos de aprendizagem

No final desta lição, você poderá:

  • Criar um conjunto de dados na Adobe Experience Platform
  • Configurar a sequência de dados para enviar dados do Web SDK para o Adobe Experience Platform
  • Ativar transmissão de dados da Web para o Perfil do cliente em tempo real
  • Validar se os dados chegaram ao conjunto de dados da Plataforma e ao Perfil do cliente em tempo real
  • Assimilar dados de amostra do programa de fidelidade na Platform
  • Criar um público-alvo simples da Platform

Pré-requisitos

Para concluir esta lição, primeiro você deve:

  • Ter acesso a um aplicativo do Adobe Experience Platform, como Real-Time Customer Data Platform, Journey Optimizer ou Customer Journey Analytics
  • Conclua as lições anteriores nas seções Configuração inicial e Configuração de tags deste tutorial.
NOTE
Se você não tiver aplicativos da Platform, ignore esta lição ou leia tudo.

Criar um conjunto de dados

Todos os dados assimilados com sucesso na Adobe Experience Platform são mantidos no data lake como conjuntos de dados. Um conjunto de dados é uma construção de armazenamento e gerenciamento para uma coleção de dados, geralmente uma tabela que contém um esquema (colunas) e campos (linhas). Os conjuntos de dados também contêm metadados que descrevem vários aspectos dos dados armazenados.

Vamos configurar um conjunto de dados para seus dados de evento da Web do Luma:

  1. Ir para a interface Experience Platform ou Journey Optimizer

  2. Confirme que você está na sandbox de desenvolvimento que está usando para este tutorial

  3. Abra Gerenciamento de dados > Conjuntos de dados na navegação à esquerda

  4. Selecione Criar conjunto de dados

    Criar esquema

  5. Selecione a opção Criar conjunto de dados do esquema

    Criar conjunto de dados a partir do esquema

  6. Selecione o esquema Luma Web Event Data criado na lição anterior e selecione Próximo

    Conjunto de dados, selecionar esquema

  7. Forneça um Nome e uma Descrição opcional para o conjunto de dados. Neste exercício, use Luma Web Event Data e selecione Concluir

    Nome do Conjunto de Dados

Um conjunto de dados agora está configurado para começar a coletar dados da implementação do Platform Web SDK.

Configurar o fluxo de dados

Agora você pode configurar sua sequência de dados para enviar dados para a Adobe Experience Platform. A sequência de dados é o link entre a propriedade da tag, a Platform Edge Network e o conjunto de dados da Experience Platform.

  1. Abrir a interface de Coleção de Dados

  2. Selecione Datastreams na navegação à esquerda

  3. Abra a sequência de dados criada na lição Configurar uma sequência de dados, Luma Web SDK: Development Environment

    Selecione a sequência de dados do Luma Web SDK

  4. Selecione Adicionar Serviço
    Adicionar um serviço à sequência de dados

  5. Selecione Adobe Experience Platform como o Serviço

  6. Selecionar Habilitado

  7. Selecione Luma Web Event Data como o Conjunto de Dados do Evento

  8. Selecione Salvar

    Configuração da sequência de dados

À medida que você gera tráfego no site de demonstração Luma mapeado para a propriedade da sua tag, os dados preenchem o conjunto de dados na Experience Platform.

Validar o conjunto de dados

Essa etapa é crítica para garantir que os dados tenham chegado ao conjunto de dados. Há várias maneiras de validar o caminho dos dados enviados para o conjunto de dados.

  • Validar usando o Experience Platform Debugger
  • Validar usando o Experience Platform Assurance
  • Validar usando Visualizar Conjunto de Dados
  • Validar usando o Serviço de consulta

Debugger

Estas etapas são mais ou menos as mesmas que você fez na Lição de depuração. No entanto, como os dados só serão enviados para a Platform depois de ativá-los na sequência de dados, você deve gerar mais alguns dados de amostra:

  1. Abra o site de demonstração do Luma e selecione o ícone de extensão do Experience Platform Debugger

  2. Configure o Depurador para mapear a propriedade da tag para o seu ambiente de desenvolvimento, conforme descrito na lição Validar com o Depurador

    Sua ID da Organização mostrada no Depurador

  3. Navegue pelo site. Exibir alguns produtos e adicionar alguns ao carrinho de compras

  4. No Debugger, abra a linha "eventos" para procurar algumas das variáveis XDM

Você validou que os dados saíram do navegador e foram enviados para o fluxo de dados!

Assurance

Como agora ativamos um serviço no fluxo de dados, há mais informações que podemos ver no Assurance:

  1. Abra sua sessão do Assurance ou inicie uma nova

  2. Abrir o evento datastream

  3. Aqui você pode visualizar a configuração do serviço da Platform, incluindo a ID da sequência de dados criada anteriormente nesta lição.

    configuração de sequência de dados para a plataforma no Assurance

  4. Abra o evento genérico pertencente ao fornecedor com.adobe.streaming.validation. Isso mostra que a solicitação foi enviada para o conjunto de dados com os dados XDM que a acompanham

    Validação no Assurance

Você validou que a solicitação foi recebida pelo Platform Edge Network e encaminhada para o conjunto de dados da Platform.

Visualizar o conjunto de dados

Agora, vamos realmente olhar no conjunto de dados! Uma opção rápida é usar o recurso Visualizar conjunto de dados. Os dados do Web SDK são microprocessados no data lake e atualizados periodicamente na interface da Platform. Pode levar de 10 a 15 minutos para ver os dados gerados.

  1. Na interface do Experience Platform, selecione Gerenciamento de Dados > Conjuntos de Dados na navegação à esquerda para abrir o painel Conjuntos de Dados.

    O painel lista todos os conjuntos de dados disponíveis para sua organização. Os detalhes são exibidos para cada conjunto de dados listado, incluindo seu nome, o esquema ao qual o conjunto de dados adere e o status da execução de ingestão mais recente.

  2. Selecione seu conjunto de dados Luma Web Event Data para abrir sua tela Atividade do conjunto de dados.

    Evento Web Luma do Conjunto de Dados

    A tela de atividade inclui um gráfico que visualiza a taxa de mensagens que estão sendo consumidas, bem como uma lista de lotes bem-sucedidos e com falha.

  3. Como esse é um novo conjunto de dados, se você vir até mesmo um lote com registros assimilados, isso é um sinal positivo:

  4. Na tela Atividade do conjunto de dados, selecione Visualizar conjunto de dados próximo ao canto superior direito da tela para visualizar até 100 linhas de dados. Se o conjunto de dados estiver vazio, o link de visualização será desativado.

    Visualização do conjunto de dados

  5. Uma consulta será executada para obter 100 linhas de dados recentes do conjunto de dados. Você pode detalhar campos XDM individuais, como web.webPageDetails.name:

    Visualização do conjunto de dados

Consultar os dados

Você pode executar queries personalizados nos dados para validar a assimilação de dados:

  1. Na interface do Experience Platform, selecione Gerenciamento de Dados > Consultas na navegação à esquerda para abrir a tela Consultas.

  2. Selecionar Criar consulta

  3. Primeiro, execute uma consulta para ver todos os nomes das tabelas no data lake. Insira SHOW TABLES no editor de consultas e clique no ícone reproduzir para executar a consulta.

  4. Nos resultados, observe como o nome da tabela é luma_web_event_data

  5. Agora consulte a tabela com uma consulta simples que faz referência à sua tabela (observe que, por padrão, a consulta será limitada a 100 resultados): SELECT * FROM "luma_web_event_data"

  6. Após alguns minutos, você deverá ver registros de amostra dos seus dados da Web.

    Consulta do conjunto de dados

ERROR
Se você receber um erro "Tabela não provisionada", verifique novamente o nome da tabela. Também pode ser que o microlote de dados ainda não tenha caído no data lake. Tente novamente em 10-15 minutos.
INFO
O serviço de query é uma ferramenta muito eficiente para engenheiros de dados e analistas. Para obter mais detalhes sobre o serviço de consulta da Adobe Experience Platform, consulte Explorar dados na seção de tutoriais da Platform.
NOTE
Obrigado por investir seu tempo aprendendo sobre o Adobe Experience Platform Web SDK. Se você tiver dúvidas, quiser compartilhar comentários gerais ou tiver sugestões sobre conteúdo futuro, compartilhe-as nesta postagem de discussão da Comunidade Experience League
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4