Beta

Criar um Merkury Enterprise Identity Resolution conexão de origem e fluxo de dados na interface do

NOTE
A variável Merkury Enterprise Identity Resolution a fonte está na versão beta. Leia as visão geral das origens para obter mais informações sobre o uso de fontes rotuladas como beta.

Este tutorial fornece etapas para criar um Merkury Enterprise Identity Resolution conexão de origem e fluxo de dados usando a interface do usuário do Adobe Experience Platform.

Introdução

Este tutorial requer um entendimento prático dos seguintes componentes do Experience Platform:

Coletar credenciais necessárias

Para acessar seu bucket no Experience Platform, é necessário fornecer valores válidos para as seguintes credenciais:

Credencial
Descrição
Chave de acesso
A ID da chave de acesso do seu bucket. Você pode recuperar esse valor de seu Merkury equipe.
Chave secreta
A ID da chave secreta para o seu bucket. Você pode recuperar esse valor de seu Merkury equipe.
Nome do bucket
Este é o seu balde Merkury onde os arquivos serão compartilhados. Você pode recuperar esse valor de seu Merkury equipe.

Para obter mais informações sobre a configuração do Merkury e outros pré-requisitos, leia a Merkury visão geral da origem.

Conectar sua conta do Merkury

Na interface do usuário da Platform, selecione Origens na barra de navegação esquerda, para acessar a Origens espaço de trabalho. A variável Catálogo A tela 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.

No Parceiros de dados categoria, selecione Merkury e selecione Configurar.

O catálogo de origens com a origem de Merkury selecionada.

A variável  Conectar-se ao Merkury  é exibida. Nesta página, você pode usar credenciais novas ou existentes.

Criar uma nova conta

Se estiver usando novas credenciais, selecione  Nova conta. No formulário de entrada que aparece, forneça um nome, uma descrição opcional e Merkury credenciais. Quando terminar, selecione  Conectar à origem  e aguarde algum tempo para estabelecer a nova conexão.

A nova interface de conta do Merkury.

Usar uma conta existente

Para usar uma conta existente, selecione Conta existente e, em seguida, selecione a Merkury conta que deseja usar. Selecione Próximo para continuar.

A interface de conta existente para o Merkury.

recommendation-more-help

Formatos de arquivo não suportados

Você pode assimilar os seguintes formatos de arquivo com o Merkury origem:

  • Valores separados por delimitadores (DSV): qualquer valor com um único caractere pode ser usado como delimitador para arquivos de dados formatados em DSV.
  • JavaScript Object Notation (JSON): os arquivos de dados formatados em JSON devem ser compatíveis com XDM.
  • Apache Parquet: arquivos de dados formatados com Parquet devem ser compatíveis com XDM.
  • Arquivos compactados: JSON e arquivos delimitados podem ser compactados como: bzip2, gzip, deflate, zipDeflate, tarGzip, e tar.

Adicionar dados

Depois de criar o Merkury conta, a variável Adicionar dados é exibida, fornecendo uma interface para você explorar suas Merkury hierarquia de arquivos e selecione a pasta ou o arquivo específico que deseja trazer para o Experience Platform.

  • A parte esquerda da interface é um navegador de diretórios, que exibe Merkury hierarquia de arquivos.
  • A parte direita da interface permite visualizar até 100 linhas de dados de uma pasta ou arquivo compatível.

O diretório de arquivos e pastas do workflow de origens em que você pode selecionar os dados que deseja assimilar.

Selecione a pasta raiz para acessar a hierarquia de pastas. Aqui, você pode selecionar uma única pasta para assimilar todos os arquivos na pasta recursivamente. Ao assimilar uma pasta inteira, você deve garantir que todos os arquivos nessa pasta compartilhem o mesmo formato de dados e esquema.

Depois de selecionar uma pasta, a interface correta é atualizada para uma pré-visualização do conteúdo e da estrutura do primeiro arquivo na pasta selecionada.

Os dados selecionados para assimilação e a interface de visualização do arquivo.

Durante essa etapa, você pode fazer várias configurações para seus dados antes de continuar. Primeiro, selecione Formato de dados e selecione o formato de dados apropriado para seu arquivo no painel suspenso exibido.

A tabela a seguir exibe os formatos de dados apropriados para os tipos de arquivos compatíveis:

