Nesta página, você vai encontrar ajuda para a solução de problemas e respostas a perguntas frequentes sobre o Cloud Messaging.
Qual é a diferença entre o Editor do Notificações e o FCM?
O Firebase Cloud Messaging fornece um conjunto completo de recursos de mensagens
por meio dos SDKs clientes e do protocolo de servidor
HTTP. Para implantações com requisitos de mensagens mais complexos, o FCM é a escolha certa.
O Editor do Notificações é uma solução de mensagens leve e sem servidor
integrada ao Firebase Cloud Messaging. Com um console gráfico simples que exige pouca codificação, o Editor do Notificações facilita o envio de mensagens para engajar novamente e reter usuários, promover o crescimento do app e respaldar campanhas de marketing.
Recursos |
|
Editor do Notificações |
Cloud Messaging |
Destino |
Dispositivo único |
|
|
|
Clientes inscritos em tópicos (por exemplo, clima) |
|
|
|
Clientes em segmento de usuário predefinido (app, versão e idioma) |
|
|
|
Clientes em públicos de análise especificados |
|
|
|
Clientes em grupos de dispositivos |
|
|
|
Upstream, do cliente ao servidor |
|
|
Tipo de mensagem |
Notificações de até 2 KB |
|
|
|
Mensagens de dados de até 4 KB |
|
|
Entrega |
Imediato |
|
|
|
Horário local do dispositivo do cliente no futuro |
|
|
Analytics |
Análises de funil e coleta de análises do Notificações, ambas integradas |
|
|
Preciso usar outros
serviços do Firebase para usar o FCM?
Você pode usar o Firebase Cloud Messaging como um componente independente, sem usar
outros serviços do Firebase.
Por que meus dispositivos de destino
parecem não receber mensagens?
Quando você achar que os dispositivos não estão recebendo mensagens corretamente, verifique primeiro
estas duas possíveis causas:
Tratamento de mensagens em primeiro plano para mensagens de notificação. Os apps clientes precisam
adicionar lógica de tratamento de mensagens para gerenciar as mensagens de notificação quando o app está em
primeiro plano no dispositivo. Consulte os detalhes para
iOS e
Android.
Restrições do firewall da rede. Se a sua organização tiver um firewall que
restrinja o tráfego para ou da Internet, configure-o para permitir a
conectividade com o FCM para que os apps clientes do Firebase Cloud Messaging
recebam mensagens. Abra estas portas:
Geralmente, o FCM usa a 5228, mas às vezes usa a 5229 e a 5230.
Como o FCM não fornece IPs específicos, configure o firewall para
aceitar conexões de saída com todos os endereços IP contidos nos blocos IP
listados no ASN 15169 do Google.
Por que onMessageReceived
não está sendo chamado no meu app Android?
Quando seu app estiver em segundo plano, as mensagens de
notificação
serão exibidas na bandeja do sistema, e onMessageReceived
não será chamado. As
mensagens de notificação com um payload de dados são exibidas
na bandeja do sistema, e os dados incluídos com a mensagem de notificação
podem ser recuperados do intent iniciado quando o usuário toca na
notificação.
Para mais informações, consulte Receber e lidar com as mensagens.
Por que meu app
recebe "Argumento inválido para o fid especificado" quando me registro com
FCM?
O FID (ID de instalação do Firebase) é o identificador de uma instância de app. Se os
dados de instalação de uma instância de app forem restaurados de um backup, FCM
retornará esse erro para indicar que o FID já foi
ocupado por uma instância de app diferente. Assim, a instância de app atual não pode usar o
FID para se registrar no FCM.
Recomendamos que os desenvolvedores façam o seguinte no app:
- Excluir
dados de instalação do Firebase no backup. Os dados de instalação do Firebase são armazenados
em um arquivo
PersistedInstallation....json
. O nome do arquivo é uma constante para um
app. Por exemplo, <exclude domain="file" path="PersistedInstallation....json"
/>
- Exclua o arquivo
PersistedInstallation....json
ao receber erros "Argumento inválido para o FID especificado". Na próxima vez que o app se registrar com
FCM, um novo FID será criado.
A Apple
anunciou que está descontinuando o protocolo binário legado para APNs. Preciso fazer algo?
Não. O Firebase Cloud Messaging foi encaminhado para o protocolo de APNs baseado em HTTP/2 em 2017.
Se você estiver usando o FCM para enviar notificações a dispositivos iOS, não precisará fazer nada.
Cotas e limites do FCM
Como notificar uma grande base de clientes em dois minutos?
Esse caso de uso não é compatível. Distribua o tráfego em mais de cinco minutos.
Meu app notifica os usuários sobre
eventos, e essas mensagens precisam ser entregues imediatamente para apoiar meu modelo de
negócios. Posso aumentar a cota?
Infelizmente, não podemos aumentar as cotas por esse motivo. Distribua o tráfego em mais de cinco minutos para evitar picos.
Minhas mensagens são sobre
eventos programados. Como posso enviar todo o tráfego no auge da hora?
Recomendamos que você comece a enviar as notificações pelo menos 5 minutos antes
do evento. Outra opção é enviar mensagens
de dados e implementar
o equivalente do manipulador onMessageReceived
da sua plataforma para programar notificações
locais com antecedência.
Os erros 429 são difíceis
para mim e minha empresa lidarmos. Posso conseguir uma isenção ou mais cota para evitar
o recebimento de 429s?
Entendemos que os limites de cota podem ser desafiadores, mas as cotas são vitais para
manter o serviço confiável. Além disso, não podemos conceder isenções. Use novas tentativas para tratar erros 429 corretamente.
Quanto tempo vai levar para que meu pedido de aumento de cota seja atendido?
Seu pedido de aumento de cota depende do seu uso do FCM. De qualquer forma, você vai receber uma resposta em alguns dias úteis. Em alguns casos, pode haver idas e vindas ao seu uso do
FCM e várias circunstâncias, o que pode prolongar o processo. Se todos os requisitos forem atendidos, a maioria das solicitações será resolvida em até duas semanas.
Posso ter mais cota para um
evento temporário?
É possível solicitar uma cota extra para dar suporte a um evento com duração de até um mês.
Faça a solicitação com pelo menos um mês de antecedência do evento e com detalhes claros
sobre quando ele começa e termina. O FCM fará todos os esforços práticos
para atender à solicitação. Se concedidos, esses aumentos de cota serão
revertidos após a data de término do evento.
Minha cota atual está sujeita
a mudanças?
Embora o Google não faça isso de forma simples, as cotas podem ser alteradas conforme necessário para proteger a
integridade do sistema. Quando possível, o Google vai avisar você com antecedência sobre essas mudanças. Mantenha seus contatos da MSA do Cloud atualizados para aumentar as chances de receber anúncios de serviço.