Geplante API-getriggerte Campaigns aktualisieren

Verwenden Sie diesen Endpunkt, um geplante API-getriggerte Campaigns zu aktualisieren, die im Dashboard erstellt wurden. So können Sie entscheiden, welche Aktion den Versand der Nachricht triggern soll.

Sie können trigger_properties übergeben, die Braze als Templates in die Nachricht selbst einfügt.

Beachten Sie, dass Sie zum Versenden von Nachrichten mit diesem Endpunkt eine Campaign-ID benötigen, die beim Erstellen einer API-getriggerten Campaign erzeugt wurde.

Jeder Zeitplan überschreibt vollständig den Zeitplan, den Sie in der Anfrage zum Erstellen des Zeitplans oder in früheren Anfragen zum Aktualisieren des Zeitplans angegeben haben. Wenn Sie den Zeitplan beispielsweise ursprünglich auf "schedule" : {"time" : "2015-02-20T13:14:47", "in_local_time" : true} eingestellt haben und ihn später auf "schedule" : {"time" : "2015-02-20T14:14:47"} aktualisieren, sendet Braze die Nachricht zur angegebenen Zeit in UTC, nicht in der Ortszeit der Nutzer:innen.

Geplante Trigger, die kurz vor oder während der geplanten Sendezeit aktualisiert werden, werden nach bestem Bemühen aktualisiert, sodass Braze Änderungen in letzter Sekunde auf alle, einige oder keine Ihrer Zielgruppen-Nutzer:innen anwenden kann. Updates werden nicht übernommen, wenn der ursprüngliche Zeitplan die Ortszeit verwendete und die ursprüngliche Zeit in einer beliebigen Zeitzone bereits vergangen ist.

Voraussetzungen

Um diesen Endpunkt zu verwenden, benötigen Sie einen API-Schlüssel mit der Berechtigung campaigns.trigger.schedule.update.

Rate-Limit

Wir wenden auf diesen Endpunkt das standardmäßige Braze-Rate-Limit von 250.000 Anfragen pro Stunde an, wie in API-Rate-Limits dokumentiert.

Anfragetext

1
2
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY

1
2
3
4
5
6
7
{
  "campaign_id": (required, string) see campaign identifier,
  "schedule_id": (required, string) the `schedule_id` to update (obtained from the response to create schedule),
  "schedule": {
    // required, see create schedule documentation
  }
}

Anfrageparameter

Beispielanfrage

1
2
3
4
5
6
7
8
9
10
11
curl --location --request POST 'https://rest.iad-01.braze.com/campaigns/trigger/schedule/update' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
  "campaign_id": "campaign_identifier",
  "schedule_id": "schedule_identifier",
  "schedule": {
    "time": "2017-05-24T21:30:00Z",
    "in_local_time": true
  }
}'