Configuração de ações externas
As ações externas permitem que as jornadas de conta no Journey Optimizer B2B edition se conectem a sistemas externos diretamente da tela de jornada. Quando um público-alvo de conta atinge um nó de ação externa, o sistema faz uma chamada de saída assíncrona para um serviço externo configurado, transmitindo dados de atributos de público-alvo para contas, pessoas ou ambos. O serviço externo processa os dados e responde usando um retorno de chamada, retornando os dados e os metadados do público-alvo que podem ser usados para orientar a execução da jornada.
Esse recurso oferece suporte a dois tipos de nó do jornada:
- Ação externa - Chama um serviço externo e continua ao longo de um único caminho de saída. Ideal para disparar e esquecer integrações, como a atualização de um registro CRM ou o acionamento de uma notificação downstream.
- Caminhos divididos externos - Chama um serviço externo e avalia a resposta para rotear contas ao longo de um dos vários caminhos definidos.
Visão geral da implementação
A criação de ações externas exige coordenação entre três funções em sequência:
Implementar o serviço externo implement-service
O desenvolvedor deve criar e publicar um serviço Web voltado para o público que esteja em conformidade com a Interface do Provedor de Serviços de Ações Externas do Adobe Journey Optimizer B2B edition.
Depois que o serviço estiver ativo, forneça o URL para a especificação OpenAPI e as credenciais de autenticação ao administrador do produto responsável pela configuração da ação.
Configurar a ação configure-action
Uma ação deve ser configurada e ativada antes que os profissionais de marketing possam usá-la em uma jornada. As ações são criadas no estado Rascunho e suas alterações são salvas automaticamente. Permanece como rascunho até que você o ative.
-
Vá para Administração > Configurações.
-
Clique em Ações Externas no painel intermediário.
-
Clique em Criar ação na parte superior direita.
-
Insira a URL para a especificação OpenAPI do seu serviço externo e clique em Criar.
note note NOTE Seu serviço externo deve estar ativo e acessível para que esta etapa seja bem-sucedida. -
Quando a URL for resolvida com êxito, revise os Detalhes do serviço.
Os detalhes do serviço são lidos diretamente da especificação OpenAPI quando a ação é criada. Não é possível alterar essas propriedades na configuração após a criação.
table 0-row-3 1-row-3 2-row-3 3-row-3 Propriedade Descrição Propriedade de especificação OpenAPI Nome Nome da ação info.titleDescrição Descrição da ação info.descriptionURL URL da especificação OpenAPI que define o serviço externo servers.url -
Insira as credenciais de Autenticação para o serviço externo (
components.securitySchemes).note note NOTE Os campos de credencial exibidos dependem do mecanismo de autenticação definido no serviço externo. Os tipos compatíveis são Chave de API, OAuth2 e Autenticação básica de HTTP. 
Você pode alterar as credenciais conforme necessário quando a ação configurada estiver no status Rascunho ou Ativo.
-
Clique em Next.
-
Defina as propriedades Configurações para definir como a ação troca dados com o serviço externo.
note note NOTE As propriedades marcadas como Estáticas não são atualizáveis no momento da configuração e se baseiam na definição do serviço. -
Tipo de ação (Estática) - O tipo de nó de jornada com suporte:
- Ação externa (
enableSplitPath= falso) - Caminho dividido da ação externa (
enableSplitPath= verdadeiro)
Não é possível alterar o tipo de ação após criar a configuração da ação.
- Ação externa (
-
Acessadores (Estático) - (Somente caminho dividido de ação externa) As variáveis retornadas pelo serviço externo para estarem disponíveis como condições de caminho em um nó de caminho dividido externo. (
invocationPayloadDef.accessorsMetadata) -
Contexto de Jornada (Estático) - O escopo dos dados de público enviados na solicitação (
supportedEntityType):-
Conta - Envia somente contas
-
Pessoas - Envia somente pessoas
-
Pessoas na Conta - Envia contas e pessoas relacionadas à conta
-
-
Campos de Saída - Mapeie cada campo da tabela para um campo XDM. Esses campos são enviados no corpo da solicitação para o serviço externo. Propriedades de definição de serviço:
invocationPayloadDef.accountFields,invocationPayloadDef.fields.
-
Campos de Entrada - Mapeie cada campo da tabela para um campo XDM atualizável. Esses campos são preenchidos a partir da resposta do serviço externo. Propriedades de definição de serviço:
callbackPayloadDef.accountFields,callbackPayloadDef.fields. Atualizável após a criação. -
Parâmetros de cabeçalho - Insira um valor para cada linha a ser transmitida como um cabeçalho HTTP na solicitação. Propriedade de definição de serviço:
invocationPayloadDef.headers. -
Tempo limite - Insira o número de minutos para aguardar o serviço externo invocar o retorno de chamada antes que a solicitação seja considerada com falha. Propriedade de definição de serviço:
timeout. -
Atributos globais - Insira um valor para cada linha a ser incluída como um campo estático no corpo da solicitação. Propriedade de definição de serviço:
invocationPayloadDef.globalAttributes.
-
-
Clique na Seta para trás para retornar à lista e manter a ação no estado Rascunho.
Ou clique em Ativar para alterar a configuração da ação para o estado Ativo. A ação externa configurada deve estar ativa para torná-la disponível para uso nas jornadas da conta.
Adicionar um nó externo a uma jornada add-journey-node
Após a ativação de uma ação, os profissionais de marketing podem adicionar um nó Ação externa ou Caminho dividido externo a qualquer jornada de conta. Para obter informações sobre como adicionar e usar esses nós na tela de jornada da conta, consulte Nós externos.