[Beta]{class="badge informative"}

Criar uma conexão e um fluxo de dados de origem Acxiom Data Ingestion na interface do usuário

NOTE
A origem Acxiom Data Ingestion está na versão beta. Leia os termos e condições na visão geral das fontes para obter mais informações sobre como usar fontes com rótulo beta.

Use a fonte Acxiom Data Ingestion para assimilar dados Acxiom na Real-time Customer Data Platform e enriquecer perfis próprios. Em seguida, você pode usar seus perfis primários enriquecidos com Acxiom para melhorar os públicos e ativar em canais de marketing.

Leia este tutorial para saber como criar uma conexão de origem e um fluxo de dados do Acxiom Data Ingestion usando a interface do usuário do Adobe Experience Platform. A origem Acxiom Data Ingestion é usada para recuperar e mapear a resposta do serviço de aprimoramento Acxiom usando o Amazon S3 como ponto de lançamento.

Pré-requisitos prerequisites

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 autenticação Acxiom
A chave de autenticação. Você pode recuperar esse valor da equipe Acxiom.
Amazon S3 chave de acesso
A ID da chave de acesso do seu bucket. Você pode recuperar esse valor da equipe Acxiom.
Amazon S3 chave secreta
A ID da chave secreta para o seu bucket. Você pode recuperar esse valor da equipe Acxiom.
Nome do bucket
Esse é o seu bucket onde os arquivos serão compartilhados. Você pode recuperar esse valor da equipe Acxiom.
IMPORTANT
Você deve ter as permissões Exibir Fontes e Gerenciar Fontes habilitadas para sua conta a fim de conectar sua conta do Acxiom ao Experience Platform. Entre em contato com o administrador do produto para obter as permissões necessárias. Para obter mais informações, leia o guia da interface do usuário de controle de acesso.

Conectar sua conta do Acxiom

Na interface da Platform, selecione Fontes na barra de 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 Parceiros de dados e identidade, selecione Assimilação de dados da Acxiom e Configurar.

TIP
Um cartão de origem que exibe Adicionar dados significa que a origem já tem uma conta autenticada. Por outro lado, um cartão de origem que exibe Configurar significa que você deve fornecer credenciais e criar uma nova conta para usar essa origem.

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

Criar uma nova conta

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

A nova interface de conta do fluxo de trabalho de origens.

Credenciais
Descrição
Nome da conta
O nome da conta.
Descrição
(Opcional) Uma breve explicação da finalidade da conta.
Chave de autenticação Acxiom
A chave fornecida por Acxiom é necessária para a aprovação da conta. Deve corresponder ao valor correto para que uma conexão com o banco de dados possa ser estabelecida. Essa chave deve ter 24 caracteres e pode incluir apenas: A-Z, a-z e 0-9.
Chave de acesso S3
A chave de acesso S3 faz referência ao local do Amazon S3. Ele é fornecido pelo administrador quando as permissões de função do S3 são definidas.
Chave secreta S3
A chave secreta S3 faz referência ao local do Amazon S3. Ele é fornecido pelo administrador quando as permissões de função do S3 são definidas.
s3SessionToken
(Opcional) O valor do token de autenticação ao se conectar ao S3.
serviceUrl
(Opcional) O local do URL a ser usado ao se conectar ao S3 em um local não padrão.
Nome do bucket
(Opcional) O nome do bucket do S3 configurado no S3 que serve como um caminho inicial na seleção de dados.
Caminho da pasta
Se os subdiretórios em um bucket forem usados, você também poderá especificar um caminho como um caminho inicial na seleção de dados.

Usar uma conta existente

Para usar uma conta existente, selecione Conta existente.

Selecione uma conta na lista para ver os detalhes dessa conta. Depois de selecionar uma conta, selecione Avançar para continuar.

A interface de conta existente do fluxo de trabalho de origens.

Selecionar dados

Selecione o arquivo que deseja assimilar do bucket e do subdiretório desejados. Uma visualização dos dados pode ser fornecida assim que o delimitador e o tipo de compactação forem definidos. Depois de selecionar o arquivo, selecione Avançar para continuar.

A interface de visualização de arquivos e dados selecionados do fluxo de trabalho de fontes.

NOTE
Embora os tipos de arquivos JSON e Parquet estejam listados, não é necessário ou esperado que você os use durante o fluxo de trabalho de origem Acxiom.

Fornecer detalhes do conjunto de dados e do fluxo de dados

Em seguida, você deve fornecer informações sobre o conjunto de dados e o fluxo de dados.

Detalhes do conjunto de dados

Usar um novo conjunto de dados

Um 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 dados assimilados com sucesso no Experience Platform são mantidos no data lake como conjuntos de dados. Para usar um novo conjunto de dados, selecione Novo conjunto de dados.

A nova interface do conjunto de dados.

table 0-row-2 1-row-2 2-row-2 3-row-2
Detalhes do novo conjunto de dados Descrição
Nome do conjunto de dados de saída O nome do novo conjunto de dados.
Descrição (Opcional) Uma breve explicação da finalidade do conjunto de dados.
Esquema Uma lista suspensa de esquemas que existem em sua organização. Você também pode criar seu próprio esquema antes do processo de configuração de origem. Para obter mais informações, leia o manual sobre criação de esquema na interface.
Usar um conjunto de dados existente

Para usar um conjunto de dados existente, selecione Conjunto de dados existente.

