Verhalten von Content Cards anpassen
In diesem Implementierungsleitfaden werden Änderungen am Verhalten von Content Cards, das Hinzufügen von Extras wie Schlüssel-Wert-Paaren zur Nutzlast und Vorgehensweisen für gängige Anpassungen erläutert. Eine vollständige Liste der Content-Card-Typen finden Sie unter Über Content Cards.
Schlüssel-Wert-Paare
Braze ermöglicht es Ihnen, zusätzliche Daten-Payloads über Content Cards mithilfe von Schlüssel-Wert-Paaren an die Geräte der Nutzer:innen zu senden. Diese können Ihnen helfen, interne Metriken zu verfolgen, App-Inhalte zu aktualisieren und Eigenschaften anzupassen. Fügen Sie Schlüssel-Wert-Paare über das Dashboard hinzu.

Wir empfehlen nicht, verschachtelte JSON-Werte als Schlüssel-Wert-Paare zu senden. Stattdessen sollten Sie das JSON vor dem Senden flach strukturieren.
Schlüssel-Wert-Paare werden auf card-Objekten als extras gespeichert. Diese können verwendet werden, um Daten zusammen mit einer Card zur weiteren Verarbeitung durch die App zu senden. Rufen Sie card.extras auf, um auf diese Werte zuzugreifen.
Schlüssel-Wert-Paare werden auf card-Objekten als extras gespeichert. Diese können verwendet werden, um Daten zusammen mit einer Card zur weiteren Verarbeitung durch die App zu senden. Rufen Sie card.extras auf, um auf diese Werte zuzugreifen.
Schlüssel-Wert-Paare werden auf card-Objekten als extras gespeichert. Diese können verwendet werden, um Daten zusammen mit einer Card zur weiteren Verarbeitung durch die App zu senden. Rufen Sie card.extras auf, um auf diese Werte zuzugreifen.

Es ist wichtig, dass Ihre Marketing- und Entwickler:innen-Teams abstimmen, welche Schlüssel-Wert-Paare verwendet werden (zum Beispiel feed_type = brand_homepage), da alle Schlüssel-Wert-Paare, die Marketer im Braze-Dashboard eingeben, genau mit den Schlüssel-Wert-Paaren übereinstimmen müssen, die Entwickler:innen in die App-Logik einbauen.
Content Cards als ergänzende Inhalte

Sie können Content Cards nahtlos in einen bestehenden Feed einbinden, sodass Daten aus mehreren Feeds gleichzeitig geladen werden. Dies schafft ein stimmiges, harmonisches Erlebnis mit Braze Content Cards und bestehenden Feed-Inhalten.
Das nebenstehende Beispiel zeigt einen Feed mit einer hybriden Liste von Artikeln, die sowohl mit lokalen Daten als auch mit Content Cards von Braze befüllt werden. Auf diese Weise sind Content Cards von bestehenden Inhalten nicht zu unterscheiden.
API-getriggerte Schlüssel-Wert-Paare
API-getriggerte Campaigns sind eine gute Strategie, wenn die Werte einer Card von externen Faktoren abhängen, die bestimmen, welche Inhalte den Nutzer:innen angezeigt werden sollen. Um beispielsweise ergänzende Inhalte anzuzeigen, legen Sie Schlüssel-Wert-Paare mit Liquid fest. Beachten Sie, dass class_type zum Zeitpunkt der Einrichtung bekannt sein sollte.

Content Cards als interaktive Inhalte

Content Cards können genutzt werden, um dynamische und interaktive Erlebnisse für Ihre Nutzer:innen zu schaffen. Im nebenstehenden Beispiel erscheint ein Content-Card-Pop-up an der Kasse, um Nutzer:innen Last-Minute-Aktionen anzubieten. Gut platzierte Cards wie diese sind eine großartige Möglichkeit, Nutzer:innen einen „Nudge“ in Richtung bestimmter Aktionen zu geben.
Die Schlüssel-Wert-Paare für diesen Anwendungsfall umfassen einen discount_percentage, der als gewünschter Rabattbetrag festgelegt wird, und einen class_type, der als coupon_code festgelegt wird. Diese Schlüssel-Wert-Paare ermöglichen es Ihnen, typspezifische Content Cards auf dem Checkout-Bildschirm zu filtern und anzuzeigen. Weitere Informationen zur Verwendung von Schlüssel-Wert-Paaren zur Verwaltung mehrerer Feeds finden Sie unter Anpassen des Standard-Content-Card-Feeds.

Content-Card-Badges

Badges sind kleine Symbole, die sich ideal eignen, um die Aufmerksamkeit von Nutzer:innen zu gewinnen. Mithilfe von Badges können Sie Nutzer:innen auf neue Content-Card-Inhalte aufmerksam machen, sie zurück in Ihre App locken und die Anzahl der Sitzungen steigern.
Anzahl ungelesener Content Cards als Badge anzeigen
Sie können die Anzahl ungelesener Content Cards als Badge auf dem App-Symbol anzeigen lassen.
Sie können die Anzahl ungelesener Karten jederzeit abfragen, indem Sie Folgendes aufrufen:
braze.getCachedContentCards().getUnviewedCardCount();
Anschließend können Sie diese Information verwenden, um ein Badge mit der Anzahl ungelesener Content Cards anzuzeigen. Weitere Informationen finden Sie in den SDK-Referenzdokumenten.
Sie können die Anzahl ungelesener Karten jederzeit abfragen, indem Sie Folgendes aufrufen:
Braze.getInstance(context).getContentCardUnviewedCount();
Braze.getInstance(context).contentCardUnviewedCount
Anschließend können Sie diese Information verwenden, um ein Badge mit der Anzahl ungelesener Content Cards anzuzeigen. Weitere Informationen finden Sie in den SDK-Referenzdokumenten.
Das folgende Beispiel verwendet braze.contentCards, um die Anzahl ungelesener Content Cards abzufragen und anzuzeigen. Nachdem die App geschlossen wurde und die Sitzung der Nutzer:innen beendet ist, fragt dieser Code die Kartenanzahl ab und filtert die Anzahl der Karten basierend auf der Eigenschaft viewed.
Apps, die den UIScene-Lebenszyklus übernommen haben (erforderlich für Apps, die mit Xcode 27 und höher erstellt wurden), sollten dies in sceneDidEnterBackground(_:) von SceneDelegate.swift implementieren anstatt in applicationDidEnterBackground(_:) von AppDelegate.swift.
func sceneDidEnterBackground(_ scene: UIScene)
Implementieren Sie innerhalb dieser Methode den folgenden Code, der den Badge-Zähler aktiv aktualisiert, während Nutzer:innen während einer bestimmten Sitzung Karten ansehen:
let unreadCards = AppDelegate.braze?.contentCards.cards.filter { $0.viewed == false }
UIApplication.shared.applicationIconBadgeNumber = unreadCards?.count ?? 0
(void)sceneDidEnterBackground:(UIScene *)scene
Implementieren Sie innerhalb dieser Methode den folgenden Code, der den Badge-Zähler aktiv aktualisiert, während Nutzer:innen während einer bestimmten Sitzung Karten ansehen:
NSInteger unreadCardCount = 0;
for (BRZContentCardRaw *card in AppDelegate.braze.contentCards.cards) {
if (card.viewed == NO) {
unreadCardCount += 1;
}
}
[UIApplication sharedApplication].applicationIconBadgeNumber = unreadCardCount;