Show Menu
TÓPICOS×

Configuração de pipeline

Parâmetros de autenticação, como a ID do cliente, a chave privada e o terminal de autenticação, são configurados nos arquivos de configuração da instância. A lista de acionadores a serem processados é configurada em uma opção. Está no formato JSON. O acionador é processado imediatamente usando o código Javascript. Ele é salvo em uma tabela de banco de dados sem nenhum processamento adicional em tempo real. Os acionadores são usados para segmentação por um fluxo de trabalho de campanha que envia emails. A campanha é configurada para que um cliente que tenha ambos eventos de disparo receba um e-mail.

Pré-requisitos

O uso Experience Cloud Triggers na Campanha requer:
  • Adobe Campaign versão 6.11 build 8705 ou posterior.
  • Adobe Analytics Ultimate, Premium, Foundation, OD, Select, Prime, Mobile Apps, Select ou Standard.
As configurações de pré-requisito são:
  • Criação de um arquivo de chave privada e, em seguida, a criação do aplicativo oAuth registrado com essa chave.
  • Configuração dos acionadores no Adobe Analytics.
A configuração do Adobe Analytics está fora do escopo deste documento.
O Adobe Campaign exige as seguintes informações da Adobe Analytics:
  • O nome do aplicativo oAuth.
  • O IMSOrgId, o identificador do cliente do Experience Cloud.
  • Os nomes dos acionadores configurados no Analytics.
  • O nome e o formato dos campos de dados a serem reconciliados com o banco de dados de Marketing.
Parte dessa configuração é um desenvolvimento personalizado e requer o seguinte:
  • Conhecimento de trabalho da análise JSON, XML e Javascript no Adobe Campaign.
  • Conhecimento prático das APIs QueryDef e Writer.
  • Noções de trabalho de criptografia e autenticação usando chaves privadas.
Como a edição do código JS requer habilidades técnicas, não tente sem a compreensão adequada.
Os acionadores são salvos em uma tabela do banco de dados. Dessa forma, os dados de disparo podem ser usados com segurança pelos operadores de marketing em workflows de direcionamento.

Arquivos de autenticação e configuração

A autenticação é necessária, pois o Pipeline está hospedado na Adobe Experience Cloud. Se o servidor de marketing estiver hospedado no local, quando fizer logon no Pipeline, ele deverá ser autenticado para ter uma conexão segura. Usa um par de chaves públicas e privadas. Esse processo tem a mesma função que um usuário/senha, apenas mais seguro.

IMSOrgId

O IMSOrgId é o identificador do cliente na Adobe Experience Cloud. Defina-o no arquivo serverConf.xml da instância, sob o atributo IMSOrgId. Exemplo:
<redirection IMSOrgId="C5E715(…)98A4@AdobeOrg" (…)

Geração de chaves

A chave é um par de arquivos. Está no formato RSA e com 4096 bytes de comprimento. Ele pode ser gerado com uma ferramenta de código aberto, como OpenSSL. Cada vez que a ferramenta é executada, uma nova chave é gerada aleatoriamente. Por uma questão de conveniência, as etapas são listadas abaixo:
  • openssl genrsa -out <private_key.pem> 4096
  • openssl rsa -pubout -in <private_key.pem> -out <public_key.pem>
Exemplo de arquivo private_key.pem:
----BEGIN RSA PRIVATE KEY----
MIIEowIBAAKCAQEAtqcYzt5WGGABxUJSfe1Xy8sAALrfVuDYURpdgbBEmS3bQMDb
(…)
64+YQDOSNFTKLNbDd+bdAA+JoYwUCkhFyvrILlgvlSBvwAByQ2Lx
----END RSA PRIVATE KEY----

Exemplo de arquivo public_key.pem:
----BEGIN PUBLIC KEY----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtqcYzt5WGGABxUJSfe1X
(…)
EwIDAQAB
----END PUBLIC KEY----

As chaves não devem ser geradas pelo PuttyGen, o OpenSSL é a melhor opção.

Criação de clientes Auth na Adobe Experience Cloud

