Implantação de uma instância

Assistente de implantação

Um assistente gráfico, disponível no console do cliente Adobe Campaign, permite que você defina os parâmetros da instância à qual você se conectará.

Para start do assistente de implantação, selecione Ferramentas > Avançado > Assistente de implantação.

As etapas de configuração são as seguintes:

1. Parâmetros gerais
2. Parâmetros de canal de email
3. Gerenciamento de emails salvos
4. Configuração de rastreamento
5. Parâmetros do canal móvel
6. Configurações regionais
7. Acesso através da Internet
8. Gerenciamento de recursos públicos
9. Expurgando dados

Parâmetros gerais

A primeira etapa do assistente de implantação permite que você insira informações gerais sobre a instância.

Informações gerais

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 string de caracteres com o nome da empresa. Essas informações podem ser usadas nos links de unsubscription.
• Namespace : Insira um identificador curto em minúsculas. O objetivo é distinguir entre a configuração específica e a configuração de fábrica no caso de uma atualização. A namespace padrão é cus - para o cliente.

Opções técnicas

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 o delivery de e-mail. Consulte Parâmetros do canal de email.
• Tracking : Para ativar o rastreamento da população do público alvo (abre e clica). Consulte Configuração de rastreamento.
• Managing bounced emails : Para definir a conta POP usada para coletar e-mails de entrada. Consulte Gerenciar e-mails enviados.
• LDAP integration : Para configurar a autenticação do usuário por meio de um diretório LDAP. Consulte Ligar através do LDAP.

Parâmetros de canal de email

A etapa a seguir permite definir as informações a serem exibidas nos cabeçalhos de 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

Indique os seguintes parâmetros:

• Sender name : Nome do remetente,
• Sender address : O endereço do remetente,
• Reply address text : O nome, que é personalizável, que será usado quando o recipient clicar no Reply botão em seu software cliente de e-mail,
• Reply address : O endereço de email a ser usado quando o recipient clicar no Reply botão em seu software cliente de email,
• Error address : Endereço de email das mensagens com erros. Este é o endereço técnico usado para lidar com emails de rejeição, incluindo emails recebidos pelo servidor Adobe Campaign devido a endereços de público alvo inexistentes.

Além disso, você pode especificar as máscaras autorizadas para o endereço do remetente e o endereço do erro. Se necessário, essas máscaras podem ser separadas por vírgulas. Essa configuração é opcional. Quando os campos são inseridos, a 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 acionar problemas de delivery. Os endereços dos delivery devem ser configurados no servidor do delivery.

Caracteres autorizados em endereços

No banco de dados Adobe Campaign, todos os endereços de email devem ser criados da seguinte forma: x@y.z. Os caracteres x, y e z não devem estar vazios e não devem incluir caracteres não autorizados.

É possível 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 no banco de dados por meio da interface, por meio de um formulário da Web e também ao importar dados.

Duas listas estão disponíveis: Apenas europeu ou Apenas EUA. Outros caracteres podem ser adicionados, se necessário.

Parâmetros do delivery

Os parâmetros avançados…O link permite que você acesse opções de delivery, parâmetros vinculados a tentativas e quarentenas.

Essa janela permite que você defina, para todas as campanhas de e-mail, as opções de gerenciamento de qualidade de delivery e endereço.

As seguintes opções estão disponíveis:

• Delivery duration of messages : Além desse tempo, o delivery é parado (por padrão, 5 dias),
• Online resources validity duration : Tempo durante o qual são mantidas as informações do perfil do recipient para gerar mirrores page,
• Exclude recipients who no longer wish to be contacted : Quando essa opção for selecionada, não será lista de bloqueios contato com recipient de ,
• Automatically ignore doubles : Quando essa opção for selecionada, o delivery não será feito para endereços de duplicado.

Repetir parâmetros

As informações sobre recuperações são fornecidas nos campos Períodos de recuperação e Número de recuperações: quando um recipient é inacessível, por exemplo, se sua caixa de entrada estiver cheia, por padrão o programa tentará contatá-los 5 vezes, com um intervalo de uma hora entre cada tentativa (durante o tempo máximo do delivery). Esses valores podem ser alterados de acordo com suas necessidades.

Parâmetros de quarentena

As opções de configuração para quarentena 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 for atingido, o endereço de email será 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 dos próximos deliveries.

Gerenciamento de emails enviados

O e-mail de rejeição é extremamente importante para qualificar erros de delivery. Esses erros são classificados no diretório NP@I depois que as regras determinarem sua causa.

