DocumentaçãoExperience PlatformTutorial do SDK da web

Transmitir dados para o Experience Platform com o SDK da Web

Last update: Sat Jun 01 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • undefined
  • undefined
  • undefined

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.

Diagrama do SDK da Web 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 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. A conjunto de dados é uma construção de armazenamento e gerenciamento para uma coleção de dados, normalmente 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 Experience Platform ou Journey Optimizer interface

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

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

  4. Selecionar Criar conjunto de dados

    Criar esquema

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

    Criar conjunto de dados a partir do esquema

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

    Conjunto de dados, selecionar esquema

  7. Forneça um Nome e opcional Descrição para o conjunto de dados. Para este exercício, use Luma Web Event Datae 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 suas sequência de dados para enviar dados ao 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. Abra o Coleta de dados interface

  2. Selecionar Datastreams na navegação à esquerda

  3. Abra o fluxo de dados criado na Configurar um fluxo de dados lição, Luma Web SDK

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

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

  5. Selecionar Adobe Experience Platform como o Serviço

  6. Selecionar 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 tráfego no Site de demonstração da Luma mapeados para a propriedade da 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 o Visualizar conjunto de dados
  • Validar usando o Serviço de consulta

Experience Platform Debugger

Essas etapas são mais ou menos as mesmas do que você fez na Lição do Debugger. 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 Experience Platform Debugger ícone de extensão

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

    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 Debugger

  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 Debugger

Agora, os dados devem ser preenchidos na variável Luma Web Event Data e pronto 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 Visualizar conjunto de dados recurso. 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. No Experience Platform , selecione Gerenciamento de dados > Conjuntos de dados no painel de navegação esquerdo para abrir a Conjuntos de dados painel.

    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 o Luma Web Event Data conjunto de dados para abrir seu Atividade do conjunto de dados tela.

    Evento da 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. No 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 1 do conjunto de dados

Consultar os dados

  1. No Experience Platform , selecione Gerenciamento de dados > Consultas no painel de navegação esquerdo para abrir a Consultas tela.
  2. Selecionar Criar consulta
  3. Primeiro, execute uma consulta para ver todos os nomes das tabelas no data lake. Enter SHOW TABLES no editor de consultas e clique no ícone play 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 à 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 Tutoriais da plataforma.

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 o Alternar perfil para ativá-lo

    Alternar perfil

  3. Confirme se deseja Ativar o conjunto de dados

    Ativar/desativar perfil

Para ativar o esquema:

  1. Abra o esquema criado, Luma Web Event Data

  2. Selecione o Alternar perfil para ativá-lo

    Alternar perfil

  3. Selecionar Os dados deste esquema conterão uma identidade principal 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 Ativar

    Ativar/desativar perfil

  5. Selecionar 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. Inspect A solicitação do SDK da Web da Platform para garantir que envie dados com o lumaCRMId.

  1. No Experience Platform , selecione Cliente > Perfis no painel de navegação esquerdo

  2. Como a variável Namespace de identidade use lumaCRMId

  3. Copie e cole o valor de lumaCRMId transmitido na chamada que você inspecionou no Depurador Experience Platform, neste caso 112ca06ed53d3db37e4cea49cc45b71e.

    Perfil

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

    Perfil

  5. Para visualizar o Perfil do cliente para cada ID, selecione o 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. Escolher Perfil individual como o classe base

  3. Nomeie o esquema Luma Loyalty Schema

  4. Adicione o Detalhes de fidelidade grupo de campos

  5. Adicione o Detalhes demográficos grupo de campos

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

  7. Ativar 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 pela Luma Loyalty Schema

  2. Nomeie o conjunto de dados Luma Loyalty Dataset

  3. Ativar 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. Selecionar Criar público

  3. Selecionar Criar regra

  4. Selecionar Criar

    Criar um público-alvo

  5. Selecionar Atributos

  6. Localize o Fidelidade > Nível e arraste-o para a Atributos seção

  7. Definir o público-alvo como usuários cujos tier é gold

  8. Nomear o público Luma Loyalty Rewards – Gold Status

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

  10. Selecionar Salvar

    Definir o público

Como esse é um público-alvo muito simples, podemos usar o método de avaliação Edge. Os públicos-alvo da borda avaliam a borda, 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 feedback geral ou tiver sugestões sobre conteúdo futuro, compartilhe-as nesta Publicação de discussão da comunidade do Experience League
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4