api-referenceDEL
DELETEhttps://analytics.flowsery.com/analytics/api/v1/goals

Benutzerdefinierte Zielereignisse nach Besucher, Ereignisname oder innerhalb eines Datumsbereichs loeschen.

Bearer-Token (Workspace-Token oder Website-API-Schlüssel)

Workspace-Tokens benötigen einen Website-Selektor

Workspace-API-Tokens können auf jede Website im Workspace zugreifen. Übergeben Sie entweder <code>websiteId</code> oder <code>domain</code>, damit Flowsery weiß, welche Website abgefragt oder geändert werden muss. Website-API-Schlüssel sind bereits auf eine Website beschränkt, sodass der Selektor weggelassen werden kann.

Website-Auswahl

ParameterTypBeschreibung
websiteIdstringWebsite-ID zur Verwendung mit einem Workspace-API-Token. Bei der Authentifizierung mit einem Website-API-Schlüssel weglassen.
domainstringWebsite domain zur Verwendung mit einem Workspace-API-Token, wenn websiteId nicht bereitgestellt wird. Bei der Authentifizierung mit einem Website-API-Schlüssel weglassen.

Mindestens ein Filter erforderlich

Mindestens ein Abfrageparameter muss angegeben werden. Der Aufruf dieses Endpunkts ohne Filter gibt einen 400-Fehler zurueck.

Abfrageparameter

ParameterTypBeschreibung
visitorIdstringZiele entfernen, die an eine bestimmte Besucher-ID gebunden sind.
namestringZiele entfernen, die einem bestimmten Ereignisnamen entsprechen (z. B. signup, purchase).
startAtstringISO 8601 Startzeitstempel (z. B. 2024-01-01T00:00:00Z).
endAtstringISO 8601 Endzeitstempel (z. B. 2024-01-31T23:59:59Z).

Loeschverhalten

<strong>Nur Zeitraum:</strong> Entfernt alle Ziele innerhalb dieses Zeitraums.

<strong>Nur Besucher-ID:</strong> Entfernt alle Ziele fuer diesen Besucher (gesamter Zeitraum).

<strong>Nur Name:</strong> Entfernt alle Ziele mit diesem Namen (gesamter Zeitraum).

<strong>Besucher-ID + Name:</strong> Entfernt Ziele, die beiden Kriterien entsprechen.

<strong>Zeitraum + Filter:</strong> Entfernt Ziele, die den Filtern innerhalb des angegebenen Zeitfensters entsprechen.

Die Angabe von <code>visitorId</code> oder <code>name</code> ohne Zeitraum loescht ALLE uebereinstimmenden Datensaetze ueber den gesamten Verlauf.

Fehlerantworten

<strong>400 Bad Request</strong> -- Es wurden keine Filterparameter angegeben.

<strong>401 Unauthorized</strong> – API-Token fehlt, ist ungültig, abgelaufen oder wird für diesen Endpunkt nicht akzeptiert.

Nach Name innerhalb eines Zeitraums loeschen
curl -X DELETE "https://analytics.flowsery.com/analytics/api/v1/goals?websiteId=flid_abc123&name=signup&startAt=2024-01-01T00:00:00Z&endAt=2024-01-31T23:59:59Z" \
  -H "Authorization: Bearer <workspace-or-website-token>"
Alle Ziele eines Besuchers loeschen
curl -X DELETE "https://analytics.flowsery.com/analytics/api/v1/goals?websiteId=flid_abc123&visitorId=a3ab2331-989f-4cfa-91c6-2461c9e3c6bd" \
  -H "Authorization: Bearer <workspace-or-website-token>"
200
{
  "status": "success",
  "data": [
    {
      "deleted": 14,
      "message": "Goal events deleted successfully"
    }
  ]
}