Esta etapa só estará disponível se as opções de gerenciamento canal de e-mail e Rejeitar e-mail estiverem selecionadas na primeira etapa do assistente de implantação. Consulte Parâmetros gerais.

Esta etapa permite definir configurações para gerenciar e-mails de rejeição.

Conta POP usada para recuperar emails recebidos

Indique os parâmetros a serem conectados à conta para recuperar emails recebidos.

• Label : Nome que inclui todos os parâmetros abaixo indicados,
• Server : Servidor utilizado para recuperar correio de rejeição (correio de entrada),
• Security : Se necessário, selecione SSL na lista suspensa,
• Port : porta do servidor (geralmente 110),
• Account : Nome da conta usada para o correio de rejeição,
• Password : Senha associada à conta.

Depois que as configurações de POP forem especificadas, clique em Testar para verificar se estão corretas.

Mensagens de rejeição não processadas

As rejeições são feitas automaticamente pela Adobe Campaign, aplicando as regras listadas no nó Administração > Gestão de campanha > Gerenciamento de não entregas > qualificação de log de Delivery. Para obter mais informações, consulte Gerenciamento de e-mails de rejeição.

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 esse 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 apenas as mensagens de erro que o processo do InMail não pôde qualificar.
• SMTP server : Servidor usado para enviar emails de rejeição não processados.

Rastreamento da configuração

A próxima etapa permite configurar o rastreamento para a instância. A instância deve ser declarada e registrada com os servidores de rastreamento.

Esta etapa só é oferecida quando as opções canal de e-mail 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 o rastreamento da Web (modo de rastreamento, criação e inserção de tags…), consulte este documento.

Princípio operacional

Quando você ativa o rastreamento em uma instância, os URLs nos delivery são alterados durante o envio para ativar o rastreamento.

• As informações sobre URLs externos (seguras 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, do recipient e do URL.

  As informações de rastreamento são coletadas pela Adobe Campaign nos servidores de rastreamento para enriquecer os perfis dos recipient e os dados vinculados ao delivery ( Tracking guias).

  As informações sobre URLs internos só são usadas pelo servidor de aplicativos Adobe Campaign para entrar em contato com os servidores 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 estar registrada nos servidores de rastreamento.

  Para obter mais informações, consulte Salvando o rastreamento.

Servidor de rastreamento

Para garantir a eficiência do rastreamento nesta instância, as seguintes informações devem ser exibidas:

• External URL e/ou Secure external URL : Insira o URL de redirecionamento a ser usado no email a ser enviado.

• Internal URL(s) : URLs usados apenas pelo servidor Adobe Campaign para entrar em contato com os servidores de rastreamento para coletar registros e fazer upload dos 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 do Mid-sourcing, você pode externalizar o gerenciamento de rastreamento. Para fazer isso:

1. Selecione a opção Externalize tracking management : isso permite que você use um servidor mid-sourcing como um servidor de rastreamento.

2. Preencha os campos External account e Instance name para se conectar ao servidor mid-sourcing.

   Para obter mais informações, consulte Mid-sourcing server.

3. Clique no botão Enable the tracking instance para aprovar a conexão com o servidor.

   

Salvando rastreamento

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.

Existem três tipos possíveis de arquitetura para implementar o rastreamento:

1. 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 internal no(s) servidor(es) de redirecionamento para configurar a instância de rastreamento.

   OBSERVAÇÃO

   Se vários servidores de rastreamento forem usados, todos devem usar o mesmo nome e senha.

   Especifique o nome da instância e a senha.

2. Criar uma nova instância dedicada ao rastreamento

   Essa opção é útil quando instâncias de rastreamento são reservadas para rastreamento e não têm outros módulos de aplicativo.

   

   Digite a senha da conta internal no(s) servidor(es) de redirecionamento para configurar a instância de rastreamento.

   OBSERVAÇÃO

   Se vários servidores de rastreamento estiverem configurados, todos devem usar a mesma senha.

   Especifique o nome da instância, a senha e quaisquer máscaras de DNS associadas, como Campaign*.

3. Validar uma instância de rastreamento já pré-configurada para você

   Esta opção é usada quando você não tem a senha para a conta internal; Nesse caso, uma conta de rastreamento é pré-configurada para você nos servidores de rastreamento. Digite 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 a ser validada.

Clique em Aprovar para start o processo de gravação ao servidor de rastreamento.

Na 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 a Adobe.

Parâmetros do canal móvel

A próxima etapa permite definir as configurações padrão de delivery para dispositivos móveis (SMS e Push WAP).

Conta padrão para o delivery SMS

Insira a seguinte informação:

• Label : Insira um nome para esta conta SMS/Wap Push. Por exemplo, você pode desejar usar o nome do roteador.
• Para os campos Server, Port, Account, Password, Connector, Send Endpoint, Reception Endpoint, Notification Endpoint: Entre em contato com seu provedor de serviço para obter as configurações necessárias.

Parâmetros de SMS enviados

Na lista suspensa Priority: Selecione "Normal", "Alto" ou "Urgente" para aplicá-lo às mensagens a serem enviadas.

Parâmetros avançados

Os parâmetros avançados…O link permite que você acesse as opções de nova tentativa e quarentena.

As informações sobre o tentativas estão disponíveis nos campos Período do tentativas e Número de tentativas: Quando um dispositivo móvel é inacessível, por padrão, o programa tentará novamente 5 vezes em intervalos de pelo menos 15 minutos (para o período máximo do delivery). Esses valores podem ser adaptados às suas necessidades.

As opções de configuração para quarentena são as seguintes:

• Time between two significant errors : Digite 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 : Quando esse valor for atingido, o número de dispositivos móveis será 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 delivery futuros.

Configurações regionais

Essa etapa 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 é então obrigatório, pois o número de dígitos não será verificado antes de aplicar a formatação). Se essa opção não estiver selecionada, você deve prefixar o número de telefone internacional com "+" ou "00".
• Store all phone numbers using the international format : Esta opção só diz respeito aos números de telefone ​​doméstico importados ou editados. Defina se deseja usar um formato interno (como 425 555 0150) ou o formato internacional (por exemplo, +1 425 555 0150)

