Push-Benachrichtigung an Teilmengen deiner App-Nutzer senden

Aktualisiert am 29. Juli 2021 von Jan Bunk

Die auf dieser Seite beschriebenen Funktionen benötigen das Push-Benachrichtigungs-Addon. Bitte kontaktiere uns, wenn es für deine App noch nicht aktiviert ist.

Das grundlegende Konzept, wie du Push-Benachrichtigungen an eine Gruppe von Nutzern deiner App senden kannst, ist wie folgt:

  1. Dein Nutzer John öffnet deine App (für dieses Beispiel gehen wir davon aus, dass es sich um eine Shopping-App handelt).
  2. John führt eine Aktion aus, die ihn zu einem Teil deiner Zielgruppe macht, zum Beispiel das Drücken eines Buttons, um Benachrichtigungen über Rabatte auf Küchenutensilien zu abonnieren. Die Aktion könnte auch einfach nur das Durchstöbern der Küchenutensilienabteilung deiner App sein, was bedeuten könnte, dass John an Produkten für seine Küche interessiert ist.
  3. Deine Webseite ruft die Javascript-Funktion "setNotificationTopicSubscriptionStatus" mit dem Namen des Themas auf, das John abonnieren soll, zum Beispiel "kitchen".
  4. Später kannst du eine Benachrichtigung an John und alle anderen Nutzer, die dieses Thema abonniert haben, senden. Wenn du zum Beispiel einen Rabattcode für Küchenartikel hast, könntest du eine Benachrichtigung an alle senden, die das Thema "kitchen" abonniert haben, um sie über den Rabatt zu informieren.

Verfügbare Javascript Funktionen

Schau dir gerne auch die executeWhenAppReady() Funktion von unser App-Helfer-Skript. Sie stellt sicher, dass deine Website nicht versucht, mit der App zu interagieren, bevor die App bereit ist oder wenn die Website mit einem normalen Browser geladen wird.

Wenn eine App-Instanz ein Push-Benachrichtigungsthema abonnieren soll, rufe einfach die Funktion setNotificationTopicSubscriptionStatus mit dem neuen Abonnement-Status (true = abonniert, false = nicht abonniert) und deinem gewünschten Themennamen auf.


<script>
    try {
        await setNotificationTopicSubscriptionStatus(true, "mytopic");
    }
    catch (e) {
        // Can occur if:
        // - you passed an invalid topic name.
        // - you didn't pass all necessary parameters to setNotificationTopicSubscriptionStatus().
        // - the app couldn't subscribe to the topic, for example because of connection issues. Should be very unlikely.
        // - the app couldn't connect to the native code. Should be very unlikely.
        // - push notifications are not enabled for your app
        console.log(e);
    }
</script>

Dinge, die du im Hinterkopf behalten solltest:

  • Das Thema muss den folgenden Regex erfüllen: [a-zA-Z0-9-_.~%]{1,850}
  • Obwohl es unwahrscheinlich ist, könnte das Abonnieren fehlschlagen, also stelle sicher, dass du mögliche Fehler abfängst.

Vielleicht möchtest du später auch eine Liste der Themen erhalten, die die App-Instanz abonniert hat. Der Rückgabewert ist eine Liste von Strings.


<script>
    try {
        var topics = (await getSubscribedNotificationTopics())["topics"];
    }
    catch (e) {
        // Can occur if:
        // - the app couldn't connect to the native code. Should be very unlikely.
        // - push notifications are not enabled for your app
        console.log(e);
    }
</script>

Senden einer Themen-Benachrichtigung über die webtoapp.design API

Hol dir deinen App-spezifischen API-Schlüssel von deinem App Dashboard.

Sende deinen API-Schlüssel als Query in der URL und den Request Body im JSON-Format.