Problemen met WNS-pushmeldingen oplossen

In dit onderwerp worden de eerste stappen voor probleemoplossing besproken die u moet uitvoeren wanneer u problemen ondervindt met tegel-, pop-up- en badgemeldingen, waaronder de verschillende meldingsmethoden: lokaal, pushen, periodiek en geplande meldingen.

Specifieke fouten oplossen

In deze sectie worden enkele veelvoorkomende fouten beschreven die kunnen optreden tijdens het werken met pushmeldingen.

• Uw gebeurtenislogboeken controleren
• Pushmelding ontvangt een '200 OK'-antwoord, maar wordt niet weergegeven
• Pushmelding retourneert een andere code dan '200 OK'
• Fouten bij het maken van een pushmeldingskanaal

Uw gebeurtenislogboeken controleren

Als tile- of toastmeldingen niet worden weergegeven zoals verwacht, kijk dan naar de gebeurtenislogboeken.

• Als de melding wordt ontvangen, maar niet wordt weergegeven: Open Logboeken en controleer het Microsoft-Windows-TWinUI/Operationeel logboek onder Applications and Services\Microsoft\Windows\Apps.
• Als de melding helemaal niet wordt ontvangen: Start de Event Viewer en bekijk het Operationele Logboek onder Toepassingen en Services\Microsoft\Windows\PushNotifications-Platform.

Pushmelding ontvangt een '200 OK'-antwoord, maar wordt niet weergegeven

Als Windows Push Notification Services (WNS) een '200 OK'-antwoord retourneert, wordt de melding aan de client geleverd als de client online is. Als u hebt gecontroleerd of de client online is, maar de melding niet weergeeft, voert u de volgende stappen uit:

• Oorzaak: XML-fouten in de meldingsinhoud.

  Oplossing: Controleer de xml-basissyntaxis en zorg ervoor dat uw XML is voltooid en juist is. Enkele veelvoorkomende fouten in de XML-inhoud zijn:

  • Case sensitivity. Tagnamen, kenmerknamen en kenmerkwaarden zijn allemaal hoofdlettergevoelig. Zorg ervoor dat uw XML de juiste behuizing heeft.
  • Er moet een bindingselement worden opgegeven voor elke ondersteunde tegelindeling. U moet een -bindingselement opgeven voor elk van de tegelformaten die u ondersteunt in iedere melding die u verstuurt.
  • Tekstreeksen mogen geen gereserveerde XML-tekens bevatten. U kunt bijvoorbeeld geen tegel- of toast-berichten cursief maken door <i> en </i> tags te gebruiken. Als u de letterlijke tekens '<i>' wilt weergeven, moeten ze correct geëscaped worden. Zie XML-tekenentiteiten en XAML voor meer informatie over escapetekens in XML.
  • De opgegeven waarden voor de lang-kenmerken moeten voldoen aan de ITEF BCP 47-specificatie .
  • XML-tekenreeksen die via pushmeldingen worden verzonden, moeten gebruikmaken van de UTF-8-codering.
  • Als u een afbeeldingselement opneemt in uw XML-nettolading met een niet-leeg src-kenmerk, moet u ervoor zorgen dat u een verwijzing naar een geldige afbeelding opneemt of dat de melding wordt verwijderd.

• Oorzaak: Onjuist gebruik van API-parameters voor pushmeldingen

  Fix: Zie de API-documentatie in de Windows.Networking.PushNotifications naamruimte voor specifieke informatie.

• Oorzaak: het headertype komt niet overeen met de inhoud van de melding. Als de header X-WNS-Type niet is ingesteld op een waarde (tile, badge of melding) die overeenkomt met de meldingssjabloon die is opgegeven in de payload, wordt de melding niet weergegeven. Deze niet-overeenkomende fout veroorzaakt een fout op de client en de melding wordt verwijderd.

  Oplossing: Raadpleeg aanvraag- en antwoordheaders voor pushmeldingen om ervoor te zorgen dat de app-server de juiste waarde gebruikt voor de X-WNS-Type-header.

