Configure seu agente do Decisioning Studio Go

Este artigo descreve como configurar um agente do Decisioning Studio Go com o fluxo de configuração self-service no dashboard da Braze.

Para uma visão geral de como o Decisioning Studio Go funciona, consulte BrazeAI Decisioning Studio Go. Para confirmar se o seu programa é adequado antes de configurar um agente, consulte Exemplos para o Decisioning Studio Go.

Pré-requisitos

Confirme que você tem os seguintes itens prontos:

• Um Segment para seu público de entrada que não esteja sendo usado ativamente em outro Canvas ou Campaign. Recomendamos um público mínimo de 20.000 usuários. O agente aceita públicos de até 40.000.000 usuários. Públicos menores podem ser usados, mas aprendem mais devagar e mostram um aumento menos confiável.
• Pelo menos um modelo de e-mail.
• O conteúdo das variantes que você quer testar, como linhas de assunto alternativas, chamadas para ação (CTAs) e imagens principais. Você pode criar variantes durante a configuração, mas tê-las prontas agiliza o processo.
• Acesso ao espaço de trabalho com permissões para configurar agentes do AI Decisioning.

Se o seu espaço de trabalho ainda não foi provisionado para o Decisioning Studio Go, a opção de configuração do agente não vai aparecer na guia AI Decisioning. Entre em contato com seu gerente de sucesso do cliente para obter acesso.

Etapa 1: Configure seu agente

1. No dashboard da Braze, acesse a guia AI Decisioning.
2. Selecione Create Agent.
3. Dê ao seu agente um nome que o diferencie dos outros agentes no seu espaço de trabalho. Por exemplo, use “Membros de fidelidade—Engajamento semanal” em vez de “Agente de e-mail”.
4. (Opcional) Adicione uma descrição com o contexto que você ou alguém da sua equipe possa precisar mais tarde. Ela pode incluir a finalidade do agente, o Segment que ele direciona e como o sucesso será medido.

O agente otimiza o criativo do seu e-mail para maximizar o engajamento real, medido pela atividade de cliques relevante por usuário. Os cliques passam por vários filtros de validação independentes, que excluem atividades automatizadas e cliques relacionados a opt-out. Assim, o sinal reflete o interesse real dos clientes, e não apenas o volume bruto de cliques.

Etapa 2: Selecione o público-alvo

Selecione o Segment da Braze para o qual seu agente envia mensagens. Os usuários desse Segment são divididos automaticamente em dois grupos:

• Grupo do Decisioning Studio: Recebe conteúdo de e-mail otimizado por IA. O agente escolhe a melhor combinação de variantes para cada usuário.
• Grupo de controle aleatório: Um grupo de medição permanente que recebe combinações das mesmas opções que você configurou, escolhidas aleatoriamente. Esses envios ocorrem nos dias permitidos, dentro do mesmo cronograma e das mesmas restrições. A única diferença em relação ao grupo do Decisioning Studio é que a escolha é aleatória, e não otimizada por IA. Esse grupo é obrigatório e é por meio dele que o aumento é medido. Os usuários desse grupo continuam recebendo e-mails.

Escolha o tamanho do grupo de controle

A divisão recomendada varia de acordo com o tamanho do seu público. Um público maior consegue medir o aumento com confiabilidade usando um grupo de controle menor. Já um público menor precisa de um grupo proporcionalmente maior para manter a significância estatística. O tamanho mínimo do grupo de controle é 5%.

Tamanho do público	Divisão recomendada (Decisioning Studio / controle aleatório)
20.000 – 100.000	80 / 20
100.000 – 1.000.000	90 / 10
1.000.000 – 40.000.000	95 / 5

Por que um Segment dedicado é importante

Se os usuários do Segment selecionado também recebem mensagens de outros Canvas ou Campaigns, o engajamento observado pelo agente é afetado por essas outras mensagens. O agente não consegue saber se um usuário clicou por causa das decisões dele ou por outro motivo. Um alerta aparece se o Segment selecionado estiver em uso em outro lugar. Você pode prosseguir, mas espere resultados com mais ruído.

Pesquisa de usuários

Use a Pesquisa de usuários para verificar se usuários específicos atendem aos critérios do seu Segment. Isso é útil para validar a definição do seu Segment.

Filtros de público

