Configurar um fluxo de dados para uma conexão de comércio eletrônico na interface do usuário

Um fluxo de dados é uma tarefa agendada que recupera e assimila dados de uma fonte para um conjunto de dados Platform. Este tutorial fornece etapas para configurar um novo fluxo de dados usando sua conta eCommerce.

Introdução

Este tutorial requer uma compreensão funcional dos seguintes componentes do Adobe Experience Platform:

  • Experience Data Model (XDM) Sistema: A estrutura padronizada pela qual Experience Platform organiza os dados de experiência do cliente.
    • Noções básicas da composição do schema: Saiba mais sobre os elementos básicos dos esquemas XDM, incluindo princípios-chave e práticas recomendadas na composição do schema.
    • Tutorial do Editor de esquema: Saiba como criar esquemas personalizados usando a interface do Editor de esquemas.
  • Real-time Customer Profile: Fornece um perfil de consumidor unificado e em tempo real com base em dados agregados de várias fontes.

Além disso, este tutorial requer que você já tenha criado uma conta eCommerce. Uma lista de tutoriais para criar diferentes conectores eCommerce na interface do usuário pode ser encontrada na visão geral dos conectores de origem.

Selecionar dados

Depois de criar sua conta eCommerce, a etapa Selecionar dados é exibida, fornecendo uma interface interativa para explorar sua hierarquia de arquivos.

  • A metade esquerda da interface é um navegador de diretório, que exibe os arquivos e diretórios do seu servidor.
  • A metade direita da interface permite visualizar até 100 linhas de dados de um arquivo compatível.

Você pode usar a opção Pesquisar na parte superior da página para identificar rapidamente os dados de origem que pretende usar.

OBSERVAÇÃO

A opção de dados de origem da pesquisa está disponível para todos os conectores de origem baseados em tabelas, excluindo os conectores Analytics, Classificações, Hubs de eventos e Kinesis.

Depois de encontrar os dados de origem, selecione o diretório e selecione Next.

select-data

Mapear campos de dados para um esquema XDM

A etapa Mapeamento é exibida, fornecendo uma interface interativa para mapear os dados de origem para um conjunto de dados Platform.

Escolha um conjunto de dados para os dados de entrada que serão assimilados. Você pode usar um conjunto de dados existente ou criar um novo conjunto de dados.

Usar um conjunto de dados existente

Para assimilar dados em um conjunto de dados existente, selecione Usar conjunto de dados existente e clique no ícone do conjunto de dados.

conjunto de dados use-existing

A caixa de diálogo Selecionar conjunto de dados é exibida. Encontre o conjunto de dados que deseja usar, selecione-o e clique em Continuar.

select-existing-dataset

Usar um novo conjunto de dados

Para assimilar dados em um novo conjunto de dados, selecione Create new dataset e insira um nome e uma descrição para o conjunto de dados nos campos fornecidos.

Você pode anexar um campo de esquema inserindo um nome de esquema na barra de pesquisa Select schema. Você também pode selecionar o ícone suspenso para ver uma lista de schemas existentes. Como alternativa, você pode selecionar Pesquisa avançada para acessar a tela de esquemas existentes, incluindo seus respectivos detalhes.

Durante essa etapa, você pode ativar seu conjunto de dados para Real-time Customer Profile e criar uma exibição holística dos atributos e comportamentos de uma entidade. Os dados de todos os conjuntos de dados ativados serão incluídos em Profile e as alterações serão aplicadas quando você salvar o fluxo de dados.

Alterne o botão Conjunto de dados de perfil para ativar seu conjunto de dados de destino para Profile.

create-new-dataset

A caixa de diálogo Selecionar esquema é exibida. Selecione o esquema que deseja aplicar ao novo conjunto de dados e clique em Concluído.

select-schema

Com base em suas necessidades, você pode optar por mapear campos diretamente ou usar funções de preparação de dados para transformar dados de origem em valores calculados ou calculados. Para obter mais informações sobre funções do mapeador e campos calculados, consulte o Guia de funções de Preparação de Dados ou o guia de campos calculados.

DICA

Platform fornece recomendações inteligentes para campos mapeados automaticamente com base no esquema de destino ou conjunto de dados selecionado. Você pode ajustar manualmente as regras de mapeamento de acordo com seus casos de uso.

Selecione Preview data para ver os resultados de mapeamento de até 100 linhas de dados de amostra do conjunto de dados selecionado.

Durante a visualização, a coluna de identidade é priorizada como o primeiro campo, pois são as informações principais necessárias ao validar resultados de mapeamento.

Depois que os dados de origem forem mapeados, selecione Fechar.

Agendar execução de ingestão

A etapa Scheduling é exibida, permitindo configurar um agendamento de assimilação para assimilar automaticamente os dados de origem selecionados usando os mapeamentos configurados. A tabela a seguir descreve os diferentes campos configuráveis para programação:

Campo Descrição
Frequência As frequências selecionáveis incluem Once, Minute, Hour, Day e Week.
Intervalo Um número inteiro que define o intervalo para a frequência selecionada.
Hora de início Um carimbo de data e hora UTC indicando quando a primeira assimilação está definida para ocorrer.
Preenchimento retroativo Um valor booleano que determina quais dados são assimilados inicialmente. Se Backfill estiver ativado, todos os arquivos atuais no caminho especificado serão assimilados durante a primeira assimilação agendada. Se Backfill estiver desativado, somente os arquivos carregados entre a primeira execução de assimilação e a hora de início serão assimilados. Os arquivos carregados antes da hora de início não serão assimilados.
Coluna Delta Uma opção com um conjunto filtrado de campos do schema de origem do tipo, data ou hora. Esse campo é usado para diferenciar dados novos e existentes. Os dados incrementais serão assimilados com base no carimbo de data e hora da coluna selecionada.

Os fluxos de dados são projetados para assimilar dados automaticamente de forma programada. Comece selecionando a frequência de assimilação. Em seguida, defina o intervalo para designar o período entre duas execuções de fluxo. O valor do intervalo deve ser um número inteiro diferente de zero e deve ser definido como maior ou igual a 15.

Para definir a hora de início da assimilação, ajuste a data e a hora exibidas na caixa de hora de início. Como alternativa, você pode selecionar o ícone de calendário para editar o valor de hora de início. A hora de início deve ser maior ou igual à hora UTC atual.

Selecione Load incremental data by para atribuir a coluna delta. Este campo estabelece uma distinção entre dados novos e dados existentes.

Configurar um fluxo de dados de ingestão único

Para configurar a assimilação única, selecione a seta suspensa de frequência e selecione Once.

DICA

​ Intervale ​​Backfilter não é visível durante uma ingestão única.

Depois de fornecer os valores apropriados ao agendamento, selecione Next.

Fornecer detalhes do fluxo de dados

A etapa Detalhes do fluxo de dados é exibida, permitindo nomear e fornecer uma breve descrição sobre o novo fluxo de dados.

Durante esse processo, você também pode ativar Assimilação parcial e Diagnóstico de erro. Habilitar Assimilação parcial fornece a capacidade de assimilar dados contendo erros até um determinado limite. Depois que Assimilação parcial estiver ativado, arraste a marcação Error threshold % para ajustar o limite de erro do lote. Como alternativa, você pode ajustar manualmente o limite selecionando a caixa de entrada. Para obter mais informações, consulte a visão geral da ingestão parcial de lote.

Forneça valores para o fluxo de dados e selecione Next.

detalhes do fluxo de dados

Revisar o fluxo de dados

A etapa Revisar é exibida, permitindo que você revise o novo fluxo de dados antes de ele ser criado. Os detalhes são agrupados nas seguintes categorias:

  • Conexão: Mostra o tipo de origem, o caminho relevante do arquivo de origem escolhido e a quantidade de colunas dentro desse arquivo de origem.
  • Atribuir conjunto de dados e mapear campos: Mostra em qual conjunto de dados os dados de origem estão sendo assimilados, incluindo o esquema ao qual o conjunto de dados adere.
  • Agendamento: Mostra o período ativo, a frequência e o intervalo do agendamento de ingestão.

Depois de revisar o fluxo de dados, clique em Finish e aguarde algum tempo para que o fluxo de dados seja criado.

revisão

Monitorar o fluxo de dados

Depois que o fluxo de dados for criado, você poderá monitorar os dados que estão sendo assimilados por meio dele para ver informações sobre taxas de ingestão, sucesso e erros. Para obter mais informações sobre como monitorar o fluxo de dados, consulte o tutorial em monitorando contas e fluxos de dados na interface do usuário.

Excluir seu fluxo de dados

Você pode excluir fluxos de dados que não são mais necessários ou foram criados incorretamente usando a função Delete disponível no espaço de trabalho Fluxos de dados. Para obter mais informações sobre como excluir fluxos de dados, consulte o tutorial em excluir fluxos de dados na interface do usuário.

Próximas etapas

Ao seguir este tutorial, você criou com êxito um fluxo de dados para trazer dados eCommerce e ganhou informações sobre o monitoramento de conjuntos de dados. Os dados recebidos agora podem ser usados por serviços Platform downstream, como Real-time Customer Profile e Data Science Workspace. Consulte os seguintes documentos para obter mais detalhes:

Nesta página