Live-Aktivität starten

Verwenden Sie diesen Endpunkt, um Live-Aktivitäten, die in Ihrer iOS-App angezeigt werden, aus der Ferne zu starten. Dieser Endpunkt erfordert eine zusätzliche Einrichtung.

Nachdem Sie eine Live-Aktivität erstellt haben, senden Sie eine POST-Anfrage, um ein Segment, eine verbundene Zielgruppe oder bestimmte Nutzer:innen anzusprechen. Identifizieren Sie bestimmte Nutzer:innen anhand der externen Nutzer-ID, des Nutzer-Alias oder beidem. Weitere Informationen zu den Live-Aktivitäten von Apple finden Sie unter Starten und Aktualisieren von Live-Aktivitäten mit ActivityKit-Push-Benachrichtigungen.

Wenn content-available nicht festgelegt ist, beträgt die Standardpriorität des Apple Push Notification Service (APNs) 10. Wenn content-available festgelegt ist, beträgt diese Priorität 5. Weitere Informationen finden Sie unter Apple-Push-Objekt.

Wichtig

Warten Sie nach einer erfolgreichen /messages/live_activity/start-Anfrage mindestens 5 Minuten, bevor Sie die erste /messages/live_activity/update-Anfrage für dieselbe activity_id senden. Diese Verzögerung gibt Braze und APNs Zeit, die neue Live-Aktivität und ihre Token-Abbildung zu registrieren. Wenn Sie das erste Update zu früh senden, wird dieses Update möglicherweise nicht auf die Aktivität angewendet.

Tipp

Um eine Live-Aktivität zu beenden, verwenden Sie den Endpunkt /messages/live_activity/update, wobei end_activity auf true gesetzt ist.

Automatisches Entfernen einrichten

Um das automatische Entfernen nach dem Start einer Live-Aktivität einzurichten, planen Sie über Ihr Backend eine Folgeanfrage an den Update-Endpunkt.

1. Senden Sie eine /messages/live_activity/start-Anfrage mit einer activity_id, die Sie später wiederverwenden können.
2. Speichern Sie diese activity_id und Ihren gewünschten Endzeitpunkt in Ihrem Backend-Scheduler.
3. Senden Sie zum gewünschten Endzeitpunkt eine /messages/live_activity/update-Anfrage, wobei end_activity auf true gesetzt ist.
4. Konfigurieren Sie das Entfernungsverhalten in derselben Update-Anfrage. Weitere Details finden Sie beim Endpunkt /messages/live_activity/update.
5. Überprüfen Sie Sende- und Ergebnis-Events im Nachrichten-Aktivitätsprotokoll.

Sie können das OpenAPI-Dokument herunterladen und damit Schemas validieren. Wie das geht, erfahren Sie unter OpenAPI-Schemas zur Validierung von Anfragen verwenden.