Os filtros de público não são compatíveis com esta versão. Se você precisar de critérios de direcionamento adicionais, crie um Segment com esses filtros aplicados e, depois, selecione esse Segment como seu público de entrada.

Integração com Canvas existentes

Para usar o Decisioning Studio Go em uma jornada mais ampla:

1. Crie um Segment dedicado para os usuários que devem fazer parte do agente.
2. No seu Canvas, use uma etapa de Atualização de Usuário para adicionar o usuário a esse Segment no momento certo da jornada.
3. Confirme que os usuários saem do Canvas para que, a partir desse ponto, o agente cuide do envio de e-mails para todos do Segment.

Etapa 3: Configurar o cronograma

Determine quando o agente tem permissão para enviar mensagens.

Etapa 3.1: Determinar a frequência de envio

Selecione com que frequência os usuários recebem e-mails desse agente — por exemplo, três vezes por semana. Essa é uma seleção única. O agente não otimiza entre frequências diferentes. Ele escolhe dias e horários dentro da frequência que você definir.

Etapa 3.2: Selecionar os dias da semana

Escolha em quais dias o agente pode enviar mensagens. Você precisa selecionar pelo menos a quantidade de dias que sua frequência exige. Por exemplo, se o agente envia três vezes por semana, selecione pelo menos três dias. Selecionar mais dias dá mais flexibilidade ao agente. O agente otimiza dentro desse conjunto e escolhe os melhores dias para cada usuário. Para ter o máximo de flexibilidade, selecione os sete dias.

Etapa 3.3: Definir o horário de silêncio

Especifique os horários que o agente não deve escolher para um envio. O horário de silêncio usa o fuso local do usuário, e o uso mais comum é bloquear envios tarde da noite e muito cedo pela manhã. Fora do horário de silêncio, o agente agenda os envios nos horários com maior probabilidade de gerar cliques para cada usuário.

O horário de silêncio orienta os horários que o agente escolhe para um envio. Para garantir o bloqueio de envios, defina também o horário de silêncio no nível do espaço de trabalho.

Para públicos em vários fusos horários, o agente prioriza a entrega da mensagem em vez do envio no horário local exato pretendido. Ocasionalmente, uma mensagem pode chegar fora do dia ou da janela de horário pretendidos. Se a maior parte do seu público estiver em uma única região, leve isso em conta ao definir os dias permitidos e o horário de silêncio.

Etapa 3.4: Definir regras de limite de frequência

Suas regras de limite de frequência podem ser aplicadas no nível do agente:

• Aplicar limite de frequência: Impede que o agente envie mensagens a um usuário depois que o limite de frequência dele for atingido. Dependendo de como suas regras estão configuradas, esse limite pode ser aplicado no nível individual do usuário ou no nível geral da conta. Em qualquer caso, as mensagens não são enviadas a esse usuário enquanto o limite estiver atingido.
• Contar para o limite: Escolha se os envios desse agente contam para o limite geral do usuário.

Etapa 4: Adicionar conteúdo e modelos

Defina com o que o agente vai trabalhar:

• Criativos base: Os modelos de e-mail completos. Primeiro, o agente escolhe qual criativo base enviar para cada usuário.
• Componentes criativos: Os elementos específicos dentro de um criativo base, como linha de assunto, CTA e imagem principal, que o agente personaliza para cada usuário.

Você pode criar criativos base de duas formas:

• Usando o criador de e-mail padrão da Braze
• Importando um e-mail de um Canvas ou de uma Campaign existente

Use um único criativo base ou vários. Com um criativo base, o agente personaliza apenas os componentes dentro dele. Com vários criativos base, por exemplo um casual, um formal e um promocional, o agente também escolhe qual criativo base é o mais adequado para cada usuário. O agente também pode escolher entre vários criativos base sem nenhum componente criativo adicional.

Quando você adiciona criativos, o agente cria a própria representação de cada um. Depois, usa esse entendimento para decidir qual conteúdo combina com quais usuários. Opções realmente diferentes entre si ajudam o agente a distinguir os criativos e aprender com eles. Para saber como estruturar sua biblioteca de criativos, consulte Configuração e gerenciamento de criativos.

Etapa 4.1: Marcar pontos de personalização com Liquid tags

Para cada componente que você quer que o agente personalize, substitua o conteúdo estático do seu criativo base por uma Liquid tag do menu de personalização. Em seguida, informe as opções de variantes na seção Componentes criativos.

