DocumentaçãoExperience PlatformTutorial do SDK da web

Transmitir dados para o Experience Platform com o SDK da Web

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

Criado para:

  • Iniciante
  • Intermediário
  • Desenvolvedor

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

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

SDK da Web e diagrama do 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 o Edge Network da plataforma, a configuração do fluxo de dados pode encaminhá-los para o 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 SDK da Web para a 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. Vá 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 SDK da Web da Platform.

Configurar o fluxo de dados

Agora você pode configurar sua sequência de dados para enviar dados para a Adobe Experience Platform. O fluxo de dados é o link entre a propriedade da tag, o Edge Network da plataforma e o conjunto de dados 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

    Selecione a sequência de dados do SDK da Web Luma

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

  5. Selecione Adobe Experience Platform como o Serviço

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

  7. Selecione Salvar.

    Configuração da sequência de dados

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

Validar o conjunto de dados

Essa etapa é crítica para garantir que os dados tenham chegado ao conjunto de dados. Há dois aspectos da validação dos dados enviados para o conjunto de dados.

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

Experience Platform 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 Luma e selecione o ícone de extensão Depurador do Experience Platform

  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

    Seu ambiente de desenvolvimento do Launch mostrado no Debugger

  3. Faça logon no site Luma usando as credenciais test@adobe.com/test

  4. Retorne à página inicial do Luma

  5. Nos beacons de rede do SDK da Web da Platform mostrados pelo depurador, selecione a linha "eventos" para expandir os detalhes em uma janela pop-up

    SDK da Web no Depurador

  6. Procure o "identityMap" na janela pop-up. Aqui você deve ver lumaCrmId com três chaves de authenticatedState, id e primary
    SDK da Web no Depurador

Agora, os dados devem ser preenchidos no conjunto de dados Luma Web Event Data e estar prontos para a validação "Visualizar conjunto de dados".

Visualizar o conjunto de dados

Para confirmar que os dados chegaram ao data lake da Platform, uma opção rápida é usar o recurso Visualizar conjunto de dados. Os dados do SDK da Web são armazenados em microlote 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 Experience Platform, selecione Gerenciamento de Dados > Conjuntos de Dados no menu de navegação esquerdo 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. 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

    Na janela de pré-visualização, a visualização hierárquica do esquema do conjunto de dados é mostrada à direita.

    Visualização do conjunto de dados 1

Consultar os dados

  1. Na interface Experience Platform, selecione Gerenciamento de Dados > Consultas no menu de navegação esquerdo 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 é algo como 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.
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
Para obter mais detalhes sobre o serviço de consulta da Adobe Experience Platform, consulte Explorar dados na seção de tutoriais da Platform.

Ativar o conjunto de dados e o esquema para o Perfil do cliente em tempo real

Para clientes do Real-time Customer Data Platform e do Journey Optimizer, a próxima etapa é ativar o conjunto de dados e o esquema para o Perfil do cliente em tempo real. A transmissão de dados do SDK da Web será uma das muitas fontes de dados que fluem para a Platform e você deseja unir seus dados da Web a outras fontes de dados para criar perfis de clientes de 360 graus. Para saber mais sobre o Perfil do cliente em tempo real, assista a este vídeo curto:

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

CAUTION
Ao trabalhar com seu próprio site e dados, recomendamos uma validação mais robusta dos dados antes de habilitá-los para o Perfil do cliente em tempo real.

Para habilitar o conjunto de dados:

  1. Abra o conjunto de dados criado, Luma Web Event Data

  2. Selecione a Alternância de Perfil para ativá-la

    Alternância de perfil

  3. Confirme se deseja Habilitar o conjunto de dados

    Alternância de Habilitação de Perfil

Para habilitar o esquema:

  1. Abrir o esquema criado, Luma Web Event Data

  2. Selecione a Alternância de Perfil para ativá-la

    Alternância de perfil

  3. Selecione Os dados deste esquema conterão uma identidade primária no campo identityMap.

    note important
    IMPORTANT
    As identidades primárias são necessárias em todos os registros enviados ao Perfil do cliente em tempo real. Normalmente, os campos de identidade são rotulados no esquema. No entanto, ao usar mapas de identidade, os campos de identidade não ficam visíveis no esquema. Essa caixa de diálogo é para confirmar que você tem uma identidade primária em mente e que você a especificará em um mapa de identidade ao enviar seus dados. Como você sabe, o SDK da Web usa um mapa de identidade com a ID de Experience Cloud (ECID) como a identidade principal padrão e uma ID autenticada como a identidade principal, quando disponível.

  4. Selecionar Habilitar

    Alternância de Habilitação de Perfil

  5. Selecione Salvar para salvar o esquema atualizado

Agora, o esquema também é ativado para o perfil.

IMPORTANT
Depois que um esquema é ativado para Perfil, ele não pode ser desativado ou excluído sem redefinir ou excluir toda a sandbox. Além disso, os campos não podem ser removidos do esquema após esse ponto.
Ao trabalhar com seus próprios dados, recomendamos que você faça as coisas na seguinte ordem:
  • Primeiro, assimile alguns dados em seus conjuntos de dados.
  • Resolva quaisquer problemas que surjam durante o processo de assimilação de dados (por exemplo, problemas de validação ou mapeamento de dados).
  • Ativar seus conjuntos de dados e esquemas para o Perfil
  • Assimilar novamente os dados, se necessário

