Configurar orquestração

Os agentes de decisão precisam se conectar a uma plataforma de engajamento com clientes (CEP) para orquestrar comunicações depois de ingerir dados de clientes e personalizar em nível 1:1. Este artigo aborda o que você precisa preparar e como configurar a integração para cada CEP compatível.

O que é orquestração?

A orquestração é a conexão entre o Decisioning Studio Pro e a sua plataforma de engajamento com clientes (CEP). Depois que seu agente de decisão determina a ação ideal para cada cliente, a orquestração executa essas decisões, disparando comunicações personalizadas pela sua CEP.

Pense assim:

• Decisioning Studio Pro decide o que enviar e quando enviar
• Sua CEP cuida de como enviar

Escolha sua CEP

A primeira etapa é escolher qual CEP usar com o Decisioning Studio Pro. Sua escolha afeta a complexidade da configuração e os recursos disponíveis.

CEPs compatíveis

Dica

Se você já usa a Braze como sua CEP, use a integração nativa da Braze para ter a experiência de configuração mais simples.

Pré-requisitos

Antes de configurar a orquestração, reúna os itens a seguir de acordo com a CEP escolhida.

• braze
• salesforce marketing cloud
• outras ceps

Planeje suas Campaigns

Antes de configurar a orquestração, considere os seguintes detalhes:

Modelos base

Um modelo base é qualquer modelo de mensagem que seu agente de decisão possa usar. Considere:

• Quantos modelos? Seu agente pode trabalhar com um ou vários modelos. Se houver vários, o agente pode personalizar qual modelo cada cliente recebe.
• Quais canais? E-mail, push, SMS ou uma combinação deles. Cada canal pode exigir modelos e Campaigns separados.
• Quais elementos dinâmicos? Identifique quais partes da sua mensagem o agente personaliza (como linhas de assunto, CTAs, ofertas e horário de envio). Esses elementos se tornam propriedades de acionamento da API ou espaços reservados dinâmicos.

Configurações de reelegibilidade

Suas Campaigns devem permitir que os usuários recebam mensagens várias vezes:

• Durante os testes, você envia a mesma Campaign para o mesmo usuário repetidamente
• Em produção, o agente pode determinar que a mesma Campaign é a ideal para um usuário em dias consecutivos

Nota

Mesmo com a reelegibilidade configurada para testes, os agentes do Decisioning Studio Pro respeitam os limites de frequência e não enviam a mesma Campaign para um usuário mais de uma vez por dia em produção.

Propriedades de acionamento da API

Para integrações com a Braze, planeje quais dimensões seu agente otimiza. Elas se tornam propriedades de acionamento da API que passam valores dinâmicos para suas Campaigns:

Configuração da integração

Selecione sua CEP nesta lista para começar a configurar a integração.

• braze
• salesforce marketing cloud
• other ceps

Configurar a integração com a Braze

Siga estas etapas para integrar um agente do Decisioning Studio Pro com a orquestração na Braze (a equipe de serviços da Braze está disponível para ajudar):

Etapa 1: Criar uma chave de API

Acesse Configurações > Chaves de API e crie uma nova chave com as seguintes permissões:

Permissão	Finalidade	Obrigatória?
/users/track	Atualiza atributos personalizados nos perfis de usuário, além de criar perfis de usuário temporários ao usar envios de teste.	✓
/users/delete	Exclui perfis de usuário temporários que foram criados durante o uso de envios de teste.	Somente para envios de teste
/users/export/segment	Atualiza as comunicações de público disponíveis todas as manhãs, exportando a lista de usuários de cada Segment selecionado.	✓
/users/export/ids	Recupera uma lista de identificadores ao direcionar usuários usando um external_id em vez de um Segment. Como o Decisioning Studio não aceita Informações Pessoais Identificáveis (IPI), você precisará garantir que o parâmetro fields_to_export retorne apenas campos que não sejam IPI.	Somente se estiver usando external_ids
/messages/send	Envia variantes recomendadas no momento recomendado usando Campaigns da API configuradas para o experimentador do Decisioning Studio.	✓
/campaigns/list	Recupera a lista de Campaigns ativas e extrai o conteúdo de e-mail disponível para experimentação.	✓
/campaigns/data_series	Exporta dados agregados de Campaigns para possibilitar relatórios, validação e solução de problemas no Decisioning Studio, permitindo comparar valores de relatórios e analisar o desempenho de referência. Embora não seja obrigatória, essa permissão é recomendada.
/campaigns/details	Recupera conteúdo HTML, linha de assunto e recursos de imagem de Campaigns existentes para experimentação.	✓
/canvas/list	Recupera a lista de Canvas ativos para extrair o conteúdo de e-mail disponível para experimentação.	✓
/canvas/data_series	Exporta dados agregados de Canvas para geração de relatórios e validação, especialmente quando o BAU é orquestrado por meio de Canvas. Embora não seja obrigatória, essa permissão é recomendada.
/canvas/details	Recupera conteúdo HTML, linha de assunto e recursos de imagem de Canvas existentes para experimentação.	✓
/segments/list	Recupera todos os Segments existentes como potenciais públicos-alvo para o experimentador do Decisioning Studio.	✓
/segments/data_series	Exporta informações sobre o tamanho do Segment, que são exibidas no Decisioning Studio ao selecionar um público.	✓
/segments/details	Recupera detalhes do Segment, como critérios de entrada e saída, para ajudar a entender mudanças no tamanho ou no desempenho do público.
/templates/email/create	Cria cópias de modelos HTML básicos selecionados com placeholders dinâmicos (Liquid tags da Braze) para experimentação, evitando alterações nos originais.	✓
/templates/email/update	Envia atualizações para cópias de modelos criadas pelo Decisioning Studio quando os critérios de experimentação mudam, como chamadas para ação.	✓
/templates/email/info	Recupera informações sobre modelos criados pelo Decisioning Studio na sua instância da Braze.	✓
/templates/email/list	Valida que os modelos foram copiados com sucesso para a sua instância da Braze.	✓

Etapa 2: Configurar Campaigns disparadas por API

Configure uma Campaign disparada por API para cada modelo base, com propriedades de disparo da API para todas as dimensões otimizadas.

Um modelo base é qualquer modelo que o agente do Decisioning possa usar para orquestrar mensagens. Um agente do Decisioning pode ter um ou vários modelos base. Nesse caso, escolher o modelo base certo para cada cliente é uma das decisões que o agente personaliza.

Etapa 3: Configurar a reelegibilidade

Confira se todas as Campaigns disparadas por API permitem que os usuários se tornem reelegíveis em até 15 minutos.

Nota

Embora o agente do Decisioning Studio Pro nunca envie a mesma Campaign mais de uma vez por dia, é bom poder enviar as mesmas Campaigns várias vezes ao dia para fins de teste.

Etapa 4: Adicionar placeholders dinâmicos

Eles funcionam como placeholders dinâmicos para as decisões que o agente do Decisioning Studio Pro está otimizando.

Exemplo 1: Campaign de e-mail

Suponha que o agente do Decisioning Studio Pro esteja otimizando uma Campaign de e-mail. Ela pode ser configurada assim:

Se o agente estiver otimizando a escolha de modelos e a mensagem de chamada para ação (CTA), crie uma Campaign disparada por API para cada modelo. A seção de CTA de um modelo pode ficar assim:

Exemplo 2: Campaign de push

Suponha que um agente do Decisioning Studio Pro esteja otimizando a mensagem de uma Campaign de push. Ela pode ser configurada assim:

O resultado é a seguinte mensagem:

Exemplo 3: Campaign de SMS

Suponha que o agente do Decisioning Studio Pro esteja otimizando campos de uma Campaign de SMS. Ela pode ser configurada assim:

O resultado é a seguinte mensagem:

Configurar a integração com o SFMC

O Decisioning Studio Pro oferece integração nativa com o Salesforce Marketing Cloud. O Decisioning Studio Pro dispara eventos de API em uma jornada com os dados necessários para preencher os elementos dinâmicos.

Importante

Na sua configuração, os IDs de API devem ser inseridos em letras maiúsculas. Isso inclui IDs de jornada, IDs de campanha e quaisquer outros identificadores. Se os IDs de API forem inseridos em letras minúsculas, mas seus dados do SFMC contiverem UUIDs em maiúsculas, os filtros de eventos não vão corresponder e as métricas dos relatórios não serão preenchidas corretamente.

Configurar integrações com outras CEPs

O Decisioning Studio Pro pode se integrar a qualquer plataforma de engajamento com clientes. No entanto, isso pode exigir algum trabalho de engenharia personalizado da sua equipe, já que o Decisioning Studio Pro não consegue disparar comunicações diretamente.

Nesse cenário, o agente entrega um “arquivo de recomendação”. Esse arquivo contém uma linha para cada cliente, com colunas que indicam todas as decisões personalizadas para esse cliente.

Por exemplo, o seguinte arquivo de recomendação:

Pode ser usado para otimizar uma campanha de e-mail como esta:

Práticas recomendadas

Lembre-se destas práticas recomendadas ao se preparar para a orquestração:

1. Comece com um escopo restrito: No início, use um canal e um ou dois modelos. Você pode expandir depois, à medida que descobrir o que funciona.
2. Teste bem: Antes de lançar, teste sua integração com um pequeno grupo de usuários para verificar se o conteúdo dinâmico é preenchido corretamente.
3. Documente sua configuração: Registre os IDs de campanha, IDs de modelo, chaves de API e outros identificadores. Você vai precisar deles como referência no portal do Decisioning Studio Pro.
4. Coordene com sua equipe: A configuração da orquestração pode envolver as equipes de marketing, engenharia e dados. Garanta que todos entendam seu papel no processo.
5. Planeje os dados de feedback: A orquestração envia mensagens e coleta os dados de engajamento e conversão que ajudam seu agente a aprender. Consulte Prepare seus dados para saber mais.

Próximas etapas

Depois de configurar a orquestração, siga para o design do seu agente:

• Criar agentes de decisão