Acesso da 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 relacionadas aos Formulários web.

Servidores expostos na Web

Use esta página para preencher os URLs do servidor para:

1. Acesse o servidor de aplicativos exposto na Internet: Formulários de subscrição/unsubscription, extranet etc.

2. Acesse o servidor de aplicativos para obter recursos não expostos na Web: formulários, intranet, páginas de confirmação.

3. Acesse os mirrores page dos delivery.

   Um mirror page é uma página dinâmica que exibe o conteúdo do email. Ele é acessado por meio de um link inserido na mensagem enviada ao recipient e pode conter elementos personalizados. O mirror page oferece ao recipient a possibilidade de ler a mensagem em um navegador da Internet em vez do software de e-mail, independentemente do formato do delivery (texto ou HTML). No entanto, os mirrores page só são gerados para um determinado delivery se o conteúdo HTML necessário tiver sido definido.

A Adobe Campaign permite diferenciar esses três URLs para distribuir a carga por várias plataformas.

Gerenciando recursos públicos

Para serem vistas de fora, as imagens usadas em e-mails e recursos públicos vinculados a campanhas devem estar presentes em um servidor acessível externamente. Eles podem então estar disponíveis para recipient ou operadores externos.

Para esta etapa, é necessário inserir:

1. O novo URL do recurso público. Para obter mais informações, consulte a seção URL Recursos públicos.
2. O modo de detecção de imagem em um delivery. Para obter mais informações, consulte a seção Detecção de imagem de Delivery.
3. Opções de publicação. Para obter mais informações, consulte a seção Modos de publicação.

Os recursos públicos são acessíveis pelo nó Administração > Recursos > Online > Recursos públicos da árvore do Adobe Campaign. Eles são coletados em uma biblioteca e podem ser incluídos em e-mails, mas também usados em campanhas ou tarefas e na gestão de conteúdo.

URL de recursos públicos

O primeiro campo permite que você especifique o start do URL usado para os recursos após o upload. Quando carregados, os recursos são acessíveis por meio desse novo URL.

Em um delivery, você pode usar imagens armazenadas na biblioteca de recursos públicos ou qualquer outra imagem ou imagem local armazenada em um servidor.

• Para imagens de email, o URL https:// server /res/img.

  Esse valor pode ser substituído para cada delivery.

• Para recursos públicos, o URL https:// server /res/ instance ​, em que instance​é o nome da instância de rastreamento.

Detecção de imagem de delivery

Em um delivery, você pode usar imagens armazenadas na biblioteca de recursos públicos ou qualquer outra imagem ou imagem local armazenada em um servidor.

O campo máscaras de URL permite que você especifique a lista de máscaras de URL a serem ignoradas ao carregar imagens automaticamente. Por exemplo, se você usar imagens que estão armazenadas em um site acessível do lado de fora, em particular em um site da Internet, poderá digitar o URL do site neste campo.

É possível especificar várias máscaras de URL usando uma vírgula para separá-las.

