Atualizar para o novo servidor de avaliação do delivery

Última atualização em 2023-12-04
  • Tópicos
  • Technote
    Exibir mais informações sobre este tópico
  • Deliverability
    Exibir mais informações sobre este tópico

Iniciando Versão v7.2.2, a Adobe Campaign conta com um novo servidor de entrega que oferece alta disponibilidade e aborda problemas de conformidade de segurança. O Campaign Classic agora sincroniza as regras de capacidade de entrega, broadlogs e o endereço de supressão de e para o novo servidor de capacidade de entrega. O servidor de entrega antigo será descontinuado em 31 de agosto de 2022.

Como cliente do Campaign Classic, você deve implementar o novo servidor de capacidade de entrega antes de 31 de agosto de 2022.

OBSERVAÇÃO

Para obter mais informações sobre essas alterações, consulte o Perguntas frequentes, ou entre em contato com Atendimento ao cliente Adobe.

O que mudou?

A Adobe está desativando data centers mais antigos devido a motivos de conformidade de segurança. Os clientes do Adobe Campaign Classic precisam migrar para o novo serviço de entrega, hospedado no Amazon Web Service (AWS).

Esse novo servidor garante uma alta disponibilidade (99,9)​ e fornece endpoints seguros e autenticados para permitir que os servidores de campanha busquem os dados necessários: em vez de se conectar ao banco de dados para cada solicitação, o novo servidor de capacidade de entrega armazena os dados em cache para atender às solicitações, quando possível. Esse mecanismo melhora o tempo de resposta.​

Você será afetado?

Todos os clientes foram afetados e devem atualizar para Campaign v7.2.2 (ou mais) e implementar seu ambiente para se beneficiar do novo servidor de capacidade de delivery.

Como atualizar?

Como um cliente hospedado, o Adobe trabalhará com você para atualizar suas instâncias para a versão mais recente e criar o projeto no Adobe Developer Console.

Como um cliente no local/híbrido, é necessário atualizar para Campaign v7.2.2 (ou mais) para se beneficiar do novo servidor de capacidade de entrega. Depois que todas as instâncias forem atualizadas, você deverá implementar a nova integração para o servidor de deliverability Adobe e garantir uma transição contínua.

Etapas de implementação

AVISO

Essas etapas só devem ser executadas para implementações híbridas e no local.

Como parte da nova integração do servidor de entrega, o Campaign precisa se comunicar com o Adobe Shared Services por meio de uma autenticação baseada no Identity Management Service (IMS). A maneira preferida é usar o Gateway Token baseado em Adobe Developer (também chamado de Technical Account Token ou Adobe IO JWT).

DISPONIBILIDADE

O JWT (Tokens JSON da Web) está atualmente em processo de descontinuação, sendo substituído pelo OAuth. A transição será realizada progressivamente nas próximas versões do Campaign e a documentação será atualizada para refletir essas atualizações.

Pré-requisitos

Antes de iniciar a implementação, verifique a configuração da instância.

  1. Abra o console do cliente Campaign e faça logon no Adobe Campaign como administrador.

  2. Navegue até Administração > Plataforma > Opções.

  3. Verifique se DmRendering_cuid o valor da opção está preenchido.

    • Se a opção estiver preenchida, é possível iniciar a implementação.
    • Se nenhum valor for preenchido, entre em contato com Atendimento ao cliente Adobe para obter seu CUID.

    Essa opção deve ser preenchida em todas as instâncias do Campaign (MKT, MID, RT, EXEC) com o valor correto. Como um cliente híbrido, entre em contato com o Adobe para ter a opção definida em suas instâncias MID, RT e EXEC.

Como cliente local, você também deve verificar se uma campanha Product profile O está disponível para sua organização da. Para fazer isso, siga as etapas abaixo:

  1. Como Administrador, conecte-se Adobe Admin Console.

  2. Acesse o Produtos e serviços seção e verificar Adobe Campaign está listado.
    Se você não conseguir ver Adobe Campaign contato Atendimento ao cliente Adobe para adicioná-lo.

  3. Clique em Adobe Campaign e selecione sua organização.
    Cuidado: se você tiver mais de uma organização, selecione a correta. Saiba mais sobre Organizações nesta página.

  4. Verifique se um Product profile existe. Caso contrário, crie-o. Nenhuma permissão é necessária para este Product profile.

ATENÇÃO

Como cliente local, se um firewall estiver implementado em seu lado, você deverá adicionar esse url https://deliverability-service.adobe.io para a sua inclui na lista de permissões. Saiba mais.

Etapa 1: criar/atualizar seu projeto do Adobe Developer

  1. Access Console do Adobe Developer e faça logon com o Acesso de desenvolvedor da sua organização. Verifique se você está conectado ao portal correto da organização.
    Cuidado: se você tiver mais de uma organização, selecione a correta. Saiba mais sobre Organizações nesta página.

  2. Selecione Create new project.

    ATENÇÃO

    Se você já estiver usando a funcionalidade de autenticação JWT do Adobe IO para outra integração, como conector do Analytics ou acionadores de Adobe, será necessário atualizar o projeto adicionando API do Campaign para esse projeto.

  3. Escolher Add API.

  4. Na janela Add an API, selecione Adobe Campaign.

  5. Se a ID do cliente estiver vazia, selecione Generate a key pair para criar um par de chaves público e privado.

    As chaves serão baixadas automaticamente com uma data de expiração padrão de 365 dias. Depois de expirar, você precisará criar um novo par de chaves e atualizar a integração no arquivo de configuração. Usando a Opção 2, você pode optar por criar e fazer upload manualmente da Public key com uma data de expiração mais longa.

    ATENÇÃO

    Você deve salvar o config.zip arquivo quando o prompt de download aparecer, pois você não poderá baixá-lo novamente.

  6. Clique em Next.

  7. Escolha qualquer Product profile existente ou crie um novo, se necessário. Nenhuma permissão é necessária para este Product profile. Para obter mais informações sobre Product Profiles, consulte esta página.

    Em seguida, clique em Save configured API.

  8. Em seu projeto, selecione Adobe Campaign e copie as seguintes informações em Service Account (JWT)

    • Client ID
    • Client Secret
    • Technical account ID
    • Organization ID
ATENÇÃO

O certificado do Adobe Developer expirará após 12 meses. Você precisa gerar um novo par de chaves todo ano.

Etapa 2: adicionar as credenciais do projeto no Adobe Campaign

A chave privada deve ser codificada no formato base64 UTF-8.

Para fazer isso:

  1. Use a chave privada gerada nas etapas acima.

  2. Codifique a chave privada usando o seguinte comando: base64 ./private.key > private.key.base64. Isso salvará o conteúdo base64 em um novo arquivo private.key.base64.

    OBSERVAÇÃO

    Às vezes, uma linha extra pode ser adicionada automaticamente ao copiar/colar a chave privada. Lembre-se de removê-la antes de codificar sua chave privada.

  3. Copie o conteúdo do arquivo private.key.base64.

  4. Faça logon via SSH em cada container em que a instância do Adobe Campaign está instalada e adicione as credenciais do Projeto no Adobe Campaign executando o comando a seguir como usuárioneolane. Isso inserirá as credenciais Technical Account no arquivo de configuração da instância.

    nlserver config -instance:<instance name> -setimsjwtauth:Organization_Id/Client_Id/Technical_Account_ID/<Client_Secret>/<Base64_encoded_Private_Key>
    
  5. Você deve interromper e reiniciar o servidor para que a modificação seja considerada. Você também pode executar um config -reload comando.

Etapa 3: validar sua configuração

Para verificar se a integração foi bem-sucedida, siga as etapas abaixo:

  1. Abra o console do cliente e faça logon no Adobe Campaign.
  2. Navegue até Administração > Produção > Workflows técnicos.
  3. Reinicie o Atualizar para entregabilidade (deliverabilityUpdate). Isso deve ser executado em todas as instâncias do Campaign (MKT, MID, RT, EXEC). Como um cliente híbrido, entre em contato com o Adobe para reiniciar o fluxo de trabalho nas instâncias MID, RT e EXEC.
  4. Verificar logs: o workflow deve ser executado sem erros.
ATENÇÃO

Após a atualização, a variável Atualização da rede seed para renderização da caixa de entrada (updateRenderingSeeds) o workflow deve ser interrompido, pois não será mais aplicado e falhará.

Perguntas frequentes

Qual é a linha do tempo da atualização?

A transição para o novo servidor de entrega, permitindo a adição desses recursos aprimorados e reforçando a segurança, começará em 22 de julho para os clientes hospedados (Campaign Managed Services). Todos os clientes hospedados serão atualizados até o final de agosto.

Os clientes no local e híbridos devem fazer a transição durante o mesmo período.

O que acontece se eu não atualizar meu ambiente?

Qualquer instância do Campaign não atualizada até 31 de agosto não poderá mais se conectar ao servidor de avaliação do delivery do Campaign. Em consequência, a Atualizar para entregabilidade (deliverabilityUpdate) falhará, e isso afetará sua capacidade de delivery.

Se você não atualizar seu ambiente, as configurações de email deixarão de ser sincronizadas (regras de Gerenciamento MX, regras de Email de entrada, regras de Gerenciamento de domínio e regras de qualificação de rejeição). Isso pode afetar com o tempo sua capacidade de delivery. Se uma alteração significativa for feita nessas regras, elas terão de ser aplicadas manualmente a partir deste ponto.

Para instâncias MKT, somente Lista de supressão global é afetada.

Nesta página