Sanfte Push-Aufforderungen für das Internet

Voraussetzungen

Bevor Sie dieses Feature nutzen können, müssen Sie das Braze Web SDK integrieren. Außerdem müssen Sie Push-Benachrichtigungen einrichten.

Wenn Sie Braze über das eingebettete Kit von mParticle im Web integrieren, lesen Sie Schritt 3 in der Braze-Web-Event-Integration von mParticle für Anweisungen zur Implementierung von sanften Push-Aufforderungen.

Über sanfte Push-Aufforderungen

Es ist oft sinnvoll, auf Websites eine „sanfte“ Push-Aufforderung zu implementieren, bei der Sie die Nutzer:innen vorbereiten und ihnen den Mehrwert von Push-Benachrichtigungen erklären, bevor Sie die Push-Berechtigung anfordern. Dies ist nützlich, weil der Browser die Häufigkeit einschränkt, mit der Sie Nutzer:innen direkt auffordern dürfen, und wenn Nutzer:innen die Berechtigung ablehnen, können Sie sie nie wieder fragen.

Alternativ können Sie, wenn Sie eine spezielle angepasste Behandlung einbinden möchten, anstatt requestPushPermission() direkt aufzurufen, wie in der standardmäßigen Web-Push-Integration beschrieben, unsere getriggerten In-App-Nachrichten verwenden.

Tipp

Dies kann ohne SDK-Anpassung mithilfe unseres neuen No-Code-Push-Primers erfolgen.

Sanfte Push-Aufforderungen einrichten

Hinweis

Diese Anleitung verwendet Codebeispiele aus dem Braze Web SDK 4.0.0+. Um ein Upgrade auf die neueste Web SDK-Version durchzuführen, siehe SDK Upgrade Guide.

Schritt 1: Push-Primer-Campaign erstellen

Zunächst müssen Sie eine „Prime for Push“-In-App-Messaging-Campaign im Braze-Dashboard erstellen:

1. Erstellen Sie eine modale In-App-Nachricht mit dem gewünschten Text und Styling.
2. Setzen Sie anschließend das Klickverhalten auf Nachricht schließen. Dieses Verhalten wird später angepasst.
3. Fügen Sie der Nachricht ein Schlüssel-Wert-Paar hinzu, wobei der Schlüssel msg-id und der Wert push-primer ist.
4. Weisen Sie der Nachricht eine angepasste Event-Trigger-Aktion zu (z. B. „prime-for-push“). Sie können das angepasste Event bei Bedarf manuell über das Dashboard erstellen.

Schritt 2: Aufrufe entfernen

Suchen und entfernen Sie in Ihrer Braze-SDK-Integration alle Aufrufe von automaticallyShowInAppMessages() aus Ihrem Lade-Snippet.

Schritt 3: Integration aktualisieren

Ersetzen Sie abschließend den entfernten Aufruf durch das folgende Snippet. Rufen Sie subscribeToInAppMessage() auf, bevor Sie openSession() aufrufen. So wird sichergestellt, dass Ihr In-App-Nachrichten-Listener rechtzeitig registriert ist, um die Push-Primer-Nachricht zu empfangen.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

import * as braze from "@braze/web-sdk";
// Be sure to remove any calls to braze.automaticallyShowInAppMessages()
braze.subscribeToInAppMessage(function(inAppMessage) {
  // check if message is not a control variant
  if (inAppMessage instanceof braze.inAppMessage) {
    // access the key-value pairs, defined as `extras`
    const keyValuePairs = inAppMessage.extras || {};
    // check the value of our key `msg-id` defined in the Braze dashboard
    if (keyValuePairs["msg-id"] === "push-primer") {
      // We don't want to display the soft push prompt to users on browsers
      // that don't support push, or if the user has already granted/blocked permission
      if (
        braze.isPushSupported() === false ||
        braze.isPushPermissionGranted() ||
        braze.isPushBlocked()
      ) {
        // do not call `showInAppMessage`
        return;
      }

      // user is eligible to receive the native prompt
      // register a click handler on one of the two buttons
      if (inAppMessage.buttons[0]) {
        // Prompt the user when the first button is clicked
        inAppMessage.buttons[0].subscribeToClickedEvent(function() {
          braze.requestPushPermission(
            function() {
              // success!
            },
            function() {
              // user declined
            }
          );
        });
      }
    }
  }

  // show the in-app message now
  braze.showInAppMessage(inAppMessage);
});

Wenn Sie die sanfte Push-Aufforderung den Nutzer:innen anzeigen möchten, rufen Sie braze.logCustomEvent auf – mit dem Event-Namen, der diese In-App-Nachricht triggert.