Envio de mensagens de teste

Antes de enviar uma campanha de mensagens para seus usuários, você pode querer testá-la para garantir que ela esteja correta e funcione da maneira esperada. Você pode usar o dashboard para criar e enviar mensagens de teste com notificações por push, mensagens no app (IAM) ou e-mail.

Envio de uma mensagem de teste

Etapa 1: Crie um segmento de teste designado

Depois de configurar um segmento de teste, você poderá usá-lo para testar qualquer um dos seus canais de envio de mensagens da Braze. Quando configurado corretamente, isso só precisa ser feito uma única vez.

Para configurar um segmento de teste, acesse Segments e crie um novo segmento. Selecione Add Filter e escolha um dos filtros de teste.

Com os filtros de teste, é possível garantir que apenas os usuários com um endereço de e-mail específico ou ID de usuário externo recebam a mensagem de teste.

Os filtros de endereço de e-mail e de ID de usuário externo oferecem as seguintes opções:

Você pode selecionar vários e-mails específicos usando a opção “matches” e separando os endereços de e-mail com um caractere |. Por exemplo: “matches” “[email protected] | [email protected]”. Você também pode combinar vários operadores. Por exemplo, o segmento de teste pode incluir um filtro de endereço de e-mail que “matches” “@braze.com” e outro filtro que “does not equal” “[email protected]”.

Depois de adicionar os filtros de teste ao seu segmento de teste, é possível verificar se ele está funcionando selecionando Preview ou Settings > CSV Export All User Data para exportar os dados de usuários desse segmento para um arquivo CSV.

Nota

Exportar os dados de usuários do segmento para um arquivo CSV é o método de verificação mais preciso, pois a pré-visualização mostrará apenas uma amostra dos seus usuários e poderá não incluir todos os usuários.

Etapa 2: Envie a mensagem

Você pode enviar uma mensagem usando o dashboard da Braze ou a linha de comando.

• using the dashboard
• using the command line

• push or in-app message
• email message

Para enviar notificações por push de teste ou mensagens no app, você precisa direcionar o segmento de teste criado anteriormente. Comece criando sua Campaign e seguindo os passos habituais. Quando chegar à etapa Target Audiences, selecione seu segmento de teste no menu suspenso.

Confirme sua Campaign e lance-a para testar a notificação por push e as mensagens no app.

Nota

Certifique-se de selecionar Allow users to become re-eligible to receive campaign na parte Schedule do criador de campanhas se você pretende usar uma única Campaign para enviar uma mensagem de teste para si mesmo mais de uma vez.

Se você estiver apenas testando mensagens de e-mail, não é necessário configurar um segmento de teste. Na primeira etapa do criador de campanhas, onde você compõe a mensagem de e-mail da sua Campaign, clique em Send Test e insira o endereço de e-mail para o qual você deseja enviar um e-mail de teste.

Dica

Você também pode ativar ou desativar TEST (ou SEED) sendo anexado às suas mensagens de teste.

Como alternativa, você pode enviar uma única notificação usando cURL e a API de envio de mensagens da Braze. Note que esses exemplos fazem uma solicitação usando a instância US-01. Para descobrir a sua, consulte Endpoints de API.

• android
• swift
• kindle

1
2
3
4
5
6
7
8
9
10
11
12
curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {BRAZE_API_KEY}" -d '{
  "external_user_ids":["EXTERNAL_USER_ID"],
  "messages": {
    "android_push": {
      "title":"Test push title",
      "alert":"Test push",
      "extra":{
        "CUSTOM_KEY":"CUSTOM_VALUE"
      }
    }
  }
}' https://rest.iad-01.braze.com/messages/send

1
2
3
4
5
6
7
8
9
10
11
curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {BRAZE_API_KEY}" -d '{
  "external_user_ids":["EXTERNAL_USER_ID"],
  "messages": {
    "apple_push": {
      "alert": "Test push",
      "extra": {
        "CUSTOM_KEY" :"CUSTOM_VALUE"
      }
    }
  }
}' https://rest.iad-01.braze.com/messages/send

1
2
3
4
5
6
7
8
9
10
11
12
curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {BRAZE_API_KEY}" -d '{
  "external_user_ids":["EXTERNAL_USER_ID"],
  "messages": {
    "kindle_push": {
      "title":"Test push title",
      "alert":"Test push",
      "extra":{
        "CUSTOM_KEY":"CUSTOM_VALUE"
      }
    }
  }
}' https://rest.iad-01.braze.com/messages/send

Substitua o seguinte:

Espaço reservado	Descrição
BRAZE_API_KEY	Sua chave de API da Braze usada para autenticação. Na Braze, acesse Settings > API Keys para localizar sua chave.
EXTERNAL_USER_ID	O ID de usuário externo usado para enviar sua mensagem a um usuário específico. Na Braze, acesse Audience > Search Users e pesquise um usuário.
CUSTOM_KEY	(Opcional) Uma chave personalizada para dados adicionais.
CUSTOM_VALUE	(Opcional) Um valor personalizado atribuído à sua chave personalizada.

Limitações do teste

Existem algumas situações em que as mensagens de teste não têm paridade completa de recursos com o lançamento de uma Campaign ou Canvas para um conjunto real de usuários. Nesses casos, para validar esse comportamento, você deve lançar a Campaign ou Canvas para um conjunto limitado de usuários de teste.

• A visualização da Central de Preferências da Braze a partir das Mensagens de Teste fará com que o botão de envio fique acinzentado.
• O cabeçalho list-unsubscribe não está incluído nos e-mails enviados pela funcionalidade de mensagem de teste.
• Para mensagens no app e Content Cards, o usuário de destino deve ter um token por push para o dispositivo de destino.