Validar um perfil

Você pode procurar um perfil do cliente na interface da Platform (ou na interface da Journey Optimizer) para confirmar se os dados chegaram ao Perfil do cliente em tempo real. Como o nome sugere, os perfis são preenchidos em tempo real, de modo que não há atraso como houve com a validação de dados no conjunto de dados.

Primeiro, você deve gerar mais dados de amostra. Repita as etapas das etapas anteriores nesta lição para fazer logon no site da Luma quando ele for mapeado para a propriedade de tag. A Inspect recebeu a solicitação do SDK da Web da Platform para garantir que ela envie dados com o lumaCRMId.

  1. Na interface Experience Platform, selecione Cliente > Perfis no menu de navegação esquerdo

  2. Como o Namespace de identidade usa lumaCRMId

  3. Copie e cole o valor do lumaCRMId transmitido na chamada inspecionada no Depurador Experience Platform, neste caso 112ca06ed53d3db37e4cea49cc45b71e.

    Perfil

  4. Se houver um valor válido no Perfil para lumaCRMId, uma ID de Perfil será preenchida no console:

    Perfil

  5. Para exibir o Perfil do Cliente completo para cada ID, selecione a ID do Perfil na janela principal.

    note note
    NOTE
    Observação: é possível selecionar o hiperlink da ID do perfil ou, se você selecionar a linha, um menu direito será aberto e você poderá selecionar o hiperlink da ID do perfil
    Perfil do cliente

    Aqui você pode ver todas as identidades vinculadas ao lumaCRMId, como o ECID.

    Perfil do cliente

Agora você ativou o SDK da Web da plataforma para Experience Platform (E Real-Time CDP! E o Journey Optimizer! E Customer Journey Analytics!).

Criar um esquema de fidelidade e assimilar dados de amostra

A conclusão deste exercício é esperada para clientes do Real-time Customer Data Platform e do Journey Optimizer.

Quando os dados do SDK da Web são assimilados na Adobe Experience Platform, eles podem ser enriquecidos por outras fontes de dados assimiladas na Platform. Por exemplo, quando um usuário faz logon no site Luma, um gráfico de identidade é construído no Experience Platform e todos os outros conjuntos de dados habilitados para perfis podem ser unidos para criar Perfis de clientes em tempo real. Para ver isso em ação, crie rapidamente outro conjunto de dados no Adobe Experience Platform com alguns dados de fidelidade de exemplo, para que você possa usar os Perfis de clientes em tempo real com o Real-time Customer Data Platform e o Journey Optimizer. Como você já fez exercícios semelhantes, as instruções serão breves.

Crie o esquema de fidelidade:

  1. Criar um novo esquema

  2. Escolha Perfil Individual como a classe base

  3. Nomeie o esquema Luma Loyalty Schema

  4. Adicionar o grupo de campos Detalhes de fidelidade

  5. Adicionar o grupo de campos Detalhes demográficos

  6. Selecione o campo Person ID e marque-o como uma Identidade e Identidade principal usando o Luma CRM Id Namespace de identidade.

  7. Habilite o esquema para Perfil. Se não conseguir encontrar o botão de alternância Perfil, tente clicar no nome do esquema no canto superior esquerdo.

  8. Salvar o esquema

    Esquema de fidelidade

Para criar o conjunto de dados e assimilar os dados de amostra:

  1. Crie um novo conjunto de dados a partir do Luma Loyalty Schema

  2. Nomeie o conjunto de dados Luma Loyalty Dataset

  3. Habilitar o conjunto de dados para Perfil

  4. Baixe o arquivo de amostra luma-fidelization-forWeb.json

  5. Arraste e solte o arquivo no seu conjunto de dados

  6. Confirme se os dados foram assimilados com êxito

    Esquema de fidelidade

Criar um público-alvo

Os públicos-alvo agrupam perfis em torno de características comuns. Crie um público-alvo rápido que você pode usar em sua campanha da Web:

  1. Na interface do Experience Platform ou Journey Optimizer, vá para Cliente > Públicos-alvo na navegação à esquerda

  2. Selecione Criar público-alvo

  3. Selecionar Regra de compilação

  4. Selecionar Criar

    Criar um público-alvo

  5. Selecionar Atributos

  6. Localize o campo Fidelidade > Camada e arraste-o para a seção Atributos

  7. Defina a audiência como usuários cujo tier é gold

  8. Nomear a audiência Luma Loyalty Rewards – Gold Status

  9. Selecione Edge como o Método de avaliação

  10. Selecione Salvar

    Definir o público-alvo

Como esse é um público-alvo muito simples, podemos usar o método de avaliação do Edge. Os públicos-alvo da Edge avaliam na borda do, portanto, na mesma solicitação feita pelo SDK da Web para o Platform Edge Network, podemos avaliar a definição do público-alvo e confirmar imediatamente se o usuário se qualificará.

Próximo:

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