Ziele
GET https://pico-analytics.com/api/goals/
curl --request GET \
--url 'https://pico-analytics.com/api/goals/' \
--header 'Authorization: Bearer {api_key}' \
--url 'https://pico-analytics.com/api/goals/' \
--header 'Authorization: Bearer {api_key}' \
| Parameter | Details | Beschreibung |
|---|---|---|
| website_id | Optional Ganzzahl | |
| type | Optional Zeichenfolge | Erlaubte Werte: pageview, custom, scroll, scroll_element, click_element, webhook |
| search | Optional Zeichenfolge | Der Suchtext. |
| search_by | Optional Zeichenfolge | Das Feld, in dem gesucht wird. Erlaubte Werte: name, path, key. |
| datetime_field | Optional Zeichenfolge | Erlaubte Werte: datetime, last_datetime |
| datetime_start | Optional Zeichenfolge | Ergebnisse ab diesem Zeitpunkt filtern. Format: Y-m-d H:i:s. |
| datetime_end | Optional Zeichenfolge | Ergebnisse bis zu diesem Zeitpunkt filtern. Format: Y-m-d H:i:s. |
| order_by | Optional Zeichenfolge | Das Feld, nach dem die Ergebnisse sortiert werden. Erlaubte Werte: goal_id, last_datetime, datetime, name, path, key, scroll_percentage. |
| order_type | Optional Zeichenfolge | Die Sortierreihenfolge der Ergebnisse. Erlaubte Werte: ASC für aufsteigend und DESC für absteigend. |
| page | Optional Ganzzahl | Die Seitenzahl, für die du Ergebnisse abrufen möchtest. Standardmäßig 1. |
| results_per_page | Optional Ganzzahl | Anzahl der Ergebnisse pro Seite. Erlaubte Werte: 10, 25, 50, 100, 250, 500, 1000. Standardmäßig 25. |
{
"data": [
{
"id": 1,
"website_id": 1,
"user_id": 1,
"key": "123456789",
"type": "custom",
"path": null,
"scroll_percentage": null,
"scroll_selector": null,
"click_selector": null,
"value": null,
"webhook_url": null,
"name": "Example",
"last_datetime": null,
"datetime": "2026-11-19 22:33:30"
}
],
"meta": {
"page": 1,
"total_pages": 1,
"results_per_page": 25,
"total_results": 1
},
"links": {
"first": "https://pico-analytics.com/api/goals?page=1",
"last": "https://pico-analytics.com/api/goals?page=1",
"next": null,
"prev": null,
"self": "https://pico-analytics.com/api/goals?page=1"
}
}
GET https://pico-analytics.com/api/goals/{goal_id}
curl --request GET \
--url 'https://pico-analytics.com/api/goals/{goal_id}' \
--header 'Authorization: Bearer {api_key}' \
--url 'https://pico-analytics.com/api/goals/{goal_id}' \
--header 'Authorization: Bearer {api_key}' \
{
"data": {
"id": 1,
"website_id": 1,
"user_id": 1,
"key": "123456789",
"type": "custom",
"path": null,
"scroll_percentage": null,
"scroll_selector": null,
"click_selector": null,
"value": null,
"webhook_url": null,
"name": "Example",
"last_datetime": null,
"datetime": "2026-11-19 22:33:30"
}
}
POST https://pico-analytics.com/api/goals
| Parameter | Details | Beschreibung |
|---|---|---|
| website_id | Erforderlich Ganzzahl | - |
| type | Erforderlich Zeichenfolge | Erlaubte Werte: pageview, custom, scroll, scroll_element, click_element, webhook |
| name | Erforderlich Zeichenfolge | - |
| path | Optional Zeichenfolge | Verfügbar, wenn: type = pageview, scroll, scroll_element, click_element |
| scroll_percentage | Optional Ganzzahl | Verfügbar, wenn: type = scroll |
| scroll_selector | Erforderlich Zeichenfolge | Verfügbar, wenn: type = scroll_element. Das Ziel wird erreicht, sobald das erste passende Element im sichtbaren Bereich erscheint – auch wenn es bereits beim Laden der Seite sichtbar ist. Gib einen gültigen CSS-Selektor mit höchstens 1024 Zeichen ein. |
| click_selector | Erforderlich Zeichenfolge | Verfügbar, wenn: type = click_element. Das Ziel wird erreicht, sobald ein Besucher auf ein passendes Element klickt. Auch Klicks auf Symbole oder Text innerhalb des Elements zählen. Gib einen gültigen CSS-Selektor mit höchstens 1024 Zeichen ein. |
| value | Optional Gleitkommazahl | Optionaler Betrag, der mit jeder neuen Conversion gespeichert wird. Lass das Feld leer, um Conversions ohne Wert zu erfassen. Verwende für diese Website immer dieselbe Einheit oder Währung. Gib einen Wert zwischen 0 und unter 10000000000000 mit höchstens 2 Nachkommastellen ein. |
| key | Optional Zeichenfolge | - |
curl --request POST \
--url 'https://pico-analytics.com/api/goals' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'website_id=1' \
--form 'name=Example' \
--form 'type=click_element' \
--form 'path=blog/*' \
--form 'click_selector=.buy-button' \
--url 'https://pico-analytics.com/api/goals' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'website_id=1' \
--form 'name=Example' \
--form 'type=click_element' \
--form 'path=blog/*' \
--form 'click_selector=.buy-button' \
{
"data": {
"id": 1,
"website_id": 1,
"user_id": 1,
"key": "123456789",
"type": "click_element",
"path": "/blog/*",
"scroll_percentage": null,
"scroll_selector": null,
"click_selector": ".buy-button",
"value": null,
"webhook_url": null,
"name": "Example",
"last_datetime": null,
"datetime": "2026-11-19 22:33:30"
}
}
POST https://pico-analytics.com/api/goals/{goal_id}
| Parameter | Details | Beschreibung |
|---|---|---|
| website_id | Optional Ganzzahl | - |
| type | Optional Zeichenfolge | Erlaubte Werte: pageview, custom, scroll, scroll_element, click_element, webhook |
| name | Optional Zeichenfolge | - |
| path | Optional Zeichenfolge | Verfügbar, wenn: type = pageview, scroll, scroll_element, click_element |
| scroll_percentage | Optional Ganzzahl | Verfügbar, wenn: type = scroll |
| scroll_selector | Optional Zeichenfolge | Verfügbar, wenn: type = scroll_element. Das Ziel wird erreicht, sobald das erste passende Element im sichtbaren Bereich erscheint – auch wenn es bereits beim Laden der Seite sichtbar ist. Gib einen gültigen CSS-Selektor mit höchstens 1024 Zeichen ein. |
| click_selector | Optional Zeichenfolge | Verfügbar, wenn: type = click_element. Das Ziel wird erreicht, sobald ein Besucher auf ein passendes Element klickt. Auch Klicks auf Symbole oder Text innerhalb des Elements zählen. Gib einen gültigen CSS-Selektor mit höchstens 1024 Zeichen ein. |
| value | Optional Gleitkommazahl | Optionaler Betrag, der mit jeder neuen Conversion gespeichert wird. Lass das Feld leer, um Conversions ohne Wert zu erfassen. Verwende für diese Website immer dieselbe Einheit oder Währung. Gib einen Wert zwischen 0 und unter 10000000000000 mit höchstens 2 Nachkommastellen ein. |
| key | Optional Zeichenfolge | - |
curl --request POST \
--url 'https://pico-analytics.com/api/goals/{goal_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Example' \
--form 'type=scroll' \
--form 'path=blog/*' \
--form 'scroll_percentage=75' \
--url 'https://pico-analytics.com/api/goals/{goal_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Example' \
--form 'type=scroll' \
--form 'path=blog/*' \
--form 'scroll_percentage=75' \
{
"data": {
"id": 1,
"website_id": 1,
"user_id": 1,
"key": "123456789",
"type": "scroll",
"path": "/blog/*",
"scroll_percentage": 75,
"scroll_selector": null,
"click_selector": null,
"value": null,
"webhook_url": null,
"name": "Example",
"last_datetime": "2026-11-19 22:33:30",
"datetime": "2026-11-19 22:33:30"
}
}
Sende eine POST-Anfrage an die private Webhook-URL, die beim Bearbeiten des Ziels angezeigt wird. JSON und Formulardaten werden unterstützt. Auch eine leere POST-Anfrage erfasst eine Conversion.
Webhook-Ziele geben eine private webhook_url in der Antwort zurück. Über diese URL kannst du Conversions ohne API-Schlüssel übermitteln.
Übermittle einen Wert, um einen tatsächlichen Betrag zu erfassen, oder lasse ihn weg, um den eingestellten Conversion-Wert zu verwenden. Gespeichert werden nur Zeitpunkt und Wert der Conversion. Jede akzeptierte POST-Anfrage zählt einzeln, auch bei wiederholten Anfragen. Webhook-Conversions werden keinem Besucher, keiner Sitzung und keinem Seitenereignis zugeordnet.
POST https://pico-analytics.com/pixel-webhook/{webhook_key}
curl --request POST \
--url 'https://pico-analytics.com/pixel-webhook/{webhook_key}' \
--header 'Content-Type: application/json' \
--data '{"value":49.90}'
--url 'https://pico-analytics.com/pixel-webhook/{webhook_key}' \
--header 'Content-Type: application/json' \
--data '{"value":49.90}'
{"message":"","status":"success","details":[]}
DELETE https://pico-analytics.com/api/goals/{goal_id}
curl --request DELETE \
--url 'https://pico-analytics.com/api/goals/{goal_id}' \
--header 'Authorization: Bearer {api_key}' \
--url 'https://pico-analytics.com/api/goals/{goal_id}' \
--header 'Authorization: Bearer {api_key}' \