Você pode selecionar Pesquisa avançada para exibir uma janela de todos os conjuntos de dados de sua organização, incluindo seus respectivos detalhes, como se eles estão habilitados para assimilação no Perfil do cliente em tempo real.

A interface do conjunto de dados existente.

Selecione para obter as etapas para habilitar a Assimilação de perfil, o diagnóstico de erros e a assimilação parcial.

Se o seu conjunto de dados estiver habilitado para o Perfil de cliente em tempo real, durante essa etapa você poderá alternar para o conjunto de dados do perfil para habilitar seus dados para assimilação de perfil. Você também pode usar esta etapa para habilitar o Diagnóstico de erro e a Assimilação parcial.

  • Diagnóstico de erro: selecione Diagnóstico de erro para instruir a origem a produzir o diagnóstico de erro que você poderá consultar posteriormente ao monitorar a atividade do conjunto de dados e o status do fluxo de dados.
  • Assimilação parcial: a assimilação parcial de lotes é a capacidade de assimilar dados que contêm erros, até um determinado limite configurável. Esse recurso permite assimilar com sucesso todos os seus dados precisos no Experience Platform, enquanto todos os seus dados incorretos são armazenados em lote separadamente com informações sobre por que são inválidos.

Detalhes do fluxo de dados

Depois que o conjunto de dados é configurado, você deve fornecer detalhes sobre o fluxo de dados, incluindo um nome, uma descrição opcional e configurações de alerta.

A interface de configurações de detalhes do fluxo de dados.

Configurações de fluxo de dados
Descrição
Nome do fluxo de dados
O nome do fluxo de dados. Por padrão, esse campo usará o nome do arquivo que está sendo importado.
Descrição
(Opcional) Uma breve descrição do fluxo de dados.
Alertas

O Experience Platform pode produzir alertas baseados em eventos, nos quais os usuários podem assinar. Todas essas opções fazem parte de um fluxo de dados em execução para acioná-los. Para obter mais informações, leia a visão geral dos alertas

  • Início da Execução do Fluxo de Dados de Fontes: selecione este alerta para receber uma notificação quando a execução do fluxo de dados começar.
  • Êxito na Execução do Fluxo de Dados de Fontes: selecione este alerta para receber uma notificação se o fluxo de dados terminar sem erros.
  • Falha na execução do fluxo de dados de fontes: selecione este alerta para receber uma notificação se a execução do fluxo de dados terminar com erros.

Mapeamento

Use a interface de mapeamento para mapear os dados de origem para os campos de esquema apropriados antes de assimilar dados no Experience Platform. Para obter mais informações, leia o guia de mapeamento na interface

A interface de mapeamento.

Agendar a assimilação do fluxo de dados

Em seguida, use a interface de programação para definir a programação de assimilação do fluxo de dados.

A interface de configuração de agendamento.

Configuração de agendamento
Descrição
Frequência

Configure a frequência para indicar a frequência de execução do fluxo de dados. Você pode definir a frequência como:

  • Uma vez: defina sua frequência como once para criar uma assimilação única. As configurações para intervalo e preenchimento retroativo não estão disponíveis ao criar um fluxo de dados de assimilação única. Por padrão, a frequência de agendamento é definida como uma vez.
  • Minuto: Defina sua frequência como minute para agendar seu fluxo de dados para assimilar dados por minuto.
  • Hora:Defina sua frequência como hour para agendar seu fluxo de dados para assimilar dados por hora.
  • Dia: Defina sua frequência como day para agendar seu fluxo de dados para assimilar dados por dia.
  • Semana: Defina sua frequência como week para agendar seu fluxo de dados para assimilar dados por semana.
Intervalo
Depois de selecionar uma frequência, você pode definir o intervalo para estabelecer o intervalo de tempo entre cada assimilação. Por exemplo, se você definir a frequência como dia e configurar o intervalo como 15, o fluxo de dados será executado a cada 15 dias. Observação: não é possível definir o intervalo como zero.
Hora de início
O carimbo de data e hora da execução projetada, apresentado no fuso horário UTC.
Preenchimento retroativo
O preenchimento retroativo 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.

Revisar seu fluxo de dados

Use a página de revisão para obter um resumo do seu fluxo de dados antes da assimilação. Os detalhes estão agrupados nas seguintes categorias:

  • Conexão - Mostra o tipo de origem, o caminho relevante do arquivo de origem escolhido e o número de colunas nesse arquivo de origem.
  • Atribuir campos de conjunto de dados e mapa - Mostra em qual conjunto de dados os dados de origem estão sendo assimilados, incluindo o esquema ao qual o conjunto de dados pertence.
  • Agendamento - Mostra o período, a frequência e o intervalo ativos do agendamento de assimilação.
    Depois de revisar seu fluxo de dados, clique em Concluir e aguarde algum tempo para que o fluxo de dados seja criado.

A página de revisão.

Próximas etapas

Ao seguir este tutorial, você criou com êxito um fluxo de dados para trazer dados em lote da origem Acxiom para o 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, visite o tutorial em monitoramento de contas e fluxos de dados na interface.

Atualizar seu fluxo de dados

Para atualizar as configurações do agendamento de fluxos de dados, mapeamento e informações gerais, visite o tutorial em atualizando fluxos de dados de fontes na interface.

Excluir seu fluxo de dados

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

Recursos adicionais additional-resources

Para obter mais informações, leia a Acxiom InfoBase.

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