Criar uma conexão de streaming HTTP API usando a interface

Este tutorial fornece etapas para a criação de uma conexão de origem de streaming usando o espaço de trabalho Fontes.

Introdução

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

Criar uma conexão de streaming

Na interface da Platform, selecione Fontes na navegação à esquerda para acessar o espaço de trabalho Fontes. A tela Catálogo 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 API HTTP e Adicionar dados.

catálogo

A página Conectar conta da API HTTP é exibida. Nesta página, você pode usar credenciais novas ou 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 Avançar para continuar.

conta-existente

Nova conta

Se você estiver criando uma nova conta, selecione Nova conta. No formulário de entrada que aparece, 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:

  • Autenticação: Essa propriedade determina se a conexão de streaming requer ou não autenticação. A autenticação garante que os dados sejam coletados de fontes confiáveis. Se você estiver lidando com Informações de identificação pessoal (PII), essa propriedade deve ser ativada. Por padrão, essa propriedade está desativada.
  • Compatível com XDM: essa propriedade indica se essa conexão de streaming enviará eventos compatíveis com esquemas XDM. Por padrão, essa propriedade está desativada.

Quando terminar, selecione Conectar à origem e Avançar para continuar.

nova-conta

Selecionar dados

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

Selecione Carregar arquivos para carregar seus dados. Como alternativa, você pode arrastar e soltar seus dados na seção Arrastar e soltar arquivos da interface.

adicionar-dados

Com os dados carregados, você pode usar o lado direito da interface para visualizar a hierarquia de arquivos. Selecione Avançar para continuar.

visualizar-amostra-dados

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.

A origem HTTP API oferece suporte à assimilação de arquivos JSON. Os arquivos JSON não exigem configuração manual se estiverem marcados como reclamação XDM. Caso contrário, você deve 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 Novo conjunto de dados. No formulário exibido, forneça o nome, uma descrição opcional, bem como o schema de destino para o conjunto de dados. Se você selecionar um esquema habilitado para Profile, poderá escolher se o conjunto de dados também deve ser habilitado para Profile.

novo-conjunto-de-dados

Usar um conjunto de dados existente

Para usar um conjunto de dados existente, selecione Conjunto de dados existente. 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 ser habilitado para Profile.

conjunto de dados existente

Mapear campos padrão

Com base nas suas necessidades, você pode optar por mapear campos diretamente ou usar funções de preparação de dados para transformar dados de origem para derivar valores calculados ou calculados. Para obter etapas abrangentes sobre como usar a interface do mapeador e campos calculados, consulte o Guia da Interface do Preparo de Dados.

Para adicionar um novo campo de origem, selecione Adicionar novo mapeamento.

adicionar-novo-mapeamento

Um novo emparelhamento de campo de origem e campo de destino é exibido. Para adicionar um novo campo de origem, selecione o ícone de seta ao lado da barra de entrada Selecionar campo de origem.

selecionar-campo-fonte

O painel Selecionar atributos permite explorar a 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 Selecionar para continuar.

selecionar-atributos

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

selecionar-campo-alvo

A janela Mapear campo de origem para campo de destino é 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 Selecionar para continuar.

mapear-para-campo-alvo

Depois que todos os campos de origem forem mapeados para os campos XDM de destino apropriados, selecione Avançar

preparação de dados concluída

Detalhes do fluxo de dados

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

Depois de fornecer detalhes para o fluxo de dados, selecione Próximo.

detalhes do fluxo de dados

Revisar

A etapa Revisar é exibida, permitindo que você revise os detalhes do fluxo de dados antes que ele seja criado. Os detalhes estão agrupados nas seguintes categorias:

  • Conexão: mostra o nome da conta, a plataforma de origem e o nome de origem.
  • Atribuir conjunto de dados e mapear campos: mostra o conjunto de dados de destino e o esquema ao qual o conjunto de dados pertence.

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

avaliação

Obter URL de ponto de extremidade de streaming

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

ponto de extremidade

Próximas etapas

Seguindo este tutorial, você criou uma conexão HTTP de transmissão, permitindo usar o ponto de extremidade de transmissão para acessar uma variedade de APIs do Data Ingestion. Para obter instruções sobre como criar uma conexão de streaming na API, leia o tutorial sobre criação de uma conexão de streaming.

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

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089