Tipo de arquivo
Formato dos dados
CSV
Delimitado
JSON
JSON
Parquet
Parquet XDM

Selecionar um delimitador de coluna

Selecione para exibir etapas sobre como definir um delimitador

Após configurar o formato de dados, é possível definir um delimitador de coluna ao assimilar arquivos delimitados. Selecione o Delimitador e selecione um delimitador no menu suspenso. O menu exibe as opções usadas com mais frequência para delimitadores, incluindo uma vírgula (,), uma guia (\t), e uma barra vertical (|).

Se preferir usar um delimitador personalizado, selecione Personalizado e insira um delimitador de caractere único de sua escolha na barra de entrada pop-up.

Assimilar arquivos compactados

Selecione para ver as etapas sobre como assimilar arquivos compactados

Você também pode assimilar arquivos JSON ou delimitados compactados especificando o tipo de compactação.

No Selecionar dados selecione um arquivo compactado para assimilação e, em seguida, selecione o tipo de arquivo apropriado e se ele é compatível com XDM ou não. Em seguida, selecione Tipo de compactação e selecione o tipo de arquivo compactado apropriado para seus dados de origem.

Para trazer um arquivo específico para a Platform, selecione uma pasta e, em seguida, selecione o arquivo que deseja assimilar. Durante essa etapa, também é possível visualizar o conteúdo de outros arquivos em uma determinada pasta usando o ícone de visualização ao lado de um nome de arquivo.

Quando terminar, selecione Próxima.

Fornecer detalhes do fluxo de dados

A variável Detalhes do fluxo de dados permite selecionar se deseja usar um conjunto de dados existente ou um novo conjunto de dados. Durante esse processo, você também pode configurar os dados para serem assimilados no Perfil e ativar configurações como Diagnóstico de erro, Assimilação parcial, e Alertas.

Usar um conjunto de dados existente

Para assimilar dados em um conjunto de dados existente, selecione Conjunto de dados existente. É possível recuperar um conjunto de dados existente usando o Pesquisa avançada ou rolando pela lista de conjuntos de dados existentes no menu suspenso. Depois de selecionar um conjunto de dados, forneça um nome e uma descrição para o fluxo de dados.

A interface do conjunto de dados existente.

Usar um novo conjunto de dados

Para assimilar em um novo conjunto de dados, selecione Novo conjunto de dados e forneça um nome de conjunto de dados de saída e uma descrição opcional. Em seguida, selecione um esquema para mapear usando o Pesquisa avançada ou rolando pela lista de esquemas existentes no menu suspenso. Depois de selecionar um esquema, forneça um nome e uma descrição para o fluxo de dados.

A nova interface do conjunto de dados.

Ativar perfil e diagnóstico de erro

Selecione para exibir as etapas para habilitar o diagnóstico de erros e a assimilação de perfis

Em seguida, selecione o Conjunto de dados Perfil Ative para ativar seu conjunto de dados para o Perfil de cliente em tempo real. Isso permite criar uma visualização integral dos atributos e comportamentos de uma entidade. Os dados de todos os conjuntos de dados habilitados para perfil serão incluídos no Perfil e as alterações serão aplicadas quando você salvar seu fluxo de dados.

Diagnóstico de erro permite a geração de mensagens de erro detalhadas para qualquer registro incorreto que ocorra em seu fluxo de dados, enquanto Assimilação parcial O permite assimilar dados que contêm erros, até um determinado limite definido manualmente. Consulte a visão geral da assimilação parcial de lotes para obter mais informações.

Ativar alertas

Selecione para exibir etapas para ativar alertas

Você pode ativar os alertas para receber notificações sobre o status do fluxo de dados. Selecione um alerta na lista para assinar e receber notificações sobre o status do seu fluxo de dados. Para obter mais informações sobre alertas, consulte o manual sobre assinatura de alertas de origens usando a interface do usuário.

Quando terminar de fornecer detalhes ao seu fluxo de dados, selecione Próxima.

Mapear campos de dados para um esquema XDM

A variável Mapeamento é exibida, fornecendo uma interface para mapear os campos de origem do esquema de origem para os campos XDM de destino apropriados no esquema de destino.