Um aplicativo do tipo JWT precisa ser criado fazendo logon no Adobe Analytics na conta correta da organização em Admin > User Management > Legacy Oath application .
Siga estas etapas:
  1. Selecione o Service Account (JWT Assertion) .
  2. Insira o Application Name .
  3. Registre o Public key .
  4. Selecione o acionador Scopes .
  5. Clique em Create e marque o Application ID e Application Secret crie.

Registro do nome do aplicativo no Adobe Campaign Classic

O ID da aplicação do cliente oAuth criado deve ser configurado no Adobe Campaign. Você pode fazer isso editando o arquivo de configuração da instância no pipelined elemento, especificamente o atributo appName.
Exemplo:
<pipelined autoStart="true" appName="applicationID" authPrivateKey="@qQf146pexBksGvo0esVIDO(…)"/>

Criptografia de chave

Para ser usada por pipelined, a chave privada deve ser criptografada. A criptografia é feita usando a função cryptString Javascript e deve ser executada na mesma instância pipelined.
Uma amostra da criptografia de chave privada com JavaScript está disponível nesta página .
A chave privada criptografada deve estar registrada no Adobe Campaign. Você pode fazer isso editando o arquivo de configuração da instância no pipelined elemento, especificamente o atributo authPrivateKey.
Exemplo:
<pipelined autoStart="true" appName="applicationID" authPrivateKey="@qQf146pexBksGvo0esVIDO(…)"/>

start automático do processo implantado

O pipelined processo deve ser iniciado automaticamente. Para fazer isso, defina o elemento no arquivo de configuração como autostart="true":
<pipelined autoStart="true" appName="applicationID" authPrivateKey="@qQf146pexBksGvo0esVIDO(…)"/>

Reinicialização do processo implantado

Também pode ser iniciado manualmente usando a linha de comando:
nlserver start pipelined@instance

É necessário reiniciar para que as alterações entrem em vigor:
nlserver restart pipelined@instance

Em caso de erros, procure por erros na saída padrão (se você tiver iniciado manualmente) ou no arquivo de pipelined log. Consulte a seção Solução de problemas deste documento para obter mais informações sobre como resolver problemas.

Opções de configuração implantadas

Opção
Descrição
appName
ID do aplicativo OAuth (ID da aplicação) registrado no Adobe Analytics (onde a chave pública foi carregada): Admin > Gerenciamento de usuários > Aplicativo legado de juramento. Refer to this  section .
authGatewayEndpoint
URL para obter "tokens de gateway".
Padrão: https://api.omniture.com
authPrivateKey
Chave privada (peça pública carregada no Adobe Analytics (consulte esta seção). AES criptografado com a opção XtkSecretKey: xtk.session.EncryptPassword("PRIVATE_KEY");
disableAuth
Desabilitar autenticação (a conexão sem tokens de gateway é aceita somente por alguns pontos de extremidade do Pipeline de desenvolvimento)
discoverPipelineEndpoint
URL para descobrir o ponto de extremidade de Serviços de Pipeline a ser usado para este locatário. Padrão: https://producer-pipeline-pnw.adobe.net
dumpStatePeriodSec
O período entre 2 despejos do estado interno do processo em var/INSTANCE/pipelined.jsonção interna também está acessível sob demanda em http://INSTANCE/pipelined/status (porta 7781).
forcedPipelineEndpoint
Desative a descoberta do PipelineServicesEndpoint e force-a
monitorServerPort
O pipelined processo escuta essa porta para fornecer o estado interno do processo em http://INSTANCE/pipelined/status (porta 7781).
pointerFlushMessageCount
Quando esse número de mensagens é processado, os deslocamentos são salvos no banco de dados. O padrão é 1000
pointerFlushPeriodSec
Após esse período, os deslocamentos serão salvos no banco de dados. O padrão é 5 (segundos)
processingJSThreads
Número de mensagens de processamento de threads dedicados com conectores JS personalizados. O padrão é 4
processingThreads
Número de mensagens de processamento de threads dedicados com código incorporado. O padrão é 4
retryPeriodSec
Atraso entre tentativas (se houver erros de processamento). O padrão é 30 (segundos)
retryValiditySec
Descarte a mensagem se ela não for processada com êxito após esse período (muitas tentativas). O padrão é 300 (segundos)