Conexão SFTP

Log de alterações de destino changelog

Com a versão de Experience Platform de julho de 2023, o destino SFTP fornece novas funcionalidades, conforme listado abaixo:

Visão geral overview

Crie uma conexão de saída ativa com o servidor SFTP para exportar arquivos de dados delimitados da Adobe Experience Platform periodicamente.

IMPORTANT
Embora o Experience Platform ofereça suporte a exportações de dados para servidores SFTP, os locais de armazenamento na nuvem recomendados para exportar dados são Amazon S3 e Azure Blob.

Conectar-se ao SFTP por meio da API ou da interface connect-api-or-ui

Públicos-alvo compatíveis supported-audiences

Esta seção descreve quais tipos de públicos-alvo você pode exportar para esse destino.

Origem do público
Suportado
Descrição
Segmentation Service
Públicos gerados por meio do Serviço de segmentação do Experience Platform.
Uploads personalizados
Públicos importados para o Experience Platform de arquivos CSV.

Tipo e frequência de exportação export-type-frequency

Consulte a tabela abaixo para obter informações sobre o tipo e a frequência da exportação de destino.

Item
Tipo
Notas
Tipo de exportação
Baseado em perfil
Você está exportando todos os membros de um segmento, juntamente com os campos de esquema desejados (por exemplo: endereço de email, número de telefone, sobrenome), conforme escolhido na tela selecionar atributos de perfil do fluxo de trabalho de ativação de destino.
Frequência de exportação
Lote
Os destinos em lote exportam arquivos para plataformas downstream em incrementos de três, seis, oito, doze ou vinte e quatro horas. Leia mais sobre destinos com base em arquivo de lote.

Tipo de exportação baseado em perfil SFTP realçado no catálogo de destinos.

Exportar conjuntos de dados export-datasets

Esse destino suporta exportações de conjunto de dados. Para obter informações completas sobre como configurar exportações de conjunto de dados, leia os tutoriais:

Formato de arquivo dos dados exportados file-format

Ao exportar dados de público-alvo, a Platform cria um arquivo .csv, parquet ou .json no local de armazenamento fornecido. Para obter mais informações sobre os arquivos, consulte a seção formatos de arquivo compatíveis com a exportação no tutorial de ativação de público-alvo.

Ao exportar conjuntos de dados, a Platform cria um arquivo .parquet ou .json no local de armazenamento fornecido. Para obter mais informações sobre os arquivos, consulte a seção verificar exportação bem-sucedida do conjunto de dados no tutorial exportar conjuntos de dados.

Conectar ao destino connect

IMPORTANT
Para se conectar ao destino, você precisa de Exibir Destinos e Gerenciar Destinos permissões de controle de acesso. Leia a visão geral do controle de acesso ou contate o administrador do produto para obter as permissões necessárias.

Para se conectar a este destino, siga as etapas descritas no tutorial de configuração de destino. No workflow de configuração de destino, preencha os campos listados nas duas seções abaixo.

Informações de autenticação authentication-information

Se você selecionar o tipo de autenticação SFTP com senha para se conectar ao seu local SFTP:

Autenticação básica de destino SFTP com senha.

  • Domínio: o endereço do local de armazenamento SFTP;

  • Nome de usuário: o nome de usuário para fazer logon no local de armazenamento SFTP;

  • Porta: a porta usada pelo local de armazenamento SFTP;

  • Senha: a senha para fazer logon no local de armazenamento SFTP.

  • Chave de criptografia: como opção, você pode anexar sua chave pública formatada em RSA para adicionar criptografia aos arquivos exportados. Veja um exemplo de uma chave de criptografia formatada corretamente na imagem abaixo.

    Imagem mostrando um exemplo de uma chave PGP formatada corretamente na interface.

Se você selecionar o tipo de autenticação SFTP com chave SSH para se conectar ao seu local SFTP:

Autenticação de chave SSH de destino SFTP.

  • Domínio: preencha o endereço IP ou o nome de domínio da sua conta SFTP

  • Porta: a porta usada pelo local de armazenamento SFTP;

  • Nome de usuário: o nome de usuário para fazer logon no local de armazenamento SFTP;

  • Chave SSH: a chave SSH privada usada para fazer logon no local de armazenamento SFTP. A chave privada deve ser uma string com formato RSA e codificação Base64, e não deve ser protegida por senha.

  • Chave de criptografia: como opção, você pode anexar sua chave pública formatada em RSA para adicionar criptografia aos arquivos exportados. Veja um exemplo de uma chave de criptografia formatada corretamente na imagem abaixo.

    Imagem mostrando um exemplo de uma chave PGP formatada corretamente na interface.

Detalhes do destino destination-details

Depois de estabelecer a conexão de autenticação com o local SFTP, forneça as seguintes informações para o destino:

Campos de detalhes do destino SFTP.

  • Nome: insira um nome que ajude a identificar este destino na interface do usuário do Experience Platform;

  • Descrição: insira uma descrição para este destino;

  • Caminho da pasta: digite o caminho para a pasta no local SFTP para onde os arquivos serão exportados.

  • Tipo de arquivo: selecione o Experience Platform de formato que deve ser usado para os arquivos exportados. Ao selecionar a opção CSV, você também pode configurar as opções de formatação de arquivo.

  • Formato de compactação: selecione o tipo de compactação que o Experience Platform deve usar para os arquivos exportados.

  • Incluir arquivo de manifesto: ative essa opção se desejar que as exportações incluam um arquivo JSON de manifesto que contenha informações sobre o local de exportação, tamanho da exportação e muito mais. O manifesto é nomeado usando o formato manifest-<<destinationId>>-<<dataflowRunId>>.json. Exibir um arquivo de manifesto de exemplo. O arquivo de manifesto inclui os seguintes campos:

    • flowRunId: A execução do fluxo de dados que gerou o arquivo exportado.
    • scheduledTime: A hora em UTC quando o arquivo foi exportado.
    • exportResults.sinkPath: O caminho no local de armazenamento onde o arquivo exportado está depositado.
    • exportResults.name: O nome do arquivo exportado.
    • size: O tamanho do arquivo exportado, em bytes.

Ativar públicos-alvo para esse destino activate

IMPORTANT

Consulte Ativar dados do público-alvo para destinos de exportação de perfil em lote para obter instruções sobre como ativar públicos-alvo para esse destino.

Validar exportação de dados bem-sucedida exported-data

Para verificar se os dados foram exportados com êxito, verifique o armazenamento SFTP e se os arquivos exportados contêm as populações de perfis esperadas.

INCLUIR NA LISTA DE PERMISSÕES endereço IP ip-address-allow-list

Consulte o artigo Adobe inclui na lista de permissões de endereço IP se precisar adicionar IPs de lista de permissões a um arquivo de.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6