Skip to content

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.

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.

Content Cards als ergänzende Inhalte

Feed mit einer hybriden Liste, die lokale Daten und Braze Content Cards kombiniert.

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.

Die Schlüssel-Wert-Paare für den Anwendungsfall „Ergänzende Content Cards“. In diesem Beispiel werden verschiedene Aspekte der Card wie „tile_id“, „tile_deeplink“ und „tile_title“ mithilfe von Liquid festgelegt.

Content Cards als interaktive Inhalte

Eine interaktive Content Card mit einer 50-Prozent-Aktion, die in der unteren linken Ecke des Bildschirms erscheint. Nach dem Klick wird die Aktion auf den Warenkorb angewendet.

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.

Interaktive Content Card mit einer Checkout-Aktion.

Content-Card-Badges

Ein iPhone-Startbildschirm, der eine Braze-Beispiel-App namens Swifty mit einem roten Badge zeigt, das die Zahl 7 anzeigt

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;
New Stuff!