• Para obter informações sobre como usar e gerenciar imagens em emails, consulte esta seção.
• No assistente do delivery, as imagens chamadas desses URLs terão o status "Ignorado".

Modos de publicação

A seção inferior do assistente permite que você selecione as opções de publicação de recursos públicos e imagens. Essas opções também estão disponíveis para Formulários web e pesquisas.

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 estão configurados na etapa Configuração de rastreamento.

• Outros servidores Adobe Campaign

  Você pode usar mais um servidor Adobe Campaign onde os recursos serão copiados.

  No lado do servidor, para usar um servidor Adobe Campaign dedicado, é necessário criar uma nova instância com o seguinte comando:

  nlserver config -addtrackinginstance:<trackingA>/<trackingA*>
  

  Em seguida, insira a senha.

  Os parâmetros dos servidores dedicados 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:

  • Você deve criar este script: Seu conteúdo depende da sua configuração.

  • O script será chamado pelo seguinte comando:

    [INSTALL]/copyToFrontal.vbs "$(XTK_INSTALL_DIR)\var\<instance>\upload\" "img1,img2,img3"
    

    em que [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 pela 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 evento de publicação em um servidor Adobe Campaign sem um script de publicação manual, por padrão, as imagens de um delivery são armazenadas em $(XTK_INSTALL_DIR)/var/res/img/ directory. O URL correspondente é o seguinte: https://server/res/img.

XTK_INSTALL_DIR)/var/res/$(INSTANCE_NAME). O URL correspondente é o seguinte: https://server/res/instance onde instância é o nome da instância de rastreamento.

Sincronizando recursos públicos

Essa funcionalidade permite sincronizar 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á localizar o recurso em um dos servidores sobressalentes.

A declaração e configuração de servidores sobressalentes devem ser feitas no arquivo serverConf.xml do servidor de marketing. Todos os parâmetros disponíveis em serverConf.xml estão listados nesta seção.

Declaração

<redirection>
<spareServer enabledIf="" id="" url=""/>
</redirection>

Configuração

Para cada recurso público que precisa ser sincronizado, é necessário adicionar um atributo de status ao elemento <url> na parte <relay>:

O atributo status pode ser um dos três valores:

• sobressalente: O recurso público está sincronizado

• normal: Comportamento existente (sem sincronização)

• lista negra: O URL será adicionado à lista de bloqueios se retornar um erro 404. A duração (em segundos) do URL que está na lista de bloqueios é definida por um atributo timeout cujo valor padrão é 60s.

A configuração predefinida 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/*?lang=pt-BR"/>
      <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/*?lang=pt-BR"/>
      <url IPMask="" deny="" hostMask="" relayHost="true" relayPath="true" status="blacklist" targetUrl="https://localhost:8080" timeout="" urlPath="/report/*?lang=pt-BR"/>
      <url IPMask="" deny="" hostMask="" relayHost="true" relayPath="true" status="blacklist" targetUrl="https://localhost:8080" timeout="" urlPath="/jssp/*?lang=pt-BR"/>
      <url IPMask="" deny="" hostMask="" relayHost="true" relayPath="true" status="normal" targetUrl="https://localhost:8080" timeout="" urlPath="/strings/*?lang=pt-BR"/>
      <url IPMask="" deny="" hostMask="" relayHost="true" relayPath="true" status="normal" targetUrl="https://localhost:8080" timeout="" urlPath="/interaction/*?lang=pt-BR"/>
      <url IPMask="" deny="" hostMask="" relayHost="true" relayPath="true" status="normal" targetUrl="https://localhost:8080" timeout="" urlPath="/barcode/*?lang=pt-BR"/>

      <url IPMask="" deny="" hostMask="" relayHost="false" relayPath="false" status="spare" targetUrl="" timeout="" urlPath="/favicon.*?lang=pt-BR"/>
      <url IPMask="" deny="" hostMask="" relayHost="false" relayPath="false" status="spare" targetUrl="" timeout="" urlPath="/*.html?lang=pt-BR"/>
      <url IPMask="" deny="" hostMask="" relayHost="false" relayPath="false" status="spare" targetUrl="" timeout="" urlPath="/*.png?lang=pt-BR"/>
      <url IPMask="" deny="" hostMask="" relayHost="false" relayPath="false" status="spare" targetUrl="" timeout="" urlPath="/*.jpg?lang=pt-BR"/>

 </relay>

Expurgando dados

A última etapa do assistente de implantação permite configurar a remoçã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 de limpeza do Banco de Dados. Para obter mais informações sobre como configurar e operar esse fluxo de trabalho e detalhes sobre os itens excluídos, consulte este documento.