Web-Push-Konfiguration

Um mit dem Senden von Web-Push-Benachrichtigungen mit Pushwoosh zu beginnen, müssen Sie Ihre Web-Push-Plattform konfigurieren und die Abonnement-Aufforderung aktivieren, die den Benutzern angezeigt wird.

Wichtig

Stellen Sie sicher, dass das Web Push SDK ordnungsgemäß in Ihre Website integriert ist. Dies ist ein erforderlicher Schritt, damit Benutzer Benachrichtigungen abonnieren und empfangen können. Erfahren Sie mehr

Um mit der Konfiguration zu beginnen, gehen Sie zu Einstellungen > Plattformkonfiguration > Web-Push-Benachrichtigungen und klicken Sie auf Konfigurieren.

Konfigurieren Sie Web-Push für alle Browser (außer ältere Safari-Versionen)

Diese Konfiguration gilt für alle modernen Browser, einschließlich der neuesten Versionen von Safari, die jetzt Web-Push-Benachrichtigungen nativ unterstützen.

Hinweis: Ältere Safari-Versionen (macOS 10.14–12) erfordern eine separate Einrichtung. Sie können dies in einem speziellen Abschnitt konfigurieren. Erfahren Sie mehr

Um mit der Einrichtung zu beginnen, klicken Sie unter Konfiguration für alle Browser auf Konfigurieren.

Wählen Sie im Konfigurationsfenster eine der folgenden Optionen:

• Eine neue Push-Konfiguration erstellen Empfohlen, wenn Sie zuvor keine Web-Push-Benachrichtigungen über einen anderen Dienst eingerichtet haben. Pushwoosh generiert automatisch ein neues VAPID-Schlüsselpaar.

• Bestehende Konfiguration verwenden Wählen Sie diese Option, wenn Sie bereits VAPID-Schlüssel haben, zum Beispiel von Firebase, und diese weiterhin verwenden möchten, ohne die Benutzer erneut zum Abonnieren aufzufordern.

Eine neue Push-Konfiguration erstellen

Wählen Sie Eine neue Push-Konfiguration erstellen, wenn Sie zuvor keine Web-Push-Benachrichtigungen mit einem anderen Dienst eingerichtet haben. Pushwoosh generiert automatisch die erforderlichen VAPID-Schlüssel (Voluntary Application Server Identification) für Sie.

Was sind VAPID-Schlüssel?

VAPID-Schlüssel sind ein öffentlich-privates Schlüsselpaar, das im Web-Push-Protokoll verwendet wird, um den Anwendungsserver beim Senden von Push-Benachrichtigungen an Webbrowser zu authentifizieren. Der öffentliche Schlüssel wird mit dem Browser geteilt, wenn ein Benutzer Benachrichtigungen abonniert. Der private Schlüssel verbleibt auf Ihrem Server und wird verwendet, um jede von Ihnen gesendete Nachricht sicher zu signieren.

Klicken Sie auf Konfigurieren, um die Schlüssel zu generieren und anzuwenden.

Nach der Erstellung verwendet Pushwoosh diese Schlüssel automatisch in der SDK-Konfiguration. Erfahren Sie mehr über die Integration des Web Push SDK

Bestehende Konfiguration verwenden

Wenn Sie bereits VAPID-Schlüssel haben (wie die, die über Firebase generiert wurden), können Sie diese wiederverwenden, um Web-Push-Benachrichtigungen in Pushwoosh einzurichten.

Dafür:

1. Wählen Sie Bestehende Konfiguration verwenden.

2. Geben Sie im Feld Web-Push-Zertifikat Ihren öffentlichen VAPID-Schlüssel ein.

3. Geben Sie im Feld Privater Web-Push-Schlüssel Ihren privaten VAPID-Schlüssel ein.

4. Klicken Sie auf Konfigurieren, um die Einstellungen zu speichern und anzuwenden.

So finden Sie VAPID-Schlüssel in Firebase

Wenn Sie von Firebase migrieren und Ihre vorhandenen VAPID-Schlüssel wiederverwenden müssen, folgen Sie diesen Schritten, um sie zu finden.

Web-Push-Zertifikat