A Platform fornece recomendações inteligentes para campos mapeados automaticamente com base no esquema ou conjunto de dados de destino selecionado. Você pode ajustar manualmente as regras de mapeamento para atender aos seus casos de uso. 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 o uso da interface do mapeador e campos calculados, consulte o Guia da interface de preparação de dados.

Depois que os dados de origem forem mapeados com sucesso, selecione Próxima.

A interface de mapeamento.

Programar execuções de assimilação

A variável Agendamento Esta etapa permite configurar uma programação de assimilação para assimilar automaticamente os dados de origem selecionados usando os mapeamentos configurados. Por padrão, o agendamento está definido como Once. Para ajustar a frequência de assimilação, selecione Frequência e selecione uma opção no menu suspenso.

TIP
O intervalo e o preenchimento retroativo não ficam visíveis durante uma assimilação única.

A interface de agendamento

Se você definir a frequência de assimilação como Minute, Hour, Dayou Week, você deve definir um intervalo para estabelecer um intervalo de tempo definido entre cada assimilação. Por exemplo, uma frequência de assimilação definida como Day e um intervalo definido como 15 significa que seu fluxo de dados está programado para assimilar dados a cada 15 dias.

Durante essa etapa, você também pode ativar preenchimento retroativo e definir uma coluna para a assimilação incremental de dados. O preenchimento retroativo é usado para assimilar dados históricos, enquanto a coluna definida para assimilação incremental permite que novos dados sejam diferenciados dos dados existentes.

Consulte a tabela abaixo para obter mais informações sobre como programar configurações.

Campo
Descrição
Frequência
A frequência na qual ocorre uma assimilação. As frequências selecionáveis incluem Once, Minute, Hour, Day, e Week.
Interval
Um número inteiro que define o intervalo para a frequência selecionada. O valor do intervalo deve ser um inteiro diferente de zero e deve ser definido como maior ou igual a 15.
Hora de início
Um carimbo de data e hora UTC que indica quando a primeira assimilação está definida para ocorrer. A hora de início deve ser maior ou igual à hora UTC atual.
Preenchimento retroativo
Um valor booleano que determina quais dados são assimilados inicialmente. Se o preenchimento retroativo estiver ativado, todos os arquivos atuais no caminho especificado serão assimilados durante a primeira assimilação agendada. Se o preenchimento retroativo estiver desativado, somente os arquivos carregados entre a primeira execução da 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.
NOTE
Para assimilação em lote, cada fluxo de dados subsequente seleciona arquivos que serão assimilados de sua origem com base em seus última modificação carimbo de data e hora. Isso significa que os fluxos de dados em lote selecionam arquivos da origem que são novos ou que foram modificados desde a última execução do fluxo. Além disso, você deve garantir que haja um intervalo de tempo suficiente entre o carregamento do arquivo e uma execução de fluxo agendada, pois os arquivos que não foram totalmente carregados na sua conta de armazenamento na nuvem antes do tempo de execução do fluxo agendado podem não ser coletados para assimilação.

Quando terminar de configurar a programação de assimilação, selecione Próxima.

Revisar seu fluxo de dados

A variável Revisão é exibida, permitindo que você revise seu 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 nesse 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, a frequência e o intervalo ativos da programação de assimilação.

Depois de revisar o fluxo de dados, clique em Concluir e aguarde algum tempo para criar o fluxo de dados.

A página de revisão.

Próximas etapas

Ao seguir este tutorial, você criou com sucesso um fluxo de dados para trazer dados em lote de seus Merkury origem para Experience Platform. Para obter recursos adicionais, consulte a documentação descrita abaixo.

Monitorar seu 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 exibir informações sobre taxas de assimilação, sucesso e erros. Para obter mais informações sobre como monitorar o fluxo de dados, consulte o tutorial em monitoramento de contas e fluxos de dados na interface do.

Atualizar seu fluxo de dados

Para atualizar as configurações para o agendamento de fluxos de dados, mapeamento e informações gerais, visite o tutorial em atualização de fluxos de dados de fontes na interface do usuário

Excluir seu fluxo de dados

É possível excluir fluxos de dados que não são mais necessários ou que foram criados incorretamente usando o Excluir disponível na Fluxos de dados espaço de trabalho. Para obter mais informações sobre como excluir fluxos de dados, consulte o tutorial em exclusão de fluxos de dados na interface.

337b99bb-92fb-42ae-b6b7-c7042161d089