Résolution des problèmes liés aux notifications Push WNS

Cette rubrique décrit les premières étapes de dépannage que vous devez suivre lorsque vous rencontrez des problèmes liés aux notifications de vignette, "toast" et badge, y compris les différentes méthodes de notification : locale, push, périodique et planifiée.

Résolution des erreurs spécifiques

Cette section traite des erreurs courantes que vous pouvez rencontrer lors de l’utilisation de notifications Push.

• Vérifier vos journaux d’événements
• La notification Push reçoit une réponse « 200 OK », mais ne s’affiche pas
• La notification Push retourne un code autre que « 200 OK »
• Erreurs lors de la tentative de création d’un canal de notification Push

Vérifier vos journaux d’événements

Si les notifications push de vignette ou de toast ne s'affichent pas comme prévu, consultez les journaux d'événements.

• Si la notification est reçue, mais n’apparaît pas: lancez l’Observateur d’événements et examinez le journal Microsoft-Windows-TWinUI/Operational sous Applications et services\Microsoft\Windows\Apps.
• Si la notification n’est pas reçue du tout: lancez l’Observateur d’événements et examinez le journal opérationnel sous Applications et Services\Microsoft\Windows\PushNotifications-Platform.

La notification Push reçoit une réponse « 200 OK », mais ne s’affiche pas

Si Windows Push Notification Services (WNS) retourne une réponse « 200 OK », elle remet la notification au client si le client est en ligne. Si vous avez vérifié que le client est en ligne mais qu’il n’affiche pas la notification, procédez comme suit :

• Cause: erreurs XML dans le contenu de la notification.

  Corriger: vérifiez la syntaxe XML de base et assurez-vous que votre XML est complet et correct. Voici quelques points courants d’échec dans le contenu XML :

  • Case sensitivity. Les noms de balises, les noms d’attributs et les valeurs d’attributs sont tous sensibles à la casse. Assurez-vous que votre XML a la casse correcte.
  • Un élément de liaison doit être fourni pour chaque format de tuile supporté. Vous devez fournir un élément de liaison pour chaque taille de vignette que vous gérez dans chaque notification que vous envoyez.
  • Les chaînes de texte ne doivent pas contenir de caractères XML réservés. Par exemple, vous ne pouvez pas mettre en italique les chaînes de caractères des vignettes ou des toasts en utilisant les balises <i> et </i>. Si vous envisagez d’afficher les caractères littéraux «<i>», ils doivent être correctement protégés. Pour plus d'informations sur les caractères d'échappement dans XML, consultez Entités de Caractères XML etXAML.
  • Les valeurs fournies pour les attributs lang doivent être conformes à la spécification ITEF BCP 47.
  • Les chaînes XML envoyées par le biais de notifications Push doivent utiliser l’encodage UTF-8.
  • Si vous incluez une image élément dans votre charge utile XML avec un attribut src non vide, vous devez être sûr d’inclure une référence à une image valide ou la notification sera supprimée.

• Cause: utilisation incorrecte des paramètres de l’API de notification Push

  Correctif: Veuillez consulter la documentation de l’API dans l’espace de noms Windows.Networking.PushNotifications pour plus de détails spécifiques.

• Cause: le type d’en-tête ne correspond pas au contenu de la notification. Si l’en-tête X-WNS-Type n’est pas défini sur une valeur (vignette, badge ou toast) qui correspond au modèle de notification spécifié dans la charge utile, la notification ne s’affiche pas. Cette incompatibilité entraîne une erreur sur le client et la notification est supprimée.

  Correctif: reportez-vous aux en-têtes de demande et de réponse du service de notification Push pour vous assurer que votre serveur d’applications utilise la valeur correcte pour l’en-tête X-WNS-Type.

• Cause: la valeur de durée de vie (TTL), définie dans l’en-tête X-WNS-TTL, est trop petite.

  Corriger: Fournissez une valeur TTL supérieure, sachant que la valeur est donnée en secondes.

Si vous ne voyez toujours pas votre notification affichée après avoir traité les points dans les étapes précédentes, consultez les étapes de résolution des problèmes pour les notifications locales dans la section de cette rubrique intitulée La notification de vignette locale n’est pas affichée pour obtenir d’autres suggestions.

La notification Push retourne un code autre que « 200 OK »

Si WNS ne retourne pas « 200 OK », votre notification ne sera pas remise au client. Si le code de retour est dans les 400, vous, en tant que développeur, devriez être en mesure de résoudre le problème.

• La demande de notification retourne « 400 Demande incorrecte »
• La demande de notification retourne « 401 Non autorisé »
• La demande de notification retourne « 401 Non autorisé », le jeton a expiré
• La demande de notification retourne « 403 Interdit »
• La demande de notification retourne « 404 Introuvable »
• La demande de notification retourne « 406 Non acceptable »
• La demande de notification retourne « 410 Gone »

La demande de notification retourne « 400 Demande incorrecte »

• Cause: l’utilisation d’un ou plusieurs en-têtes WNS peut être incorrecte ou la requête HTTP n’est pas valide.

  Correction: reportez-vous aux en-têtes de demande et de réponse du service de notification push pour vous assurer que votre serveur d’applications utilise tous les en-têtes personnalisés comme décrit.

La demande de notification retourne « 401 Non autorisé »

