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 a sua plataforma de engajamento com clientes (CEP). Depois que o 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:
- O Decisioning Studio decide o que enviar e quando enviar
- A sua CEP cuida de como enviar
Escolha a sua CEP
O primeiro passo é escolher qual CEP usar com o Decisioning Studio. Sua escolha afeta a complexidade da configuração e os recursos disponíveis.
CEPs compatíveis
| CEP | 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 CEPs | Personalizada (arquivo de recomendação) | Alta |
Se você já usa a Braze como sua CEP, recomendamos usar a integração nativa da Braze para a experiência de configuração mais fluida.
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 o seu agente usará para orquestração. Você criará 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 de app | Client ID, Client Secret, Authentication Base URI, REST Base URI e SOAP Base URI de um pacote instalado com integração de API servidor-a-servidor. |
| 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ê precisará 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ção:
| 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 precisará construir a integração para ler os arquivos de recomendação e disparar 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 o 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 campanhas separados.
- Quais elementos dinâmicos? Identifique quais partes da sua mensagem o agente vai personalizar (linhas de assunto, CTAs, ofertas, horários, etc.). Esses se tornarão propriedades de disparo de API ou placeholders dinâmicos.
Configurações de reelegibilidade
Suas campanhas devem permitir que os usuários recebam mensagens várias vezes:
- Para testes, você vai querer enviar a mesma campanha para o mesmo usuário repetidamente
- Em produção, o agente pode determinar que a mesma campanha é ideal para um usuário em dias consecutivos
Embora a configuração de reelegibilidade seja necessária para testes, os agentes do Decisioning Studio são projetados para respeitar limites de frequência e não enviarão a mesma campanha 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 o seu agente vai otimizar. Essas se tornam propriedades de disparo de API que passam valores dinâmicos para as suas campanhas:
| 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 a sua CEP abaixo 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 estará disponível para ajudar):
Etapa 1: Criar uma chave de API
Acesse Settings > API Keys e crie uma nova chave com as seguintes permissões:
| Permissão | Finalidade | Necessário? |
|---|---|---|
/users/track |
Atualiza os 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 segmento selecionado. | ✓ |
/users/export/ids |
Recupera uma lista de identificadores ao direcionar usuários usando um external_id em vez de um segmento. Como o Decisioning Studio não aceita Informações Pessoais Identificáveis (IPI), você precisará garantir que seu fields_to_export parâmetro retorne apenas campos não-IPI. |
|
Somente se estiver usando external_ids |
||
/messages/send |
Envia variantes recomendadas no momento recomendado usando Campanhas API que estão configuradas para o experimentador do Decisioning Studio. | ✓ |
/campaigns/list |
Recupera a lista de campanhas ativas e extrai o conteúdo de e-mail disponível para experimentação. | ✓ |
/campaigns/data_series |
Exporta dados agregados da campanha para ativar relatórios, validação e solução de problemas no Decisioning Studio, para que você possa comparar valores de relatórios e analisar a performance 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 campanhas 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 do canva para geração de relatórios e validação, especialmente quando a BAU é orquestrada por meio do canva. Embora não seja obrigatória, essa permissão é recomendada. |
|
/canvas/details |
Recupera conteúdo HTML, linha de assunto e recursos de imagem de canvase existentes para experimentação. | ✓ |
/segments/list |
Recupera todos os segmentos existentes como potenciais públicos-alvo para o experimentador do Decisioning Studio. | ✓ |
/segments/data_series |
Exporta informações sobre o tamanho do segmento, que são exibidas no Decisioning Studio ao selecionar um público. | ✓ |
/segments/details |
Recupera detalhes do segmento, como critérios de entrada e saída, para ajudar a entender as mudanças no tamanho ou no desempenho do público. | |
/templates/email/create |
Cria cópias de modelos HTML básicos selecionados com espaços reservados dinâmicos (Braze liquid tags) para experimentação, evitando alterações nos originais. | ✓ |
/templates/email/update |
Envia atualizações para cópias de modelo criadas no Decisioning Studio quando os critérios de experimentação mudam, como chamadas para ação. | ✓ |
/templates/email/info |
Recupera informações sobre modelos criados no Decisioning Studio na sua instância do Braze. | ✓ |
/templates/email/list |
Valida que os modelos foram copiados com sucesso para 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 decisão pode usar para orquestrar mensagens. Um agente de decisão pode ter 1 modelo base ou vários; nesse caso, escolher o modelo base certo para cada cliente será uma das decisões que o agente personaliza.
Etapa 3: Configurar 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 campanha mais de uma vez por dia, você vai querer ter a capacidade de enviar as mesmas campanhas várias vezes ao dia para fins de teste.
Etapa 4: Adicionar placeholders dinâmicos
Esses 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 ficar assim:
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 suporte a 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 etapas detalhadas sobre como configurar a integração com o SFMC, siga as instruções do SFMC na documentação do Decisioning Studio Go.
Configurar integrações com outras CEPs
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 pode disparar comunicações diretamente.
Nesse cenário, o agente entregará 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:
Práticas recomendadas
Tenha estas práticas recomendadas 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 Campaign, IDs de modelo, chaves de API e outros identificadores. Você precisará consultá-los no portal do Decisioning Studio.
- Coordene com a 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 inclui o envio de mensagens e a coleta de dados de engajamento e conversão que ajudam o seu agente a aprender. Consulte Preparar seus dados para mais detalhes.
Próximas etapas
Após configurar a orquestração, prossiga para projetar o seu agente: