Nesta página: Configure o roteamento de arquivos e uma configuração de canal de correspondência direta para que seus arquivos de extração sejam exportados para o servidor correto a ser recuperado pelo seu provedor de correspondência direta.
O Journey Optimizer permite que você personalize e gere os arquivos necessários aos provedores de correspondência direta para enviar emails aos seus clientes.
Ao criar uma mensagem de correspondência direta, você define os dados do público alvo, incluindo as informações de contato escolhidas (endereço postal por exemplo). Um arquivo contendo esses dados será gerado e exportado automaticamente para um servidor, onde seu provedor de correspondência direta poderá recuperá-lo e cuidar do envio real.
Antes de poder gerar esse arquivo, é necessário criar:
-
Uma configuração de roteamento de arquivo para especificar o servidor para o qual o arquivo será exportado e criptografá-lo, se necessário.
-
Uma configuração de correspondência direta que faz referência à configuração de roteamento de arquivos. Se você não tiver configurado nenhuma opção de roteamento de arquivo, não será possível criar uma configuração de correspondência direta.
-
Para criar uma configuração de roteamento de arquivo, você precisa ter a permissão interna Manage file routing. Saiba mais
-
Os arquivos de correspondência direta são gerados somente no momento da exportação; o sistema não armazena indefinidamente exportações mais antigas. Para um backup mais longo ou permanente, configure uma opção de roteamento de arquivo (armazenamento em nuvem ou SFTP).
Configurar o roteamento de arquivos file-routing-configuration
Para entregar uma mensagem de correspondência direta, o Journey Optimizer gera e exporta o arquivo contendo os dados do público-alvo direcionado para um servidor.
Você precisa especificar esses detalhes do servidor para que o provedor de correspondência direta possa acessar e usar esse arquivo para entregar email.
Para configurar o roteamento de arquivos, siga as etapas abaixo.
-
Acesse o menu Administração > Canais > Configurações de correspondência direta > Roteamento de arquivos e clique em Criar configuração de roteamento de arquivos.
{align="center" width="800"}
-
Defina um nome para a sua configuração.
-
Selecione o tipo de servidor que deseja usar para exportar seus arquivos de correspondência direta: Amazon S3, SFTP, Azure ou Data Landing Zone.
{align="center" width="800"}
-
Preencha os campos específicos para cada tipo de servidor, conforme detalhado nas guias abaixo.
Escolha o tipo de servidor server-type
Se você selecionou Amazon S3 como o Tipo de servidor, preencha os detalhes e as credenciais do seu servidor:
-
nome do bucket do AWS:To saiba onde encontrar o nome do seu bucket do AWS, consulte esta página.
-
Chave de acesso do AWS: para saber onde encontrar sua ID de chave de acesso do AWS, consulte esta página.
-
Chave secreta do AWS: para saber onde encontrar sua chave secreta do AWS, consulte esta página.
-
região do AWS: escolha a região do AWS onde a infraestrutura do servidor estará localizada. As regiões do AWS são áreas geográficas que o AWS usa para hospedar sua infraestrutura em nuvem. Como prática geral, é preferível escolher a região mais próxima da localização do provedor de correspondência direta.
Se você selecionou SFTP como o Tipo de servidor, preencha os detalhes e as credenciais do seu servidor:
-
Tipo de autenticação: selecione o tipo de autenticação usado para conectar ao servidor (senha ou chave SSH).
-
Conta: nome da conta usado para conexão com o servidor SFTP.
-
Endereço do servidor: URL servidor SFTP.
-
Porta: número da porta de conexão SFTP.
-
Senha / Chave SSH: senha ou chave SSH usada para se conectar ao servidor SFTP.
| note tip |
|---|
| TIP |
| Ao usar a autenticação de chave SSH, a chave deve ser uma chave privada OpenSSH codificada em Base64. Se for um arquivo no formato PPK, use a ferramenta PuTTY para convertê-lo para o formato OpenSSH. Para obter instruções detalhadas, consulte esta seção. |
| note |
|---|
| NOTE |
| Para especificar um caminho no servidor para salvar o arquivo, atualize o campo Filename da campanha de correspondência direta para incluir o caminho desejado. Saiba mais |
Se você selecionou Azure como o Tipo de servidor, preencha os detalhes e as credenciais do seu servidor:
-
Cadeia de Conexão do Azure: para encontrar sua Cadeia de Conexão do Azure, consulte esta página.
A Cadeia de Conexão do Azure deve seguir o formato abaixo:
DefaultEndpointsProtocol=[http|https];AccountName=myAccountName;AccountKey=myAccountKey -
Nome do Contêiner: para localizar seu Nome do Contêiner, consulte esta página.
O Nome do Contêiner deve conter somente o nome do contêiner sem barras.
note NOTE Para especificar um caminho no contêiner para salvar o arquivo, atualize o campo Filename da campanha de correspondência direta para incluir o caminho desejado. Saiba mais
Se você selecionou Zona de Aterrissagem de Dados como o Tipo de servidor, nenhum detalhe específico será necessário.
Todos os clientes de Adobe Experience Platform são provisionados com um contêiner da Zona de aterrissagem de dados por sandbox. Saiba mais sobre a Data Landing Zone na documentação do Adobe Experience Platform.
Para criptografar o arquivo, copie e cole sua chave de criptografia no campo Chave de criptografia PGP/GPG.
Se a configuração de roteamento de arquivo for enviada por meio de jornadas, é possível especificar a frequência com a qual o arquivo será enviado ao servidor.
Depois de preencher os detalhes do tipo de servidor, selecione Enviar. A configuração de roteamento de arquivos foi criada com o status Ativo. Agora ele está pronto para ser usado em uma configuração de correspondência direta.
Você também pode selecionar Salvar como rascunho para criar a configuração de roteamento de arquivo, mas não poderá selecioná-la em uma configuração até que ela esteja Ativa.
Gerar chave SSH para autenticação SFTP ssh-key-generation
Se você estiver usando o SFTP com autenticação de chave SSH, deverá ter uma chave privada OpenSSH codificada em Base64. Se a chave não estiver formatada corretamente, podem ocorrer erros de conexão ao configurar o roteamento de arquivos.
-
No PuTTYgen, gere seu par de chaves. RSA com 2048 bits ou superior é recomendado.
-
Selecione Conversões > Exportar chave OpenSSH no menu.
-
Quando solicitado, escolha salvar a chave privada sem proteção por senha.
-
Na caixa de diálogo Salvar, selecione Todos os arquivos (.) como o tipo de arquivo para garantir que a chave seja salva como texto simples e não como um arquivo .ppk.
-
Abra o arquivo salvo com um editor de texto e verifique seu formato:
- O arquivo deve começar com
-----BEGIN RSA PRIVATE KEY-----(cinco traços antes e depois). - Não deve haver nenhum texto que indique criptografia.
- O arquivo deve terminar com
-----END RSA PRIVATE KEY-----(cinco traços antes e depois).
- O arquivo deve começar com
-
Copie o conteúdo inteiro do arquivo (incluindo os marcadores
-----BEGIN/END RSA PRIVATE KEY-----) e codifique-o em Base64 usando uma ferramenta como Base64 Encode e Decode.note NOTE Na saída da codificação Base64, remova qualquer formatação MIME. A chave codificada deve ser uma única cadeia de caracteres contínua. -
Agora é possível colar a chave SSH codificada na Base64 no campo dedicado no Journey Optimizer.
| note caution |
|---|
| CAUTION |
Após a codificação Base64, a chave não conterá mais os marcadores -----BEGIN/END RSA PRIVATE KEY----- e não deve incluir quebras de linha. A chave pública correspondente deve ser adicionada ao arquivo de chaves autorizadas do servidor SFTP. |
Para obter mais informações sobre como conectar sua conta SFTP à Experience Platform, consulte esta documentação.
Criar uma configuração de correspondência direta direct-mail-surface
Para entregar correspondência direta com Journey Optimizer, é necessário criar uma configuração de canal para definir as configurações de formatação do arquivo que será usado pelo provedor de email.
Uma configuração de correspondência direta também deve incluir a configuração de roteamento de arquivos, que define o servidor para o qual o arquivo de correspondência direta será exportado.
-
No painel à esquerda, vá para Administração > Canais e selecione Configurações gerais > Configurações de canal. Clique no botão Criar configuração de canal. Saiba mais
-
Insira um nome e uma descrição (opcional) para a configuração e selecione o canal a ser configurado.
note NOTE Os nomes devem começar com uma letra (A-Z). Ele só pode conter caracteres alfanuméricos. Também é possível usar os caracteres de sublinhado _, ponto.e hífen-. -
Para atribuir rótulos de uso de dados personalizados ou de núcleo à configuração, você pode selecionar Gerenciar acesso. Saiba mais sobre o OLAC (Controle de Acesso em Nível de Objeto).
-
Selecione o canal Correspondência direta.
-
Selecione Ação de marketing(s) para associar políticas de consentimento às mensagens que usam essa configuração. Todas as políticas de consentimento associadas à ação de marketing são utilizadas para respeitar as preferências dos clientes. Saiba mais
-
Defina as configurações de correspondência direta na seção dedicada da configuração do canal.
{align="center" width="800"}
-
Selecione o formato de arquivo: CSV ou Delimitado por texto.
-
Se você selecionar Texto delimitado, defina o separador de coluna de sua escolha: tabulação, ponto e vírgula, barra vertical ou E comercial.
-
Selecione a Configuração de roteamento de arquivos entre as que você criou. Isso define para onde o arquivo será exportado para ser usado pelo provedor de correspondência direta.
note caution CAUTION Se você não tiver configurado nenhuma opção de roteamento de arquivo, não será possível criar uma configuração de correspondência direta. Saiba mais {align="center" width="800"}
-
Envie a configuração de correspondência direta.
Agora você pode criar uma mensagem de correspondência direta dentro de uma campanha. Depois que a campanha for iniciada, o arquivo que contém os dados do público-alvo serão exportados automaticamente para o servidor definido. O provedor de correspondência direta poderá recuperar esse arquivo e prosseguir com o delivery de correspondência direta.
Tópicos relacionados related-topics
Para perguntas comuns sobre correspondência direta, consulte Introdução à correspondência direta.
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how to set up a file routing configuration and a direct mail channel configuration so that extraction files are exported to the right server for your direct mail provider to retrieve.
Intents:
- Create a file routing configuration that defines the export server
- Choose a server type: Amazon S3, SFTP, Azure, or Data Landing Zone
- Encrypt the exported file with a PGP/GPG encryption key
- Generate a Base64-encoded OpenSSH private key for SFTP SSH key authentication
- Create a direct mail configuration that references a file routing configuration
- Select the file format and column separator for the exported file
Glossary:
- File routing configuration: The configuration that specifies the server where the extraction file is exported and, if needed, encrypts the file (product-specific)
- Direct mail configuration: The channel configuration that defines the file formatting and references a file routing configuration (product-specific)
- Data Landing Zone: A supported server type provisioned as one container per sandbox for all Adobe Experience Platform customers (product-specific)
- PGP/GPG encryption key: The key pasted into the configuration to encrypt the exported file (product-specific)
- Marketing action: A selection that associates consent policies with messages using the configuration (product-specific)
Guardrails:
- Creating a file routing configuration requires the Manage file routing built-in permission.
- If no file routing configuration exists, you cannot create a direct mail configuration.
- Supported server types are Amazon S3, SFTP, Azure, and Data Landing Zone.
- SFTP SSH key authentication requires a Base64-encoded OpenSSH private key; a PPK-format key must be converted with PuTTY.
- Configuration names must begin with a letter (A-Z) and can contain only alphanumeric characters plus underscore, dot, and hyphen.
- A file routing configuration cannot be selected in a configuration until it has the Active status; a Save as draft configuration is not selectable.
- Direct mail files are generated only at export time and older exports are not stored indefinitely; configure a file routing option (SFTP or cloud storage) for longer backup.
- Duplicate rows where all values in the row are the same are automatically removed from the file.
- The file split threshold can be set to any value between 1 and 200,000 records per file, after which another file is created for the remaining records.
Terminology:
- Canonical name: Direct mail configuration — Acronym: n/a — variants: direct mail channel configuration, direct mail surface
- Synonyms: “file routing configuration” = “file routing config”
- Do not confuse: “file routing configuration” (defines the export server) ≠ “direct mail configuration” (defines file formatting and references the file routing configuration)
- Do not confuse: “Active” (usable status) ≠ “Save as draft” (not selectable in a configuration)
FAQ:
- Q: What must I create before a direct mail configuration? — A file routing configuration; without one you cannot create a direct mail configuration.
- Q: Which server types are supported? — Amazon S3, SFTP, Azure, and Data Landing Zone.
- Q: What permission do I need to create file routing? — The Manage file routing built-in permission.
- Q: How do I encrypt the exported file? — Paste your encryption key into the PGP/GPG encryption key field.
- Q: Why can I not select my file routing configuration? — It is likely saved as a draft; a file routing configuration must have the Active status to be selectable.
- Q: Which file formats are available? — CSV or Text delimited, and Text delimited lets you choose a tabulation, semicolon, pipe, or ampersand column separator.