1. Navigieren Sie in Firebase zu Projekteinstellungen → Cloud Messaging.
2. Scrollen Sie nach unten zum Abschnitt Web-Konfiguration und kopieren Sie das vorhandene Schlüsselpaar.

3. Fügen Sie es in das Feld Web-Push-Zertifikat im Pushwoosh-Webkonfigurationsformular ein.

Privater Web-Push-Schlüssel

1. Gehen Sie in der Firebase Console zu Projekteinstellungen → Cloud Messaging → Web-Konfiguration.
2. Klicken Sie auf das Drei-Punkte-Menü unter Aktionen neben dem Schlüsselpaar und wählen Sie Privaten Schlüssel anzeigen. Dieser Schlüssel ist unerlässlich, um sicherzustellen, dass Web-Push-Benachrichtigungen korrekt funktionieren.

3. Kopieren Sie den angezeigten Schlüssel in Ihre Zwischenablage.

4. Fügen Sie ihn im Pushwoosh-Webkonfigurationsformular in das Feld Privater Web-Push-Schlüssel ein.

5. Klicken Sie auf Anwenden, um Ihre Änderungen zu speichern.

Web-Push-Konfiguration neu konfigurieren

Wenn Sie bereits Web-Push-Benachrichtigungen eingerichtet haben, aber Ihre Anmeldeinformationen aktualisieren müssen (z. B. Ihre VAPID-Schlüssel ersetzen), gehen Sie wie folgt vor:

1. Klicken Sie unter Konfiguration für alle Browser auf Neu konfigurieren.

2. Geben Sie im erscheinenden Popup Ihre neuen VAPID-Schlüssel ein:

   • Web-Push-Zertifikat: Ihr neuer öffentlicher VAPID-Schlüssel
   • Privater Web-Push-Schlüssel: Ihr neuer privater VAPID-Schlüssel

3. Klicken Sie auf Konfigurieren, um die Änderungen zu speichern.

Wichtig

Das Ersetzen Ihrer VAPID-Schlüssel wirkt sich auf Ihre gesamte Web-Push-Einrichtung aus und kann die Zustellung von Benachrichtigungen stören, wenn es nicht korrekt gehandhabt wird. Ändern Sie die Schlüssel nur, wenn es wirklich notwendig ist, und stellen Sie sicher, dass Sie die Auswirkungen verstehen, bevor Sie Aktualisierungen vornehmen.

Die Abonnement-Aufforderung konfigurieren

Um Push-Benachrichtigungen zu senden, müssen Benutzer explizit über die systemeigene Aufforderung des Browsers die Erlaubnis erteilen. Ohne diese Erlaubnis können keine Benachrichtigungen zugestellt werden.

Aufgrund der jüngsten Richtlinienänderungen von Chrome und Firefox kann das native Berechtigungs-Popup nur erscheinen, nachdem der Benutzer mit der Seite interagiert hat (z. B. durch Klicken auf eine Schaltfläche). Um diese Anforderung zu erfüllen, zeigt Pushwoosh standardmäßig ein Abonnement-Aufforderungs-Widget an. Dieses Widget ermutigt Benutzer, sich anzumelden, und löst bei Zustimmung die native Browser-Aufforderung aus.

Tipp

Eine gut gestaltete Aufforderung, die den Wert von Benachrichtigungen erklärt (z. B. „Erhalten Sie die neuesten Nachrichten und Updates“), kann die Anmelderaten erheblich verbessern.

Um den Text und das Erscheinungsbild der Aufforderung anzupassen, klicken Sie auf Einstellungen.

Arten von Aufforderungen

Es gibt zwei Arten von Abonnement-Aufforderungen:

• Standard-Widget Wird von Pushwoosh bereitgestellt und automatisch angezeigt. Erfahren Sie, wie Sie das Standard-Widget anpassen.

• Benutzerdefiniertes Widget Verwenden Sie Ihr eigenes Widget-Design. Erfahren Sie mehr

Hinweis: Aufgrund von Plattformbeschränkungen kann es bis zu 30 Minuten dauern, bis Änderungen am Widget angezeigt werden. Wenn die Änderungen nicht übernommen werden, wenden Sie sich an das Pushwoosh-Support-Team.

