Criar uma conexão de transmissão usando a interface do usuário

Este tutorial fornece etapas para criar uma conexão de origem de transmissão usando o espaço de trabalho Sources.

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.

Criar uma conexão de transmissão

Na interface do usuário da plataforma, selecione Sources na navegação à esquerda para acessar o espaço de trabalho Sources. A tela Catalog exibe uma variedade de fontes com as quais você pode criar uma conta.

Você pode selecionar a categoria apropriada no catálogo no lado esquerdo da tela. Como alternativa, você pode encontrar a fonte específica com a qual deseja trabalhar usando a opção de pesquisa.

Na categoria Streaming, selecione HTTP API e selecione Add data.

catálogo

A página Connect HTTP API account é exibida. Nesta página, você pode usar novas credenciais ou credenciais existentes.

Conta existente

Para usar uma conta existente, selecione a conta da API HTTP com a qual deseja criar um novo fluxo de dados e selecione Next para prosseguir.

conta existente

Nova conta

Se estiver criando uma nova conta, selecione New account. No formulário de entrada exibido, forneça um nome de conta e uma descrição opcional. Você também terá a opção de fornecer as seguintes propriedades de configuração:

  • Authentication: essa propriedade determina se a conexão de transmissão requer autenticação. A autenticação garante que os dados sejam coletados de fontes confiáveis. Se você estiver lidando com Informações pessoais identificáveis (PII), essa propriedade deve ser ativada. Por padrão, essa propriedade está desativada.
  • XDM compatible: essa propriedade indica se essa conexão de transmissão enviará eventos compatíveis com esquemas XDM. Por padrão, essa propriedade está desativada.

Quando terminar, selecione Connect to source e selecione Next para continuar.

nova conta

Selecionar dados

Depois de criar a conexão da API HTTP, a etapa Select data é exibida, fornecendo uma interface para carregar e visualizar seus dados.

Selecione Upload files para carregar seus dados. Como alternativa, você pode arrastar e soltar seus dados na seção Drag and drop files da interface.

add-data

Com os dados carregados, você pode usar o lado direito da interface para visualizar a hierarquia do arquivo. Selecione Next para continuar.

preview-sample-data

Mapear campos de dados para um esquema XDM

A etapa Mapping é exibida, fornecendo uma interface para mapear os dados de origem para um conjunto de dados da plataforma.

Os arquivos de parâmetro devem ser compatíveis com XDM e não exigem a configuração manual do mapeamento, enquanto os arquivos CSV exigem a configuração explícita do mapeamento, mas permitem que você escolha os campos de dados de origem a serem mapeados. Os arquivos JSON, se marcados como reclamação XDM, não exigem configuração manual. No entanto, se não estiver marcado como compatível com XDM, será necessário configurar explicitamente o mapeamento.

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.

Criar um novo conjunto de dados

Para criar um novo conjunto de dados, selecione New dataset. No formulário exibido, forneça o nome, uma descrição opcional e o esquema de destino do conjunto de dados. Se você selecionar um esquema habilitado para Profile, poderá escolher se o conjunto de dados também deve estar habilitado para Profile.

novo conjunto de dados

Usar um conjunto de dados existente

Para usar um conjunto de dados existente, selecione Existing dataset. No formulário exibido, selecione o conjunto de dados que deseja usar. Depois de selecionar um conjunto de dados, você pode escolher se o conjunto de dados deve estar Profile habilitado.

conjunto de dados existente

Mapear campos padrão

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 mapeamento de dados e funções de mapeador, consulte o tutorial em mapear dados CSV para campos de esquema XDM.

Para adicionar um novo campo de origem, selecione Add new mapping.

add-new-mapping

Um novo campo de origem e o emparelhamento de campo de destino são exibidos. Para adicionar um novo campo de origem, selecione o ícone de seta ao lado da barra de entrada Select source field.

select-source-field

O painel Select attributes permite explorar sua hierarquia de arquivos e selecionar um campo de origem específico para mapear para um campo XDM de destino. Depois de selecionar o campo de origem que deseja mapear, selecione Select para continuar.

select-attributes

Com um campo de origem selecionado, agora é possível identificar o campo XDM de destino apropriado para o qual mapear. Selecione o ícone de schema na seção target field .

select-target-field

A janela Map source field to target field é exibida, fornecendo uma interface para explorar o esquema do conjunto de dados de destino. Selecione o campo de destino que corresponde ao campo de origem e selecione Select para prosseguir.

campo mapear para destino

Depois que os campos de origem forem mapeados para os campos XDM de destino apropriados, selecione Next

data-prep-complete

Detalhes do fluxo de dados

A etapa Dataflow detail é exibida. Nesta página, você pode fornecer detalhes para o fluxo de dados criado, fornecendo um nome e uma descrição opcional.

Depois de fornecer os detalhes do fluxo de dados, selecione Next.

detalhe do fluxo de dados

Revisão

A etapa Review é exibida, permitindo que você revise os detalhes do fluxo de dados antes de criá-lo. Os detalhes são agrupados nas seguintes categorias:

  • Connection: Mostra o nome da conta, a plataforma de origem e o nome de origem.
  • Assign dataset and map fields: Mostra o conjunto de dados de destino e o esquema ao qual o conjunto de dados adere.

Depois de confirmar que os detalhes estão corretos, selecione Finish.

revisão

Obter URL de ponto de extremidade de fluxo

Com a conexão criada, a página de detalhes das fontes é exibida. Esta página mostra detalhes da conexão recém-criada, incluindo fluxos de dados executados anteriormente, ID e URL do endpoint de transmissão.

endpoint

Próximas etapas

Ao seguir este tutorial, você criou uma conexão HTTP de transmissão, permitindo usar o endpoint de transmissão para acessar uma variedade de Data Ingestion APIs. Para obter instruções para criar uma conexão de transmissão na API, leia o tutorial de conexão de transmissão.

Para saber como transmitir dados para a Platform, leia o tutorial em dados da série de tempo de transmissão ou o tutorial em dados de registro de transmissão.

Nesta página