• Oorzaak: De TTL-waarde (Time to Live), ingesteld in de X-WNS-TTL header, is te klein.

  Oplossing: Geef een grotere TTL-waarde op, waarbij u er rekening mee houdt dat de waarde in seconden wordt opgegeven.

Als uw melding nog steeds niet wordt weergegeven na het aanpakken van de items in de vorige stappen, raadpleegt u de stappen voor het oplossen van problemen voor lokale meldingen in de sectie "Lokale tegelmelding wordt niet weergegeven" van dit onderwerp voor verdere suggesties.

Pushmelding retourneert een andere code dan '200 OK'

Als WNS '200 OK' niet retourneert, wordt uw melding niet bezorgd bij de client. Als de retourcode in de 400-reeks valt, zou u als ontwikkelaar het probleem moeten kunnen oplossen.

• Meldingsaanvraag retourneert '400 Ongeldige aanvraag'
• Meldingsaanvraag retourneert '401 Niet geautoriseerd'
• Meldingsaanvraag retourneert '401 Niet geautoriseerd', token is verlopen
• Meldingsaanvraag retourneert '403 Verboden'
• Meldingsaanvraag retourneert '404 Niet gevonden'
• Meldingsaanvraag retourneert '406 Niet acceptabel'
• Meldingsaanvraag retourneert '410 Verdwenen'

Meldingsaanvraag retourneert '400 Ongeldige aanvraag'

• Oorzaak: Het gebruik van een of meer WNS-headers kan onjuist zijn of de HTTP-aanvraag is ongeldig.

  Oplossing: Raadpleeg aanvraag- en antwoordheaders voor pushmeldingen om ervoor te zorgen dat uw app-server gebruikmaakt van alle aangepaste headers zoals beschreven.

Meldingsaanvraag retourneert '401 Niet geautoriseerd'

• Oorzaak: uw app-server moet de juiste pakketbeveiligings-id (pakket-SID) en geheime sleutel gebruiken die u hebt gekregen bij het registreren van uw app. Als u onlangs uw geheime sleutel hebt gewijzigd in het Windows Store-dashboard, moet u ook uw app-server bijwerken.

  Fix: Ga naar het Windows StoreDashboard om uw pakket-SID en geheim te verifiëren.

Meldingsaanvraag retourneert '401 Niet geautoriseerd', token is verlopen

• Oorzaak: Een toegangstoken heeft een eindige levensduur. Als u een melding met een verlopen toegangstoken verzendt, zijn de referenties van uw app-server ongeldig en kan de melding niet worden verzonden.

  Oplossing: Vraag een nieuw toegangstoken aan vanuit WNS door te verifiëren met WNS met behulp van uw pakketbeveiligings-id (pakket-SID) en geheime sleutel. Raadpleeg voor meer informatie het overzicht Windows Push Notification Services (WNS).

Meldingsaanvraag retourneert '403 Verboden'

• Oorzaak: Deze fout treedt op wanneer het toegangstoken dat u hebt gepresenteerd niet overeenkomt met de referenties die zijn vereist voor het verzenden van meldingen naar de bijbehorende kanaal-URL. Elke app moet worden geregistreerd bij de Windows Store om referenties voor de app-server te ontvangen. Voor elke app kunnen alleen de referenties van de Windows Store worden gebruikt om meldingen naar die app te verzenden en kunnen ze alleen worden gebruikt voor die specifieke app.

  Oplossing: Meld u aan bij het Windows Store-dashboard met uw ontwikkelaarsaccount. Selecteer uw app en klik op 'Geavanceerde functies' -> 'Uw cloudservice-instellingen beheren'. Selecteer 'Uw app identificeren' om instructies te lezen voor het bijwerken van uw app-manifest zodat deze overeenkomt met uw cloudservicereferenties.