• Cause: Votre serveur d’applications doit utiliser l’identificateur de sécurité du package (SID de package) et la clé secrète qui vous ont été fournies lors de l’inscription de votre application. Si vous avez récemment modifié votre clé secrète dans le tableau de bord du Windows Store, vous devez également mettre à jour votre serveur d’applications.

  Fix: visitez le Windows Store Dashboard pour vérifier votre SID de programme et votre secret.

La demande de notification retourne « 401 Non autorisé », le jeton a expiré

• Cause: un jeton d’accès a une durée de vie limitée. Si vous envoyez une notification avec un jeton d’accès expiré, les informations d’identification de votre serveur d’applications ne sont pas valides et la notification ne peut pas être envoyée.

  Corriger: demandez un nouveau jeton d’accès auprès de WNS en vous authentifiant auprès de WNS à l’aide de votre identificateur de sécurité de package (SID de package) et de la clé secrète. Pour plus d’informations, consultez la vue d’ensemble Windows Push Notification Services (WNS)

La demande de notification retourne « 403 Interdit »

• Cause: cette erreur se produit lorsque le jeton d’accès que vous avez présenté ne correspond pas aux informations d’identification requises pour envoyer des notifications à l’URL du canal correspondant. Chaque application doit être inscrite auprès du Windows Store pour recevoir des informations d’identification pour son serveur d’applications. Pour chaque application, seules les informations d’identification fournies par le Windows Store peuvent être utilisées pour envoyer des notifications à cette application et elles ne peuvent être utilisées que pour cette application particulière.

  corriger: connectez-vous au tableau de bord du Windows Store avec votre compte de développeur. Sélectionnez votre application, puis cliquez sur « Fonctionnalités avancées » -> « Gérer vos paramètres de service cloud ». Sélectionnez « Identification de votre application » pour lire des instructions sur la mise à jour du manifeste de votre application pour correspondre à vos informations d’identification de service cloud.

La demande de notification retourne « 404 Introuvable »

• Cause: cette erreur signifie généralement que l’URL du canal n’est pas formée correctement. L’URL du canal ne doit jamais être falsifiée ou modifiée lorsque vous envoyez une notification à WNS. L’URL du canal doit toujours être traitée comme une chaîne opaque , vous n’avez jamais besoin d’examiner ou même de connaître son contenu.

  corriger: vérifiez que votre code ne modifie pas l’URL du canal en modifiant un ou plusieurs de ses caractères ou en modifiant son encodage.

La demande de notification retourne « 406 Non acceptable »

• Cause: WNS a des stratégies de protection en place pour empêcher les applications malveillantes d’avoir un impact négatif sur le service pour d’autres utilisateurs et développeurs. Un nombre excessif de notifications dans un délai trop court peut entraîner la suppression explicite des notifications WNS.

  Corriger: passez en revue votre fréquence de notification pour voir si elle peut être réduite ou optimisée pour produire une meilleure expérience utilisateur.

La demande de notification retourne « 410 Gone »

• Cause: l’URL du canal a expiré. Aucune autre notification ne peut être envoyée tant que votre application ne fonctionne pas et ne demande une nouvelle URL du canal.

  Corriger: Votre application du Windows Store doit demander une URL de canal chaque fois qu’elle est lancée. L’URL du canal qu’il est affecté n’est pas garantie de rester la même. Si l’URL a changé, le client doit mettre à jour les informations sur son serveur cloud.

Erreurs lors de la tentative de création d’un canal de notification Push

• La création d’un canal de notification entraîne une erreur de ERROR_NO_NETWORK
• La création d’un canal de notification entraîne une erreur de WPN_E_CLOUD_INCAPABLE
• La création d’un canal de notification entraîne une erreur de WPN_E_INVALID_APP

La création d’un canal de notification entraîne une erreur de ERROR_NO_NETWORK

• Cause: WNS nécessite une connexion Internet pour créer un canal de notification.

  Corriger: Vérifiez votre connectivité Internet.

La création d’un canal de notification entraîne une erreur de WPN_E_CLOUD_INCAPABLE

• Cause: votre application n’a pas déclaré la fonctionnalité Internet dans son manifeste d’application (package.appxmanifest).

  Corriger: Assurez-vous que votre manifeste d’application a déclaré la fonctionnalité Internet. Dans l’éditeur de manifeste Visual Studio, vous trouverez cette option sous l’onglet Fonctionnalités comme Internet (client). Pour plus d’informations, consultez Fonctionnalités.

La création d’un canal de notification entraîne une erreur de WPN_E_INVALID_APP

• Cause: votre application doit utiliser un nom de package valide. Si vous n’en avez pas encore reçu, vous pouvez l’obtenir via le portail du Windows Store sous « Fonctionnalités avancées ».

  Correctif: Pour plus d'informations sur la récupération d'un Package Security Identifier (PKSID) pour votre application du Windows Store, consultez Vue d'ensemble des Windows Push Notification Services (WNS).

Signaler un problème

Si vous avez essayé les solutions suggérées dans cette rubrique et n’avez pas résolu votre problème, publiez un message sur les forums Microsoft pour discuter avec les développeurs Microsoft et d’autres parties intéressées.

Pour les notifications Push, en plus d’une description du problème, vous pouvez être invité à fournir votre URL de canal et un exemple de réponse que vous avez reçue de WNS, y compris les codes d’erreur HTTP et les en-têtes HTTP. Il existe des en-têtes spécifiques que votre serveur d’applications doit consigner lors de la déclaration d’un problème. Pour plus d'informations, consultez les en-têtes de demande et de réponse du service de notification Push .