Aviso: Não existe documentação legada disponível para este item, pelo que está a ver a documentação atual.
Ao construir uma estratégia de comunicação robusta e eficaz utilizando notificações push da web, é crucial conhecer o estado de subscrição dos visitantes do seu website. Isto é especialmente importante se conectar a sua base de dados existente à sua lista de subscritores de push.
Compreender se os seus utilizadores com sessão iniciada estão subscritos em notificações push permite-lhe adaptar a sua mensagem, criar experiências mais personalizadas e maximizar a taxa de envolvimento das suas notificações. Esta documentação irá guiá-lo através do processo de utilização da nossa API para verificar o estado de subscrição dos visitantes do seu website.
Verificar o Estado de Subscrição Utilizando o Web SDK
Antes de verificar o estado de subscrição, certifique-se de que a instalação do PushEngage está completa. Se não tiver isto integrado, siga este guia e complete a sua instalação.
Aqui o método getPermission() é uma forma direta de determinar o estado de subscrição de um utilizador. Este método retorna o estado atual da permissão de notificação push do utilizador que visita o seu website.
A sintaxe para este Método é:
getPermission().then(successFunctionCallback).catch(errorFunctionCallback);
Pode utilizá-lo da seguinte forma
PushEngage.push(function () {
PushEngage.getPermission()
.then(function (notificationPermission) {
console.log(notificationPermission);
})
.catch(function (error) {
console.log(error.message, error.details);
});
});
Se estiver a lidar com múltiplos casos com base em respostas ou no estado de permissão do utilizador. Pode utilizar o código de exemplo abaixo:
// Check the user's push notification subscription status
PushEngage.getPermission().then(function(permissionStatus) {
console.log("User's push subscription status: ", permissionStatus);
// Handle different subscription statuses
switch(permissionStatus) {
case 'default':
console.log("User has not yet made a decision about push notifications.");
break;
case 'granted':
console.log("User has granted permission for push notifications.");
break;
case 'denied':
console.log("User has denied permission for push notifications.");
break;
default:
console.log("Unknown permission status.");
}
}).catch(function(error) {
console.error("An error occurred while checking the subscription status: ", error);
});
O método getPermission() retorna um dos três valores possíveis:
default: O utilizador ainda não tomou uma decisão relativamente a notificações push.granted: O utilizador concedeu permissão para receber notificações push.denied: O utilizador negou permissão para receber notificações push.
Com base nestes valores, pode decidir como interagir eficazmente com os seus utilizadores. Por exemplo, se o estado for default, pode querer solicitar ao utilizador que opte por receber notificações push. Se o estado for denied, pode optar por oferecer um método de interação alternativo.
Caso se depare com algum problema, não hesite em contactar-nos clicando aqui. A nossa equipa de suporte poderá ajudá-lo.