Safari-Konfiguration (macOS 10.14–12)

Um Push-Benachrichtigungen auf älteren Versionen von Safari (macOS 10.14–12) zu unterstützen, müssen Sie einen separaten Konfigurationsprozess mit Ihren Apple-Entwickleranmeldeinformationen durchführen. Dieser Schritt ist nur für diese älteren Versionen erforderlich, da neuere Safari-Versionen (macOS Ventura und neuer) die Standard-Web-Push-Einrichtung unterstützen, die in der Konfiguration für alle Browser enthalten ist.

Holen Sie sich die erforderlichen Anmeldeinformationen von Apple

1. Gehen Sie zum Abschnitt Zertifikate, Kennungen & Profile des Apple Developer Portals.

2. Fügen Sie ein neues Zertifikat hinzu.

3. Wählen Sie den Zertifikatstyp Website Push ID Certificate und klicken Sie auf Weiter.

4. Wählen Sie die Website Push ID aus – Ihre eindeutige Reverse-Domain-Zeichenfolge, wie z. B. web.com.example.domain (muss mit web. beginnen).

5. Laden Sie eine Zertifikatsignierungsanforderung hoch. Um mehr über das Erstellen von Zertifikatsignierungsanforderungen zu erfahren, lesen Sie bitte den Hilfeartikel zum Entwicklerkonto.

6. Laden Sie anschließend das Push-Benachrichtigungszertifikat herunter.

Hinweis

Das Zertifikat, das Sie von Apple herunterladen, ist eine .cer-Datei. Um die für die Konfiguration von Pushwoosh erforderliche .p12-Datei zu erhalten, müssen Sie einen privaten Schlüssel exportieren. Details finden Sie in der Anleitung zur iOS-Konfiguration.

Safari in Pushwoosh konfigurieren

1. Klicken Sie unter Safari-Konfiguration auf Konfigurieren.

2. Füllen Sie die folgenden Felder im Konfigurationsformular aus:

Name der Website	Der Name Ihrer Website, der in der Push-Aufforderung erscheint.
Zulässige Domains	Liste der Domains, die die Berechtigung zur Benachrichtigung anfordern dürfen (eine pro Zeile).
URL-Vorlage	URL, die geöffnet wird, wenn ein Benutzer auf die Benachrichtigung klickt. Unterstützt Platzhalter wie %@, um dynamische Werte einzufügen. Beispiel: https://yourwebsite.com/%@
Website-Symbol	Laden Sie ein quadratisches PNG-Bild (256×256 px) hoch. Pushwoosh passt die Größe automatisch für verschiedene Oberflächen an.
Schlüsseldatei	Laden Sie das aus Ihrem Apple-Entwicklerkonto exportierte .p12-Zertifikat hoch.
Passwort für den privaten Schlüssel	Passwort, das beim Exportieren der .p12-Datei verwendet wurde.

3. Klicken Sie auf Konfigurieren, um Ihre Änderungen zu speichern.

Pushwoosh generiert automatisch das Push-Paket mit dem Icon-Set, dem Website-JSON-Wörterbuch und der Manifest-Datei, die Safari vom Server anfordert. Sie können es jederzeit herunterladen.

Wichtig

Wenn ein Benutzer um die Erlaubnis zum Empfang von Push-Benachrichtigungen gebeten wird, fordert Safari vom Webserver von Pushwoosh ein push package an. Das Paket enthält Daten, die von der Benutzeroberfläche der Benachrichtigung verwendet werden, wie z. B. den Namen und das Symbol Ihrer Website, sowie eine kryptografische Signatur, die überprüft, ob Ihre Benachrichtigung von einer vertrauenswürdigen Quelle stammt: Ihnen.

Das Push-Paket mit all seinen Inhalten wird von jedem abonnierten Benutzer NUR EINMAL bei der Registrierung heruntergeladen und kann nicht zwangsweise auf Geräten aktualisiert werden.

Berücksichtigen Sie dies, wenn Sie Safari-Push-Benachrichtigungen für Ihre Website in der Produktion starten.