Push-Benachrichtigungen anpassen

Voraussetzungen

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

Verwendung eines Callbacks für Push-Ereignisse

Braze stellt einen subscribeToPushNotificationEvents()-Callback bereit, der ausgelöst wird, wenn Push-Benachrichtigungen empfangen, geöffnet oder verworfen werden. Es wird empfohlen, diesen Callback in Ihrem Application.onCreate() zu platzieren, um keine Ereignisse zu verpassen, die auftreten, während Ihre Anwendung nicht läuft.

Hinweis

Wenn Sie bisher einen angepassten Broadcast-Empfänger für diese Funktion in Ihrer Anwendung verwendet haben, können Sie ihn zugunsten dieser Integrationsoption bedenkenlos entfernen.

• java
• kotlin

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

Braze.getInstance(context).subscribeToPushNotificationEvents(event -> {
  final BrazeNotificationPayload parsedData = event.getNotificationPayload();

  //
  // The type of notification itself
  //
  final boolean isPushOpenEvent = event.getEventType() == BrazePushEventType.NOTIFICATION_OPENED;
  final boolean isPushReceivedEvent = event.getEventType() == BrazePushEventType.NOTIFICATION_RECEIVED;
  // Sent when a user has dismissed a notification
  final boolean isPushDeletedEvent = event.getEventType() == BrazePushEventType.NOTIFICATION_DELETED;

  //
  // Notification data
  //
  final String pushTitle = parsedData.getTitleText();
  final Long pushArrivalTimeMs = parsedData.getNotificationReceivedTimestampMillis();
  final String deeplink = parsedData.getDeeplink();

  //
  // Custom KVP data
  //
  final String myCustomKvp1 = parsedData.getBrazeExtras().getString("my first kvp");
  final String myCustomKvp2 = parsedData.getBrazeExtras().getString("my second kvp");
});

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

Braze.getInstance(context).subscribeToPushNotificationEvents { event ->
    val parsedData = event.notificationPayload

    //
    // The type of notification itself
    //
    val isPushOpenEvent = event.eventType == BrazePushEventType.NOTIFICATION_OPENED
    val isPushReceivedEvent = event.eventType == BrazePushEventType.NOTIFICATION_RECEIVED
    // Sent when a user has dismissed a notification
    val isPushDeletedEvent = event.eventType == BrazePushEventType.NOTIFICATION_DELETED

    //
    // Notification data
    //
    val pushTitle = parsedData.titleText
    val pushArrivalTimeMs = parsedData.notificationReceivedTimestampMillis
    val deeplink = parsedData.deeplink

    //
    // Custom KVP data
    //
    val myCustomKvp1 = parsedData.brazeExtras.getString("my first kvp")
    val myCustomKvp2 = parsedData.brazeExtras.getString("my second kvp")
}

Tipp

Bei Aktions-Buttons für Benachrichtigungen werden die BRAZE_PUSH_INTENT_NOTIFICATION_OPENED-Intents ausgelöst, wenn Buttons mit den Aktionen opens app oder deep link angeklickt werden. Die Handhabung von Deeplinks und Extras bleibt unverändert. Buttons mit close-Aktionen lösen keine BRAZE_PUSH_INTENT_NOTIFICATION_OPENED-Intents aus und schließen die Benachrichtigung automatisch.

Wichtig

Erstellen Sie Ihren Listener für Push-Benachrichtigungen in Application.onCreate, um sicherzustellen, dass er getriggert wird, wenn Endnutzer:innen auf eine Benachrichtigung tippen, während sich Ihre App in einem beendeten Zustand befindet.

Anpassen der Benachrichtigungsanzeige

Schritt 1: Angepasste Benachrichtigungs-Factory erstellen

In manchen Szenarien möchten Sie Push-Benachrichtigungen auf eine Weise anpassen, die auf dem Server umständlich oder nicht verfügbar wäre. Um Ihnen die vollständige Kontrolle über die Benachrichtigungsanzeige zu geben, haben wir die Möglichkeit hinzugefügt, Ihre eigene IBrazeNotificationFactory zu definieren, um Benachrichtigungsobjekte für die Anzeige durch Braze zu erstellen.

Wenn eine angepasste IBrazeNotificationFactory eingestellt ist, ruft Braze beim Push-Empfang die Methode createNotification() Ihrer Factory auf, bevor die Benachrichtigung den Nutzer:innen angezeigt wird. Braze übergibt ein Bundle mit Push-Daten von Braze und ein weiteres Bundle mit angepassten Schlüssel-Wert-Paaren, die entweder über das Dashboard oder die Messaging-APIs gesendet werden:

Braze übermittelt ein BrazeNotificationPayload mit Daten aus der Braze-Push-Benachrichtigung.

• java
• kotlin

1
2
3
4
5
6
7
8
9

// Factory method implemented in your custom IBrazeNotificationFactory
@Override
public Notification createNotification(BrazeNotificationPayload brazeNotificationPayload) {
  // Example of getting notification title
  String title = brazeNotificationPayload.getTitleText();

  // Example of retrieving a custom KVP ("my_key" -> "my_value")
  String customKvp = brazeNotificationPayload.getBrazeExtras().getString("my_key");
}

1
2
3
4
5
6
7
8

// Factory method implemented in your custom IBrazeNotificationFactory
override fun createNotification(brazeNotificationPayload: BrazeNotificationPayload): Notification {
  // Example of getting notification title
  val title = brazeNotificationPayload.getTitleText()

  // Example of retrieving a custom KVP ("my_key" -> "my_value")
  val customKvp = brazeNotificationPayload.getBrazeExtras().getString("my_key")
}

Sie können von Ihrer angepassten createNotification()-Methode null zurückgeben, um die Benachrichtigung vollständig zu unterdrücken, mit BrazeNotificationFactory.getInstance().createNotification() unser Standard-notification-Objekt für diese Daten abrufen und es vor der Anzeige modifizieren oder ein vollständig separates notification-Objekt für die Anzeige generieren.

Hinweis

Die Dokumentation zu den Push-Datenschlüsseln von Braze finden Sie im Android SDK.

Schritt 2: Angepasste Benachrichtigungs-Factory einstellen

Um Braze anzuweisen, Ihre angepasste Benachrichtigungs-Factory zu verwenden, nutzen Sie die Methode setCustomBrazeNotificationFactory, um Ihre IBrazeNotificationFactory einzustellen:

• java
• kotlin

1

setCustomBrazeNotificationFactory(IBrazeNotificationFactory brazeNotificationFactory);

1

setCustomBrazeNotificationFactory(brazeNotificationFactory: IBrazeNotificationFactory)

Der empfohlene Ort, um Ihre angepasste IBrazeNotificationFactory einzustellen, ist die Lifecycle-Methode Application.onCreate() (nicht Activity). Dadurch kann die Benachrichtigungs-Factory korrekt eingerichtet werden, wenn Ihr App-Prozess aktiv ist.

Wichtig

Das Erstellen einer eigenen Benachrichtigung von Grund auf ist ein fortgeschrittener Anwendungsfall und sollte nur nach gründlichen Tests und einem umfassenden Verständnis der Push-Funktionalität von Braze durchgeführt werden. Sie müssen zum Beispiel sicherstellen, dass Ihre Benachrichtigung Push-Öffnungen korrekt protokolliert.

Um Ihre angepasste IBrazeNotificationFactory zu deaktivieren und zur Standard-Braze-Behandlung für Push zurückzukehren, übergeben Sie null an den Setter der angepassten Benachrichtigungs-Factory:

• java
• kotlin

1

setCustomBrazeNotificationFactory(null);

1

setCustomBrazeNotificationFactory(null)

Mehrfarbigen Text rendern

In Braze SDK Version 3.1.1 kann HTML an ein Gerät gesendet werden, um mehrfarbigen Text in Push-Benachrichtigungen zu rendern.

Dieses Beispiel wird mit dem folgenden HTML gerendert:

1
2
3

<p><span style="color: #99cc00;">M</span>u<span style="color: #008080;">lti</span>Colo<span style="color: #ff6600;">r</span> <span style="color: #000080;">P</span><span style="color: #00ccff;">u</span><span style="color: #ff0000;">s</span><span style="color: #808080;">h</span></p>

<p><em>test</em> <span style="text-decoration: underline; background-color: #ff6600;"><strong>message</strong></span></p>

Beachten Sie, dass Android einschränkt, welche HTML-Elemente und Tags in Ihren Push-Benachrichtigungen zulässig sind. Zum Beispiel ist marquee nicht erlaubt.

Wichtig

Das Rendern von mehrfarbigem Text ist gerätespezifisch und wird möglicherweise je nach Android-Gerät oder -Version nicht korrekt angezeigt.

Um mehrfarbigen Text in einer Push-Benachrichtigung zu rendern, können Sie Ihre braze.xml oder BrazeConfig aktualisieren:

• braze.xml
• brazeconfig

1

<bool translatable="false" name="com_braze_push_notification_html_rendering_enabled">true</bool>

1
2
3
4

BrazeConfig brazeConfig = new BrazeConfig.Builder()
  .setPushHtmlRenderingEnabled(true)
  .build();
Braze.configure(this, brazeConfig);