Os componentes compatíveis nesta versão são:

• Linha de assunto: Substitua a linha de assunto em Configurações de envio pela Liquid tag da linha de assunto.
• CTA: Substitua o texto do botão no corpo do e-mail pela Liquid tag do CTA.
• Imagem: Substitua o URL da imagem principal pela Liquid tag da imagem.

O agente avalia o conteúdo totalmente renderizado de cada criativo. Liquid, referências de catálogo e Content Blocks são expandidos antes de o agente formar seu entendimento. Portanto, o conteúdo dinâmico e montado faz parte do que ele vê.

O Connected Content é uma exceção. Ele é renderizado e enviado normalmente, mas o agente não vê nem aprende com o que ele retorna. Então, não dependa do Connected Content como o elemento que diferencia dois criativos.

Etapa 4.2: Adicionar variantes

Na seção Componentes criativos, adicione as opções de variantes para cada ponto de personalização:

• Várias opções de linha de assunto
• Várias opções de texto de CTA
• Várias imagens

Cada variante pode ser associada a criativos base específicos ou ficar disponível para todos os criativos base. Por exemplo, se você tem um criativo base que promove uma liquidação e outro que promove novidades, pode restringir a linha de assunto Don't miss our biggest savings of the year apenas ao criativo da liquidação e manter o CTA Just dropped disponível nos dois.

As imagens precisam ser selecionadas na biblioteca de mídia da Braze. Não é possível colar um URL de imagem diretamente. Se quiser usar uma imagem, faça o upload dela para a biblioteca de mídia primeiro.

Se o seu e-mail for uma única imagem sem elementos de texto separados, use um criativo base e deixe o agente escolher a imagem dentro dele. Você também pode deixar o agente escolher a linha de assunto. Não carregue cada variação de imagem como um criativo base separado.

Etapa 4.3: Visualizar e testar

À medida que adicionar mais conteúdo, visualize e teste sua mensagem usando a prévia dinâmica, que mostra como diferentes combinações de variantes são renderizadas. Isso ajuda a identificar e resolver problemas de renderização antes do lançamento. Depois que seus criativos base e variantes estiverem configurados, você poderá ver uma lista completa de todas as combinações que o agente tem permissão para enviar.

Você também pode fazer um envio de teste da mensagem para você ou para alguém da sua equipe. Os envios de teste exibem a combinação específica de variantes que você selecionar, e não o que o agente escolheria para um usuário específico.

Etapa 5: Definir restrições

As restrições impedem que o agente envie conteúdo repetitivo para o mesmo usuário. Os seguintes níveis estão disponíveis:

• Nível de criativo base: Impede que o mesmo criativo base seja enviado a um usuário mais de uma vez dentro de uma janela que você define. É útil quando cada criativo base é distinto o suficiente para que repeti-lo dentro de, por exemplo, uma semana pareça desgastado.
• Nível de linha de assunto: Impede que a mesma linha de assunto seja enviada a um usuário mais de uma vez dentro de uma janela que você define. É útil quando as linhas de assunto são o sinal de repetição mais visível.

Restrições no nível da variante para imagens ou CTAs específicos não são compatíveis nesta versão.

Etapa 6: Revisar e lançar

A tela Revisão mostra toda a sua configuração: público e divisão do controle aleatório, cronograma, criativos base, contagem de variantes e restrições ativas. Revise e resolva todos os alertas de validação exibidos nessa seção, como a sobreposição de segmentos com outra campanha.

Selecione Lançar para ativar o agente. Ele passa de Rascunho para Ativo e começa a enviar no próximo dia elegível.

Após o lançamento

Período de treinamento

Quando seu agente é lançado, ele entra em um período de treinamento, e os relatórios mostram em qual estágio ele está. O agente avança pelos seguintes estágios:

Estágio	O que está acontecendo
Lançado, ainda sem envios	O agente está ativo, mas ainda não fez o primeiro envio.
Aguardando sinal	O agente está enviando, mas ainda não reuniu cliques genuínos suficientes para começar o treinamento.
Em treinamento	O agente tem sinal suficiente e está explorando combinações. É esperado que o desempenho pareça próximo do aleatório durante essa fase.
Parcialmente treinado	O agente está personalizando, mas os resultados ainda não são robustos o bastante para serem considerados finais.
Totalmente treinado	O agente está totalmente treinado e os resultados são robustos. Este é o momento de confiar no aumento e reportá-lo.

