DocumentaçãoCampaignDocumentação do Campaign Classic v7

Arquitetura de mensagens transacionais transactional-messaging-architecture

Last update: Thu Sep 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

As mensagens transacionais dependem de uma arquitetura específica, composta por várias instâncias:

  • Uma instância de controle, na qual os modelos de mensagem são criados.

  • Uma ou mais instâncias de execução, que recebem eventos e entregam mensagens.

Instância de controle
Instância de execução

Os usuários do Adobe Campaign fazem logon na instância de controle para:

  • Criar modelos de mensagem transacional
  • Gerar a pré-visualização da mensagem usando uma lista de seed
  • Exibir relatórios
  • Monitorar as instâncias de execução

As instâncias de execução estão aqui para:

  • Receber eventos
  • Vinculá-los a modelos de mensagem transacional
  • Enviar uma mensagem personalizada para cada destinatário

Instalar instâncias installing-instances

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.

IMPORTANT
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. Para obter mais informações, consulte Adicionar um canal de entrega.

Instância de controle control-instance

Para instalar a instância de controle em sua máquina, selecione o pacote Transactional message control por meio do menu Tools > Advanced > Import package. Para obter mais informações, consulte Instalação de pacotes padrão do Campaign Classic.

As etapas detalhadas para configurar a instância de controle são apresentadas nesta seção.

Suporte a várias instâncias de controle supporting-several-control-instances

IMPORTANT
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.

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

Instância de execução execution-instance

Para instalar uma instância de execução em sua máquina, selecione o pacote Transactional message execution por meio do menu Tools > Advanced > Import package. Para obter mais informações, consulte Instalação de pacotes padrão do Campaign Classic.

As etapas detalhadas para configurar uma instância de execução são apresentadas nesta seção.

Canais de entrega disponíveis

O canal de email está disponível por padrão. Para enviar mensagens transacionais em vários canais, você pode adicionar outros canais (canal móvel, canal de aplicativo móvel etc.).

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

Adicionar um canal de entrega adding-a-delivery-channel

A Adobe recomenda sempre adicione o pacote de canal de entrega 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.

NOTE
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, como, por exemplo, o Canal móvel, por meio do assistente de importação de pacotes (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 da entrega 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).

Notificações por push transacionais transactional-messaging-and-push-notifications

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.

NOTE
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>
NOTE
A criação de templates de mensagem permanece igual.

Mensagens transacionais e LINE transactional-messaging-and-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 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 serviço LINE, consulte esta seção.

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.

      note note
      NOTE
      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 da conta do banco de dados externo na instância de execução.

  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ê pode começar a criar mensagens transacionais.

recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1