1
2
3
4

val brazeConfig = BrazeConfig.Builder()
    .setPushHtmlRenderingEnabled(true)
    .build()
Braze.configure(this, brazeConfig)

Unterstützte HTML-Tags

Derzeit listet Google seine unterstützten HTML-Tags für Android nicht direkt in der Dokumentation auf—diese Informationen finden sich nur in der Html.java-Datei ihres Git-Repositorys. Beachten Sie dies, wenn Sie die folgende Tabelle heranziehen, da diese Informationen aus dieser Datei entnommen wurden und sich die unterstützten HTML-Tags ändern können.

Inline-Bilder rendern

Funktionsweise

Sie können ein größeres Bild in Ihrer Android-Push-Benachrichtigung mithilfe von Inline-Bild-Push präsentieren. Mit diesem Design müssen Nutzer:innen die Push-Benachrichtigung nicht manuell erweitern, um das Bild zu vergrößern. Im Gegensatz zu regulären Android-Push-Benachrichtigungen haben Inline-Bild-Push-Bilder ein Seitenverhältnis von 3:2.

Kompatibilität

Sie können zwar Inline-Bilder an jedes Gerät senden, aber Geräte und SDKs, die die Mindestversionen nicht erfüllen, zeigen stattdessen ein Standardbild an. Damit Inline-Bilder korrekt angezeigt werden, sind sowohl das Android Braze SDK v10.0.0+ als auch ein Gerät mit Android M+ erforderlich. Das SDK muss außerdem aktiviert sein, damit das Bild gerendert wird.

Hinweis

Geräte mit Android 12 werden aufgrund von Änderungen an angepassten Push-Benachrichtigungsstilen anders gerendert.

Inline-Bild-Push senden

Beim Erstellen einer Android-Push-Nachricht ist dieses Feature im Dropdown Notification Type verfügbar.

Einstellungen

Für Android-Push-Benachrichtigungen, die über das Braze-Dashboard gesendet werden, stehen zahlreiche erweiterte Einstellungen zur Verfügung. Dieser Artikel beschreibt diese Features und wie Sie sie erfolgreich nutzen können.

Benachrichtigungs-ID

Eine Benachrichtigungs-ID ist ein eindeutiger Bezeichner für eine von Ihnen gewählte Nachrichtenkategorie, der den Messaging-Dienst anweist, nur die aktuellste Nachricht dieser ID zu berücksichtigen. Durch das Festlegen einer Benachrichtigungs-ID können Sie nur die aktuellste und relevanteste Nachricht senden, anstatt einen Stapel veralteter, irrelevanter Nachrichten.

Verhindern, dass identische Benachrichtigungen überschrieben werden

Standardmäßig generiert Android bei Push-Benachrichtigungen mit identischem Titel und Textkörper dieselbe Benachrichtigungs-ID für beide Nachrichten, indem Titel- und Text-Strings gemeinsam gehasht werden. Dies führt dazu, dass die zweite Benachrichtigung die erste überschreibt und nur eine einzige Benachrichtigung in der Benachrichtigungsleiste angezeigt wird.

Um zu verhindern, dass identische Benachrichtigungen sich gegenseitig überschreiben, können Sie eindeutige Benachrichtigungs-ID-Werte in Ihren Android-Push-Benachrichtigungseinstellungen angeben. Hier sind einige Optionen:

• Liquid-Templating mit Zeitstempel verwenden: Generieren Sie einen eindeutigen Wert basierend auf der aktuellen Uhrzeit.

1
2

{% assign random_number = 'now' | date: '%s' | plus: 1000000 %}
{{random_number}}

• Serverseitige Generierung: Für wirklich zufällige Werte generieren Sie die Benachrichtigungs-ID auf Ihrem Server und übergeben sie über Liquid. So wird sichergestellt, dass jede Benachrichtigung einen eigenen Bezeichner hat, sodass mehrere Benachrichtigungen gleichzeitig angezeigt werden können.

Firebase Messaging Zustellungspriorität

Das Feld Firebase Messaging Zustellungspriorität ermöglicht es Ihnen zu steuern, ob ein Push mit „normal“- oder „high“-Priorität an Firebase Cloud Messaging gesendet wird.

TTL (Time to Live)

Das Feld TTL (Time to Live) ermöglicht es Ihnen, eine angepasste Speicherdauer für Nachrichten beim Push-Messaging-Dienst festzulegen. Die Standardwerte für die TTL betragen vier Wochen für FCM und 31 Tage für ADM.

Zusammenfassungstext

Der Zusammenfassungstext ermöglicht es Ihnen, zusätzlichen Text in der erweiterten Benachrichtigungsansicht festzulegen. Er dient auch als Bildunterschrift für Benachrichtigungen mit Bildern.