Dois fatores fazem o agente avançar: o acúmulo de cliques genuínos e o tempo de calendário. O treinamento começa depois que cliques limpos suficientes se acumulam, e os resultados se tornam robustos ao atingir um limite mais alto. Já a personalização passa a ser significativa aproximadamente a partir do início da segunda semana de treinamento. Um público de baixo volume pode permanecer em Aguardando sinal por vários dias. Isso pode indicar que ele precisa de mais volume de engajamento.

Um novo usuário recebe o primeiro envio no primeiro dia em que entra no público, e o agente começa a personalizar para ele no dia seguinte. Os e-mails continuam sendo enviados durante todo o período de aprendizado do agente.

Não avalie resultados, redimensione o público nem altere a divisão do grupo de controle enquanto o agente ainda estiver em treinamento. Para saber o que esperar em cada estágio e como interpretar os primeiros resultados, consulte O que esperar após o lançamento.

Visualizações de relatórios

A interface de relatórios oferece três visualizações principais:

Visualização	Descrição
Desempenho	Taxas de cliques, métricas de engajamento e o aumento do grupo do Decisioning Studio em relação ao controle aleatório. A principal métrica de aprendizado é Clientes únicos que clicaram diariamente.
Configuração	As configurações atuais do agente, úteis para confirmar o que está em execução.
Preferências do agente	Contagens de quantas vezes cada variante foi escolhida pelo agente, mostrando para onde o agente está tendendo com seu público.

Os detalhamentos por elemento mostram o desempenho de cada linha de assunto, CTA e imagem em todas as combinações.

Editar um agente ativo

Acesse a visualização Configuração para modificar público, cronograma, criativos ou restrições após o lançamento. Tanto as variantes quanto as dimensões podem ser alteradas após o lançamento. A visualização Configuração mostra um resumo das alterações, e você precisa promovê-las para que entrem em vigor. Ao adicionar novas variantes, o agente mantém o treinamento sobre as variantes existentes e acrescenta as novas opções ao seu menu.

Alterar a proporção da divisão entre controle e IA ou trocar o Segment provoca uma redistribuição dos usuários entre os grupos do Decisioning Studio e de controle aleatório. Edições de criativos, cronograma e restrições não redistribuem o público.

Pausar ou interromper

O ciclo de vida de um agente é Rascunho > Ativo > Interrompido. Selecione Interromper a qualquer momento para parar um agente. Ele deixa de enviar e retoma os envios quando você o reativar.

Referência

A tabela a seguir resume as áreas do Decisioning Studio Go e os detalhes relacionados.

Área	Detalhes
Canal	Somente e-mail
Métrica de conversão	Somente cliques genuínos (clientes únicos que clicaram diariamente)
Pontos de personalização	Linha de assunto, CTA, imagem principal (por criativo base)
Público	Um Segment da Braze (mínimo recomendado de 20.000 e máximo de 40.000.000), com grupo de controle aleatório obrigatório (mínimo de 5%; veja as divisões recomendadas)
Frequência	Seleção única (sem decisão de frequência)
Envios de teste	Pelo criador da Braze
Relatórios	Visualizações de desempenho, configuração e preferências do agente, além de detalhamentos por elemento

Considerações

• O agente avalia o conteúdo totalmente renderizado. Então, Liquid, referências de catálogo e Content Blocks fazem parte do que ele usa para aprender. O Conteúdo conectado é renderizado e enviado normalmente, mas o agente não o vê.
• As imagens são selecionadas na biblioteca de mídia da Braze. Não é possível colar a URL bruta de uma imagem.
• Não há suporte a filtros de público além da seleção de segmento.
• A personalização do corpo do texto, do pré-cabeçalho e do cabeçalho ainda não está disponível.

Solução de problemas

Entre em contato com seu gerente de sucesso do cliente ou consultor de soluções para obter ajuda com a configuração de agentes, a análise de desempenho ou o design do programa.

Para perguntas comuns sobre relatórios e configuração, consulte Solução de problemas do Decisioning Studio Go.

Para perguntas comuns, consulte as Perguntas frequentes do Decisioning Studio Go.