Tag Push Permission Status

Push Permission Status est un tag par défaut qui stocke l’état de l’autorisation des notifications push sur un appareil. Utilisez-le pour créer des segments d’accessibilité regroupant des utilisateurs qu’un simple indicateur activé/désactivé ne permet pas de distinguer, par exemple les utilisateurs à qui vous pouvez encore demander l’autorisation et ceux qui l’ont déjà refusée.

Valeurs de Push Permission Status

Le tag est un tag de type String qui stocke l’une des valeurs ci-dessous pour chaque appareil dans chaque application. Chaque plateforme n’en remonte qu’une partie. Voir Ce que remonte chaque plateforme.

Valeur	Signification
`not_determined`	L’utilisateur n’a pas encore répondu à la demande d’autorisation, l’application peut donc encore la demander
`granted_explicit`	L’utilisateur a autorisé les notifications dans la demande d’autorisation
`granted_default`	Les notifications sont autorisées, mais pas par une réponse à la demande d’autorisation du SDK Pushwoosh. Android uniquement
`provisional`	Les notifications sont autorisées à titre provisoire. Elles arrivent discrètement dans le Centre de notifications, sans alertes, sons ni bannières. iOS uniquement
`ephemeral`	Les notifications sont autorisées pour une durée limitée, comme pour une App Clip. iOS uniquement
`denied`	L’utilisateur a désactivé les notifications, soit dans la demande, soit plus tard dans les paramètres de l’appareil ou du navigateur
`unsupported`	Le navigateur ne peut pas recevoir de notifications web push. Web uniquement

Le tag n’a pas de valeur sur tvOS et macOS, ni sur les appareils dont la version du SDK est antérieure à :

Plateforme	Version minimale du SDK
iOS	7.2.10
Android	6.17.0
Web	3.95.0

Quand le tag est mis à jour

Le SDK remonte l’état actuel aux moments suivants :

À chaque ouverture de l’application.
Lorsque l’appareil s’enregistre pour les notifications push.
Juste après la réponse de l’utilisateur à la demande d’autorisation.

Si l’utilisateur modifie l’autorisation dans les paramètres de l’appareil ou du navigateur, le tag est mis à jour plus tard, selon la plateforme :

Plateforme	Quand le tag est mis à jour
iOS	À la prochaine ouverture de l’application
Android	À la prochaine ouverture de l’application ou à son retour au premier plan
Web : navigateurs basés sur Chromium et Firefox	Dès que le navigateur signale le changement
Web : Safari	Au prochain chargement de la page

Lorsqu’une requête arrive sans état, par exemple depuis une ancienne version du SDK, le tag conserve sa dernière valeur.

Ce que remonte chaque plateforme

Chaque plateforme lit l’autorisation via sa propre API système, l’ensemble des valeurs diffère donc selon la plateforme.

iOS

Le SDK iOS associe directement le statut d’autorisation système de l’application au tag.

Statut d’autorisation iOS	Push Permission Status
Not determined	`not_determined`
Authorized	`granted_explicit`
Provisional	`provisional`
Ephemeral	`ephemeral`
Denied	`denied`

Android

Android 13 et versions ultérieures exigent que l’utilisateur autorise les notifications dans une demande d’autorisation. Les versions antérieures les autorisent par défaut après l’installation, le SDK Android distingue donc une réponse explicite d’une autorisation par défaut :

granted_explicit : l’utilisateur a autorisé les notifications dans la demande d’autorisation affichée par le SDK Pushwoosh, sur Android 13 ou version ultérieure, dans une application qui cible Android 13 (niveau d’API 33) ou version ultérieure.
granted_default : les notifications sont autorisées d’une autre manière. Cela inclut Android 12 et versions antérieures, les applications qui ciblent un niveau d’API inférieur à 33, une autorisation déjà accordée lorsque le SDK l’a vérifiée pour la première fois, et une autorisation accordée depuis votre propre demande ou depuis les paramètres système.
not_determined : sur Android 13 et versions ultérieures, les notifications sont désactivées et l’utilisateur n’a pas encore répondu à la demande, y compris s’il l’a fermée sans faire de choix.
denied : les notifications sont désactivées après que l’utilisateur a refusé la demande, ou après avoir été autorisées auparavant. Sur Android 12 et versions antérieures, tout appareil dont les notifications sont désactivées remonte denied.

Web

Les navigateurs n’autorisent les notifications qu’après un clic de l’utilisateur pour les autoriser, un appareil web ne remonte donc jamais granted_default.

Autorisation du navigateur	Push Permission Status
Pas encore demandée (`default`)	`not_determined`
Autorisée (`granted`)	`granted_explicit`
Bloquée (`denied`)	`denied`
Le navigateur ne prend pas en charge le web push	`unsupported`

Créer des segments d’accessibilité

Combinez les valeurs dans un seul filtre Push Permission Status avec l’opérateur l’un de pour cibler les utilisateurs selon la façon dont vous pouvez les atteindre. En savoir plus sur la création de segments par tags.

Segment	Filtre	Utilisation
Utilisateurs qui voient les alertes push	l’un de `granted_explicit`, `granted_default`	Envoyer des notifications push urgentes
Distribution discrète uniquement	l’un de `provisional`, `ephemeral`	Prévoir une visibilité moindre et inviter ces utilisateurs à autoriser les notifications complètes
Utilisateurs à qui vous pouvez encore demander	l’un de `not_determined`	Afficher une in-app avant la demande d’autorisation push
Utilisateurs qui ont refusé	l’un de `denied`	Les atteindre par e-mail, SMS ou messages in-app, ou lancer un pop-up de récupération de désabonnement
Navigateurs sans web push	l’un de `unsupported`	Utiliser d’autres canaux pour ces utilisateurs web

Pour trouver les appareils qui ne remontent pas encore le tag, utilisez l’opérateur non défini. Ces appareils utilisent une ancienne version du SDK : ciblez-les plutôt avec Push Alerts Enabled. Pour la différence entre les deux tags, voir Push Permission Status et Push Alerts Enabled.

Push Permission Status et Push Alerts Enabled

Les deux tags répondent à des questions différentes :

Push Alerts Enabled (Boolean) : cet appareil peut-il afficher des alertes push en ce moment ?
Push Permission Status (String) : quel est l’état de l’autorisation ? Il distingue des états que Push Alerts Enabled remonte comme un même false, par exemple « jamais demandée » et « refusée ».

Le tableau compare la façon dont les deux tags remontent les états courants.

	Push Alerts Enabled	Push Permission Status
Type	Boolean	String
Autorisation jamais demandée	`false`	`not_determined`
Autorisation refusée	`false`	`denied`
Autorisation provisoire ou temporaire sur iOS	Dépend des réglages d’alertes, de sons et de badges	`provisional` ou `ephemeral`
Autorisation explicite ou par défaut	`true` lorsque l’appareil affiche des alertes	`granted_explicit` ou `granted_default`
Appareils avec d’anciennes versions du SDK	Remonté sur toutes les versions du SDK	Non défini

Choisissez le tag en fonction de la question à laquelle vous devez répondre :

Utilisez Push Alerts Enabled pour compter rapidement les utilisateurs abonnés sur toutes les versions du SDK.
Utilisez Push Permission Status lorsque votre prochaine étape dépend de la raison pour laquelle un utilisateur n’est pas joignable. Par exemple, sollicitez les utilisateurs à qui l’autorisation n’a jamais été demandée et laissez tranquilles ceux qui l’ont refusée.