Der Zusammenfassungstext wird in der erweiterten Ansicht unterhalb des Nachrichtentexts angezeigt.

Bei Push-Benachrichtigungen, die Bilder enthalten, wird der Nachrichtentext in der zusammengeklappten Ansicht angezeigt, während der Zusammenfassungstext als Bildunterschrift dargestellt wird, wenn die Benachrichtigung erweitert wird.

Angepasste URIs

Das Feature Angepasste URI ermöglicht es Ihnen, eine Web-URL oder eine Android-Ressource anzugeben, zu der navigiert wird, wenn die Benachrichtigung angeklickt wird. Wenn kein angepasster URI angegeben wird, gelangen Nutzer:innen beim Klicken auf die Benachrichtigung in Ihre App. Sie können den angepassten URI verwenden, um Deeplinks innerhalb Ihrer App zu setzen und Nutzer:innen zu Ressourcen außerhalb Ihrer App zu leiten. Dies kann über die Messaging-API oder in unserem Dashboard unter Erweiterte Einstellungen im Push-Composer angegeben werden, wie dargestellt:

Anzeigepriorität der Benachrichtigung

Wichtig

Die Einstellung für die Anzeigepriorität der Benachrichtigung wird auf Geräten mit Android O oder neuer nicht mehr verwendet. Für neuere Geräte legen Sie die Priorität über die Benachrichtigungskanal-Konfiguration fest.

Die Prioritätsstufe einer Push-Benachrichtigung beeinflusst, wie Ihre Benachrichtigung in der Benachrichtigungsleiste im Vergleich zu anderen Benachrichtigungen angezeigt wird. Sie kann auch die Geschwindigkeit und Art der Zustellung beeinflussen, da Nachrichten mit normaler und niedriger Priorität mit etwas höherer Latenz gesendet oder gebündelt werden können, um die Akkulaufzeit zu schonen, während Nachrichten mit hoher Priorität immer sofort gesendet werden.

Ab Android O wurde die Benachrichtigungspriorität zu einer Eigenschaft von Benachrichtigungskanälen. Sie müssen mit Ihren Entwickler:innen zusammenarbeiten, um die Priorität für einen Kanal während seiner Konfiguration festzulegen, und dann das Dashboard verwenden, um den richtigen Kanal beim Senden Ihrer Benachrichtigungstöne auszuwählen. Für Geräte mit Android-Versionen vor O ist es möglich, eine Prioritätsstufe für Android-Benachrichtigungen über das Braze-Dashboard und die Messaging-API festzulegen.

Um Ihre gesamte Nutzerbasis mit einer bestimmten Priorität anzusprechen, empfehlen wir Ihnen, die Priorität indirekt über die Benachrichtigungskanal-Konfiguration (für O+-Geräte) festzulegen und die individuelle Priorität über das Dashboard zu senden (für <O-Geräte).

Die Prioritätsstufen, die Sie für Android- oder Fire OS-Push-Benachrichtigungen festlegen können, sind:

Weitere Informationen finden Sie in der Google-Dokumentation zu Android-Benachrichtigungen.

Töne

Ab Android O wurden Benachrichtigungstöne zu einer Eigenschaft von Benachrichtigungskanälen. Sie müssen mit Ihren Entwickler:innen zusammenarbeiten, um den Ton für einen Kanal während seiner Konfiguration festzulegen, und dann das Dashboard verwenden, um den richtigen Kanal beim Senden Ihrer Benachrichtigungen auszuwählen.

Für Geräte mit Android-Versionen vor O ermöglicht Braze Ihnen, den Ton einer einzelnen Push-Nachricht über den Dashboard-Composer festzulegen. Sie können dies tun, indem Sie eine lokale Sound-Ressource auf dem Gerät angeben (z. B. android.resource://com.mycompany.myapp/raw/mysound). Wenn in diesem Feld „default“ angegeben wird, wird der Standard-Benachrichtigungston des Geräts abgespielt. Dies kann über die Messaging-API oder das Dashboard unter Erweiterte Einstellungen im Push-Composer angegeben werden.

Geben Sie den vollständigen Sound-Ressourcen-URI (z. B. android.resource://com.mycompany.myapp/raw/mysound) in das Dashboard-Eingabefeld ein.

Um Ihre gesamte Nutzerbasis mit einem bestimmten Ton anzusprechen, empfehlen wir Ihnen, den Ton indirekt über die Benachrichtigungskanal-Konfiguration (für O+-Geräte) festzulegen und den individuellen Ton über das Dashboard zu senden (für <O-Geräte).