https://analytics.flowsery.com/analytics/api/v1/goalsUsuwa zdarzenia własnych celów według odwiedzającego, nazwy zdarzenia lub zakresu dat.
Tokeny obszaru roboczego wymagają wskazania witryny
Tokeny API obszaru roboczego mają dostęp do wszystkich witryn w obszarze. Należy przekazaćwebsiteId lub domain, aby Flowsery wiedziało, której witryny dotyczy zapytanie lub zmiana. Klucze API witryn są już przypisane do jednej witryny, więc można to pominąć.Wskazanie witryny
| Parametr | Typ | Opis |
|---|---|---|
websiteId | string | ID witryny używane z tokenem API obszaru roboczego. Należy pominąć przy uwierzytelnianiu kluczem API witryny. |
domain | string | Domena witryny używana z tokenem API obszaru roboczego, gdy nie podano websiteId. Należy pominąć przy uwierzytelnianiu kluczem API witryny. |
Wymagany co najmniej jeden filtr
Należy podać co najmniej jeden parametr zapytania. Wywołanie bez filtrów zwraca błąd 400.Parametry zapytania
| Parametr | Typ | Opis |
|---|---|---|
visitorId | string | Usuwa cele powiązane z danym identyfikatorem odwiedzającego. |
name | string | Usuwa cele o danej nazwie zdarzenia (np. signup, purchase). |
startAt | string | Znacznik czasu początku w ISO 8601 (np. 2024-01-01T00:00:00Z). |
endAt | string | Znacznik czasu końca w ISO 8601 (np. 2024-01-31T23:59:59Z). |
Działanie usuwania
<strong>Tylko zakres czasu:</strong> usuwa wszystkie cele z tego okresu.
<strong>Tylko ID odwiedzającego:</strong> usuwa wszystkie cele tego odwiedzającego (z całego okresu).
<strong>Tylko nazwa:</strong> usuwa wszystkie cele o tej nazwie (z całego okresu).
<strong>ID odwiedzającego + nazwa:</strong> usuwa cele spełniające oba kryteria.
<strong>Zakres czasu + filtry:</strong> usuwa cele pasujące do filtrów w podanym okresie.
visitorId lub name bez zakresu czasu usuwa WSZYSTKIE pasujące rekordy z całej historii.Odpowiedzi z błędami
<strong>400 Bad Request</strong> -- Nie podano parametrów filtrowania.
<strong>401 Unauthorized</strong> -- Token API jest nieobecny, nieprawidłowy, wygasł lub nie jest akceptowany przez ten punkt końcowy.
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>"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>"{
"status": "success",
"data": [
{
"deleted": 14,
"message": "Goal completions deleted successfully"
}
]
}