Entenda a entrega de notificação push
Saiba mais sobre a entrega de notificação push, incluindo como as notificações são entregues e por que a entrega pode falhar.
Entrega de notificação push
A Klaviyo registra um evento de Push recebido quando o serviço de notificação push da Apple ou do Google aceita uma notificação push padrão para entrega. Isso não confirma que a notificação chegou ao dispositivo do destinatário.
Um perfil pode ter mais de 1 token de notificação push se o usuário tiver seu app para dispositivos móveis instalado em vários dispositivos. Por padrão, a Klaviyo tenta entregar em todos os dispositivos qualificados. Em Entrega de push, você pode selecionar Ambos, iOS ou Android e escolher Todos os dispositivos ou Dispositivo principal (1 dispositivo por perfil). Se você selecionar Dispositivo principal e esse dispositivo não corresponder à plataforma selecionada, o perfil será ignorado.
O conceito de entregabilidade não se aplica a notificação push como acontece com o e-mail, já que notificações push não têm posicionamento na caixa de entrada ou na pasta de spam. As configurações de notificação de um dispositivo ainda podem afetar quando e como uma notificação aparece.
Quando você envia uma notificação push por meio de uma campanha ou fluxo, a Klaviyo verifica a notificação push e depois a envia para o Apple Push Notification Service (APNs) no iOS ou para o serviço de notificação push do Android, o Firebase Cloud Messaging (FCM), para entrega no dispositivo do destinatário. Uma notificação pode ser ignorada antes de chegar a esses serviços, por exemplo, se o perfil não tiver um token de notificação push ou tiver negado permissão para notificações push padrão.
O APNs e o FCM vão aceitar a notificação e tentar entregá-la no dispositivo do destinatário ou rejeitar a notificação com uma série de possíveis erros.
A Klaviyo só tem insights sobre se esses serviços aceitam a notificação ou a rejeitam. A Klaviyo não pode confirmar se a notificação falha depois que o APNs ou o FCM aceita o push.
Quer solicitar um recurso para as notificações push da Klaviyo? Preencha este formulário do Google para nos contar sobre isso!
Motivos da rejeição
Se a Klaviyo receber uma resposta de erro do APNs ou do FCM após enviar uma notificação, um evento chamado Push devolvido será criado para cada token afetado pela falha na entrega. Isso aparecerá no feed de atividades do perfil que recebeu, junto com a atividade do destinatário do respectivo fluxo ou campanha de onde a notificação foi enviada.
O evento Bounced Push inclui metadados que mostram a mensagem do código de erro (por exemplo, ExpiredToken) retornada pelo APNs ou pelo Firebase. Se você estiver com problemas de entrega, trabalhe com o seu desenvolvedor de aplicativos para resolver o erro com base na descrição do evento.
Para ver os metadados de um evento, abra o menu do evento no registro de atividades do perfil e selecione Detalhes da atividade.
Notificação push silenciosa
Você pode ver a taxa de entrega e a taxa de rejeição de uma notificação push silenciosa individual. As notificações push silenciosas usam métricas de entrega e rejeição separadas e não contribuem com aberturas nem conversões atribuídas para os relatórios padrão de desempenho de push. Você também pode selecionar métricas de notificações push silenciosas em um Relatório de várias métricas.
Observe que você verá eventos diferentes para push silencioso do que para push padrão, especificamente Push Silencioso Recebido e Push Silencioso com Bounce.
Se você estiver com problemas com a entrega de notificações push silenciosas no iOS, observe que o iOS não garante a entrega de notificações push silenciosas. Eles podem não entregá-las com base no estado atual do dispositivo, como nível de bateria e conexão de rede.
iOS
Para notificações push do iOS enviadas pelo APNs, pode haver rejeições por pelo menos um dos motivos listados na referência da Apple sobre como lidar com respostas de notificações do APNs.
Código do status | String de erro do APNs | Descrição do APNs |
400 | BadDeviceToken | O token do dispositivo especificado estava incorreto. Verifique se a solicitação contém um token válido e se o token corresponde ao ambiente. |
400 | BadTopic | O valor de apns-topic é inválido. |
400 | DeviceTokenNotForTopic | O token do dispositivo não corresponde ao tópico especificado. |
400 | DuplicateHeaders | Um ou mais cabeçalhos foram repetidos. |
400 | Tempo limite de inatividade | Tempo limite de inatividade. |
400 | InvalidPushType | O valor apns-push-type é inválido. |
400 | PayloadEmpty | O payload da mensagem estava vazio. |
403 | Certificado inválido | O certificado era inválido. |
403 | Ambiente de certificado inválido | O certificado de cliente era para o ambiente errado. |
403 | InvalidProviderToken | O token do provedor não é válido ou não foi possível verificar a assinatura do token. |
404 | CaminhoInválido | A solicitação continha um valor :path inválido. |
405 | MethodNotAllowed | O :method especificado não foi POST. |
410 | Token expirado | O token do dispositivo expirou. |
410 | Não registrado | O token do dispositivo está sem atividade para o tópico especificado. |
429 | Excesso de atualizações de token do provedor | O token do provedor está sendo atualizado com muita frequência. |
500 | InternalServerError | Ocorreu um erro interno do servidor. |
503 | Serviço indisponível | O serviço não está disponível. |
Android
Para notificações push do Android enviadas via FCM, as rejeições podem ocorrer por pelo menos um dos motivos listados na referência do Google para códigos de erro do FCM.
Código do status | String de erro do FCM | Descrição do FCM |
400 | INVALID_ARGUMENT | Verifique o formato do token de registro que você envia ao servidor. Confira se ele corresponde ao token de registro que o app cliente recebe ao se registrar no Firebase Notifications. Não trunque nem adicione caracteres extras. |
400 | INVALID_ARGUMENT | Verifique se a mensagem foi endereçada a um token de registro cujo nome do pacote corresponda ao valor passado na solicitação. |
400 | INVALID_ARGUMENT | Verifique se o tamanho total dos dados do payload incluídos em uma mensagem não excede os limites do FCM: 4096 bytes para a maioria das mensagens ou 2048 bytes no caso de mensagens para tópicos. Isso inclui tanto as chaves quanto os valores. |
400 | INVALID_ARGUMENT | Verifique se os dados do payload não contêm uma chave (como from, ou gcm, ou qualquer valor prefixado por google) que é usada internamente pelo FCM. Observe que algumas palavras (como collapse_key) também são usadas pelo FCM, mas são permitidas no payload; nesse caso, o valor do payload será substituído pelo valor do FCM. |
400 | INVALID_ARGUMENT | Verifique se o valor usado em ttl é um número inteiro que representa uma duração em segundos entre 0 e 2.419.200 (4 semanas). |
400 | INVALID_ARGUMENT | Verifique se os parâmetros fornecidos têm o nome e o tipo corretos. |
403 | SENDER_ID_MISMATCH | O ID do remetente autenticado é diferente do ID do remetente do token de registro. |
404 | NÃO REGISTRADO | A instância do app foi removida do registro no FCM. Isso geralmente significa que o token usado não é mais válido, e um novo precisa ser usado. |
429 | QUOTA_EXCEEDED | Limite de envio excedido para o destino da mensagem. Uma extensão do tipo google.rpc.QuotaFailure é retornada para especificar qual cota foi excedida. |
500 | INTERNAL | Ocorreu um erro interno desconhecido. |
503 | Indisponível | O servidor está sobrecarregado. |
Um perfil sem token de notificação push é ignorado antes de a Klaviyo entrar em contato com o APNs ou o FCM. Se um serviço rejeitar um token inválido ou expirado, a Klaviyo registra um evento de Push devolvido. Os tokens podem ficar inválidos depois que alguém desinstala seu app. A Klaviyo remove tokens que o serviço informa como não registrados ou expirados.
Práticas recomendadas
Coletar consentimento do usuário
Para enviar uma notificação push padrão para um perfil, você deve primeiro coletar o consentimento explícito dele.
Para coletar o consentimento para notificações push, peça que os clientes ativem as notificações por meio do prompt nativo de permissão do seu app. Escolha um momento em que os clientes consigam entender por que eles receberiam notificações.
A melhor prática é usar uma linguagem clara de consentimento no seu app e deixar que os clientes escolham se querem ativar notificações push. Explique o seguinte:
- Que tipos de notificações sua marca envia
Inclua detalhes sobre as diferentes notificação push que sua marca planeja enviar (por exemplo, alterações na conta, lembretes e descontos especiais). - Por que os usuários devem aceitar
Inclua informações sobre por que um cliente deve conceder permissões (por exemplo, para receber atualizações importantes ou acesso antecipado a promoções).
Saiba mais sobre como coletar o consentimento para notificação push.
Envie notificações relevantes
Ao enviar campanhas de notificação push, é importante aproveitar a segmentação da Klaviyo para enviar conteúdo personalizado e relevante para seus assinantes.
Por exemplo, se você sabe que tem um segmento de clientes recorrentes fiéis, você pode usar notificações push para alertá-los sobre novas ofertas ou promoções antes de qualquer outra pessoa.
Ao garantir que o conteúdo que você envia aos clientes seja relevante para os interesses e as preferências deles, você pode reduzir a probabilidade de que os clientes cancelem a inscrição e maximizar sua capacidade de alcançá-los com notificação push.
Monitorar e analisar o desempenho
É essencial monitorar continuamente o desempenho das suas notificações push com a Klaviyo para identificar rapidamente problemas de entrega e quedas nas principais métricas de push.
A melhor forma de fazer isso é monitorar os seguintes eventos de notificação push:
- Push recebida
- Push Aberta
- Push Devolvida
Você pode configurar um Relatório de várias métricas no Klaviyo para monitorar como seu desempenho com esses eventos muda ao longo do tempo.
Recursos adicionais
- Como entender o consentimento para notificação push
Saiba mais sobre o consentimento para notificações push e as melhores práticas de conformidade. Essas diretrizes podem ajudar você a estar em conformidade nas suas práticas de coleta de consentimento e manter um relacionamento positivo com seus clientes.
- Como enviar uma campanha de notificação push
Saiba como usar a Klaviyo para enviar campanhas de notificação push pelo seu app iOS ou Android.
- Como entender suas configurações de notificação push
Saiba mais sobre a página de configurações de notificações push, onde você pode configurar notificações push para seu aplicativo móvel e ajustar a janela do Smart Sending.