Live Updates für Android

Erfahren Sie, wie Sie Android Live Updates im Braze SDK verwenden, auch bekannt als Progress Centric Notifications. Diese Benachrichtigungen ähneln den Live-Aktivitäten für das Swift Braze SDK und ermöglichen es Ihnen, interaktive Sperrbildschirm-Benachrichtigungen anzuzeigen. Android 16 führt fortschrittsorientierte Benachrichtigungen ein, mit denen Nutzer:innen nahtlos von ihnen initiierte End-to-End-Journeys verfolgen können.

So funktioniert es

Sie können die Schnittstelle IBrazeNotificationFactory verwenden, um die Darstellung von Braze-Push-Benachrichtigungen anzupassen. Wenn Sie BrazeNotificationFactory erweitern, ruft Braze die Methode createNotification() Ihrer Factory auf, bevor die Benachrichtigung den Nutzer:innen angezeigt wird. Dabei wird ein Payload übergeben, der benutzerdefinierte Schlüssel-Wert-Paare enthält, die über das Braze-Dashboard oder die REST API gesendet wurden.

Anzeigen eines Live Updates

In diesem Abschnitt arbeiten Sie mit Superb Owl zusammen, dem Moderator einer neuen Spielshow, in der Wildtierrettungsteams darum wetteifern, wer die meisten Eulen retten kann. Das Team möchte Live Updates in seiner Android-App nutzen, um den Status eines laufenden Spiels anzuzeigen und dynamische Aktualisierungen der Benachrichtigung in Echtzeit vorzunehmen.

Voraussetzungen

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

Schritt 1: Eine benutzerdefinierte Notification Factory erstellen

Erstellen Sie in Ihrer Anwendung eine neue Datei namens MyCustomNotificationFactory.kt, die BrazeNotificationFactory erweitert, um zu steuern, wie Braze Live Updates angezeigt werden.

Im folgenden Beispiel hat Superb Owl eine benutzerdefinierte Notification Factory erstellt, um ein Live Update für laufende Spiele anzuzeigen. Im nächsten Schritt erstellen Sie eine neue Methode namens getTeamInfo, um die Daten eines Teams der Activity zuzuordnen.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
class MyCustomNotificationFactory : IBrazeNotificationFactory {
    override fun createNotification(payload: BrazeNotificationPayload): Notification? {
        val notificationBuilder = populateNotificationBuilder(payload)
        val context = payload.context ?: return null

        if (notificationBuilder == null) {
            brazelog { "Notification could not be built. Returning null as created notification." }
            return null
        }
        notificationBuilder.setContentTitle("Android Live Updates").setContentText("Ongoing updates below")
        setProgressStyle(notificationBuilder, context)
        return notificationBuilder.build()
    }

    private fun setProgressStyle(notificationBuilder: NotificationCompat.Builder, context: Context) {
        val style = NotificationCompat.ProgressStyle()
            .setStyledByProgress(false)
            .setProgress(200)
            .setProgressTrackerIcon(IconCompat.createWithResource(context, R.drawable.notification_small_icon))
            .setProgressSegments(
                mutableListOf(
                    NotificationCompat.ProgressStyle.Segment(1000).setColor(Color.GRAY),
                    NotificationCompat.ProgressStyle.Segment(200).setColor(Color.BLUE),
                )
            )
            .setProgressPoints(
                mutableListOf(
                    NotificationCompat.ProgressStyle.Point(60).setColor(Color.RED),
                    NotificationCompat.ProgressStyle.Point(560).setColor(Color.GREEN)
                )
            )

        notificationBuilder.setStyle(style)
    }
}

Schritt 2: Benutzerdefinierte Daten zuordnen

Erstellen Sie in MyCustomNotificationFactory.kt eine neue Methode für die Datenverarbeitung, wenn Live Updates angezeigt werden.

Superb Owl hat die folgende Methode erstellt, um den Namen und das Logo jedes Teams den erweiterten Live Updates zuzuordnen:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
class CustomNotificationFactory : BrazeNotificationFactory() {
    override fun createNotification(payload: BrazeNotificationPayload): Notification? {
        // Your existing code
        return super.createNotification(payload)
    }

    // Your new method
    private fun getTeamInfo(team: String?): Pair<String, Int> {
        return when (team) {
            "WBF" -> Pair("Wild Bird Fund", R.drawable.team_wbf)
            "OWL" -> Pair("Owl Rehab", R.drawable.team_owl)
            else  -> Pair("Unknown", R.drawable.notification_small_icon)
        }
    }
}

Schritt 3: Die benutzerdefinierte Notification Factory festlegen

Verwenden Sie in Ihrer Application-Klasse customBrazeNotificationFactory, um Ihre benutzerdefinierte Notification Factory festzulegen.

1
2
3
4
5
6
7
8
class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()

        // Tell Braze to use your custom factory for notifications
        Braze.customBrazeNotificationFactory = MyCustomNotificationFactory()
    }
}

Schritt 4: Die Activity senden

Sie können den REST-API-Endpunkt /messages/send verwenden, um eine Push-Benachrichtigung an das Android-Gerät einer Nutzerin oder eines Nutzers zu senden.

Beispiel-curl-Befehl

Superb Owl hat die Anfrage mit dem folgenden curl-Befehl gesendet:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
curl -X POST "https://BRAZE_REST_ENDPOINT/messages/send" \
  -H "Authorization: Bearer {REST_API_KEY}" \
  -H "Content-Type: application/json" \
  --data '{
    "external_user_ids": ["USER_ID"],
    "messages": {
      "android_push": {
        "title": "WBF vs OWL",
        "alert": "2 to 4 1:33 Q4",
        "extra": {
          "live_update": "true",
          "team1": "WBF",
          "team2": "OWL",
          "score1": "2",
          "score2": "4",
          "time": "1:33",
          "quarter": "Q4"
        },
        "notification_id": "ASSIGNED_NOTIFICATION_ID"
      }
    }
  }'

Tipp

Obwohl curl-Befehle zum Testen hilfreich sind, empfehlen wir, diesen Aufruf in Ihrem Backend zu verarbeiten, wo Sie bereits Ihre iOS Live Activities verwalten.

Anfrageparameter

Schritt 5: Die Activity aktualisieren

Um das bestehende Live Update mit neuen Daten zu aktualisieren, ändern Sie die relevanten Schlüssel-Wert-Paare, die messages.extra zugewiesen sind, und rufen Sie dann mit derselben notification_id den Endpunkt /messages/send erneut auf.