Arquitetura de mensagens transacionais

Sobre as instâncias de execução e de controle

No Adobe Campaign, os recursos de mensagens transacionais (também conhecidos como Centro de mensagens) foram projetados para oferecer suporte à escalabilidade e um serviço 24 horas por dia, 7 dias por semana. Ele é composto por várias instâncias:

  • uma instância de controle, onde os templates de mensagem são criados,
  • uma ou mais instâncias de execução que recebem eventos e entregam mensagens.

Para usar esses recursos, os usuários do Adobe Campaign fazem logon na instância de controle para criar templates de mensagem transacional, gerar a pré-visualização da mensagem usando uma lista de propagação, exibir relatórios e monitorar instâncias de execução.

As instâncias de execução recebem eventos, os vinculam a templates de mensagem transacional e enviam uma mensagem personalizada para cada recipient.

Suporte a várias instâncias de controle

IMPORTANTE

O compartilhamento de um cluster de execução com várias instâncias de controle só é compatível com ambientes locais.

É possível compartilhar um cluster de execução entre várias instâncias de controle. Por exemplo, se você gerenciar várias lojas especializadas, será possível configurar uma instância de controle por marca e vinculá-las para o mesmo cluster de execução.

OBSERVAÇÃO

Para obter mais informações sobre a configuração necessária, consulte Uso de várias instâncias de controle.

Instalação de instâncias

Deve-se tomar várias precauções ao instalar os pacotes de mensagens transacionais. A Adobe recomenda que você trabalhe em um ambiente de teste antes de colocá-los em produção. Você também precisará ter uma licença compatível com Adobe Campaign. Para obter mais informações, entre em contato com o executivo da sua conta Adobe.

IMPORTANTE

A instância de controle e a instância de execução devem ser instaladas em máquinas diferentes. Elas não podem compartilhar a mesma instância do Campaign.

Se precisar usar vários canais, instale e configure pacotes relacionados antes de instalar pacotes de mensagens transacionais. Consulte Inclusão um canal de delivery.

  • Para instalar a instância de controle em uma máquina, selecione o módulo Transactional message control.

  • Para instalar a instância de execução em uma máquina, selecione o módulo Transactional message execution.

Adição de um canal de delivery

A adição de um canal de delivery (canal móvel, canal de aplicativo móvel, etc.) deverá ser executada antes de instalar o pacote de mensagem transacional.

A Adobe recomenda que você sempre adicione o pacote do canal do delivery antes de instalar o pacote de mensagem transacional.

No entanto, se iniciou um projeto de mensagens transacionais no canal de email e, durante o projeto, decidiu adicionar um novo canal, você pode seguir as etapas abaixo.

OBSERVAÇÃO

Esse procedimento só se aplica a clientes que usam um Windows NLServer instalado na mesma máquina em que estão trabalhando.

  1. Instale o canal necessário, por exemplo, o Canal móvel, por meio do assistente de importação de pacote (Tools > Advanced > Import package… > Adobe Campaign Package ).

  2. Faça uma importação de arquivo (Tools > Advanced > Import package… > File) e selecione o arquivo **datakitnms **[Your language]packagemessageCenter.xml.

  3. No XML content of the data to import, mantenha somente o template do delivery que corresponde ao canal adicionado. Por exemplo, se o Canal móvel foi adicionado, mantenha somente o elemento de entidades que corresponde ao Mobile transactional message (smsTriggerMessage). Caso tenha adicionado o Canal de aplicativo móvel, mantenha somente a mensagem transacional do iOS (iosTriggerMessage) e a mensagem transacional do Android (androidTriggerMessage).

Mensagens transacionais e notificações por push

Quando combinado com o módulo de canal de Aplicativo móvel, as mensagens transacionais permitem que você envie mensagens transacionais por meio de notificações em dispositivos móveis.

OBSERVAÇÃO

O canal de Aplicativo Móvel é detalhado nesta seção.

Para usar módulos de mensagem transacional com o Canal de aplicativo móvel, você precisará aplicar as seguintes configurações:

  1. Instale o pacote Canal de aplicativo móvel nas instâncias de controle e de execução.
  2. Replique o serviço do Adobe Campaign do tipo Aplicativo móvel, bem como os aplicativos móveis que ele contém nas instâncias de execução.

O evento deverá conter os seguintes elementos:

  • A ID do dispositivo móvel (registrationId para Android e deviceToken para iOS). Essa ID representa o "endereço" para o qual a notificação será enviada.
  • O link para o aplicativo móvel ou a chave de integração (uuid) que permite recuperar as informações de conexão específicas do aplicativo.
  • O canal para onde a notificação é enviada (wishedChannel): 41 para iOS e 42 para Android
  • Todos os dados úteis para personalização

Este é um exemplo de um evento que contém essas informações:

<SOAP-ENV:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Body>
     <urn:PushEvent>
         <urn:sessiontoken>mc/</urn:sessiontoken>
         <urn:domEvent>

              <rtEvent wishedChannel="41" type="DELIVERY" registrationToken="2cefnefzef758398493srefzefkzq483974">
                <mobileApp _operation=”none” uuid="com.adobe.NeoMiles"/>
                <ctx>
                    <deliveryTime>1:30 PM</deliveryTime>
                    <url>http://www.adobe.com</url>
                </ctx>
              </rtEvent>

         </urn:domEvent>
     </urn:PushEvent>           
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
OBSERVAÇÃO

A criação de templates de mensagem permanece igual.

Mensagens transacionais e LINE

Combinadas com o Canal LINE, as mensagens transacionais permitem enviar mensagens em tempo real no aplicativo LINE instalado em dispositivos móveis do consumidor. Isso é usado para enviar a mensagem de boas-vindas quando um usuário do LINE adiciona a página da marca.

Para usar o módulo de mensagem transacional com o LINE, os seguintes elementos são necessários para a configuração na sua instância de marketing e na sua instância de execução:

  • Instale o pacote LINE Connect em ambas as instâncias.
  • Instale o pacote Transactional message control na instância de marketing e o pacote Transactional message execution na instância de execução.
  • Cria uma conta externa e o serviço do LINE em ambas as instâncias com nomes idênticos para que sejam sincronizados. Para obter mais informações sobre como criar uma conta externa e o serviço do LINE, consulte esta página.

Em seguida, do Explorer, em External account > Platform, é necessário configurar as contas externas diferentes em ambas as instâncias:

  1. Crie uma conta externa External database na instância de execução com a seguinte configuração:

    • Label e Internal name: nomeie a conta externa conforme necessário.
    • Type : selecione External database.
    • A caixa Enabled deve ser marcada.

    Na categoria Connection:

    • Type: selecione o servidor de banco de dados, por exemplo, PostgresSQL.

    • Server: digite o URL do servidor do banco de dados.

    • Account: digite a conta do banco de dados.

      OBSERVAÇÃO

      O usuário do banco de dados precisa ter direitos de leitura nas seguintes tabelas para conexão FDA: XtkOption, NmsVisitor, NmsVisitorSub, NmsService, NmsBroadLogRtEvent, NmsBroadLogBatchEvent, NmsTrackingLogRtEvent, NmsTrackingLogBatchEvent, NmsRtEvent, NmsBatchEvent, NmsBroadLogMsg, NmsTrackingUrl, NmsDelivery, NmsWebTrackingLogXtkFolder.

    • Password: digite a senha da conta do banco de dados.

    • Database: digite o nome do banco de dados da instância de execução.

    • A caixa Target of an HTTP relay to remote database’s account deve ser marcada.

  2. Crie uma conta External Database na sua instância de marketing com a seguinte configuração:

    • Label e Internal name: nomeie a conta externa conforme necessário.
    • Type : selecione External database.
    • A caixa habilitada deverá estar marcada.

    Na categoria Connection:

    • Type : selecione HTTP relay to remote Database.
    • Server: digite o URL do servidor da campanha da instância de execução.
    • Account: digite a conta usada para acessar a instância de execução.
    • Password: digite a senha da conta usada para acessar a instância de execução.
    • Data Source : digite a seguinte sintaxe nms:extAccount:ID of your external database account in the execution instance.
  3. Crie uma conta externa Execution instance em sua instância de marketing usando a seguinte configuração para criar o workflow de sincronização de dados:

    • Label e Internal name: nomeie a conta externa conforme necessário.
    • Type : selecione Execution instance.
    • A caixa habilitada deverá estar marcada.

    Na categoria Connection:

    • URL: digite o URL da instância de execução.
    • Account: digite a conta usada para acessar a instância de execução.
    • Password: digite a senha da conta usada para acessar a instância de execução.

    Na categoria Account connection method:

    • Method : selecione Federated Data Access (FDA).
    • FDA account: selecione a conta FDA no menu suspenso.
    • Clique no botão Create the archiving workflow.
    • Clique no botão Create data synchronization workflow para criar o workflow de sincronização de dados do LINE.
  4. Agora você poderá começar a criar mensagens transacionais. Para obter mais informações, consulte esta página.

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now