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.

Enviar uma mensagem de teste

Etapa 1: Crie um Segment de teste designado

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

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

Com os filtros de teste, você pode garantir que apenas 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 o caractere |. Por exemplo: “matches” “[email protected] | [email protected]”. Você também pode combinar vários operadores juntos. Por exemplo, o Segment de teste poderia incluir um filtro de endereço de e-mail que “matches” “@braze.com” e outro filtro que “does not equal” “[email protected]”.

Após adicionar os filtros de teste ao seu Segment de teste, você pode verificar se está funcionando selecionando Preview ou selecionando Settings > CSV Export All User Data para exportar os dados de usuários desse Segment para um arquivo CSV.

Nota

Exportar os dados de usuários do Segment para um arquivo CSV é o método de verificação mais preciso, pois a prévia exibirá apenas uma amostra dos seus usuários e pode não incluir todos eles.

Etapa 2: Envie a mensagem

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

• usando o dashboard
• usando a linha de comando

• push ou mensagem no app
• mensagem de e-mail

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

Confirme sua Campaign e lance-a para testar suas notificações por push e mensagens no app.

Nota

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

Se você está testando apenas mensagens de e-mail, não é necessariamente preciso configurar um Segment de teste. Na primeira etapa do criador de Campaign, 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 deseja enviar um e-mail de teste.

Dica

Você também pode ativar ou desativar a adição de TEST (ou SEED) nas suas mensagens de teste.

Alternativamente, você pode enviar uma única notificação usando cURL e a API de Mensagens da Braze. Esses exemplos fazem uma requisiçã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:

Placeholder	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 para um usuário específico. Na Braze, acesse Audience > Search users e busque 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 de teste

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

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