Meldingsaanvraag retourneert '404 Niet gevonden'

• Oorzaak: Deze fout betekent meestal dat de kanaal-URL niet juist is gevormd. Er mag nooit met de kanaal-URL worden geknoeid of gewijzigd wanneer u een melding naar WNS verzendt. De kanaal-URL moet altijd worden behandeld als een ondoorzichtige tekenreeks. U hoeft de inhoud ervan nooit te onderzoeken of zelfs te kennen.

  Oplossing: Controleer of uw code de kanaal-URL niet wijzigt door een of meer tekens te wijzigen of de codering ervan te wijzigen.

Meldingsaanvraag retourneert '406 Niet acceptabel'

• Oorzaak: WNS heeft beveiligingsbeleid om te voorkomen dat schadelijke apps de service voor andere gebruikers en ontwikkelaars negatief beïnvloeden. Een overmatig aantal meldingen in een te korte periode kan leiden tot het expliciet verwijderen van WNS-meldingen.

  Oplossing: Controleer uw meldingsfrequentie om te zien of deze kan worden verlaagd of geoptimaliseerd om een betere gebruikerservaring te krijgen.

Meldingsaanvraag retourneert '410 Verdwenen'

• Oorzaak: De kanaal-URL is verlopen. Er kunnen geen verdere meldingen worden verzonden totdat uw app draait en een nieuw kanaal-URL aanvraagt.

  Oplossing: Uw Windows Store-app moet een kanaal-URL aanvragen telkens wanneer deze wordt gestart. De kanaal-URL waaraan deze is toegewezen, blijft niet gegarandeerd hetzelfde. Als de URL is gewijzigd, moet de client de informatie op de cloudserver bijwerken.

Fouten bij het maken van een pushmeldingskanaal

• Het maken van een meldingskanaal resulteert in een ERROR_NO_NETWORK-fout
• Het maken van een meldingskanaal resulteert in een WPN_E_CLOUD_INCAPABLE-fout
• Het maken van een meldingskanaal resulteert in een WPN_E_INVALID_APP fout

Het maken van een meldingskanaal resulteert in een ERROR_NO_NETWORK-fout

• Oorzaak: WNS vereist een internetverbinding om een meldingskanaal te maken.

  Opgeloste: controleer de internetverbinding.

Het maken van een meldingskanaal resulteert in een WPN_E_CLOUD_INCAPABLE-fout

• Oorzaak: Uw app heeft de internetmogelijkheid niet gedeclareerd in het app-manifest (package.appxmanifest).

  Fix: Zorg ervoor dat uw app-manifest internettoegang heeft gedeclareerd. In de Visual Studio-manifesteditor vindt u deze optie op het tabblad Mogelijkheden als Internet (Client). Zie Mogelijkheden voor meer informatie.

Het maken van een meldingskanaal resulteert in een WPN_E_INVALID_APP fout

• Oorzaak: Uw app moet een geldige pakketnaam gebruiken. Als u er nog geen hebt ontvangen, kunt u deze downloaden via de Windows Store-portal onder Geavanceerde functies.

  Fix: Voor details over het ophalen van een Package Security Identifier (PKSID) voor uw Windows Store-app, zie Windows Push Notification Services (WNS) overzicht.

Een probleem melden

Als u de oplossingen in dit onderwerp hebt geprobeerd en uw probleem niet hebt opgelost, plaatst u een bericht op de Microsoft-forums om het te bespreken met zowel Microsoft-ontwikkelaars als andere belanghebbenden.

Voor pushmeldingen wordt u, naast een beschrijving van het probleem, mogelijk gevraagd om uw kanaal-URL en een voorbeeld te geven van het antwoord dat u hebt ontvangen van WNS, inclusief zowel de HTTP-foutcodes als HTTP-headers. Er zijn specifieke headers die uw app-server moet registreren bij het melden van een probleem. Zie Push Notification Service-aanvraag- en antwoordheaders voor meer informatie.