Live-Aktivität starten
/messages/live_activity/start
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.
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-Zuordnung zu registrieren. Wenn Sie das erste Update zu früh senden, wird dieses Update möglicherweise nicht auf die Aktivität angewendet.
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.
- Senden Sie eine
/messages/live_activity/start-Anfrage mit eineractivity_id, die Sie später wiederverwenden können. - Speichern Sie diese
activity_idund Ihren gewünschten Endzeitpunkt in Ihrem Backend-Scheduler. - Senden Sie zum gewünschten Endzeitpunkt eine
/messages/live_activity/update-Anfrage, wobeiend_activityauftruegesetzt ist. - Konfigurieren Sie das Entfernungsverhalten in derselben Update-Anfrage. Weitere Details finden Sie beim Endpunkt
/messages/live_activity/update. - Überprüfen Sie Sende- und Ergebnis-Events im Nachrichten-Aktivitätsprotokoll.
Endpoint reference
This reference is generated from the OpenAPI specification for this endpoint. To run the endpoint, copy the generated cURL example and send it from your terminal or Postman. You can also download the raw OpenAPI spec for this page at /docs/de/assets/api/openapi/messaging_live_activity_start.yaml. Use this spec to validate that your requests include the correct parameters, fields, and structure before you send them. To learn how, see Use OpenAPI schemas for request validation.