v7 v8

Configuração de pipeline

Parâmetros de autenticação, como ID do cliente, chave privada e ponto de acesso de autenticação, são configurados nos arquivos de configuração da instância.
A lista de acionadores que serão processados é configurada em uma opção em formato JSON.
Os acionadores são usados para direcionamento por um fluxo de trabalho de campanha que envia emails. A campanha é configurada para que um cliente que tenha ambos os eventos de acionador receba um email.

Pré-requisitos

Antes de iniciar esta configuração, verifique se você está usando:

• No mínimo, uma das seguintes builds do Adobe Campaign:
  • 19.1.8.9039
  • 19.1.4.9032 - Gold Standard 11
  • 20.2.4.9187
  • 20.3.1
• Versão do Adobe Analytics Standard

Você também precisará de:

• Autenticação de projeto do Adobe I/O
• um ID de organização válido - Para encontrar seu ID de organização, consulte esta página
• um Acesso de desenvolvedor para sua organização
• configuração de acionadores efetuada no Adobe Analytics

Arquivos de autenticação e configuração

A autenticação é necessária, pois o pipeline está hospedado na Adobe Experience Cloud.
Ele usa um par de chaves públicas e privadas. Esse processo tem a mesma função de um usuário/senha, porém é mais seguro.
A autenticação é compatível com a Marketing Cloud por meio do Projeto do Adobe I/O.

Etapa 1: Criar/atualizar projeto do Adobe I/O

Para clientes hospedados, você pode criar um tíquete de atendimento ao cliente para habilitar sua organização com tokens de conta técnica do Adobe I/O para a integração do Triggers.

Para clientes locais, consulte a página Configuração do Adobe I/O para o Adobe Experience Cloud Triggers. Observe que é necessário selecionar Adobe Analytics ao adicionar a API à credencial do Adobe I/O.

Etapa 2: configurar a opção de pipeline NmsPipeline_Config

Depois que a autenticação for definida, o pipeline recuperará os eventos. Ele processará somente acionadores configurados no Adobe Campaign. O acionador deve ter sido gerado pelo Adobe Analytics e enviado para o pipeline que processará somente acionadores configurados no Adobe Campaign.
A opção também pode ser configurada com um curinga para capturar todos os acionadores independentemente do nome.

1. No Adobe Campaign, acesse o menu de opções em Administration > Platform > Options no Explorer.

2. Selecione a opção NmsPipeline_Config.

3. No campo Value (long text), você pode colar o seguinte código JSON, que especifica dois acionadores. Remova os comentários.

   {
   "topics": [ // list of "topics" that the pipelined is listening to.
      {
           "name": "triggers", // Name of the first topic: triggers.
           "consumer": "customer_dev", // Name of the instance that listens.  This value can be found on the monitoring page of Adobe Campaign.
           "triggers": [ // Array of triggers.
               {
                   "name": "3e8a2ba7-fccc-49bb-bdac-33ee33cf02bf", // TriggerType ID from Analytics
                   "jsConnector": "cus:triggers.js" // Javascript library holding the processing function.
               }, {
                   "name": "2da3fdff-13af-4c51-8ed0-05802a572e94", // Second TriggerType ID
                   "jsConnector": "cus:triggers.js" // Can use the same JS for all.
               },
           ]
       }
   ]
   }
   

4. Você também pode optar por colar o seguinte código JSON, que captura todos os acionadores.

   {
   "topics": [
     {
       "name": "triggers",
       "consumer":  "customer_dev",
       "triggers": [
         {
           "name": "*",
           "jsConnector": "cus:pipeline.js"
         }
       ]
     }
   ]
   }
   

O parâmetro do consumidor

O pipeline funciona com um modelo de fornecedor e consumidor. As mensagens são consumidas somente para um consumidor individual: cada consumidor recebe sua própria cópia das mensagens.

O parâmetro consumidor identifica a instância como um desses consumidores. A identidade da instância chamará o pipeline. Você pode preenchê-lo com o nome da instância que pode ser encontrado na página Monitoramento do console do cliente.

O serviço de pipeline rastreia as mensagens recuperadas por cada consumidor. Usar consumidores diferentes para instâncias diferentes permite que você se certifique de que cada mensagem seja enviada para cada instância.

Recomendações da opção de pipeline

Para configurar a opção Pipeline, siga estas recomendações:

• Adicione ou edite acionadores em Triggers. Você não deve editar o restante.
• Verifique se o JSON é válido. Você pode usar um Validador de JSON, consulte este site para obter um exemplo.
• “name” corresponde à ID do acionador. Um curinga “*” capturará todos os acionadores.
• “Consumidor” corresponde ao nome da instância chamadora ou do aplicativo.
• Pipeline também aceita o tópico “aliases”.
• Você sempre deve reiniciar o pipeline depois de fazer alterações.

Etapa 3: configuração opcional

Você pode alterar alguns parâmetros internos de acordo com seus requisitos de carga, mas certifique-se de testá-los antes de colocá-los em produção.

A lista de parâmetros opcionais pode ser encontrada abaixo:

Início automático do processo de pipeline

O processo por pipeline precisa ser iniciado automaticamente.

Para fazer isso, defina o elemento < pipelined > no arquivo de configuração como autostart="true":

 <pipelined autoStart="true" ... "/>

Reinicialização do processo de pipeline

É necessário reiniciar para que as alterações entrem em vigor:

nlserver restart pipelined@instance

Etapa 4: validação

Para validar a configuração do pipeline para provisionamento, siga as etapas abaixo:

• Certifique-se de que o processo pipelined esteja em execução.
• Verifique se há logs de conexão de pipeline no pipelined.log.
• Verifique a conexão e se os pings foram recebidos. Os clientes hospedados podem usar o monitoramento no console do cliente.

Recursos do Business.Adobe.com