Diese Seite wurde automatisch übersetzt und kann Ungenauigkeiten enthalten. Um einen Übersetzungsfehler zu melden, nutzen Sie das Feedback unten im Inhaltsverzeichnis rechts auf der Seite.

In-App-Nachrichten

Erfahren Sie mehr über In-App-Nachrichten und wie Sie sie für das Braze SDK einrichten.

Voraussetzungen

Bevor Sie dieses Feature nutzen können, müssen Sie das Internet Braze SDK integrieren. Es ist jedoch keine zusätzliche Einrichtung erforderlich.

Nachrichtentypen

Alle In-App-Nachrichten übernehmen ihren Prototyp aus InAppMessage, wo das grundlegende Verhalten und die Merkmale für alle In-App-Nachrichten definiert ist. Die prototypischen Unterklassen sind SlideUpMessage, ModalMessage, FullScreenMessage, und HtmlMessage.

Jede Art von In-App-Nachricht ist in Bezug auf Inhalt, Bilder, Symbole, Klickaktionen, Analytics, Anzeige und Zustellung anpassbar.

SlideUp In-App-Nachrichten werden so genannt, weil sie traditionell auf mobilen Plattformen vom oberen oder unteren Bildschirmrand nach oben oder unten gleiten. Im Braze Web SDK werden diese Nachrichten eher im Stil einer Growl- oder Toast-Benachrichtigung angezeigt, um dem vorherrschenden Paradigma des Internets gerecht zu werden. Sie bedecken nur einen kleinen Teil des Bildschirms und bieten eine effektive und unaufdringliche Möglichkeit zur Nachrichtenübermittlung.

Eine In-App-Nachricht, die vom unteren Rand des Telefondisplays herabgleitet, zeigt an: "Menschen sind kompliziert. Custom Engagement sollte nicht sein." Im Hintergrund wird die gleiche In-App-Nachricht in der unteren Ecke einer Internetseite angezeigt.

Modal In-App-Nachrichten erscheinen in der Mitte des Bildschirms und werden von einem durchsichtigen Feld eingerahmt. Sie können mit bis zu zwei Schaltflächen für Klick-Aktionen und Analysen ausgestattet werden und sind damit für kritische Mitteilungen geeignet.

Modale In-App-Nachricht in der Mitte eines Smartphone-Displays mit dem Text "Menschen sind kompliziert. Custom Engagement sollte nicht sein." Im Hintergrund wird die gleiche In-App-Nachricht in der Mitte einer Internetseite angezeigt.

Full-In-App-Nachrichten sind nützlich, um den Inhalt und die Wirkung Ihrer Nutzer-Kommunikation zu maximieren. Bei schmalen Browserfenstern (z. B. auf Mobilgeräten) nehmen In-App-Nachrichten des Typs full das gesamte Browserfenster ein. In größeren Browserfenstern erscheinen die In-App-Nachrichten von full ähnlich wie die In-App-Nachrichten von modal. Die obere Hälfte einer In-App-Nachricht des Typs full enthält ein Bild. Die untere Hälfte kann bis zu acht Zeilen Text sowie und bis zu zwei durch Klickaktionen und Analytics-aktivierte Buttons enthalten.

In-App-Nachricht im Vollbildmodus, die über das gesamte Display eines Smartphones angezeigt wird, mit dem Text "Menschen sind kompliziert. Custom Engagement sollte nicht sein." Im Hintergrund wird die gleiche In-App-Nachricht weitgehend in der Mitte einer Internetseite angezeigt.

HTML-In-App-Nachrichten sind nützlich, um vollständig angepasste Nutzerhalte zu erstellen. Angepasster HTML-Code wird in einem iFrame angezeigt und kann Rich Content wie Bilder, Schriftarten, Videos und interaktive Elemente enthalten, die eine vollständige Kontrolle über das Aussehen und die Funktionalität der Nachrichten ermöglichen. Diese unterstützen eine JavaScript brazeBridge Schnittstelle, um Methoden des Braze Web SDK von Ihrem HTML-Code aus aufzurufen. Weitere Einzelheiten finden Sie in unseren Best Practices.

Wichtig

Um In-App-Nachrichten im HTML-Format über das Web SDK zu aktivieren, müssen Sie Braze die Initialisierungsoption allowUserSuppliedJavascript zur Verfügung stellen, zum Beispiel braze.initialize('YOUR-API_KEY', {allowUserSuppliedJavascript: true}). Dies geschieht aus Sicherheitsgründen. In-App-Nachrichten im HTML-Format können JavaScript ausführen. Daher ist ein Website-Administrator erforderlich, um sie zu aktivieren.

Das folgende Beispiel zeigt eine paginierte HTML-In-App-Nachricht:

Eine HTML In-App-Nachricht mit einem Karussell von Inhalten und interaktiven Buttons.

Voraussetzungen

Bevor Sie dieses Feature nutzen können, müssen Sie das Android Braze SDK integrieren. Bitte beachten Sie, dass Sie auch In-App-Nachrichten aktivieren müssen.

Nachrichtentypen

android

Braze bietet mehrere standardmäßige In-App-Nachrichtentypen, die jeweils mit Nachrichten, Bildern, Font Awesome-Symbolen, Klickaktionen, Analytics, Farbschemata und mehr angepasst werden können.

Ihr grundlegendes Verhalten und ihre Eigenschaften werden durch dieIInAppMessageSchnittstelle in einer Unterklasse namens definiertInAppMessageBase. IInAppMessageEnthält auch eine Unterschnittstelle,IInAppMessageImmersive mit der Sie Buttons zum Schließen, für Klicks und für Analytics zu Ihrer App hinzufügen können.

Wichtig

Bitte beachten Sie, dass In-App-Nachrichten, die Buttons enthalten, dieclickActionNachricht in die endgültige Nutzlast aufnehmen, wenn der Klick vor dem Hinzufügen des Button-Textes hinzugefügt wird.

slideup In-App-Nachrichten werden so genannt, weil sie vom oberen oder unteren Bildschirmrand nach oben oder unten gleiten. Sie bedecken nur einen kleinen Teil des Bildschirms und bieten eine effektive und unaufdringliche Möglichkeit zur Nachrichtenübermittlung.

Das In-App-Nachricht-Objekt slideup erweitert InAppMessageBase.

Eine In-App-Nachricht, die vom unteren Rand des Telefondisplays herabgleitet, zeigt an: "Menschen sind kompliziert. Custom Engagement sollte nicht sein." Im Hintergrund wird dieselbe In-App-Nachricht angezeigt, die auch in der unteren rechten Ecke einer Webseite zu sehen ist.

modal In-App-Nachrichten erscheinen in der Mitte des Bildschirms und werden von einem durchsichtigen Feld eingerahmt. Für kritischere Nachrichten können sie mit zwei Click-Action- und Analytics-fähigen Buttons ausgestattet werden.

Dieser Nachrichtentyp ist eine Unterklasse von InAppMessageImmersiveBase, einer abstrakten Klasse, die implementiert IInAppMessageImmersiveund Ihnen die Möglichkeit bietet, Ihre lokal generierten In-App-Nachrichten mit benutzerdefinierten Funktionen anzupassen.

Eine Modal-In-App-Nachricht in der Mitte des Telefondisplays mit dem Text "Menschen sind kompliziert. Custom Engagement sollte nicht sein." Im Hintergrund wird dieselbe In-App-Nachricht in der Mitte einer Webseite angezeigt.

full-In-App-Nachrichten sind nützlich, um den Inhalt und die Wirkung Ihrer Nutzer-Kommunikation zu maximieren. Die obere Hälfte einer In-App-Nachricht von full enthält ein Bild, die untere Hälfte Text und bis zu zwei Click-Action- und Analytics-fähigen Buttons.

Dieser Nachrichtentyp erweitert die MöglichkeitenInAppMessageImmersiveBase, sodass Sie Ihren lokal generierten In-App-Nachrichten benutzerdefinierte Funktionen hinzufügen können.

Eine In-App-Nachricht im Vollbildmodus, die über den gesamten Bildschirm des Telefons angezeigt wird und lautet: "Menschen sind kompliziert. Custom Engagement sollte nicht sein." Im Hintergrund wird dieselbe In-App-Nachricht angezeigt, die groß in der Mitte einer Webseite dargestellt ist.

HTML-In-App-Nachrichten sind nützlich, um vollständig angepasste Nutzerhalte zu erstellen. Benutzerdefinierte HTML-In-App-Nachrichten werden in WebView angezeigt und können optional andere Rich-Content-Inhalte wie Bilder und Schriftarten enthalten, sodass Sie die volle Kontrolle über das Aussehen und die Funktionalität der Nachrichten haben.

Dieser Nachrichtentyp implementiert IInAppMessageHtml, eine Unterklasse von IInAppMessage.

Hinweis

Unter Android werden Links, die mittarget="_blank" in benutzerdefinierten HTML-In-App-Nachrichten konfiguriert sind, im Standard-Webbrowser des Geräts geöffnet.

Android-In-App-Nachrichten unterstützen eine brazeBridgeJavaScript-Schnittstelle, um Methoden des Braze Android SDK aus Ihrem HTML heraus aufzurufen. Weitere Informationen finden Sie auf unserer JavaScript-Bridge-Seite.

Eine HTML-In-App-Nachricht mit einer Karussellansicht von Inhalten und interaktiven Buttons.

Wichtig

Die Anzeige angepasster In-App-Nachrichten im HTML-Format in einem iFrame wird derzeit auf den Plattformen iOS und Android nicht unterstützt.

Tipp

Sie können auch benutzerdefinierte In-App-Nachrichtenansichten für Ihre App festlegen. Eine vollständige Anleitung finden Sie unter „Benutzerdefinierte Fabriken anpassen“.

Aktivieren von In-App-Nachrichten

Schritt 1: Registrieren Sie sich `BrazeInAppMessageManager`

Die Anzeige von In-App-Nachrichten wird von der Klasse BrazeInAppMessageManager verwaltet. Jede Aktivität in Ihrer App muss bei BrazeInAppMessageManager registriert sein, damit sie In-App-Nachricht-Ansichten zur Ansichtshierarchie hinzufügen kann. Es gibt zwei Möglichkeiten, dies zu erreichen:

automatically
manually

Die Callback-Integration für den Aktivitätslebenszyklus verarbeitet die Registrierung von In-App-Nachrichten automatisch; eine zusätzliche Integration ist nicht erforderlich. Dies ist die empfohlene Methode für die Registrierung von In-App-Nachrichten.

Warnung

Wenn Sie den Activity Lifecycle Callback für die automatische Registrierung verwenden, brauchen Sie diesen Schritt nicht auszuführen.

In Ihrem Application.onCreate(), Anruf ensureSubscribedToInAppMessageEvents():

java
kotlin

BrazeInAppMessageManager.getInstance().ensureSubscribedToInAppMessageEvents(context);

BrazeInAppMessageManager.getInstance().ensureSubscribedToInAppMessageEvents(context)

In jeder Aktivität, in der In-App-Nachrichten angezeigt werden können, rufen Sie registerInAppMessageManager() in der jeweiligen Aktivität onResume() auf:

java
kotlin

@Override
public void onResume() {
  super.onResume();
  // Registers the BrazeInAppMessageManager for the current Activity. This Activity will now listen for
  // in-app messages from Braze.
  BrazeInAppMessageManager.getInstance().registerInAppMessageManager(activity);
}

public override fun onResume() {
  super.onResume()
  // Registers the BrazeInAppMessageManager for the current Activity. This Activity will now listen for
  // in-app messages from Braze.
  BrazeInAppMessageManager.getInstance().registerInAppMessageManager(this)
}

Bei jeder Aktivität, bei der registerInAppMessageManager() aufgerufen wurde, rufen Sie unregisterInAppMessageManager() in der jeweiligen Aktivität onPause() auf:

java
kotlin

@Override
public void onPause() {
  super.onPause();
  // Unregisters the BrazeInAppMessageManager for the current Activity.
  BrazeInAppMessageManager.getInstance().unregisterInAppMessageManager(activity);
}

public override fun onPause() {
  super.onPause()
  // Unregisters the BrazeInAppMessageManager.
  BrazeInAppMessageManager.getInstance().unregisterInAppMessageManager(this)
}

Schritt 2: Update der Blockliste des Managers (optional)

In Ihrer Integration können Sie festlegen, dass bestimmte Aktivitäten in Ihrer App keine In-App-Nachrichten anzeigen sollen. Die Integration von Callbacks in den Aktivitätslebenszyklus bietet eine einfache Möglichkeit, dies zu erreichen.

Der folgende Code fügt der Blockliste für die Registrierung von In-App-Nachrichten zwei Aktivitäten hinzu: SplashActivity und SettingsActivity:

java
kotlin

public class MyApplication extends Application {
  @Override
  public void onCreate() {
    super.onCreate();
    Set<Class> inAppMessageBlocklist = new HashSet<>();
    inAppMessageBlocklist.add(SplashActivity.class);
    inAppMessageBlocklist.add(SettingsActivity.class);
    registerActivityLifecycleCallbacks(new BrazeActivityLifecycleCallbackListener(inAppMessageBlocklist));
  }
}

class MyApplication : Application() {
  override fun onCreate() {
    super.onCreate()
    val inAppMessageBlocklist = HashSet<Class<*>>()
    inAppMessageBlocklist.add(SplashActivity::class.java)
    inAppMessageBlocklist.add(SettingsActivity::class.java)
    registerActivityLifecycleCallbacks(BrazeActivityLifecycleCallbackListener(inAppMessageBlocklist))
  }
}

Voraussetzungen

Bevor Sie dieses Feature nutzen können, müssen Sie das Swift Braze SDK integrieren. Sie müssen auch In-App-Nachrichten aktivieren.

Nachrichtentypen

swift

Jede Art von In-App-Nachricht ist in Bezug auf Inhalt, Bilder, Symbole, Klickaktionen, Analytics, Anzeige und Zustellung in hohem Maße anpassbar. Sie sind aufgezählte Typen von Braze.InAppMessage, die das grundlegende Verhalten und die Eigenschaften aller In-App-Nachrichten definieren. Eine vollständige Liste der Eigenschaften von In-App-Nachrichten und deren Verwendung finden Sie in der KlasseInAppMessage .

Dies sind die verfügbaren In-App-Nachrichtentypen in Braze und wie sie für Endnutzer:in aussehen werden.

Slideup In-App-Nachrichten heißen so, weil sie vom oberen oder unteren Bildschirmrand aus “nach oben” oder “nach unten” rutschen. Sie bedecken nur einen kleinen Teil des Bildschirms und bieten eine effektive und unaufdringliche Möglichkeit zur Nachrichtenübermittlung.

Eine In-App-Nachricht mit Slideup am unteren und oberen Rand des Telefondisplays.

Modal In-App-Nachrichten erscheinen in der Mitte des Bildschirms und werden von einem durchsichtigen Feld eingerahmt. Für kritische Nachrichten können sie mit bis zu zwei Analytics-fähigen Buttons ausgestattet werden.

Eine modale In-App-Nachricht in der Mitte des Telefondisplays.

Modal Image In-App-Nachrichten erscheinen in der Mitte des Bildschirms und werden von einem durchsichtigen Feld eingerahmt. Diese Nachrichten ähneln dem Typ Modal, jedoch ohne Kopfzeile oder Nachrichtentext. Für kritische Nachrichten können sie mit bis zu zwei Analytics-fähigen Buttons ausgestattet werden.

Eine modale In-App-Nachricht in der Mitte des Telefondisplays.

Full-In-App-Nachrichten sind nützlich, um den Inhalt und die Wirkung Ihrer Nutzer-Kommunikation zu maximieren. Die obere Hälfte einer In-App-Nachricht des Typs Full enthält ein Bild. Die untere Hälfte enthält Text und bis zu zwei Analytics-fähige Buttons.

Eine In-App-Nachricht im Vollbildmodus, die auf dem gesamten Telefonbildschirm angezeigt wird.

Full Image-In-App-Nachrichten sind ähnlich wie Full In-App-Nachrichten, jedoch ohne Kopfzeile oder Nachrichtentext. Dieser Nachrichtentyp ist nützlich, um den Inhalt und die Wirkung Ihrer Nutzer-Kommunikation zu maximieren. Eine Full Image-In-App-Nachricht enthält ein Bild, das sich über den gesamten Bildschirm erstreckt, mit der Option, bis zu zwei Analytics-aktivierte Buttons anzuzeigen.

Eine bildschirmfüllende In-App-Nachricht, die auf dem gesamten Telefondisplay angezeigt wird.

HTML-In-App-Nachrichten sind nützlich, um vollständig angepasste Nutzerhalte zu erstellen. Der gesamte Inhalt von benutzerdefinierten HTML-Full-In-App-Nachrichten wird in WKWebViewangezeigt und kann optional anderen Rich Content wie Bilder und Schriftarten enthalten. So haben Sie die volle Kontrolle über das Aussehen und die Funktionalität der Nachrichten.

iOS In-App-Nachrichten unterstützen eine JavaScript brazeBridge Schnittstelle, um Methoden des Braze Web SDK aus Ihrem HTML-Code heraus aufzurufen. Weitere Details finden Sie in unseren Best Practices.

Das folgende Beispiel zeigt eine paginierte HTML Full In-App Nachricht:

Eine HTML In-App-Nachricht mit einem Karussell von Inhalten und interaktiven Buttons.

Beachten Sie, dass die Anzeige von angepassten In-App-Nachrichten im HTML-Format in einem iFrame unter iOS und Android derzeit nicht unterstützt wird.

Control In-App-Nachrichten enthalten keine UI-Komponente und werden in erster Linie zu Analytics-Zwecken verwendet. Dieser Typ wird verwendet, um den Empfang einer In-App-Nachricht zu überprüfen, die an eine Kontrollgruppe gesendet wurde.

Weitere Einzelheiten über die Intelligente Auswahl und Kontrollgruppen finden Sie unter Intelligente Auswahl.

Aktivieren von In-App-Nachrichten

Schritt 1: Erstellen Sie eine Implementierung von `BrazeInAppMessagePresenter`

Damit Braze In-App-Nachrichten anzeigen kann, erstellen Sie eine Implementierung des BrazeInAppMessagePresenter -Protokolls und weisen Sie es der optionalen inAppMessagePresenter auf Ihrer Braze-Instanz zu. Sie können auch den standardmäßigen UI-Presenter von Braze verwenden, indem Sie ein BrazeInAppMessageUI-Objekt instanziieren.

Beachten Sie, dass Sie die Bibliothek BrazeUI importieren müssen, um auf die Klasse BrazeInAppMessageUI zuzugreifen.

swift
objective-c

AppDelegate.braze?.inAppMessagePresenter = BrazeInAppMessageUI()

AppDelegate.braze.inAppMessagePresenter = [[BrazeInAppMessageUI alloc] init];

Schritt 2: Behandeln Sie keine passenden Trigger

Implementieren Sie BrazeDelegate.(_:noMatchingTriggerForEvent) innerhalb der entsprechenden BrazeDelegate Klasse. Wenn Braze keinen passenden Trigger für ein bestimmtes Ereignis findet, ruft es diese Methode automatisch auf.

Voraussetzungen

Bevor Sie dieses Feature nutzen können, müssen Sie das Android Braze SDK integrieren.

Über TV- und OTT-Unterstützung

Das Android Braze SDK unterstützt von Haus aus die Anzeige von In-App-Nachrichten auf OTT-Geräten wie Android TV oder Fire Stick. Es gibt jedoch einige wesentliche Unterschiede zwischen nativen Android- und OTT In-App-Nachrichten. Für OTT Geräte:

In-App-Nachrichten, die einen Touch-Modus erfordern, wie Slideup, sind auf OTT deaktiviert.
Der aktuell ausgewählte oder fokussierte Artikel, z. B. ein Button oder eine Schaltfläche zum Schließen, wird hervorgehoben.
Klicks auf den Text der In-App-Nachricht selbst, also nicht auf einen Button, werden nicht unterstützt.

Voraussetzungen

Bevor Sie dieses Feature nutzen können, müssen Sie das Cordova Braze SDK integrieren.