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 eine Endnutzer:in auf eine Benachrichtigung tippt, während sich Ihre App in einem beendeten Zustand befindet.

Anpassen der Benachrichtigungsanzeige

1. Schritt: 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 der Nutzer:in 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.

2. Schritt: 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 der Braze SDK-Version 3.1.1 kann HTML an ein Gerät gesendet werden, um mehrfarbigen Text in Push-Benachrichtigungen darzustellen.

Dieses Beispiel wird mit dem folgenden HTML-Code 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>

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

Wichtig

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

Um mehrfarbigen Text in einer Push-Benachrichtigung darzustellen, 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 die unterstützten HTML-Tags für Android nicht direkt in seiner Dokumentation auf—diese Informationen sind nur in der Html.java-Datei des Git-Repositorys zu finden. Bitte beachten Sie dies, wenn Sie sich auf die folgende Tabelle beziehen, da diese Informationen aus dieser Datei stammen und sich die unterstützten HTML-Tags ändern können.

Inline-Bilder rendern

Funktionsweise

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

Kompatibilität

Sie können Inline-Bilder an jedes Gerät senden. Geräte und SDKs, die nicht die Mindestversionen 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 ebenfalls aktiviert sein, damit das Bild gerendert werden kann.

Hinweis

Geräte mit Android 12 werden aufgrund von Änderungen bei den angepassten Push-Benachrichtigungsstilen anders dargestellt.

Versenden eines Inline-Bild-Pushs

Wenn Sie eine Android-Push-Nachricht erstellen, ist diese Funktion im Dropdown-Menü Notification Type verfügbar.

Einstellungen

Für Android-Push-Benachrichtigungen, die über das Braze-Dashboard versendet 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 dem Messaging-Dienst mitteilt, dass er nur die jüngste Nachricht mit dieser ID berücksichtigen soll. Wenn Sie eine Benachrichtigungs-ID festlegen, können Sie nur die aktuellste und relevanteste Nachricht versenden, anstatt einen Stapel veralteter, irrelevanter Nachrichten.

Priorität der Firebase-Nachrichtenzustellung

Mit dem Feld Firebase Messaging Delivery Priority können Sie festlegen, ob ein Push mit „normaler“ oder „hoher“ Priorität an Firebase Cloud Messaging gesendet wird.

Lebensdauer (TTL)

Im Feld Time to Live (TTL) können Sie eine angepasste Zeitspanne für die Speicherung von Nachrichten beim Push-Messaging-Dienst festlegen. Die Standardwerte für die Lebensdauer betragen vier Wochen für FCM und 31 Tage für ADM.

Zusammenfassungstext

Mit dem Zusammenfassungstext können Sie zusätzlichen Text in der erweiterten Benachrichtigungsansicht einstellen. Er dient auch als Bildunterschrift für Benachrichtigungen mit Bildern.

Der Zusammenfassungstext wird in der erweiterten Ansicht unter dem Text der Nachricht angezeigt.

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

Angepasste URIs

Mit der Funktion Custom URI können Sie eine Web-URL oder eine Android-Ressource angeben, zu der navigiert werden soll, wenn die Benachrichtigung angeklickt wird. Wenn keine angepasste URI angegeben ist, gelangen Nutzer:innen durch Klicken auf die Benachrichtigung zu Ihrer App. Sie können die angepasste URI verwenden, um Deeplinks in Ihrer App zu setzen und Nutzer:innen zu Ressourcen außerhalb Ihrer App zu leiten. Dies kann über die Messaging-API oder unser Dashboard unter Advanced Settings im Push Composer wie abgebildet festgelegt werden:

Benachrichtigungs-Anzeigepriorität

Wichtig

Die Einstellung für die Benachrichtigungs-Anzeigepriorität wird auf Geräten mit Android O oder neuer nicht mehr verwendet. Bei neueren Geräten legen Sie die Priorität über die Konfiguration des Benachrichtigungskanals fest.

Die Prioritätsstufe einer Push-Benachrichtigung wirkt sich darauf aus, wie Ihre Benachrichtigung im Vergleich zu anderen Benachrichtigungen in der Benachrichtigungsleiste angezeigt wird. Dies kann sich auch auf die Geschwindigkeit und die Art der Zustellung auswirken, da normale Nachrichten und Nachrichten mit geringerer Priorität mit etwas höherer Latenz oder in Stapeln gesendet werden, um den Akku zu schonen, während Nachrichten mit hoher Priorität immer sofort gesendet werden.

In Android O wurde die Benachrichtigungspriorität eine Eigenschaft der Benachrichtigungskanäle. Sie müssen mit Ihrer Entwickler:in zusammenarbeiten, um die Priorität für einen Kanal während seiner Konfiguration festzulegen, und dann das Dashboard verwenden, um den richtigen Kanal auszuwählen, wenn Sie Ihre Benachrichtigungstöne senden. Bei Geräten, auf denen Android-Versionen vor O laufen, ist es möglich, über das Braze-Dashboard und die Messaging-API eine Prioritätsstufe für Android-Benachrichtigungen festzulegen.

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

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

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

Töne

In Android O wurden die Benachrichtigungstöne eine Eigenschaft der Benachrichtigungskanäle. Sie müssen mit Ihrer Entwickler:in zusammenarbeiten, um den Ton für einen Kanal während seiner Konfiguration zu definieren, und dann das Dashboard verwenden, um den richtigen Kanal auszuwählen, wenn Sie Ihre Benachrichtigungen senden.

Für Geräte mit Android-Versionen vor O können Sie mit Braze den Ton einer einzelnen Push-Nachricht über den Dashboard Composer einstellen. Hierzu können Sie eine lokale Tonressource auf dem Gerät angeben (z. B. android.resource://com.mycompany.myapp/raw/mysound). Wenn Sie in diesem Feld „default“ angeben, wird der standardmäßige Benachrichtigungston auf dem Gerät abgespielt. Dies kann über die Messaging-API oder das Dashboard unter Advanced Settings im Push Composer festgelegt werden.

Geben Sie die vollständige URI der Tonressource (z. B. android.resource://com.mycompany.myapp/raw/mysound) in die Eingabeaufforderung des Dashboards ein.

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