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 erben ihren Prototyp von InAppMessage, das grundlegendes Verhalten und Eigenschaften für alle In-App-Nachrichten definiert. Die prototypischen Unterklassen sind SlideUpMessage, ModalMessage, FullScreenMessage und HtmlMessage.
Jeder In-App-Nachrichtentyp ist über Inhalt, Bilder, Icons, Klickaktionen, Analytics, Anzeige und Zustellung anpassbar.
SlideUp-In-App-Nachrichten tragen diesen Namen, weil sie auf mobilen Plattformen traditionell vom oberen oder unteren Bildschirmrand nach oben oder unten „gleiten“. Im Braze Web SDK werden diese Nachrichten eher als Growl- oder Toast-Benachrichtigung angezeigt, um dem vorherrschenden Paradigma im Internet zu entsprechen. Sie nehmen nur einen kleinen Teil des Bildschirms ein und bieten eine effektive, unaufdringliche Messaging-Funktion.
Modal-In-App-Nachrichten erscheinen in der Mitte des Bildschirms und sind von einem halbtransparenten Panel umrahmt. Sie eignen sich für wichtigere Nachrichten und können mit bis zu zwei Klickaktion- und Analytics-fähigen Buttons ausgestattet werden.
Full-In-App-Nachrichten eignen sich hervorragend, um den Inhalt und die Wirkung Ihrer Kommunikation mit Nutzer:innen zu maximieren. In schmalen Browserfenstern (z. B. im mobilen Internet) nehmen full-In-App-Nachrichten das gesamte Browserfenster ein. In größeren Browserfenstern werden full-In-App-Nachrichten ähnlich wie modal-In-App-Nachrichten angezeigt. Die obere Hälfte einer full-In-App-Nachricht enthält ein Bild, und die untere Hälfte ermöglicht bis zu acht Textzeilen sowie bis zu zwei Klickaktion- und Analytics-fähige Buttons.
HTML-In-App-Nachrichten eignen sich für vollständig angepasste Nutzerinhalte. Benutzerdefiniertes HTML wird in einem iFrame angezeigt und kann umfangreiche Inhalte wie Bilder, Schriftarten, Videos und interaktive Elemente enthalten, was die volle Kontrolle über Aussehen und Funktionalität der Nachricht ermöglicht. Diese unterstützen eine JavaScript-Schnittstelle brazeBridge, um Methoden des Braze Web SDK aus Ihrem HTML heraus aufzurufen. Weitere Details finden Sie in unseren Best Practices.
Um HTML-In-App-Nachrichten über das Web SDK zu aktivieren, müssen Sie die Initialisierungsoption allowUserSuppliedJavascript an Braze übergeben, z. B. braze.initialize('YOUR-API_KEY', {allowUserSuppliedJavascript: true}). Dies geschieht aus Sicherheitsgründen. HTML-In-App-Nachrichten können JavaScript ausführen, daher muss ein:e Website-Administrator:in sie aktivieren.
Das folgende Beispiel zeigt eine paginierte HTML-In-App-Nachricht:
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
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.
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.
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.
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.
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.
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.
Die Anzeige angepasster In-App-Nachrichten im HTML-Format in einem iFrame wird derzeit auf den Plattformen iOS und Android nicht unterstützt.
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:
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.
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():
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:
@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:
@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:
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
Jeder In-App-Nachrichtentyp 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 InAppMessage-Klasse.
Dies sind die verfügbaren In-App-Nachrichtentypen in Braze und wie sie für Endnutzer:innen aussehen.
Slideup-In-App-Nachrichten heißen so, weil sie vom oberen oder unteren Bildschirmrand aus „nach oben“ oder „nach unten“ gleiten. Sie bedecken nur einen kleinen Teil des Bildschirms und bieten eine effektive und unaufdringliche Möglichkeit zur Nachrichtenübermittlung.
Modal-In-App-Nachrichten erscheinen in der Mitte des Bildschirms und werden von einem durchscheinenden Panel eingerahmt. Sie eignen sich für wichtigere Nachrichten und können mit bis zu zwei Analytics-fähigen Buttons ausgestattet werden.
Modal Image-In-App-Nachrichten erscheinen in der Mitte des Bildschirms und werden von einem durchscheinenden Panel eingerahmt. Diese Nachrichten ähneln dem Typ Modal, jedoch ohne Kopfzeile oder Nachrichtentext. Sie eignen sich für wichtigere Nachrichten und können mit bis zu zwei Analytics-fähigen Buttons ausgestattet werden.
Full-In-App-Nachrichten sind nützlich, um den Inhalt und die Wirkung Ihrer Kommunikation mit Nutzer:innen zu maximieren. Die obere Hälfte einer Full-In-App-Nachricht enthält ein Bild, und die untere Hälfte zeigt Text sowie bis zu zwei Analytics-fähige Buttons an.
Full Image-In-App-Nachrichten ähneln Full-In-App-Nachrichten, jedoch ohne Kopfzeile oder Nachrichtentext. Dieser Nachrichtentyp ist nützlich, um den Inhalt und die Wirkung Ihrer Kommunikation mit Nutzer:innen 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-fähige Buttons anzuzeigen.
HTML-In-App-Nachrichten sind nützlich, um vollständig angepasste Nutzer:innen-Inhalte zu erstellen. Benutzerdefinierte HTML-Full-In-App-Nachrichteninhalte werden in einer WKWebView angezeigt und können optional weiteren Rich Content wie Bilder und Schriftarten enthalten, sodass Sie die volle Kontrolle über das Aussehen und die Funktionalität der Nachrichten haben.
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:
Beachten Sie, dass die Anzeige von angepassten HTML-In-App-Nachrichten 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 zur automatischen Variantenoptimierung und zu Kontrollgruppen finden Sie unter Mit BrazeAITM optimieren.
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.
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.
Nachrichtentypen
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.
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.
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.
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.
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.
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.
Die Anzeige angepasster In-App-Nachrichten im HTML-Format in einem iFrame wird derzeit auf den Plattformen iOS und Android nicht unterstützt.
Sie können auch benutzerdefinierte In-App-Nachrichtenansichten für Ihre App festlegen. Eine vollständige Anleitung finden Sie unter „Benutzerdefinierte Fabriken anpassen“.
Jeder In-App-Nachrichtentyp 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 InAppMessage-Klasse.
Dies sind die verfügbaren In-App-Nachrichtentypen in Braze und wie sie für Endnutzer:innen aussehen.
Slideup-In-App-Nachrichten heißen so, weil sie vom oberen oder unteren Bildschirmrand aus „nach oben“ oder „nach unten“ gleiten. Sie bedecken nur einen kleinen Teil des Bildschirms und bieten eine effektive und unaufdringliche Möglichkeit zur Nachrichtenübermittlung.
Modal-In-App-Nachrichten erscheinen in der Mitte des Bildschirms und werden von einem durchscheinenden Panel eingerahmt. Sie eignen sich für wichtigere Nachrichten und können mit bis zu zwei Analytics-fähigen Buttons ausgestattet werden.
Modal Image-In-App-Nachrichten erscheinen in der Mitte des Bildschirms und werden von einem durchscheinenden Panel eingerahmt. Diese Nachrichten ähneln dem Typ Modal, jedoch ohne Kopfzeile oder Nachrichtentext. Sie eignen sich für wichtigere Nachrichten und können mit bis zu zwei Analytics-fähigen Buttons ausgestattet werden.
Full-In-App-Nachrichten sind nützlich, um den Inhalt und die Wirkung Ihrer Kommunikation mit Nutzer:innen zu maximieren. Die obere Hälfte einer Full-In-App-Nachricht enthält ein Bild, und die untere Hälfte zeigt Text sowie bis zu zwei Analytics-fähige Buttons an.
Full Image-In-App-Nachrichten ähneln Full-In-App-Nachrichten, jedoch ohne Kopfzeile oder Nachrichtentext. Dieser Nachrichtentyp ist nützlich, um den Inhalt und die Wirkung Ihrer Kommunikation mit Nutzer:innen 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-fähige Buttons anzuzeigen.
HTML-In-App-Nachrichten sind nützlich, um vollständig angepasste Nutzer:innen-Inhalte zu erstellen. Benutzerdefinierte HTML-Full-In-App-Nachrichteninhalte werden in einer WKWebView angezeigt und können optional weiteren Rich Content wie Bilder und Schriftarten enthalten, sodass Sie die volle Kontrolle über das Aussehen und die Funktionalität der Nachrichten haben.
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:
Beachten Sie, dass die Anzeige von angepassten HTML-In-App-Nachrichten 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 zur automatischen Variantenoptimierung und zu Kontrollgruppen finden Sie unter Mit BrazeAITM optimieren.
Voraussetzungen
Bevor Sie dieses Feature nutzen können, müssen Sie das Flutter Braze SDK integrieren.
Nachrichtentypen
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.
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.
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.
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.
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.
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.
Die Anzeige angepasster In-App-Nachrichten im HTML-Format in einem iFrame wird derzeit auf den Plattformen iOS und Android nicht unterstützt.
Sie können auch benutzerdefinierte In-App-Nachrichtenansichten für Ihre App festlegen. Eine vollständige Anleitung finden Sie unter „Benutzerdefinierte Fabriken anpassen“.
Jeder In-App-Nachrichtentyp 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 InAppMessage-Klasse.
Dies sind die verfügbaren In-App-Nachrichtentypen in Braze und wie sie für Endnutzer:innen aussehen.
Slideup-In-App-Nachrichten heißen so, weil sie vom oberen oder unteren Bildschirmrand aus „nach oben“ oder „nach unten“ gleiten. Sie bedecken nur einen kleinen Teil des Bildschirms und bieten eine effektive und unaufdringliche Möglichkeit zur Nachrichtenübermittlung.
Modal-In-App-Nachrichten erscheinen in der Mitte des Bildschirms und werden von einem durchscheinenden Panel eingerahmt. Sie eignen sich für wichtigere Nachrichten und können mit bis zu zwei Analytics-fähigen Buttons ausgestattet werden.
Modal Image-In-App-Nachrichten erscheinen in der Mitte des Bildschirms und werden von einem durchscheinenden Panel eingerahmt. Diese Nachrichten ähneln dem Typ Modal, jedoch ohne Kopfzeile oder Nachrichtentext. Sie eignen sich für wichtigere Nachrichten und können mit bis zu zwei Analytics-fähigen Buttons ausgestattet werden.
Full-In-App-Nachrichten sind nützlich, um den Inhalt und die Wirkung Ihrer Kommunikation mit Nutzer:innen zu maximieren. Die obere Hälfte einer Full-In-App-Nachricht enthält ein Bild, und die untere Hälfte zeigt Text sowie bis zu zwei Analytics-fähige Buttons an.
Full Image-In-App-Nachrichten ähneln Full-In-App-Nachrichten, jedoch ohne Kopfzeile oder Nachrichtentext. Dieser Nachrichtentyp ist nützlich, um den Inhalt und die Wirkung Ihrer Kommunikation mit Nutzer:innen 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-fähige Buttons anzuzeigen.
HTML-In-App-Nachrichten sind nützlich, um vollständig angepasste Nutzer:innen-Inhalte zu erstellen. Benutzerdefinierte HTML-Full-In-App-Nachrichteninhalte werden in einer WKWebView angezeigt und können optional weiteren Rich Content wie Bilder und Schriftarten enthalten, sodass Sie die volle Kontrolle über das Aussehen und die Funktionalität der Nachrichten haben.
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:
Beachten Sie, dass die Anzeige von angepassten HTML-In-App-Nachrichten 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 zur automatischen Variantenoptimierung und zu Kontrollgruppen finden Sie unter Mit BrazeAITM optimieren.
Aktivieren von In-App-Nachrichten
Das Braze Flutter SDK richtet den Standard-Presenter für In-App-Nachrichten auf Android und iOS automatisch ein. In-App-Nachrichten werden ohne zusätzliche Einrichtung angezeigt und an die Dart-Schicht weitergeleitet.
Anpassen des In-App-Nachrichten-Presenters unter iOS
Um den Standard-Presenter für In-App-Nachrichten unter iOS zu überschreiben, verwenden Sie die postInitialization-Closure in BrazePlugin.configure(_:postInitialization:). Ihr angepasster Presenter muss BrazePlugin.processInAppMessage(message) aufrufen, um die Daten der In-App-Nachrichten an die Dart-Schicht weiterzuleiten.
import BrazeUI
BrazePlugin.configure(
{ configuration in
// Set non-API-key configurations here.
},
postInitialization: { braze in
let customPresenter = CustomInAppMessagePresenter()
braze.inAppMessagePresenter = customPresenter
}
)
Rufen Sie in der angepassten Presenter-Klasse BrazePlugin.processInAppMessage(message) und super.present(message: message) auf, um die Daten an Dart weiterzuleiten und die Standard-UI anzuzeigen.
class CustomInAppMessagePresenter: BrazeInAppMessageUI {
override func present(message: Braze.InAppMessage) {
BrazePlugin.processInAppMessage(message)
super.present(message: message)
}
}
Dieser Schritt gilt ausschließlich für iOS. Die Standardimplementierung für In-App-Nachrichten ist auf Android bereits eingerichtet.
Um den Standard-Presenter für In-App-Nachrichten unter iOS einzurichten, erstellen Sie eine Implementierung des BrazeInAppMessagePresenter-Protokolls und weisen Sie es der optionalen Eigenschaft inAppMessagePresenter in Ihrer Braze-Instanz zu. Sie können auch den Standard-UI-Presenter von Braze verwenden, indem Sie ein BrazeInAppMessageUI-Objekt instanziieren.
Sie müssen die BrazeUI-Bibliothek importieren, um auf die BrazeInAppMessageUI-Klasse zugreifen zu können.
import BrazeUI
override func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil
) -> Bool {
...
let braze = BrazePlugin.initBraze(configuration)
braze.inAppMessagePresenter = BrazeInAppMessageUI()
AppDelegate.braze = braze
return true
}
@import BrazeUI;
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
...
Braze *braze = [BrazePlugin initBraze:configuration];
braze.inAppMessagePresenter = [[BrazeInAppMessageUI alloc] init];
AppDelegate.braze = braze;
[self.window makeKeyAndVisible];
return YES;
}
Weitere Informationen zum Zugriff auf Daten von In-App-Nachrichten finden Sie unter Protokollierung von In-App-Nachrichten-Daten.
Voraussetzungen
Bevor Sie dieses Feature nutzen können, müssen Sie das React Native Braze SDK integrieren.
Nachrichtentypen
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.
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.
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.
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.
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.
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.
Die Anzeige angepasster In-App-Nachrichten im HTML-Format in einem iFrame wird derzeit auf den Plattformen iOS und Android nicht unterstützt.
Sie können auch benutzerdefinierte In-App-Nachrichtenansichten für Ihre App festlegen. Eine vollständige Anleitung finden Sie unter „Benutzerdefinierte Fabriken anpassen“.
Jeder In-App-Nachrichtentyp 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 InAppMessage-Klasse.
Dies sind die verfügbaren In-App-Nachrichtentypen in Braze und wie sie für Endnutzer:innen aussehen.
Slideup-In-App-Nachrichten heißen so, weil sie vom oberen oder unteren Bildschirmrand aus „nach oben“ oder „nach unten“ gleiten. Sie bedecken nur einen kleinen Teil des Bildschirms und bieten eine effektive und unaufdringliche Möglichkeit zur Nachrichtenübermittlung.
Modal-In-App-Nachrichten erscheinen in der Mitte des Bildschirms und werden von einem durchscheinenden Panel eingerahmt. Sie eignen sich für wichtigere Nachrichten und können mit bis zu zwei Analytics-fähigen Buttons ausgestattet werden.
Modal Image-In-App-Nachrichten erscheinen in der Mitte des Bildschirms und werden von einem durchscheinenden Panel eingerahmt. Diese Nachrichten ähneln dem Typ Modal, jedoch ohne Kopfzeile oder Nachrichtentext. Sie eignen sich für wichtigere Nachrichten und können mit bis zu zwei Analytics-fähigen Buttons ausgestattet werden.
Full-In-App-Nachrichten sind nützlich, um den Inhalt und die Wirkung Ihrer Kommunikation mit Nutzer:innen zu maximieren. Die obere Hälfte einer Full-In-App-Nachricht enthält ein Bild, und die untere Hälfte zeigt Text sowie bis zu zwei Analytics-fähige Buttons an.
Full Image-In-App-Nachrichten ähneln Full-In-App-Nachrichten, jedoch ohne Kopfzeile oder Nachrichtentext. Dieser Nachrichtentyp ist nützlich, um den Inhalt und die Wirkung Ihrer Kommunikation mit Nutzer:innen 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-fähige Buttons anzuzeigen.
HTML-In-App-Nachrichten sind nützlich, um vollständig angepasste Nutzer:innen-Inhalte zu erstellen. Benutzerdefinierte HTML-Full-In-App-Nachrichteninhalte werden in einer WKWebView angezeigt und können optional weiteren Rich Content wie Bilder und Schriftarten enthalten, sodass Sie die volle Kontrolle über das Aussehen und die Funktionalität der Nachrichten haben.
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:
Beachten Sie, dass die Anzeige von angepassten HTML-In-App-Nachrichten 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 zur automatischen Variantenoptimierung und zu Kontrollgruppen finden Sie unter Mit BrazeAITM optimieren.
Datenmodell
Das Modell für In-App-Nachrichten ist im React Native SDK verfügbar. Braze verfügt über vier In-App-Nachrichtentypen, die dasselbe Datenmodell verwenden: Slideup, Modal, Full und HTML Full.
Nachrichten
Das In-App-Nachricht-Modell bildet die Grundlage für alle In-App-Nachrichten.
| Eigenschaft | Beschreibung |
|---|---|
inAppMessageJsonString |
Die JSON-Darstellung der Nachricht. |
message |
Der Text der Nachricht. |
header |
Die Kopfzeile der Nachricht. |
uri |
Die URI, die mit der Klick-Aktion des Buttons verbunden ist. |
imageUrl |
Die Bild-URL der Nachricht. |
zippedAssetsUrl |
Die gezippten Assets, die für die Anzeige von HTML-Inhalten vorbereitet sind. |
useWebView |
Gibt an, ob die Klick-Aktion des Buttons über eine Webansicht umgeleitet werden soll. |
duration |
Die Anzeigedauer der Nachricht. |
clickAction |
Der Aktionstyp für den Klick auf den Button. Die Typen sind: URI und NONE. |
dismissType |
Die Art des Schließens der Nachricht. Die beiden Arten sind: SWIPE und AUTO_DISMISS. |
messageType |
Der vom SDK unterstützte Typ der In-App-Nachricht. Die vier Typen sind: SLIDEUP, MODAL, FULL und HTML_FULL. |
extras |
Das Extras-Wörterbuch der Nachricht. Standardwert: [:]. |
buttons |
Die Liste der Buttons in der In-App-Nachricht. |
toString() |
Die Nachricht als String-Darstellung. |
Eine vollständige Referenz des In-App-Nachricht-Modells finden Sie in der Dokumentation für Android und iOS.
Buttons
In-App-Nachrichten können Buttons hinzugefügt werden, um Aktionen durchzuführen und Analytics zu protokollieren. Das Button-Modell bildet die Grundlage für alle In-App-Nachricht-Buttons.
| Eigenschaft | Beschreibung |
|---|---|
text |
Der Text auf dem Button. |
uri |
Die URI, die mit der Klick-Aktion des Buttons verbunden ist. |
useWebView |
Gibt an, ob die Klick-Aktion des Buttons über eine Webansicht umgeleitet werden soll. |
clickAction |
Die Art der Klick-Aktion, die verarbeitet wird, wenn Nutzer:innen auf den Button klicken. Die Typen sind: URI und NONE. |
id |
Die ID des Buttons in der Nachricht. |
toString() |
Der Button als String-Darstellung. |
Eine vollständige Referenz des Button-Modells finden Sie in der Dokumentation für Android und iOS.
Voraussetzungen
Bevor Sie dieses Feature nutzen können, müssen Sie das Roku Braze SDK integrieren. Außerdem werden In-App-Nachrichten nur an Roku-Geräte gesendet, auf denen die minimal unterstützte SDK-Version läuft:
Nachrichtentypen
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.
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.
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.
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.
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.
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.
Die Anzeige angepasster In-App-Nachrichten im HTML-Format in einem iFrame wird derzeit auf den Plattformen iOS und Android nicht unterstützt.
Sie können auch benutzerdefinierte In-App-Nachrichtenansichten für Ihre App festlegen. Eine vollständige Anleitung finden Sie unter „Benutzerdefinierte Fabriken anpassen“.
Jeder In-App-Nachrichtentyp 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 InAppMessage-Klasse.
Dies sind die verfügbaren In-App-Nachrichtentypen in Braze und wie sie für Endnutzer:innen aussehen.
Slideup-In-App-Nachrichten heißen so, weil sie vom oberen oder unteren Bildschirmrand aus „nach oben“ oder „nach unten“ gleiten. Sie bedecken nur einen kleinen Teil des Bildschirms und bieten eine effektive und unaufdringliche Möglichkeit zur Nachrichtenübermittlung.
Modal-In-App-Nachrichten erscheinen in der Mitte des Bildschirms und werden von einem durchscheinenden Panel eingerahmt. Sie eignen sich für wichtigere Nachrichten und können mit bis zu zwei Analytics-fähigen Buttons ausgestattet werden.
Modal Image-In-App-Nachrichten erscheinen in der Mitte des Bildschirms und werden von einem durchscheinenden Panel eingerahmt. Diese Nachrichten ähneln dem Typ Modal, jedoch ohne Kopfzeile oder Nachrichtentext. Sie eignen sich für wichtigere Nachrichten und können mit bis zu zwei Analytics-fähigen Buttons ausgestattet werden.
Full-In-App-Nachrichten sind nützlich, um den Inhalt und die Wirkung Ihrer Kommunikation mit Nutzer:innen zu maximieren. Die obere Hälfte einer Full-In-App-Nachricht enthält ein Bild, und die untere Hälfte zeigt Text sowie bis zu zwei Analytics-fähige Buttons an.
Full Image-In-App-Nachrichten ähneln Full-In-App-Nachrichten, jedoch ohne Kopfzeile oder Nachrichtentext. Dieser Nachrichtentyp ist nützlich, um den Inhalt und die Wirkung Ihrer Kommunikation mit Nutzer:innen 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-fähige Buttons anzuzeigen.
HTML-In-App-Nachrichten sind nützlich, um vollständig angepasste Nutzer:innen-Inhalte zu erstellen. Benutzerdefinierte HTML-Full-In-App-Nachrichteninhalte werden in einer WKWebView angezeigt und können optional weiteren Rich Content wie Bilder und Schriftarten enthalten, sodass Sie die volle Kontrolle über das Aussehen und die Funktionalität der Nachrichten haben.
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:
Beachten Sie, dass die Anzeige von angepassten HTML-In-App-Nachrichten 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 zur automatischen Variantenoptimierung und zu Kontrollgruppen finden Sie unter Mit BrazeAITM optimieren.
Aktivieren von In-App-Nachrichten
1. Schritt: Einen Observer hinzufügen
Zum Verarbeiten von In-App-Nachrichten können Sie einen Observer auf BrazeTask.BrazeInAppMessage hinzufügen:
m.BrazeTask.observeField("BrazeInAppMessage", "onInAppMessageReceived")
2. Schritt: Zugriff auf getriggerte Nachrichten
Dann haben Sie innerhalb Ihres Handlers Zugriff auf die In-App-Nachricht mit der höchsten Priorität, die Ihre Campaigns getriggert haben:
sub onInAppMessageReceived()
in_app_message = m.BrazeTask.BrazeInAppMessage
...
end sub
Felder für Nachrichten
Handhabung
Im Folgenden sind die Felder aufgeführt, die Sie für die Handhabung Ihrer In-App-Nachrichten benötigen:
| Felder | Beschreibung |
|---|---|
buttons |
Liste der Buttons (kann eine leere Liste sein). |
click_action |
"URI" oder "NONE". Verwenden Sie dieses Feld, um anzugeben, ob die In-App-Nachricht einen URI-Link öffnen oder die Nachricht schließen soll, wenn darauf geklickt wird. Wenn es keine Buttons gibt, sollte dies geschehen, wenn Nutzer:innen auf „OK“ klicken, während die In-App-Nachricht angezeigt wird. |
dismiss_type |
"AUTO_DISMISS" oder "SWIPE". Verwenden Sie dieses Feld, um anzugeben, ob Ihre In-App-Nachricht automatisch ausgeblendet werden soll oder eine Swipe-Geste zum Ausblenden erforderlich ist. |
display_delay |
Wartezeit (in Sekunden), bis die In-App-Nachricht angezeigt wird. |
duration |
Anzeigedauer der Nachricht (in Millisekunden), wenn dismiss_type auf "AUTO_DISMISS" festgelegt ist. |
extras |
Schlüssel-Wert-Paare. |
header |
Der Kopfzeilentext. |
id |
Die ID, die zum Protokollieren von Impressionen oder Klicks verwendet wird. |
image_url |
Bild-URL der In-App-Nachricht. |
message |
Nachrichtentext. |
uri |
URI, an die Nutzer:innen basierend auf der click_action weitergeleitet werden. Dieses Feld muss enthalten sein, wenn click_action "URI" ist. |
Bei In-App-Nachrichten mit Buttons wird die click_action der Nachricht ebenfalls in die endgültige Payload aufgenommen, wenn die Klickaktion vor dem Hinzufügen des Button-Textes hinzugefügt wird.
Styling
Über das Dashboard können verschiedene Styling-Felder ausgewählt werden:
| Felder | Beschreibung |
|---|---|
bg_color |
Hintergrundfarbe. |
close_button_color |
Farbe des Schließen-Buttons. |
frame_color |
Farbe des Overlays für den Hintergrundbildschirm. |
header_text_color |
Textfarbe der Überschrift. |
message_text_color |
Farbe des Nachrichtentextes. |
text_align |
„START“, „CENTER“ oder „END“. Ihre ausgewählte Textausrichtung. |
Alternativ können Sie die In-App-Nachricht implementieren und sie innerhalb Ihrer Roku-Anwendung mit einer Standardpalette gestalten:
Buttons
| Felder | Beschreibung |
|---|---|
click_action |
"URI" oder "NONE". Verwenden Sie dieses Feld, um anzugeben, ob die In-App-Nachricht einen URI-Link öffnen oder die Nachricht schließen soll, wenn darauf geklickt wird. |
id |
Der ID-Wert des Buttons. |
text |
Der Text, der auf dem Button angezeigt werden soll. |
uri |
URI, an die Nutzer:innen basierend auf der click_action weitergeleitet werden. Dieses Feld muss enthalten sein, wenn click_action "URI" ist. |
Denken Sie daran, dass Sie Ihre eigene angepasste UI implementieren müssen, da In-App-Messaging über Headless UI mit dem Swift SDK unterstützt werden, das keine Standard-UI oder Standard-Ansichten für tvOS enthält.
Voraussetzungen
Bevor Sie dieses Feature nutzen können, müssen Sie das Swift Braze SDK integrieren.
Aktivieren von In-App-Nachrichten
Schritt 1: Erstellen Sie eine neue iOS-App
Wählen Sie in Braze Einstellungen > App-Einstellungen und wählen Sie dann App hinzufügen. Geben Sie einen Namen für Ihre tvOS-App ein, wählen Sie iOS – nicht tvOS – und dann App hinzufügen aus.
Wenn Sie das Kontrollkästchen tvOS auswählen, können Sie die In-App-Nachrichten für tvOS nicht anpassen.
Schritt 2: Holen Sie sich den API-Schlüssel für Ihre App
Wählen Sie in Ihren App-Einstellungen Ihre neue tvOS-App aus und notieren Sie sich den API-Schlüssel Ihrer App. Sie verwenden diesen Schlüssel, um Ihre App in Xcode zu konfigurieren.
Schritt 3: BrazeKit integrieren
Verwenden Sie den API-Schlüssel Ihrer App, um das Braze Swift SDK in Ihr tvOS-Projekt in Xcode zu integrieren. Sie müssen nur BrazeKit über das Braze Swift SDK integrieren.
Schritt 4: Angepasste UI erstellen
Da Braze unter tvOS keine Standard-UI für In-App-Nachrichten bietet, müssen Sie diese selbst anpassen. Eine ausführliche Anleitung finden Sie in unserem Schritt-für-Schritt-Tutorial: Anpassen von In-App-Nachrichten für tvOS. Ein Beispielprojekt finden Sie unter Braze Swift SDK Beispiele.
Voraussetzungen
Bevor Sie dieses Feature nutzen können, müssen Sie das Unity Braze SDK integrieren.
Nachrichtentypen
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.
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.
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.
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.
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.
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.
Die Anzeige angepasster In-App-Nachrichten im HTML-Format in einem iFrame wird derzeit auf den Plattformen iOS und Android nicht unterstützt.
Sie können auch benutzerdefinierte In-App-Nachrichtenansichten für Ihre App festlegen. Eine vollständige Anleitung finden Sie unter „Benutzerdefinierte Fabriken anpassen“.
Jeder In-App-Nachrichtentyp 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 InAppMessage-Klasse.
Dies sind die verfügbaren In-App-Nachrichtentypen in Braze und wie sie für Endnutzer:innen aussehen.
Slideup-In-App-Nachrichten heißen so, weil sie vom oberen oder unteren Bildschirmrand aus „nach oben“ oder „nach unten“ gleiten. Sie bedecken nur einen kleinen Teil des Bildschirms und bieten eine effektive und unaufdringliche Möglichkeit zur Nachrichtenübermittlung.
Modal-In-App-Nachrichten erscheinen in der Mitte des Bildschirms und werden von einem durchscheinenden Panel eingerahmt. Sie eignen sich für wichtigere Nachrichten und können mit bis zu zwei Analytics-fähigen Buttons ausgestattet werden.
Modal Image-In-App-Nachrichten erscheinen in der Mitte des Bildschirms und werden von einem durchscheinenden Panel eingerahmt. Diese Nachrichten ähneln dem Typ Modal, jedoch ohne Kopfzeile oder Nachrichtentext. Sie eignen sich für wichtigere Nachrichten und können mit bis zu zwei Analytics-fähigen Buttons ausgestattet werden.
Full-In-App-Nachrichten sind nützlich, um den Inhalt und die Wirkung Ihrer Kommunikation mit Nutzer:innen zu maximieren. Die obere Hälfte einer Full-In-App-Nachricht enthält ein Bild, und die untere Hälfte zeigt Text sowie bis zu zwei Analytics-fähige Buttons an.
Full Image-In-App-Nachrichten ähneln Full-In-App-Nachrichten, jedoch ohne Kopfzeile oder Nachrichtentext. Dieser Nachrichtentyp ist nützlich, um den Inhalt und die Wirkung Ihrer Kommunikation mit Nutzer:innen 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-fähige Buttons anzuzeigen.
HTML-In-App-Nachrichten sind nützlich, um vollständig angepasste Nutzer:innen-Inhalte zu erstellen. Benutzerdefinierte HTML-Full-In-App-Nachrichteninhalte werden in einer WKWebView angezeigt und können optional weiteren Rich Content wie Bilder und Schriftarten enthalten, sodass Sie die volle Kontrolle über das Aussehen und die Funktionalität der Nachrichten haben.
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:
Beachten Sie, dass die Anzeige von angepassten HTML-In-App-Nachrichten 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 zur automatischen Variantenoptimierung und zu Kontrollgruppen finden Sie unter Mit BrazeAITM optimieren.
Voraussetzungen
Bevor Sie dieses Feature nutzen können, müssen Sie das .NET MAUI Braze SDK integrieren.
Nachrichtentypen
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.
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.
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.
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.
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.
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.
Die Anzeige angepasster In-App-Nachrichten im HTML-Format in einem iFrame wird derzeit auf den Plattformen iOS und Android nicht unterstützt.
Sie können auch benutzerdefinierte In-App-Nachrichtenansichten für Ihre App festlegen. Eine vollständige Anleitung finden Sie unter „Benutzerdefinierte Fabriken anpassen“.
Jeder In-App-Nachrichtentyp 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 InAppMessage-Klasse.
Dies sind die verfügbaren In-App-Nachrichtentypen in Braze und wie sie für Endnutzer:innen aussehen.
Slideup-In-App-Nachrichten heißen so, weil sie vom oberen oder unteren Bildschirmrand aus „nach oben“ oder „nach unten“ gleiten. Sie bedecken nur einen kleinen Teil des Bildschirms und bieten eine effektive und unaufdringliche Möglichkeit zur Nachrichtenübermittlung.
Modal-In-App-Nachrichten erscheinen in der Mitte des Bildschirms und werden von einem durchscheinenden Panel eingerahmt. Sie eignen sich für wichtigere Nachrichten und können mit bis zu zwei Analytics-fähigen Buttons ausgestattet werden.
Modal Image-In-App-Nachrichten erscheinen in der Mitte des Bildschirms und werden von einem durchscheinenden Panel eingerahmt. Diese Nachrichten ähneln dem Typ Modal, jedoch ohne Kopfzeile oder Nachrichtentext. Sie eignen sich für wichtigere Nachrichten und können mit bis zu zwei Analytics-fähigen Buttons ausgestattet werden.
Full-In-App-Nachrichten sind nützlich, um den Inhalt und die Wirkung Ihrer Kommunikation mit Nutzer:innen zu maximieren. Die obere Hälfte einer Full-In-App-Nachricht enthält ein Bild, und die untere Hälfte zeigt Text sowie bis zu zwei Analytics-fähige Buttons an.
Full Image-In-App-Nachrichten ähneln Full-In-App-Nachrichten, jedoch ohne Kopfzeile oder Nachrichtentext. Dieser Nachrichtentyp ist nützlich, um den Inhalt und die Wirkung Ihrer Kommunikation mit Nutzer:innen 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-fähige Buttons anzuzeigen.
HTML-In-App-Nachrichten sind nützlich, um vollständig angepasste Nutzer:innen-Inhalte zu erstellen. Benutzerdefinierte HTML-Full-In-App-Nachrichteninhalte werden in einer WKWebView angezeigt und können optional weiteren Rich Content wie Bilder und Schriftarten enthalten, sodass Sie die volle Kontrolle über das Aussehen und die Funktionalität der Nachrichten haben.
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:
Beachten Sie, dass die Anzeige von angepassten HTML-In-App-Nachrichten 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 zur automatischen Variantenoptimierung und zu Kontrollgruppen finden Sie unter Mit BrazeAITM optimieren.
Nächste Schritte
Bereit, tiefer einzutauchen? Sehen Sie sich diese Schritt-für-Schritt-Tutorials an: