Perguntas frequentes
Este artigo fornece respostas para algumas perguntas frequentes sobre o canal de push.
Por que as notificações por push às vezes atrasam?
A entrega geralmente segue três estágios: processamento da Braze (segmentação, agendamento e envio ao provedor), transporte da Braze para APNs ou FCM e entrega do provedor para o dispositivo. Atrasos podem ocorrer em qualquer estágio. A Braze não tem visibilidade sobre as filas do provedor ou do dispositivo; use o registro detalhado no cliente quando precisar identificar a origem do atraso no dispositivo.
O que acontece quando vários usuários fazem login em um único dispositivo?
Quando um usuário faz logout de um dispositivo ou website, ele continuará acessível por push até que outro usuário faça login. Nesse momento, o token por push é reatribuído ao novo usuário. Isso ocorre porque cada dispositivo pode ter apenas uma inscrição de push ativa por app ou website.
Quando um token por push é reatribuído, a alteração é refletida no Push Changelog do perfil de usuário. No perfil de usuário, acesse a guia Engajamento.
Quando envio um push de teste, ele é enviado para todos os meus dispositivos?
Sim. O push de teste é enviado para todos os dispositivos habilitados para push associados ao perfil de usuário selecionado. Se você tiver vários telefones ou tablets conectados com o mesmo usuário, cada dispositivo com um token por push válido receberá a notificação.
Para enviar o push de teste para apenas um dispositivo, você pode remover os tokens por push dos outros dispositivos do perfil de usuário antes de testar. Como alternativa, se estiver enviando pelo endpoint /messages/send, defina send_to_most_recent_device_only como true no objeto apple_push ou android_push para que apenas o dispositivo ativo mais recentemente receba o push.
O que significa “Error sending push because the payload was invalid”?
Essa mensagem indica que o APNs rejeitou a solicitação de push devido a uma carga útil inválida (por exemplo, uma carga útil vazia ou uma carga útil muito grande).
Para mais detalhes e próximas etapas, consulte Mensagens de erro comuns de push.
Por que um usuário com opt-in não tem um token por push?
Isso pode acontecer se o token por push do usuário foi reatribuído a outra pessoa que usou o mesmo dispositivo.
- Acesse o Push Changelog na guia Engagement do perfil do usuário afetado.
- Procure uma mensagem informando que o token por push foi movido para outro usuário.
- Copie o token por push e cole na barra de pesquisa de usuário.
- Se o token por push ainda existir, você será direcionado ao usuário que fez login mais recentemente no dispositivo.
Se você quiser que o token por push seja reatribuído ao usuário original:
- Faça o usuário original entrar no perfil com o token por push ausente.
- Dispare um novo envio de push. Isso move o token de volta para a conta, caso o usuário ainda tenha o push ativado no nível do dispositivo.
Por que “Abrir URL da web dentro do app móvel” sempre abre o app quando estou testando um rascunho de Campaign?
Quando uma Campaign ainda está com status de Rascunho e você envia um push de teste, tocar na notificação sempre abre o app primeiro, independentemente de a opção Abrir URL da web dentro do app móvel estar selecionada ou desmarcada. Quando a Campaign está Ativa, o comportamento ao clicar funciona conforme configurado.
Se você selecionou Abrir URL da web sem a opção Dentro do app, o link abre diretamente no navegador padrão do dispositivo. Se você selecionou Abrir URL da web dentro do app móvel, o link abre em uma visualização web dentro do app.
Qual é a diferença entre “Send to Production” e “Send to Development” para certificados push do iOS?
Ao adicionar um certificado Apple Push na Braze, as opções Send to Production e Send to Development determinam qual gateway do serviço de Notificações por Push da Apple (APN) a Braze usa para entregar notificações por push:
- Send to Development: Selecione esta opção se o app foi compilado no modo de desenvolvimento no Xcode e assinado com um perfil de provisionamento de desenvolvimento. As notificações por push são roteadas pelo gateway de desenvolvimento (sandbox) da Apple.
- Send to Production: Selecione esta opção se o app é distribuído pelo TestFlight da Apple, pela App Store ou por distribuição corporativa. As notificações por push são roteadas pelo gateway de produção da Apple.
Se a opção errada for selecionada, as notificações por push falham silenciosamente porque o tipo de token por push não corresponde ao gateway. Normalmente, apps distribuídos pelo TestFlight ou pela App Store devem usar Send to Production.
A Braze assume que os tokens por push importados são tokens por push de primeiro plano válidos para o seu app e ambiente.
Quando você importa tokens iOS, a Braze não armazena um gateway do serviço de Notificações por Push da Apple (APN) (development ou production) para eles. A Braze envia para esses tokens por meio do gateway configurado do seu app. Se um token foi gerado para o outro ambiente, o APN o rejeita com BadDeviceToken, e o envio sofre bounce.
A Braze armazena um gateway para o token somente se o SDK registrar posteriormente o mesmo token e informar um gateway.
Qual é a diferença entre os filtros “Foreground Push Enabled” e “Background or Foreground Push Enabled”?
Esses filtros de segmentação verificam condições diferentes:
| Filtro | O que verifica | Caso de uso |
|---|---|---|
| Foreground Push Enabled | O usuário possui um token de push de primeiro plano válido e o estado de inscrição de push dele é Opted-In ou Subscribed. |
Direcionar usuários que podem receber notificações por push visíveis. |
| Background or Foreground Push Enabled | O usuário possui qualquer token de push (primeiro plano ou segundo plano) e o estado de inscrição de push dele é Opted-In ou Subscribed. Isso inclui usuários que desativaram notificações por push visíveis, mas ainda possuem um token de push em segundo plano. |
Usado para Uninstall Tracking, notificações por push silenciosas e geofencing. |
Um usuário pode estar com Background or Foreground Push Enabled sem estar com Foreground Push Enabled. Isso acontece quando o usuário desativou as notificações por push visíveis nas configurações do dispositivo, mas o app ainda mantém um token de push em segundo plano. Para mais detalhes, consulte Usuários de push e inscrições.
Como a Braze determina quando uma notificação por push é enviada com sucesso?
Uma mensagem é registrada como enviada assim que é recebida pelo provedor de serviço de push. Isso não significa necessariamente que o usuário recebeu ou visualizou a mensagem.
Para iOS, o provedor de serviço de push é o serviço de Notificações por Push da Apple (APNs), e para Android, normalmente é o Firebase Cloud Messaging (FCM). O provedor de serviço de push responde imediatamente com sucesso ou falha. Uma falha pode incluir um bounce ou uma nova tentativa por falha de rede.
Se uma mensagem de sucesso é retornada, o envio é registrado pela Braze, e então o serviço de push tenta entregar ao dispositivo. Se o dispositivo não puder ser alcançado imediatamente, o serviço faz novas tentativas até a opção de expiração definida na Braze (TTL para Android, Expiry para iOS). Se a mensagem expirar, o serviço de push descarta o push, mas isso não é considerado um bounce.
- Para Campaigns de push com entrega baseada em ação, o envio da mensagem é registrado assim que o usuário executa a ação que dispara a Campaign.
- Para Campaigns agendadas, o horário de envio é o momento em que a mensagem foi enfileirada e encaminhada ao provedor de serviço de push.
- Para ambos os tipos de entrega, a mensagem é marcada como “enviada” na Braze e no perfil do usuário em Campaigns Received, mesmo que o usuário ainda não tenha visto ou recebido o push.
A métrica “entregas” para push no dashboard é calculada no carregamento da página como o número de envios menos bounces.