Implantação de uma instância deploying-an-instance
assistente de implantação deployment-assistant
O Adobe Campaign fornece um assistente gráfico, disponível no console do cliente Adobe Campaign, para definir os parâmetros da instância à qual você vai se conectar.
Para iniciar o assistente de implantação, selecione Ferramentas > Avançado > assistente de implantação.
As etapas de configuração são as seguintes:
Parâmetros gerais general-parameters
A primeira etapa do assistente de implantação permite inserir informações gerais na instância.
Informações gerais general-information
A seção inferior da janela permite selecionar as opções a serem ativadas.
- Customer identifier used in billing : pode ser o nome da instância e o número da versão.
- Common name of the customer : Insira uma cadeia de caracteres com o nome da sua empresa. Essas informações podem ser usadas nos links de unsubscription.
- Namespace : Insira um identificador curto em minúsculas. O objetivo é distinguir entre sua configuração específica e a configuração de fábrica em caso de atualização. O namespace padrão é cus - para cliente.
Opções técnicas technical-options
A seção inferior da janela permite selecionar as opções a serem ativadas.
As seguintes opções estão disponíveis:
- Email channel : para ativar a entrega de email. Consulte Parâmetros do canal de email.
- Tracking : Para habilitar o rastreamento da população do público alvo (aberturas e cliques). Consulte Configuração de rastreamento.
- Managing bounced emails : Para definir a conta POP usada para coletar emails de entrada. Consulte Gerenciamento de emails devolvidos.
- LDAP integration : Para configurar a autenticação de usuário por meio de um diretório LDAP. Consulte Conectando-se via LDAP.
Parâmetros de canal de email email-channel-parameters
A etapa a seguir permite definir as informações a serem exibidas nos cabeçalhos da mensagem.
Esses parâmetros podem ser sobrecarregados em templates do delivery e individualmente para cada delivery (se os usuários tiverem os direitos necessários).
Parâmetros para emails entregues parameters-for-delivered-emails
Indique os seguintes parâmetros:
-
Sender name : Insira o nome do remetente.
-
Sender address : Digite o endereço de email do remetente. Ao enviar emails do Adobe Campaign, a caixa de correio Endereço do Remetente não é monitorada e os usuários de marketing não podem acessá-la. O Adobe Campaign também não oferece a capacidade de responder automaticamente ou encaminhar emails recebidos nessa caixa de correio. Saiba mais sobre as Práticas recomendadas de entrega nesta documentação.
-
Reply address text : Digite o nome usado quando o destinatário clicar no botão Reply.
-
Reply address : Digite o endereço de email a ser usado quando o destinatário clicar no botão Reply no software cliente de email. A finalidade do campo Endereço de Resposta é quando você deseja que o destinatário responda a um endereço diferente do Endereço do Remetente. Esse endereço deve ser um endereço de email válido, vinculado a uma caixa de correio monitorada e hospedado pelo cliente. Pode ser uma caixa de correio de suporte, por exemplo,
customer-care@customer.com, em que os emails são lidos e respondidos. -
Error address : Insira o endereço de email das mensagens com erros. Esse é o endereço técnico usado para lidar com emails devolvidos, incluindo emails recebidos pelo servidor do Adobe Campaign devido a endereços de destino inexistentes. Esse endereço deve ser um endereço de email válido, vinculado a uma caixa de correio monitorada e hospedado pelo cliente. Pode ser uma caixa de entrada de devolução, por exemplo,
errors@customer.com. Este endereço pode ser alterado para uma entrega ou nos modelos de entrega, na guia SMTP das propriedades de entrega/modelo de entrega. Saiba mais.
Além disso, você pode especificar as máscaras autorizadas para o endereço do remetente e o endereço de erro. Se necessário, essas máscaras podem ser separadas por vírgulas. Essa configuração é opcional. Quando os campos são inseridos, o Adobe Campaign verifica no momento do delivery (durante a análise, se o endereço não incluir nenhuma variável) se os endereços são válidos. Esse modo operacional garante que não sejam usados endereços que possam causar problemas de delivery. Os endereços de entrega devem ser configurados no servidor de entrega.
-
Essas configurações são salvas nas opções da plataforma do Campaign. Saiba mais.
-
Para configurações de várias marcas, você pode adaptar o Endereço de erro e substituir essa configuração da conta externa do Roteamento de email. Saiba mais.
Caracteres autorizados em endereços characters-authorized-in-addresses
No banco de dados do Adobe Campaign, todos os endereços de email devem ser criados da seguinte maneira: x@y.z. Os caracteres x, y e z não devem estar vazios e não devem incluir caracteres não autorizados.
Você pode definir aqui os caracteres autorizados ('política de dados') no campo de email do banco de dados. Os caracteres não incluídos na lista serão proibidos e, portanto, recusados ao inserir informações na base de dados por meio da interface, através de um formulário web e também importando dados.
Duas listas estão disponíveis: Somente europeia ou somente EUA. Outros caracteres podem ser adicionados, se necessário.
Parâmetros de entrega delivery-parameters
O link Advanced parameters… permite que você acesse as opções de entrega, os parâmetros vinculados à tentativa e a quarentena.
Essa janela permite definir, para todas as campanhas de email, as opções de delivery e de gerenciamento de qualidade de endereço.
As seguintes opções estão disponíveis:
- Delivery duration of messages : depois desse tempo, a entrega é interrompida (por padrão, 5 dias).
- Online resources validity duration : Tempo durante o qual as informações do perfil do destinatário são mantidas para gerar mirror pages.
- Exclude recipients who no longer wish to be contacted : quando esta opção é selecionada, em os recipients da inclui na lista de bloqueios não serão contatados.
- Automatically ignore doubles : Quando esta opção é selecionada, a entrega não será feita para endereços duplicados.
Tentar parâmetros novamente retry-parameters
As informações sobre recuperações são fornecidas nos campos Períodos de recuperação e Número de recuperações: quando um destinatário está inacessível, por exemplo, se sua caixa de entrada estiver cheia, por padrão, o programa tentará contatá-lo cinco vezes, com um intervalo de uma hora entre cada tentativa (durante o tempo máximo de entrega). Esses valores podem ser alterados para atender às suas necessidades.
Parâmetros de quarentena quarantine-parameters
As opções de configuração para quarentenas são as seguintes:
- Duration between two significant errors : insira um valor ("1d" por padrão: 1 dia) para definir o tempo que o aplicativo aguarda antes de incrementar o contador de erros, em caso de falha,
- Maximum number of errors before quarantine : quando esse valor é atingido, o endereço de email é colocado em quarentena (por padrão, "5": o endereço será colocado em quarentena no sexto erro). Isso significa que o contato será automaticamente excluído das próximas entregas.
Gerenciamento de emails devolvidos managing-bounced-emails
O email de devolução é extremamente importante para qualificar erros de delivery. Esses erros são categorizados no NP@I uma vez que as regras determinaram sua causa.
Esta etapa só estará disponível se as opções de gerenciamento Canal de email e Email de devolução forem selecionadas na primeira etapa do assistente de implantação. Consulte Parâmetros gerais.
Esse estágio permite definir configurações para gerenciar emails devolvidos.
Conta POP usada para recuperar emails de entrada pop-account-used-to-retrieve-incoming-mails
Indique os parâmetros para se conectar à conta para recuperar emails de entrada.
- Label : Nome que inclui todos os parâmetros fornecidos abaixo,
- Server : Servidor usado para recuperar emails devolvidos (emails de entrada),
- Security : Se necessário, selecione SSL na lista suspensa,
- Port : porta do servidor (geralmente 110),
- Account : Nome da conta usada para email de devolução,
- Password : Senha associada à conta.
Depois que as configurações de POP forem especificadas, clique em Testar para verificar se estão corretas.
Emails rejeitados não processados unprocessed-bounce-mails
As rejeições são tratadas automaticamente pela Adobe Campaign, aplicando as regras listadas no nó Administration > Campaign Management > Non deliverables Management > Delivery log qualification. Para obter mais informações, consulte Gerenciamento de email de devolução.
As rejeições não processadas não são exibidas na interface do Adobe Campaign. Eles são excluídos automaticamente, a menos que sejam transferidos para uma caixa de correio de terceiros usando os seguintes campos:
- Forwarding address : preencha este campo para transferir para um endereço de terceiros todas as mensagens de erro (processadas ou não processadas ) coletadas pela plataforma Adobe Campaign.
- Address for errors : Preencha este campo para transferir para um endereço de terceiros somente as mensagens de erro que o processo inMail não pôde qualificar.
- SMTP server : servidor usado para enviar os emails rejeitados não processados.
Configuração de rastreamento tracking-configuration
A próxima etapa permite configurar o rastreamento da instância. A instância deve ser declarada e registrada nos servidores de rastreamento.
Esta etapa só é oferecida quando as opções Canal de email e Rastreamento são selecionadas na primeira página do assistente de implantação. Consulte Parâmetros gerais.
Para obter informações mais detalhadas sobre rastreamento web (modo de rastreamento, criação e inserção de marcas…), consulte este documento.
Princípio operacional operating-principle
Quando você ativa o rastreamento em uma instância, os URLs nos deliveries são alterados durante o envio para ativar o rastreamento.
-
As informações sobre URLs externos (seguros ou não) inseridas nesta página do assistente de implantação são usadas para criar o novo URL. Além dessas informações, o link modificado contém: os identificadores do delivery, o recipient e o URL.
As informações de rastreamento são coletadas pela Adobe Campaign no(s) servidor(es) de rastreamento para enriquecer os perfis de destinatários e os dados vinculados à entrega (guias Tracking).
As informações sobre URLs internos são usadas somente pelo servidor de aplicativos do Adobe Campaign para entrar em contato com o(s) servidor(es) de rastreamento.
Para obter mais informações, consulte Servidor de rastreamento.
-
Depois que os URLs forem configurados, será necessário ativar o rastreamento. Para fazer isso, a instância deve ser registrada nos servidores de rastreamento.
Para obter mais informações, consulte Salvar o rastreamento.
Servidor de rastreamento tracking-server
Para garantir a eficiência do rastreamento nessa instância, as seguintes informações devem ser exibidas:
-
External URL e/ou Secure external URL : Digite a URL de redirecionamento a ser usada no email a ser enviado.
-
Internal URL(s) : URLs usadas somente pelo servidor do Adobe Campaign para contatar o(s) servidor(es) de rastreamento e coletar logs e carregar as URLs. Não é necessário associá-lo à instância.
Se você não especificar um URL, o URL de rastreamento será usado por padrão.
Com a arquitetura Mid-sourcing, você pode externalizar o gerenciamento de rastreamento. Para fazer isso:
-
Selecione a opção Externalize tracking management : permite usar um servidor mid-sourcing como servidor de rastreamento.
-
Preencha os campos External account e Instance name para poder se conectar ao servidor mid-sourcing.
Para obter mais informações, consulte Servidor Mid-sourcing.
-
Clique no botão Enable the tracking instance para aprovar a conexão com o servidor.
Salvar o rastreamento saving-tracking
Depois que os URLs forem preenchidos, você deverá registrar o servidor de rastreamento.
Clique no link Registro no(s) servidor(es) de rastreamento e selecione uma das opções disponíveis.
Há três tipos possíveis de arquitetura para implementar o rastreamento:
-
Adicionar suporte para rastreamento em uma instância existente
Essa opção se aplica se a instância já tiver sido criada para outras necessidades (servidor MTA etc.) em servidores que serão usados como servidores de rastreamento.
Digite a senha da conta interna no(s) servidor(es) de redirecionamento para configurar a instância de rastreamento.
note note NOTE Se vários servidores de rastreamento forem usados, eles deverão usar o mesmo nome e senha. Especifique o nome da instância e a senha.
-
Criar uma nova instância dedicada ao rastreamento
Essa opção é útil quando as instâncias de rastreamento são reservadas para rastreamento e não têm outros módulos de aplicativo.
Digite a senha da conta interna no(s) servidor(es) de redirecionamento para configurar a instância de rastreamento.
note note NOTE Se vários servidores de rastreamento estiverem configurados, todos eles deverão usar a mesma senha. Especifique o nome da instância, a senha e qualquer máscara DNS associada, como Campaign*.
-
Validar uma instância de rastreamento já pré-configurada para você
Essa opção é usada quando você não tem a senha da conta interna. Nesse caso, uma conta de rastreamento é pré-configurada para você no(s) servidor(es) de rastreamento. Insira a senha da conta de rastreamento do(s) servidor(es) de redirecionamento para validar a instância de rastreamento.
Especifique o nome da instância que será validada.
Clique em Aprovar para iniciar o processo de gravação com o servidor de rastreamento.
De volta à janela anterior, uma mensagem confirma o registro no nível do servidor de rastreamento:
Os parâmetros vinculados às pesquisas de URL não devem ser modificados para uma instalação padrão. Para todos os outros parâmetros, entre em contato com o Adobe.
Parâmetros do canal móvel mobile-channel-parameters
A próxima etapa permite definir configurações padrão para deliveries a dispositivos móveis (SMS e WAP Push).
Conta padrão para entrega por SMS default-account-for-sms-delivery
Insira a seguinte informação:
- Label : Digite um nome para esta conta de SMS/Wap Push. Por exemplo, talvez você queira usar o nome do roteador.
- Para os campos Server, Port, Account, Password, Connector, Send Endpoint, Reception Endpoint, Notification Endpoint: Contate seu provedor de serviços para obter as configurações necessárias.
Parâmetros de SMS enviados parameters-of-sms-sent
Na lista suspensa Prioridade: selecione "Normal", "Alto" ou "Urgente" para aplicá-lo às mensagens a serem enviadas.
Parâmetros avançados advanced-parameters
O link Advanced parameters… permite que você acesse as opções de nova tentativa e quarentena.
Informações sobre tentativas estão disponíveis nos campos Período de tentativas e Número de tentativas: quando um dispositivo móvel está inacessível, por padrão, o programa tentará novamente 5 vezes em intervalos de pelo menos 15 minutos (para o período máximo de entrega). Esses valores podem ser adaptados para atender às suas necessidades.
As opções de configuração para quarentenas são as seguintes:
- Time between two significant errors : Insira um valor padrão (por padrão "1d": dia) para definir o tempo que o aplicativo aguarda antes de incrementar o contador de erros para uma falha.
- Maximum number of errors before quarantine : Depois que esse valor é atingido, o número do celular é colocado em quarentena (por padrão, "5": o número será colocado em quarentena após o sexto erro). Isso significa que o contato será automaticamente excluído de deliveries futuros.
Configurações regionais regional-settings
Esse estágio permite incluir preferências de política de dados.
- Consider all phone numbers as international ones : Quando essa opção é selecionada, o aplicativo aplica o formato internacional a números de telefone (o prefixo do país é obrigatório porque o número de dígitos não será verificado antes da aplicação da formatação). Se esta opção não estiver selecionada, você deverá adicionar um prefixo ao número de telefone internacional com "+" ou "00".
- Store all phone numbers using the international format : esta opção só afeta números de telefone nacionais importados ou editados. Defina se deseja usar um formato doméstico (como 425 555 0150) ou internacional (por exemplo, +1 425 555 0150)
Acesso pela Internet access-from-the-internet
Esta etapa permite definir URLs de acesso para páginas do Adobe Campaign expostas na Internet.
Você também deve indicar aqui as opções de publicação vinculadas aos formulários web.
Servidores expostos na Web servers-exposed-on-the-web
Use esta página para preencher os URLs do servidor para:
-
Acesse o servidor de aplicativos exposto na Internet: formulários de assinatura/unsubscription, extranet etc.
-
Acesse o servidor de aplicativos para recursos não expostos na Web: formulários, intranet, páginas de confirmação.
-
Acesse as mirror pages dos deliveries.
Uma mirror page é uma página dinâmica que exibe o conteúdo do email. Ele é acessado por um link inserido na mensagem enviada ao recipient e pode conter elementos personalizados. A mirror page dá ao recipient a possibilidade de ler a mensagem em um navegador da Internet em vez do software de email, independentemente do formato de delivery (texto ou HTML). No entanto, as mirror pages só serão geradas para um determinado delivery se o conteúdo de HTML necessário tiver sido definido.
O Adobe Campaign permite diferenciar esses três URLs para distribuir a carga em várias plataformas.
- Essas configurações são salvas nas opções da plataforma do Campaign. Saiba mais.
- Para configurações de várias marcas, você pode adaptar o URL da Mirror page e substituir essa configuração da conta externa de Roteamento de email. Saiba mais.
Gerenciamento de recursos públicos managing-public-resources
Para serem vistas de fora, as imagens usadas em emails e recursos públicos vinculados a campanhas devem estar presentes em um servidor acessível externamente. Eles podem estar disponíveis para recipients ou operadores externos.
Para esta etapa, você precisa inserir:
- O novo URL do recurso público. Para obter mais informações, consulte a seção URL de recursos públicos.
- O modo de detecção de imagem em uma entrega. Para obter mais informações, consulte a seção Detecção de imagem de entrega.
- Opções de publicação. Para obter mais informações, consulte a seção Modos de publicação.
Os recursos públicos podem ser acessados por meio do nó Administration > Resources > Online > Public resources da árvore do Adobe Campaign. Eles são coletados em uma biblioteca e podem ser incluídos em emails, mas também são usados em campanhas ou tarefas e na gestão de conteúdo.
URL de recursos públicos public-resources-url
O primeiro campo permite especificar o início do URL usado para os recursos depois de serem carregados. Quando carregados, os recursos podem ser acessados por meio desse novo URL.
Em um delivery, você pode usar imagens armazenadas na biblioteca de recursos públicos ou qualquer outra imagem local ou imagem armazenada em um servidor.
-
Para imagens de email, a URL do https:// server /res/img.
Esse valor pode ser sobreposto para cada delivery.
-
Para recursos públicos, a URL https:// server /res/ instance onde instance é o nome da instância de rastreamento.
Detecção de imagem de entrega delivery-image-detection
Em um delivery, você pode usar imagens armazenadas na biblioteca de recursos públicos ou qualquer outra imagem local ou imagem armazenada em um servidor.
O campo máscaras de URL permite especificar a lista de máscaras de URL a serem ignoradas ao carregar imagens automaticamente. Por exemplo, se você usar imagens armazenadas em um site acessível externamente, em particular em um site da Internet, poderá inserir o URL do site neste campo.
É possível especificar várias máscaras de URL usando uma vírgula para separar cada uma delas.
- Para obter informações sobre como usar e gerenciar imagens em emails, consulte esta seção.
- No assistente de entrega, as imagens chamadas desses URLs terão o status "Ignorado".
Modos de publicação publication-modes
A seção inferior do assistente permite selecionar as opções de publicação de recursos públicos e imagens.
Os seguintes modos de publicação estão disponíveis:
-
Servidor(es) de rastreamento
Os recursos serão copiados automaticamente para os diferentes servidores de rastreamento. Eles são configurados na etapa Configuração de rastreamento.
-
Outros servidores da Adobe Campaign
Você pode usar um ou mais servidores do Adobe Campaign nos quais os recursos serão copiados.
No lado do servidor, para usar um servidor Adobe Campaign dedicado, você deve criar uma nova instância com o seguinte comando:
code language-none nlserver config -addtrackinginstance:<trackingA>/<trackingA*>Em seguida, digite a senha.
Os parâmetros do(s) servidor(es) dedicado(s) são fornecidos nos campos Media URL(s), Password e Instance name.
-
Script de publicação manual (somente para recursos públicos)
É possível publicar as imagens usando um script:
-
É necessário criar esse script: o conteúdo depende da sua configuração.
-
O script será chamado pelo seguinte comando:
code language-none [INSTALL]/copyToFrontal.vbs "$(XTK_INSTALL_DIR)\var\<instance>\upload\" "img1,img2,img3"onde
[INSTALL]é o caminho de acesso para a pasta de instalação do Adobe Campaign. -
No Unix, verifique se o script é executável.
-
Para imagens, ele deve copiá-las da pasta "images" especificada por meio da opção NmsDelivery_ImageSubDirectory para um ou mais servidores frontais. Esses servidores armazenarão as imagens para torná-las acessíveis por meio do novo URL configurado.
No caso de publicação em um servidor Adobe Campaign sem um script de publicação manual, por padrão, as imagens de uma entrega são armazenadas no $(XTK_INSTALL_DIR)/var/res/img/ directory. A URL correspondente é a seguinte: https://server/res/img.
XTK_INSTALL_DIR)/var/res/$(INSTANCE_NAME). A URL correspondente é a seguinte: https://server/res/instance onde instância é o nome da instância de rastreamento.
Sincronização de recursos públicos synchronizing-public-resources
Esta funcionalidade permite que você sincronize recursos públicos em vários servidores sobressalentes.
Se um recurso público não estiver presente no servidor de rastreamento ou se o recurso retornar um erro 404, o servidor de rastreamento tentará encontrar o recurso em um dos servidores sobressalentes.
A declaração e a configuração de servidores sobressalentes devem ser feitas no arquivo serverConf.xml do servidor de marketing. Todos os parâmetros disponíveis no serverConf.xml estão listados nesta seção.
Declaração
<redirection>
<spareServer enabledIf="" id="" url=""/>
</redirection>
Configuração
Para cada recurso público que deve ser sincronizado, é necessário adicionar um atributo de status ao elemento <url> na parte <relay>:
O atributo de status pode ter um destes três valores:
-
spare: o recurso público é sincronizado
-
normal: comportamento existente (sem sincronização)
-
incluir na lista de bloqueios blacklist: o URL é adicionado ao arquivo se retornar um erro 404. A duração (em segundos) do URL que está na inclui na lista de bloqueios é definida por um atributo timeout cujo valor padrão é 60s.
A configuração pronta para uso da sincronização é:
(extracted from the serverConf.xml file)
<redirection P3PCompactPolicy="CAO DSP COR CURa DEVa TAIa OUR BUS IND UNI COM NAV"
databaseId="" defLogCount="30" expirationURL="" maxJobsInCache="100"
startRedirection="true" startRedirectionInModule="true" trackWebVisitors="false" trackingPassword="">
<spareServer enabledIf="" id="1" url=""/>
</redirection>
....
<relay debugRelay="false" forbiddenCharsInAuthority="?#.@/:" forbiddenCharsInPath="?#/"
modDir="index.html" startRelay="false" startRelayInModule="true" timeout="60">
<url IPMask="" deny="" hostMask="" relayHost="true" relayPath="true" status="normal" targetUrl="https://localhost:8080" timeout="" urlPath="/view/*"/>
<url IPMask="" deny="" hostMask="" relayHost="true" relayPath="true" status="blacklist" targetUrl="https://localhost:8080" timeout="" urlPath="*.jsp"/>
<url IPMask="" deny="" hostMask="" relayHost="true" relayPath="true" status="blacklist" targetUrl="https://localhost:8080" timeout="" urlPath="*.jssp"/>
<url IPMask="" deny="" hostMask="" relayHost="true" relayPath="true" status="blacklist" targetUrl="https://localhost:8080" timeout="" urlPath="/webApp/*"/>
<url IPMask="" deny="" hostMask="" relayHost="true" relayPath="true" status="blacklist" targetUrl="https://localhost:8080" timeout="" urlPath="/report/*"/>
<url IPMask="" deny="" hostMask="" relayHost="true" relayPath="true" status="blacklist" targetUrl="https://localhost:8080" timeout="" urlPath="/jssp/*"/>
<url IPMask="" deny="" hostMask="" relayHost="true" relayPath="true" status="normal" targetUrl="https://localhost:8080" timeout="" urlPath="/strings/*"/>
<url IPMask="" deny="" hostMask="" relayHost="true" relayPath="true" status="normal" targetUrl="https://localhost:8080" timeout="" urlPath="/interaction/*"/>
<url IPMask="" deny="" hostMask="" relayHost="true" relayPath="true" status="normal" targetUrl="https://localhost:8080" timeout="" urlPath="/barcode/*"/>
<url IPMask="" deny="" hostMask="" relayHost="false" relayPath="false" status="spare" targetUrl="" timeout="" urlPath="/favicon.*"/>
<url IPMask="" deny="" hostMask="" relayHost="false" relayPath="false" status="spare" targetUrl="" timeout="" urlPath="/*.html"/>
<url IPMask="" deny="" hostMask="" relayHost="false" relayPath="false" status="spare" targetUrl="" timeout="" urlPath="/*.png"/>
<url IPMask="" deny="" hostMask="" relayHost="false" relayPath="false" status="spare" targetUrl="" timeout="" urlPath="/*.jpg"/>
</relay>
Limpeza de dados purging-data
O último estágio do assistente de implantação permite configurar a expurgação automática de dados obsoletos. Os valores são expressos em dias.
Os dados são excluídos automaticamente por meio do fluxo de trabalho Database cleanup. Para obter mais informações sobre como configurar e operar este fluxo de trabalho e detalhes sobre os itens excluídos, consulte este documento.