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?
Orquestração é a conexão entre o Decisioning Studio e 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 por meio da sua CEP.
Pense da seguinte forma:
- Decisioning Studio decide o que enviar e quando enviar
- Sua CEP cuida de como enviar
Escolha sua plataforma de engajamento com clientes
A primeira etapa é escolher qual plataforma de engajamento com clientes usar com o Decisioning Studio. Sua escolha afeta a complexidade da configuração e os recursos disponíveis.
Plataformas de engajamento com clientes compatíveis
| Plataforma | Tipo de integração | Complexidade da configuração |
|---|---|---|
| Braze | Integração nativa via API (recomendada) | Baixa |
| Salesforce Marketing Cloud | Eventos de API + Journey Builder | Média |
| Outras plataformas | Personalizada (arquivo de recomendação) | Alta |
Se você já usa a Braze como sua plataforma de engajamento com clientes, recomendamos usar a integração nativa da Braze para a experiência de configuração mais simples.
Pré-requisitos
Antes de configurar a orquestração, reúna os itens a seguir com base na CEP escolhida.
| Requisito | Descrição |
|---|---|
| Chave da API REST | Uma nova chave de API com permissões para dados de usuários, mensagens, Campaigns, Canvas, Segments e modelos. |
| URL do dashboard da Braze | A URL da sua instância da Braze (por exemplo, https://dashboard-01.braze.com). |
| ID do app | A chave de API associada ao app que você deseja rastrear (encontrada em Configurações > Configurações do app). |
| Nome de exibição e endereço de e-mail | As informações do remetente a serem usadas nas suas campanhas (encontradas em Configurações > Preferências de e-mail). |
| Modelos base | Os modelos de mensagem que seu agente usa para orquestração. Você cria Campaigns disparadas por API para cada modelo. |
| ID do usuário teste | Um ID de usuário para testar a integração antes do lançamento. |
| Requisito | Descrição |
|---|---|
| Credenciais do pacote do app | Client ID, Client Secret, Authentication Base URI, REST Base URI e SOAP Base URI de um pacote instalado com integração de API server-to-server. |
| Permissões de API | Escopos para canais, ativos, automações, jornadas, contatos, extensões de dados e eventos de rastreamento. |
| Extensões de dados | Você precisa de extensões de dados para dados de assinantes, dados de engajamento e recomendações. |
| Modelos de e-mail | Os modelos que você deseja que o Decisioning Studio use, com IDs de modelo para cada um. |
| Acesso ao Journey Builder | Acesso para criar e ativar jornadas de múltiplas etapas com fontes de entrada de eventos de API. |
Se você está usando uma CEP diferente da Braze ou do Salesforce Marketing Cloud, o Decisioning Studio pode se integrar por meio de uma abordagem de arquivo de recomendações:
| Item | Descrição |
|---|---|
| Capacidade de ingestão de dados | Sua CEP deve ser capaz de ingerir arquivos de recomendação (normalmente CSV ou JSON) contendo decisões personalizadas para cada cliente. |
| Suporte a conteúdo dinâmico | Suas campanhas devem suportar o preenchimento de campos dinamicamente com base nos dados de recomendação. |
| Recursos de engenharia personalizados | Sua equipe precisa construir a integração para ler os arquivos de recomendação e disparar as comunicações. |
Planeje suas campanhas
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 pode usar. Considere:
- Quantos modelos? Seu agente pode trabalhar com um modelo ou vários. Se forem vários, o agente pode personalizar qual modelo cada cliente recebe.
- Quais canais? E-mail, push, SMS ou uma combinação. 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, timing). Esses se tornam propriedades de disparo de API ou placeholders dinâmicos.
Configurações de reelegibilidade
Suas Campaigns devem permitir que os usuários recebam mensagens várias vezes:
- Para testes, você envia a mesma Campaign para o mesmo usuário repetidamente
- Em produção, o agente pode determinar que a mesma Campaign é ideal para um usuário em dias consecutivos
Ao configurar a reelegibilidade para testes, os agentes do Decisioning Studio são projetados para respeitar 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 disparo de API
Para integrações com a Braze, planeje quais dimensões seu agente otimiza. Essas se tornam propriedades de disparo de API que passam valores dinâmicos para suas Campaigns:
| Exemplo de dimensão | Propriedade de disparo de API |
|---|---|
| Linha de assunto | {{api_trigger_properties.${subject_line}}} |
| Call to action | {{api_trigger_properties.${cta_message}}} |
| Oferta | {{api_trigger_properties.${offer_id}}} |
| Valor do desconto | {{api_trigger_properties.${discount}}} |
Configuração da integração
Selecione sua plataforma de engajamento com clientes nesta lista para começar a configuração da integração.
Configurar a integração com a Braze
Siga estas etapas para integrar um agente do Decisioning Studio com os recursos de orquestração da 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, para que você possa comparar valores de relatórios e analisar o desempenho de base. 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 de API para todas as dimensões otimizadas.
Um modelo base é qualquer modelo que o agente de Decisioning pode usar para orquestrar mensagens. Um agente de Decisioning pode ter 1 modelo base ou vários. Nesse caso, escolher o modelo base certo para cada cliente é uma das decisões que o agente personaliza.
Etapa 3: Configurar a reelegibilidade
Certifique-se de que todas as Campaigns disparadas por API permitam que os usuários se tornem reelegíveis em até 15 minutos.
Embora o agente do Decisioning Studio nunca envie a mesma Campaign mais de uma vez por dia, é importante ter a capacidade de enviar as mesmas Campaigns várias vezes ao dia para fins de teste.
Etapa 4: Adicionar placeholders dinâmicos
Eles servem como placeholders dinâmicos para as decisões que o agente do Decisioning Studio está otimizando.
Exemplo 1: Campaign de e-mail
Suponha que o agente do Decisioning Studio esteja otimizando uma Campaign de e-mail. A configuração pode ser assim:
Supondo que o agente esteja otimizando a escolha de modelos e a mensagem de Call to Action (CTA), uma Campaign disparada por API deve ser criada para cada modelo, e a seção de CTA de um modelo pode ter esta aparência:
Exemplo 2: Campaign de push
Suponha que um agente do Decisioning Studio esteja otimizando a mensagem de uma Campaign de push. A configuração pode ser assim:
Resultando na seguinte mensagem:
Exemplo 3: Campaign de SMS
Suponha que o agente do Decisioning Studio esteja otimizando campos em uma Campaign de SMS. A configuração pode ser assim:
Resultando na seguinte mensagem:
Configurar a integração com o SFMC
O Decisioning Studio oferece integração nativa com o Salesforce Marketing Cloud. O Decisioning Studio dispara eventos de API em uma jornada com os dados necessários para preencher elementos dinâmicos.
Para sua configuração, os IDs de API devem ser inseridos em letras maiúsculas. Isso inclui IDs de jornada, IDs de Campaign e quaisquer outros identificadores. Se os IDs de API forem inseridos em letras minúsculas, mas os dados do seu SFMC contiverem UUIDs em maiúsculas, os filtros de eventos não corresponderão e as métricas de relatório não serão preenchidas corretamente.
Configurar integrações com outras plataformas de engajamento
O Decisioning Studio pode se integrar com qualquer plataforma de engajamento com clientes. No entanto, isso pode exigir algum trabalho de engenharia personalizado da sua equipe, já que o Decisioning Studio não consegue disparar comunicações diretamente.
Nesse cenário, o agente entrega um “arquivo de recomendação”. Esse arquivo contém linhas para cada cliente, com colunas que indicam todas as decisões personalizadas para aquele cliente.
Por exemplo, o seguinte arquivo de recomendação:
Pode ser usado para otimizar uma Campaign de e-mail com a seguinte aparência:
Boas práticas
Tenha estas boas práticas em mente ao se preparar para a orquestração:
- Comece com um escopo reduzido: Use um canal e um ou dois modelos no início. Você pode expandir depois, conforme aprende o que funciona.
- Teste com cuidado: 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.
- Documente sua configuração: Mantenha um registro dos IDs de Campaigns, IDs de modelos, chaves de API e outros identificadores. Você precisará deles para fazer referência no portal do Decisioning Studio.
- Coordene com sua equipe: A configuração da orquestração pode envolver equipes de marketing, engenharia e dados. Certifique-se de que todos entendam seu papel no processo.
- Planeje os dados de feedback: A orquestração envia mensagens e coleta dados de engajamento e conversão que ajudam seu agente a aprender. Consulte Preparar seus dados para mais detalhes.
Próximas etapas
Após configurar a orquestração, prossiga para projetar seu agente: